This guide explains the overall masks that may be used by different roles.
- A
PURIS_USERmay see use the views "Dashboard" and "Stocks". - A
PURIS_ADMINmay additionally use the views "Catalog", "Negotiations" and "Transfers".
In the following the views are explained.
Note: A user may additionally log out or see license information of the application.
The Dashboard gives an overview over the user's own production output and demands and the corresponding information from the user's partners as well as incoming and outgoing deliveries.
It is visually divided in 4 horizontal parts:
- Tabs for selecting the assumed role (customer or supplier)
- Filters for selecting material, site and partner sites
- Production/Demand information for selected site
- Corresponding data for selected partner sites
Using the tabs the user can choose the role they want to assume. This choice determines what information is shown to them.
As a customer, the user will be shown the user's own site's demand and incoming deliveries as well as the user's customers' production output and outgoing shipments.
As a supplier, the user will be shown the user's own site's production output and outgoing shipments as well as the user's customers' demands and incoming deliveries.
In either case the user will always see the current and projected item stocks of both the user's own and the user's partners' sites.
To show information in the dashboard the user have to first pick the material number the user are interested in followed by the user's own site. This will immediately display the available information for that material and site. the user can further select one or more partner sites to display the corresponding data.
Note: Each filter requires the previous ones. The user can not filter by material number and partner sites alone.
Once the user has selected a material number and site they are presented with an overview of the site's data. Depending on the user's role they will see the demand and incoming deliveries or production output and outgoing shipments for customer and supplier respectively. In addition the user will see the current and projected item stock.
The data is displayed for up to the next 4 weeks depending on available data.
By clicking on an individual demand, production or delivery data cell the user can display detailed information for the given day.
In addition to viewing the user's own data, the user can also add new data for the selected material and site. The buttons for adding new data are located to the top right of the data view.
The user can add demands for the customer role as well as production output for the supplier. Deliveries can be added for either role, but they are always from the supplier to the customer.
Upon clicking the "create demand" button, a popup will prompt the user to enter the details for the new demand. The material number and site for the demand will be pre-filled for the user based on the filters the user have currently selected.
To add a new demand the user:
- Enters the day of the demand
- Selects the demand category
- Enters the quantity required
- Selects the unit of measurement
- Selects the supplying partner
- (Optional) Selects the expected supplier site
- Clicks the "save" button
A notification in the top right of the user's screen will inform them, if saving was successful. Afterwards the user will see the newly added demand reflected in the their site data overview.
Upon clicking the "create production" button, a popup will prompt the user to enter the details for the new production output. The material number and site for the production output will be pre-filled for the user based on the filters they have currently selected.
To add a new production output, the user:
- Enters the estimated time of completion
- Selects the customer to allocate the production to
- Enters the quantity produced
- Selects the unit of measurement
- (Optional) Fills the order position reference
- Clicks the "save" button
A notification in the top right of the user's screen will inform them, if saving was successful. Afterwards the user will see the newly added production output reflected in their site data overview.
Unlike demand and production output, deliveries can be added regardless of the user's role. Upon clicking "add delivery" the user will be presented with a popup for adding a new delivery. The material number will be pre-filled based on the user's selected material. Furthermore the origin or destination site will be filled for the supplier and customer roles respectively.
To add a new delivery the user:
- Selects the departure type
- Selects the date of departure
- Selects the arrival type
- Selects the date of arrival
- Selects the partner for the delivery
- Chooses the origin or destination site (depending on the user's role)
- Enters the quantity
- Selects the unit of measurement
- (Optional) Enters the tracking number
- Selects the incoterms for the delivery
- (Optional) Fills the order position reference
- Clicks the "save" button
A notification in the top right of the user's screen will inform them, if saving was successful. Afterwards the user will see the newly added delivery reflected in their site data overview.
Note: When entering a new delivery the user should make sure that:
- a date can only be of type actual if it is in the past
- arrival can only be of type actual if departure is as well
- departure must be before arrival
By selecting one or more partner sites from the filters the user is presented with their data. Depending on the user's chosen role these tables will show the demand and incoming shipments or planned production output and outgoing shipments respectively. In both cases they will also show the current and projected item stock at each partner site.
The data is displayed for up to the next 4 weeks depending on available data.
The user can click individual production output, demand or delivery data cells to display detailed information.
The displayed data in this section is mostly reported data from the partner. Therefore it can become outdated.
In order to request an update of the data, the user can click the "Refresh" button at the top right of the section. This will start a request for updated data in the background.
Afterwards, when the user refreshes the page, they will be presented with the updated data.
Note: The update process can take a few seconds.
This view allows a user to either create material or product stocks and allocate them to a partner. Stocks always need to be allocated to a partner due to potential multi-sourcing scenarios.
The view is divided horizontally into three parts:
- Create or Update Material / Product Stocks
- Own Stocks
- Reported Stocks from partners
This view allows the user to add a material or product by choosing the corresponding tab.
To add a new item, the user:
- Selects the Material/Product from the dropdown
- Sets the partner who will receive (Product) or from whom one received (Material) the stock.
- Sets a quantity that is on stock with a selected unit of measurement (UOM).
- Whether the stock is blocked or not (e.g. quality assurance ongoing).
- The stocks location based on a Site (BPNS) and a corresponding Address (BPNA).
- Optionally adds a reference to order positions.
- Clicks the "Add or Update" Button
Upon successful creation a toast notification is displayed and the new stock is added to the "Your Stock" table.
The table shows the relevant information regarding all material / product stocks that are at the user's sites. The user may select one stock to see the corresponding stock at the partner's site.
Upon selecting a material / product this table shows detailed information about the corresponding stocks at this partner's site. Using the button "Refresh Stocks", the user may request an update of this data for all partners who supply the material / product.
Note: Stock information is updated asynchronously. The user may reload the page later to see the updated data.
An admin may use the page to query offers available at a partner to check if the partner set up the information exchange for this partner.
After choosing a partner from the dropdown and triggering the "Get Catalog" button, the admin may see a list of available assets.
Per Catalog Item the following information is listed:
- Asset ID
- Asset Prop Type defining the asset type (close to CX Taxonomy)
- Asset actions
- Asset conditions
- Prohibitions (Contracts)
- Obligations (Contracts)
Note: Only catalog items / offers that can be accessed by the user are listed.
An admin may use the page to see all recent negotiations and their state.
If no negotiation has been performed in the EDC yet, a message will be displayed informing the user of this fact.
Per Negotiation the following information is listed:
- Negotiation ID
- Type (is the user Data
PROVIDERor DataCONSUMER) - State of the negotiation
- Partner BPNL who either
- initiated the negotiation (Type =
PROVIDER) or - who the user asked to negotiate with (Type =
CONSUMER)
- initiated the negotiation (Type =
- Partner's EDC DSP endpoint
- TimeStamp when the state of the negotiation has been set
Note: Per data request per partner, the application looks up the data of interest in the Digital Twin Registry of a partner and then pulls the data.
An admin may use the page to see all recent transfers and their state.
If no transfer has been performed in the EDC yet, a message will be displayed informing the user of this fact.
Per Transfer the following information is listed:
- Transfer ID
- Correlation ID indicating the
Transfer IDon partner site - State of the negotiation
- TimeStamp when the state of the negotiation has been set
- Type (is the user Data
PROVIDERor DataCONSUMER?) - Asset ID that has been contracted
- Contract ID that has been the basis of the Transfer
- Partner BPNL who either
- initiated the negotiation (Type =
PROVIDER) or - who the user asked to negotiate with (Type =
CONSUMER)
- initiated the negotiation (Type =
Note: Per data request per partner, there are two Transfers as one contracts the partner's request asset and the partner contracts the user's response asset.