Shop Floor Control

This document describes the minimum configuration requirements to connect Shop Floor Control with Sage X3.

The Shop Floor application is only available to use with at least Sage X3 release 2024 R2/V12.0.36.

Network prerequisites

Shop Floor Control is a cloud-based application designed to integrate with your Sage X3 installation. Ensure the Sage X3 Web server is securely configured to allow this communication.

Check the Sage X3 Best Security Practices documentation on how to guarantee the security of exposing a server on the Internet.

  • The Shop Floor application uses HTTPS to secure communications with your Sage X3 installation:

    • To setup the HTTPS communication for X3, an SSL/TLS certificate is required. Note: Self-signed certificates are not supported.

    • The certificate needs to be issued by an external CA known by Node.js. You can find the list of external CAs acknowledged by Node.js here.

    • The full certificate chain, including the intermediate CA certificate, needs to be installed. Check your certificate provider to find more information on to install the full certificate chain. You can use an SSL checker to verify the certificate chain.

    • The DNS name resolution must be in place and match the SSL/TLS certificate.

Sage X3 prerequisites

  • Shop Floor Control requires X3 services to be deployed and configured. You can find more information on how to deploy and configure X3 Services here.

  • Shop Floor requires that X3 bearer token authentication to be enabled in nodelocal.js. To do that, the auth entry of nodelocal.js needs to have bearer mode enabled or added:

    javascript
    session: {
        // ...
        // authentication modes
        auth: ["bearer"],
    },

    For detailed information, check the documentation on Oauth2 authentication for Web services.

  • If a HTTP header filtering is used on the firewall or in a reverse proxy, the following headers should not be filtered: x-xtrem-endpoint.

Other prerequisites

  • It's not possible to connect the same Shop Floor Control tenant to multiple Sage X3 installations.

Devices

  • Devices used to access the Shop Floor Control application need to be able to access the application via HTTPS.

  • To track Shop Floor operations, Sage recommends the use of tablet devices. Note: Sage does not provide the devices.

  • Device requirements:

    • Apple or Android tablets with latest iOs or Android 13 minimum.

    • Recommended screen size of the device is 10" or larger.

  • Tests have been performed on the following devices. This is only an indication for suitable devices, not an exhaustive list.

    • Lenovo Tab M10 Plus

    • Apple iPad (9th generation)

    • Samsung Galaxy Tab A9