PAS-X Configuration

A number of configuration steps must be carried out on the PAS-X MES system side to integrate with system:inmation successfully.

Preparation

The following preparation sections should be read and followed according to the needs of your system:

System ID and System Name

Look up the System ID and System Name defined in the prerequisites section.

Profile/User Definition

For a simple test setup and a standard installation, the system owner profile can be used for authentication, however this is not recommended for a productive or qualification system. If a dedicated Profile will be used for that connection, configure that with the Web API first.

This Profile must be granted access to the system using the Web API (by selecting "External API" in the General Authorization) and it must be granted write access to the Message Processor object that is created below the Message Broker object, otherwise the communication will not work.

Token Authentication is used with the Web API but the token itself is not configurable within the PAS-X system. The PAS-X system just needs the correct username and password and the token is used through the Authentication Endpoint (see below).

Endpoint Configuration

For the correct communication PAS-X has to know the URLs of four endpoints:

  1. Endpoint to Shopfloor: this endpoint can be taken directly from the Message Broker Endpoint to Shopfloor property.

  2. Endpoint to MES: this endpoint can be taken directly from the Message Broker Endpoint to MES property

  3. Authentication Endpoint: this endpoint is used to request authentication ticket, prior to the communication

  4. The Delete Endpoint: this endpoint removed messages from the outgoing message queue, the delete shall be called as acknowledgement of message reception from PAS-X

The URL of the Delete endpoint can be derived from the Endpoint to MES (see above) with the "sf_to_mes" part replaced with "sf_to_mes_delete".

The Authentication Endpoint has always the same relative URL, the only thing that changes is the hostname/IP address and the Port of the Web API:

Username and Password must be configured according to the Profile/User defined (see above section on Profile/User definition).

Depending on the configuration of the Web-API regarding encryption, define the endpoints as either unencrypted http:<….> or encrypted https:<…> endpoints.

Adaptor Setup

Once the preparation steps described above have been carried out, the PASX2MSI adaptor can be configured. To do this, please follow the manufacturer instructions provided by Körber/Werum in the "PASX2MSI Adapter MSI – System Manual" regarding the Setup of a Web Service adapter.

During this process the the MsiSystem section should be configured as follows: - MsiSystemName as described in the prerequisites section - MsiSystemId as described in the prerequisites section - The ExternalIdentifier is given the value "MsiSystemId"

MsiSystem configuration
Figure 1. MsiSystem configuration

In the Connection Tab, the other endpoint information collected earlier is set: - AuthenticationURL: enter the inmation Authentication Endpoint here - GetMessageURL: enter the inmation "to MES" endpoint here - SendAcknowledgeForGet: this must be true - AcknowledgeForGetRequestUrl: enter the inmation “Delete“ endpoint here - PostMessageUrl: enter the inmation "to Shopfloor" endpoint here. - Username and Password: as defined earlier

Connection configuration
Figure 2. Connection configuration