MES Integration#
Critical Manufacturing provides a high level of extensibility and scalability that allows the system to integrate with different environments and interact with different data structures from multiple customers. A Generic Integration package was created to allow communication between different sites and solutions.
Info
The example presents two different facilities (different sites), but in certain scenarios the communication could be made within the same facility.
Generic Integrations#
The Generic Integrations package was developed to bridge the gap between integration engine and DEE actions by interpreting the integration entry and redirecting the execution to a previously configured DEE Action.
This package allows an agile and fast development of a integration scenario by simply accessing a handler resolution configuration and processing the data through the developed DEE Action.
The DEE Action is associated with the Message Type:
This integration package will be used for all integrations between Critical Manufacturing MES systems. For now, the product provides out-of-the-box Remote Material Shipment integration.
Activate Generic Integrations#
To activate generic integrations, the /Cmf/System/Configuration/Integration/GenericIntegration/GenericIntegrationIsActive configuration key must be set or updated.
Remote Material Shipment#
Some situations in systems that model more than one Facility require a workflow to transfer materials from one Facility to another. This workflow is ensured by Remote Material Shipment integration.
To setup this integration scenario, all modeled objects must be represented in the system for it to work properly. Remote site mapping configuration is required for each site, as well as a remote Facility (which will be a local Facility on the remote site) and the same Flow and Steps.
Info
The remote sites and remote Facilities shall be defined in both sites.
Configure Remote Site#
The remote site that will receive the Material should be configured in Critical Manufacturing MES system, with special attention to some mandatory fields:
- RemoteExportAddress: public endpoint of the Critical Manufacturing MES system running on the remote site
- RemoteExportTenant: security tenant for authentication
- RemoveExportToken: security personal access token (PAT) for authentication
Configure Remote Facility#
The remote Facility must be configured with same name as it has in remote site, should be also marked as remote and associated to respective remote site which needs to have been previously created:
Shipping Facilities#
In the local Facility, the user must assign the remote Facility as a shipping Facility:
Define Integration Message Type#
To allow seamless integration handler resolution, a message type name should be configured to differentiate the integration entries:
/Cmf/System/Configuration/Integration/MessageTypes/MaterialRemoteShip
Ship Material#
To perform a material shipment, the user needs to pick an active and queued Material. A Ship button will be available in the Material page.
Warning
The Allow Shipping flag must be active in the Material.
On the Ship wizard, the user chooses for which facility the Material will be shipped:
After confirmation, the MES system creates a new integration entry that will generate (through generic integration action) a material shipment request on the remote endpoint and the Material status will be updated after the acknowledgement of the request. In the meantime, the user can check the integration status within the System Integrations page:
Receive Material#
At the remote site, after the new integration entry is created, the user will have the pending Materials ready to be received in the Facility View Page.
