Dienste im Anlagenkonvertierungs-Ding
Die folgenden in dieser Integration verwendeten Dienste werden im Anlagenkonvertierungs-Ding (PTC.RA.EquipmentConverter) bereitgestellt.
AddEquipmentStructureToNetwork
Der Dienst AddEquipmentStructureToNetwork fügt einer Anlagenstruktur im Netzwerk konvertierte Dinge hinzu. Dieser Dienst wird vom Workflow-Dienst ImportPlantModelObjects verwendet.
• Eingabeparameter:
◦ equipmentStructure (JSON) – Ein JSON-Array mit den Dingnamen und Eltern-Dingnamen, etwa die Ausgabe aus dem Dienst CreateEquipmentThings. Beispiel:
[
{
"thingName": "site_S1",
"parentThingName": ""
},
{
"thingName": "area_A1",
"parentThingName": "site_S1"
},
{
"thingName": "productionline_PL1",
"parentThingName": "area_A1"
},
{
"thingName": "workcenter_WC1",
"parentThingName": "productionline_PL1"
},
{
"thingName": "equipment_E1",
"parentThingName": "workcenter_WC1"
}
]
◦ networkName (String) – Name des zu initialisierenden Netzwerks. Wenn das angegebene Netzwerk nicht vorhanden ist, wird es erstellt. Wenn das angegebene Netzwerk vorhanden ist, werden Dinge zum vorhandenen Netzwerk hinzugefügt. Wenn der Dienst AddEquipmentStructureToNetwork im Workflow-Dienst ImportPlantModelObjects verwendet wird, stammt dieser Wert aus dem Eingabeparameter networkName dieses Dienstes.
• Ausgabe: Keine Ausgabe
ConvertAlienNameToThingWorxEntityName
Der Dienst ConvertAlienNameToThingWorxEntityName ändert den Namen des Betriebsmodell-Objekts nach Bedarf, um ihn an die Benennungsanforderungen in ThingWorx anzupassen. Details zu den Benennungsanforderungen in ThingWorx finden Sie im Dienstcode. Dieser Dienst wird intern vom Dienst CreateEquipmentThings verwendet.
• Eingabeparameter:
◦ prefix (String) – Präfix, das dem Entitätsnamen hinzugefügt werden soll.
◦ suffix (String) – Suffix, das dem Entitätsnamen hinzugefügt werden soll.
◦ alienName (String) – Entitätsname, der konvertiert werden soll.
• Ausgabe: result (String) – Konvertierter Entitätsname, der den Benennungsanforderungen in ThingWorx entspricht.
CreateEquipmentThings
Der Dienst CreateEquipmentThings erstellt ein Ding für jedes Betriebsmodell-Objekt, das in der Eingabe-JSON definiert ist. Die Dinge werden gemäß der Zuordnung in der Konfigurationstabelle EquipmentTypeMapping im Anlagenkonvertierungs-Ding (PTC.RA.EquipmentConverter) erstellt. Diese JSON wird vom FactoryTalk MOM-Konnektor bereitgestellt. Der Dienst CreateEquipmentThings wird vom Workflow-Dienst ImportPlantModelObjects verwendet.
• Eingabeparameter:
◦ plantObjectModelJSON (JSON) – JSON, die die Betriebsmodell-Objektinformationen enthält. Beispiel:
{
"type": "workcenter",
"url": "http://10.81.43.8:8080/FTPCApps/rest",
"entityList": [
{
"name": "S_WC1",
"description": null,
"category": null,
"creationTime": "2018-11-30T05:18:59.687Z",
"lastModifiedTime": "2018-11-30T05:18:59.687Z",
"parentId": "s_PL1",
"parentType": "productionline"
"links": {
"selfURL": "http://10.81.43.8:8080/FTPCApps/rest/mf/v1/workcenters/S_WC1",
"parentURL": "http://10.81.43.8:8080/FTPCApps/rest/mf/v1/productionlines/s_PL1",
"childrenURL": "http://10.81.43.8:8080/FTPCApps/rest/mf/v1/equipment?workcenter=S_WC1"
}
},
{
"name": "S_WC10",
"description": null,
"category": null,
"creationTime": "2018-11-30T05:19:05.457Z",
"lastModifiedTime": "2018-11-30T05:19:05.457Z",
"parentId": "s_PL10",
"parentType": "productionline"
"links": {
"selfURL": "http://10.81.43.8:8080/FTPCApps/rest/mf/v1/workcenters/S_WC10",
"parentURL": "http://10.81.43.8:8080/FTPCApps/rest/mf/v1/productionlines/s_PL10",
"childrenURL": "http://10.81.43.8:8080/FTPCApps/rest/mf/v1/equipment?workcenter=S_WC10"
}
}
]
}
◦ uniqueIdentifier (String) (optional) – Suffix, das dem Dingnamen hinzugefügt wird, um die Eindeutigkeit des Namens sicherzustellen. Dies ist nützlich, wenn Informationen aus mehreren MES-Systemen zu ThingWorx hinzugefügt werden. Dieser Wert stammt aus dem Eingabeparameter identifierMES, wenn der Aufruf vom Workflow-Dienst ImportPlantModelObjects erfolgt.
• Ausgabe: result (JSON) – JSON mit einem Array der Eltern- und Kindnamen. Wenn die Dinge in ThingWorx vorhanden sind, werden sie nicht überschrieben. Diese JSON wird vom Dienst AddEquipmentStructureToNetwork verwendet.
GetPlantModelObjectsByType
Der Dienst GetPlantModelObjectsByType verwendet einen ThingWorx Flow Workflow, um ein JSON-Array von Betriebsobjekten eines angegebenen Typs aus dem Rockwell FactoryTalk MES System zurückzugeben. Das JSON-Array wird optional nur nach Kindern eines bestimmten Elternteils gefiltert. Kunden können diesen Workflow-Dienst bei Bedarf für weitere Filterzwecke integrieren.
• Eingabeparameter:
◦ type (String) – Der Typ der vom Dienst zurückgegebenen Entitäten. Die Werte sind Kleinbuchstaben und müssen mit einem der PlantModelObjectType-Werte in der Konfigurationstabelle EquipmentTypeMapping im Ding PTC.RA.EquipmentConverter übereinstimmen: site, area, workcenter, productionline und equipment.
◦ parentId (String) (optional) – Der Name eines bestimmten Elternelements in der Anlagenstruktur. Wenn ein gültiger Wert für parentId eingegeben wird, gibt der Dienst nur direkte Kinder des Elternteils zurück. Wird kein Wert für parentId angegeben, werden alle Betriebsobjekte des angegebenen Typs zurückgegeben.
◦ limit (Integer) – Die maximale Anzahl der zurückgegebenen Elemente. Der Standardwert ist 500. Wenn eine nicht positive Zahl eingegeben wird, gibt der Dienst ein leeres JSON-Array zurück.
• Ausgabe: result (JSON) – JSON-Array der Entitätsliste, das die Betriebsmodell-Objekte darstellt, die in einem Rockwell FactoryTalk MES System aufgezeichnet wurden.
ImportPlantModelObjects
Der Dienst ImportPlantModelObjects verwendet einen ThingWorx Flow Workflow, um:
• alle auf dem verbundenen Rockwell FactoryTalk MES System definierten Betriebsmodell-Objekte abzurufen
• ThingWorx Dinge für jedes Betriebsmodell-Objekt zu erstellen
• die erstellten Objekte zu einem ThingWorx Netzwerk in der im Rockwell FactoryTalk MES System definierten Anlagenstrukturbeziehung hinzuzufügen
Wenn Dinge mit demselben Namen in ThingWorx vorhanden sind, wird die Erstellung dieser Dinge übersprungen und die Eigenschaftswerte für die übersprungenen Dinge werden nicht aktualisiert. Dieser Dienst verwendet die Dienste CreateEquipmentThings und AddEquipmentStructureToNetwork in seinem ThingWorx Flow Workflow.
• Eingabeparameter:
◦ networkName (String) – Der Name einer ThingWorx Netzwerkentität, zu der die konvertierten Dinge hinzugefügt werden. Wenn dieses Netzwerk nicht vorhanden ist, wird es beim Ausführen des Dienstes erstellt. Wenn das angegebene Netzwerk vorhanden ist, werden Dinge zum vorhandenen Netzwerk hinzugefügt.
◦ identifierMES (String) (optional) – ID für das Rockwell FactoryTalk MES System. Dieser Wert wird an den Dingnamen angehängt. Obwohl dieses Feld optional ist, wird seine Verwendung empfohlen, um die Eindeutigkeit von Namen sicherzustellen, wenn Daten aus mehreren Rockwell FactoryTalk MES Systemen importiert werden.
• Ausgabe: Keine Ausgabe.