General information about configuration
The Material Management Clients version 3.0+ are able to communicate with a Material Management Service version 3.0+ (REST Endpoints). Older versions of the Material Management Service (Wcf Endpoints) are not supported anymore in this version and cannot be configured.
Description of the configuration files
OpCon.Settings.xml
Contains connection settings for communication with the Material Management and Order Management Services.
| Parameter | Possible values | Comment | Example |
|---|---|---|---|
TenantId |
Any valid TenantId |
The TenantId to use |
2dd0e7b8-5b15-454a-84c8-5d46ed73292a |
MaterialManagement.ServiceUrl |
The BaseUrl of the Material Management instance to use |
https://servername.de.bosch.com/mat |
|
OrderManagement.ServiceUrl |
The BaseUrl of the Order Management instance to use |
https://servername.de.bosch.com/om |
Nexeed.PlugIn.Macma.MaterialManagement.xml
Contains the configuration values to use for authenticating and authorizing the user with Macma and to obtain the token used to communicate with the Material Management Service.
| Parameter | Possible values | Comment | Example |
|---|---|---|---|
TenantId |
Any valid TenantId |
The TenantId to use |
2dd0e7b8-5b15-454a-84c8-5d46ed73292a |
MacmaBaseUrl |
The BaseUrl of the Macma instance to use |
Should contain the part of the URL containing the hostname and port. The part of the URL before "/iam/…" |
https://servername.de.bosch.com |
ClientId |
The public (-frontend) Macma ClientId for Material Management |
Other Macma Clients cannot be used |
ajdm8oxhem4h1l9qlyjjsig97-frontend |
ClientSecret |
For OidcFlow AuthCodeWithPKCE this should be left empty |
For OidcFlow Password the Client Secret needs to be entered here |
|
RefreshThreshold |
1-1000000 |
Tokens with higher remaining lifetime than this value will not be refreshed. Default Value: 30 |
30 |
RefreshCheckInterval |
1-1000000 |
Time interval in seconds between checks whether the token should be refreshed. This value should always be lower than RefreshThreshold. Default Value: 20 |
20 |
RefreshIntervalForRoles |
0-1000000 |
Time interval in seconds between the user role refreshes. 0 = Disabled. Default Value: 0 (disabled) |
60 |
OidcFlow |
AuthCodeWithPKCE, Password |
Should be set to AuthCodeWithPKCE. |
AuthCodeWithPKCE |
Nexeed.PlugIn.Macma.OrderManagement.xml
Contains the configuration values to use for authenticating the user with Macma and to obtain the token to communicate with the Order Management Service. This file has to be configured if the configuration value for ShowAndUpdateMaterialReservations is set to true, otherwise this configuration file will not be used.
| Parameter | Possible values | Comment | Example |
|---|---|---|---|
TenantId |
Any valid TenantId |
The TenantId to use |
2dd0e7b8-5b15-454a-84c8-5d46ed73292a |
MacmaBaseUrl |
The BaseUrl of the Macma instance to use |
Should contain the part of the URL containing the hostname and port. The part of the URL before "/iam/…" |
https://servername.de.bosch.com |
ClientId |
The public (-frontend) Macma ClientId for Order Management |
Other Macma Clients cannot be used |
ajdm8oxhem4h1l9qlyjjsig97-frontend |
ClientSecret |
For OidcFlow AuthCodeWithPKCE this should be left empty |
||
RefreshThreshold |
1-1000000 |
Tokens with higher remaining lifetime than this value will not be refreshed. Default Value: 30 |
30 |
RefreshCheckInterval |
1-1000000 |
Time interval in seconds between checks whether the token should be refreshed. This value should always be lower than RefreshThreshold. Default Value: 20 |
20 |
RefreshIntervalForRoles |
0-1000000 |
Time interval in seconds between the user roles refreshs. 0 = Disabled. Default Value: 0 (disabled) |
60 |
OidcFlow |
AuthCodeWithPKCE, Password |
Should be set to AuthCodeWithPKCE. |
AuthCodeWithPKCE |
LogisticsDesktopConfig.xml
The contents of this file can be configured with the Configuration UI inside the Client. Refer to the Chapter client_configuration_ui for a description of the contents of this file.
Client configuration UI
Configure climate cabinet
The Configuration menu can be opened by clicking on the Configuration button in the navigation bar on the left-hand side.
The Configuration menu opens.
-
Clicking on the + symbol will expand each of the individual nodes.
-
Open Plugins > MCCConfig node and enter the Location.
-
Open the Plugins > MCCConfig node and enter any free text in the StationInfo field.
This free text will be displayed in the title bar and will also be used as the StationInfo for the material if SelectedStationInfoMode is set to ByScanner. The remaining settings can be used to adjust the program behavior to suit the relevant application.
After you did changes to the configuration, apply the changes by clicking on the Save (floppy disc) icon.
| Parameter | Description |
|---|---|
AllowOnlyUniqueStorageBins |
The system will only allow users to book storage locations that are currently free of materials. |
BookMaterialToReservationDepotLocationAtWithdraw |
Indicates whether, upon the withdrawal from storage of reserved material, the material should be booked straight to the line’s handover location. This only works if the ShowAndUpdateMaterialReservations parameter is also activated. |
ContentAutoRefreshTimerIntervalSeconds |
The time in seconds for the automatic refresh of the displayed contents. The minimum effective refresh interval is 120 seconds. The automatic refresh is only active when ShowAndUpdateMaterialReservations is set to True and the filter option "Only reserved materials" is selected in the Content view. |
ForbiddenMsdLevelsClimateCabinet |
List of MSD levels separated by ";" that must be rejected when being stored in a "ClimateCabinet" storage location. If nothing is entered here, the function is deactivated and all materials are accepted for storage. E.g.: n;x;1;01;2;02 |
ForbiddenMsdLevelsStorage |
List of MSD levels separated by ";" that must be rejected when being stored in "Storage" storage location. If nothing is entered here, the function is deactivated and all materials are accepted for storage. In general, the system will permit users to book all materials that are still packaged into a "Storage" storage location, regardless of how this parameter is configured. E.g[].: 2a;3;03;4;04;5;05;5a |
Location |
The cabinet’s Location. |
MaxNumberOfEntriesInContentTable |
Maximum number of entries permitted in the materials list in order to increase the update speed. |
SelectedStationInfoMode |
Method that is used to set the storage location(StationInfo/Storage bin) for the booked materials.
|
SelectedStorageLocationType |
The storage type for the configured Location.
|
SelectedStoreWithdrawMode |
Mode used to store and withdraw materials.
|
ShowAndUpdateMaterialReservations |
Specifies whether or not material reservations are displayed and updated during withdrawal from storage. Note: Requires a connection to an Order Management service. |
StationInfo |
StationInfo free text; is displayed in the title bar and is used as the StationInfo when SelectedStationInfoMode is set to UseGlobalConfiguration. |
StationInfoMustBeSetAtStore |
Indicates whether the storage location must be set before the material can be booked in. |
