InterSystems IRIS Smart Factory Starter Pack
NOTE: This application is licensed as open source under the MIT License and is not officially supported by InterSystems Corporation. Use it at your own risk.
Application Starter Pack for manufacturing companies using OPC-UA for OEE Dashboard.
The Starter Pack is a generic framework for fast generation and consists of :
- API for managing master data
- API for equipment setup with their related data from the PLC
- API for datastructure generation
- API for sending information to PowerBI using the Push DataSet interface
- Integration example with JD Edwards
The Starter Pack is used within a project in a manufacturing plant to give operators realtime insight in OEE and other custom metrics witihin their process. For more information about the functional and technical working see the Wiki https://github.com/intersystems/asp-oee/wiki of the project.
Structure
The repository has been separated into 4 parts.
Classes
The source of this solution divided into:
- JDE integration sources
- OPC-UA generation framework
- PowerBI push dataset integration
Images
The images used within the Wiki
Postman
PostMan projects to get started quickly with this project
Python
This solution uses the InterSystems Python Gateway https://openexchange.intersystems.com/package/PythonGateway with the free OPC-UA library https://github.com/FreeOpcUa/opcua-asyncio
Getting started
Installation
- Create a namespace with the name OEESP
- Install the InterSystems Python Gateway https://openexchange.intersystems.com/package/PythonGateway
- Install the InterSystems classes. This can be easily done by using this tool https://github.com/gertjanklein/iris-export-builder
- Install the python code in a directory on your machine and get the requirements by running
pip install -r requirements.txt
- Install Postman (https://www.postman.com/downloads/)
- Optionally you can load the masterdata that is provided in the masterdata directory in the corresponding opc.ua.config.* table
Initial configuration
Before we can really use the solution we need to create manually the webapplications.
Go in the Management Portal to System Administration -> Security -> Applications -> Web Applications
DataModel
- Name - /api/v1/datamodel
- Dispatch Class - opc.ua.rest.datamodel.disp
- Security Settings - Unauthenticated
Equipment
- Name - /api/v1/equipment
- Dispatch Class - opc.ua.rest.equipment.disp
- Security Settings - Unauthenticated
Master data
- Name - /api/v1/masterdata
- Dispatch Class - opc.ua.rest.masterdata.disp
- Security Settings - Unauthenticated
Postman StarterProject
There are 2 postman projects available that you can import in postman to get you started.
- StarterPack collection consists of all available URL's within the Rest Services
- StarterPack example collection is a simple example to get you up and running with a simple 3 layer (staging, transformation and serving) setup for 1 equipment and some nodes.
- The StarterPack Development environment for running the projects locally
Tutorial
The wiki (https://github.com/intersystems/asp-oee/wiki/Tutorial) of this repository has a tutorial that explains the example that has been delivered as a PostMan project and how to use & update the generated model.
