Administrator guide

For the person who installs, configures, and supports the product.

Requirements

ComponentRequirement
Fishbowl2026.6 or later
PluginILC CloudPages plugin
Access rightImport / Export-Locations Import, for a user who imports

The page reads the location group list with SQL. It writes through the Fishbowl import API. It needs no other server component.

Installation

Installation is the same for every ILC catalog page. For the full steps, see TBD (public documentation URL).

  1. Buy the page on ilcreports.com.
  2. Install the CloudPages plugin in Fishbowl.
  3. Configure CloudPages with the manifest URL from the purchase.
  4. Confirm that the purchased pages appear in the installation.
  5. Grant page access to the users who need it.

Verify. Open the page. Click ? to run the guided tour. The tour changes nothing in Fishbowl.

To configure the page, see Settings.

Updates

Updates are the same for every ILC catalog page.

A customer gets the latest stable version of a page by default. To stay on a previous version, or to return to one, choose the version in the ilcreports.com portal.

Fishbowl keeps its own data through an update. The plugin data in Fishbowl holds the access rights, the module placement, and the page settings. This data also survives a page removal.

For what changed in each version, see the release notes.

Security

The page reads one access right.

RightWhat it changes
Import / Export-Locations ImportThe user without it meets a disabled import control.

This check hides a control. It does not enforce access. The page asks the Fishbowl client whether the user holds the right, and the client answers from credentials it already has. Fishbowl uses the same call to hide rows from its own import picker. Treat the result as visibility.

Two facts follow from how the client answers.

  1. A user named admin passes every right check, including a right that does not exist. Do not test this page's gating with the admin account.
  2. If the Fishbowl subscription lapses, every right that is not a view right returns false. The admin account loses access too.

Who to grant access to. A user who can open the page can read every location group name in the Fishbowl database, whatever rights that user holds. A query through the bridge is not right-checked. Grant page access to the people who build warehouse locations: implementers, and the warehouse manager who owns the layout.

Considerations

The page creates locations and updates locations. It never deletes one. A location built by mistake stays in Fishbowl until somebody removes it in the client.

An import creates the location group named in the file when that group does not exist. The page offers the list of real groups instead of a text box, so a typing mistake cannot invent a group.

Data handling

Every query and API call the page makes:

OperationAgainstRight checked
Querylocationgroup, for the group listNone
Plugin data readLocationBuilder, for the default settingsNone
Plugin data writeLocationBuilder, from the Settings dialogAdministration
API ImportLocationsOne call for each regionImport / Export-Locations Import

The page sends one import call for each region. Fishbowl does not import part of a file, so a call carries one region and a failure costs one region. This was tested: a file of three rows with one bad row created nothing.

Fishbowl reports a refusal inside its answer, not as an error. A refused import returns status 1500 with a message that names the reason and the line number. The page reads that status, marks the region failed, and writes the whole message to the import log.

What leaves the Fishbowl client. The project file, when the user saves it. It holds the floorplan image, the drawn regions, and the settings. The user chooses where to save it. Nothing else leaves the client, and the page sends nothing to ILC.

The floorplan never reaches Fishbowl. It lives in the project file only.

Settings

An administrator sets the defaults that a new project starts from. Every project then keeps the settings it was built with. The page works before anybody changes a setting.

SettingDefaultWhat changes
Separator.The character between the aisle, rack, shelf, and bin parts of a name.
Pad numbersOnA number becomes 01 instead of 1, so names sort in walking order.
Width2The number of digits a padded number uses.
Hide denied controlsOffThe import control disappears instead of showing as disabled.

The page follows the theme of the Fishbowl client, light or dark. No setting controls this, and the page carries no theme control of its own.

A badge beside the page title reads Demo when the page reaches no Fishbowl. Connected to Fishbowl, the page shows no badge, because that is the normal state.

These values are fixed and no one can change them:

LimitValue
Length of a location name30 characters. Fishbowl truncates a longer name to 30 and reports success, so the page stops it first rather than let a location be created under a name nobody chose.
Hyphen in a location nameNot allowed. Fishbowl reads a full location as Group - Location, and refuses a name that contains one.
Floorplan size3000 by 3000 pixels. A larger image is scaled down.
Levels for each region200 values for each of the four levels

Change where the page appears in the CloudPages plugin page Edit dialog:

PlacementDefault
PathReports:ILC Products
ModulesNone
Toolbar buttonNone

Troubleshooting

The import control is disabled

The import control is disabled and names no right

A region imported, and the locations are not in Fishbowl

Work is lost after the page closes

The floorplan looks soft when zoomed in

A new location group already has locations in it

A location group appeared that nobody created

Before a support request

Open the import log at the bottom of the page. Click Copy. The log names each region, the number of rows, the first and last location, and the message Fishbowl returned.

Collect: