設備轉換器物件上的服務
在此整合中使用的下列服務由設備轉換器物件 (PTC.RA.EquipmentConverter) 提供。
AddEquipmentStructureToNetwork
AddEquipmentStructureToNetwork 服務會將轉換的物件新增至網路中的設備結構。此服務由 ImportPlantModelObjects 工作流程服務使用。
• 輸入參數：
◦ equipmentStructure (JSON) - 包含物件名稱與父項物件名稱 (例如 CreateEquipmentThings 服務的輸出) 的 JSON 陣列。例如，
[
{
"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) - 要初始化之網路的名稱。如果指定的網路不存在，則會進行建立。如果指定的網路存在，則會將物件新增至現有網路。當在 ImportPlantModelObjects 工作流程服務中使用 AddEquipmentStructureToNetwork 服務時，此值來自該服務的 networkName 輸入參數。
• 輸出：無輸出
ConvertAlienNameToThingWorxEntityName
ConvertAlienNameToThingWorxEntityName 服務會根據需要修改工廠模型物件的名稱，以符合 ThingWorx 命名需求。服務碼中提供有 ThingWorx 命名需求的詳細資訊。此服務由 CreateEquipmentThings 服務在內部使用。
• 輸入參數：
◦ prefix (String) - 要新增至實體名稱的前綴。
◦ suffix (String) - 要新增至實體名稱的後綴。
◦ alienName (String) - 要轉換的實體名稱。
• 輸出︰ result (String) - 符合 ThingWorx 命名需求的已轉換實體名稱。
CreateEquipmentThings
CreateEquipmentThings 服務會針對在輸入 JSON 中定義的每個工廠模型物件建立物件。根據在設備轉換器 (PTC.RA.EquipmentConverter) 之 EquipmentTypeMapping 組態表中定義的對應來建立物件。此 JSON 由 FactoryTalk MOM 連接器提供。CreateEquipmentThings 服務由 ImportPlantModelObjects 工作流程服務使用。
• 輸入參數：
◦ plantObjectModelJSON (JSON) - 包含工廠模型物件資訊的 JSON。例如，
{
"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) - (選用) 新增至物件名稱以確保名稱具唯一性的後綴。若透過多個 MES 系統將資訊新增至 ThingWorx，此功能非常有用。若透過 ImportPlantModelObjects 工作流程服務調用，此值來自 identifierMES 輸入參數。
• 輸出︰result (JSON) - 包含父項與子項名稱陣列的 JSON。如果物件存在於 ThingWorx 中，則不會對其進行覆寫。此 JSON 由 AddEquipmentStructureToNetwork 服務使用。
GetPlantModelObjectsByType
GetPlantModelObjectsByType 服務使用 ThingWorx Flow 工作流程從 Rockwell FactoryTalk MES 系統傳回指定類型的工廠物件的 JSON 陣列。可選擇性地將 JSON 陣列篩選為僅為指定父項的子項。客戶可決定整合此工作流程服務以進一步進行篩選。
• 輸入參數：
◦ type (String) - 由服務傳回的實體類型。值為小寫，且必須與某個 PlantModelObjectType 值 (位於 PTC.RA.EquipmentConverter 物件的 EquipmentTypeMapping 組態表上) 相符︰site、area、workcenter、productionline 與 equipment。
◦ parentId (String) - (選用) 設備結構中特定父項的名稱。如果已輸入有效的 parentId，服務只會傳回父項的直接子項。如果未指定 parentId 值，則會傳回指定類型的所有工廠物件。
◦ limit (Integer) - 傳回項目的最大數目。預設值為 500。如果輸入非正數，服務會傳回空 JSON 陣列。
• 輸出︰result (JSON) - 實體清單 (表示在 Rockwell FactoryTalk MES 系統中記錄的指定工廠模型物件) 的 JSON 陣列。
ImportPlantModelObjects
ImportPlantModelObjects 服務使用 ThingWorx Flow 工作流程執行以下動作︰
• 擷取連線 Rockwell FactoryTalk MES 系統上定義的所有工廠模型物件。
• 為每個工廠模型物件建立 ThingWorx 物件。
• 將建立的物件新增至 Rockwell FactoryTalk MES 系統中所定義設備結構關係中的 ThingWorx 網路。
如果 ThingWorx 中存在同名的任何物件，則會略過這些物件的建立，且略過物件的屬性值不會更新。此服務在其 ThingWorx Flow 工作流程中使用 CreateEquipmentThings 與 AddEquipmentStructureToNetwork 服務。
• 輸入參數：
◦ networkName (String) - 要新增已轉換物件之 ThingWorx 網路實體的名稱。如果此網路不存在，則會在執行服務時進行建立。如果指定的網路存在，則會將物件新增至現有網路。
◦ identifierMES (String)—(選用) Rockwell FactoryTalk MES 系統的識別元。此值會附加至物件名稱。雖然此欄位可選，但在從多個 Rockwell FactoryTalk MES 系統匯入資料時，建議使用它來確保名稱的唯一性。
• 輸出：無輸出。