NextGen FSM
NextGen FSM
Breadcrumbs

Associate / disassociate a material kit with mobile warehouses

1. Overview

This feature allows an Administrator / Configurator to associate or disassociate an active Material Kit with one or more Mobile Warehouses.

The primary goal is to control which kits are utilized by each mobile warehouse, ensuring that the correct materials and replenishment rules are applied. This enables administrators to load or replace the set of materials used by a mobile warehouse in a controlled and consistent manner.

2. Preconditions

The following system requirements must be met before using this feature:

  • The administrator must access the Material Kit Master Data.

  • The selected Material Kit must be in an Active state.

  • Only Mobile Warehouses are eligible for association.

3. User Flow and UI

The system provides a "Associate Material Kit to Warehouses" button within the three dots action button of each Material Kit.

3.1. Adding a Mobile Warehouse (Association)

  1. Trigger Action: The user clicks the "Associate Material Kit to Warehouses" button of a specific material kit.

  2. Selection: A side panel "Associate Material Kit to Warehouses" opens, displaying two fields:

    1. Material Kit: read only field that shows the selected kit.

    2. Warehouse: an input decoder field that displays the already associated warehouses. It also displays a lens button to open a Search Warehouse page in order to facilitate the searching of warehouses

      1. It includes a Warehouse filter section for easy filtering.

      2. The user marks the desired warehouses by selecting them in the list after searching for mobile warehouses.

      3. Confirmation: A dialog box (Confirm / Cancel) appears selecting the button More Options. By clicking on Confirm the user is taking back to the previous side panel "Associate Material Kit to Warehouses" where the new selected warehouses are displayed within the field input decoder Warehouse.

  3. Success Feedback: Once confirmed by selecting Save in the side panel, changes are persisted and immediately visible.

3.2. Removing a Mobile Warehouse (Disassociation)

  1. In the side panel "Associate Material Kit to Warehouses" mentioned in the previous, each associated warehouse within the field warehouse displays a trash bin icon (delete action).

  2. Upon clicking the icon, the warehouse disappear from the list.

  3. After confirmation, the warehouse is removed from the list, and the corresponding success message is displayed.

4. Business Rules

The system enforces the following constraints to guarantee data integrity:

  • 1-to-1 Relationship (Kit - Warehouse): Only one (1) Material Kit can be associated with a Mobile Warehouse at a time.

  • Replacing Kits: If a Mobile Warehouse already has an assigned kit and needs a different one, the mandatory flow is:

    1. Remove the existing kit.

    2. Associate the new kit.

  • Duplication Prevention: The system actively prevents associating a kit to a Mobile Warehouse that already has a different active kit assigned.

5. System Behavior

5.1. Upon Association (Use Kit)

When a Material Kit is associated with a Mobile Warehouse, the NextGen FSM application executes the following:

  • Material Upsert: Performs an upsert operation of all materials defined in the kit as "allowed materials" for the selected Mobile Warehouse.

  • Synchronization (Replica): The Mobile Warehouse is marked as "using that Material Kit". This state information is sent to the replica to maintain architectural synchronization.

5.2. Upon Disassociation (Remove)

When a Material Kit is disassociated from a Mobile Warehouse:

  • Association Removal: The relational link between the kit and the warehouse is removed.

  • Material Retention: No automatic deletion of materials occurs (unless explicitly defined in future versions).

  • Synchronization (Replica): The Mobile Warehouse is no longer considered as using that Material Kit. This state change is sent to the replica.