Administrator guide
For the person who installs, configures, and supports the product.
Requirements
| Component | Requirement |
|---|---|
| Fishbowl | 2026.6 or later |
| Plugin | ILC CloudPages plugin |
| Access right | Import / 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).
- Buy the page on ilcreports.com.
- Install the CloudPages plugin in Fishbowl.
- Configure CloudPages with the manifest URL from the purchase.
- Confirm that the purchased pages appear in the installation.
- 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.
| Right | What it changes |
|---|---|
| Import / Export-Locations Import | The 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.
- 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.
- 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:
| Operation | Against | Right checked |
|---|---|---|
| Query | locationgroup, for the group list | None |
| Plugin data read | LocationBuilder, for the default settings | None |
| Plugin data write | LocationBuilder, from the Settings dialog | Administration |
API ImportLocations | One call for each region | Import / 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.
| Setting | Default | What changes |
|---|---|---|
| Separator | . | The character between the aisle, rack, shelf, and bin parts of a name. |
| Pad numbers | On | A number becomes 01 instead of 1, so names sort in walking order. |
| Width | 2 | The number of digits a padded number uses. |
| Hide denied controls | Off | The 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:
| Limit | Value |
|---|---|
| Length of a location name | 30 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 name | Not allowed. Fishbowl reads a full location as Group - Location, and refuses a name that contains one. |
| Floorplan size | 3000 by 3000 pixels. A larger image is scaled down. |
| Levels for each region | 200 values for each of the four levels |
Change where the page appears in the CloudPages plugin page Edit dialog:
| Placement | Default |
|---|---|
| Path | Reports:ILC Products |
| Modules | None |
| Toolbar button | None |
Troubleshooting
The import control is disabled
- Symptom: The user cannot click Import into Fishbowl. The control shows a message that names an access right.
- Cause: The user does not hold Import / Export-Locations Import.
- Fix: Grant the right to a user group the user belongs to.
The import control is disabled and names no right
- Symptom: The control is disabled, and the panel above lists problems.
- Cause: A location name breaks a rule, or no location group is chosen.
- Fix: Read the list. It names each problem and the location that causes it.
A region imported, and the locations are not in Fishbowl
- Symptom: The region shows as imported, and a search finds no location.
- Cause: The search looks in a different location group.
- Fix: Check the group in the review table. The import writes to that group.
Work is lost after the page closes
- Symptom: The drawing is gone after a restart.
- Cause: The page has no autosave. The project lives in a saved file.
- Fix: None. Save the project file before closing the page. The page warns about unsaved work, and an Unsaved badge sits beside the project name.
The floorplan looks soft when zoomed in
- Symptom: The plan blurs at a high zoom.
- Cause: The page stores a floorplan at 3000 by 3000 pixels at most.
- Fix: None. This behavior is expected, and it keeps the project file small.
A new location group already has locations in it
- Symptom: A location group created by an import holds a Stock, a Receiving, and a Shipping location that nobody imported.
- Cause: Fishbowl creates those with any new location group.
- Fix: None. They are Fishbowl's own defaults.
A location group appeared that nobody created
- Symptom: Fishbowl lists a location group that no one recognizes.
- Cause: An import creates a group when that group does not exist. Another tool or an edited project file can carry a group name that Fishbowl does not have.
- Fix: Remove the group in Fishbowl. Then import again with a real group.
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:
- The Fishbowl version and the page version.
- The import log.
- The project file, when the customer agrees to share it.
- The browser console output.
- A screenshot of the page.