设备转换器事物上的服务
本集成中所用的以下服务位于设备转换器事物上 (PTC.RA.EquipmentConverter)。
AddEquipmentStructureToNetwork
AddEquipmentStructureToNetwork 服务会将已转换的事物添加到网络中的设备结构。ImportPlantModelObjects 工作流服务使用此服务。
• 输入参数：
◦ equipmentStructure (JSON) - 包含事物名称和父事物名称的 JSON 数组，如 CreateEquipmentThings 服务的输出。例如，
[
{
"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) - 待初始化的网络的名称。创建指定的网络（如不存在）。如果指定的网络存在，则事物会添加到现有网络中。如果 AddEquipmentStructureToNetwork 服务用于 ImportPlantModelObjects 工作流服务，则该值来自该服务的 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) - 服务返回的实体的类型。这些值均小写，并且必须匹配 PTC.RA.EquipmentConverter 事物的 EquipmentTypeMapping 配置表上的 PlantModelObjectType 以下值之一：site、area、workcenter、productionline 和 equipment。
◦ parentId (String) - (可选) 设备结构中特定父项的名称。如果输入了有效的 parentId，则服务将仅返回父项的直接子项。如果未指定 parentId 值，则会返回指定类型的所有工厂对象。
◦ limit (Integer) - 返回项目的最大数量。默认值为 500。如果输入一个非正数，则服务返回一个空的 JSON 数组。
• 输出：result (JSON) - 实体列表的 JSON 数组，表示 Rockwell FactoryTalk MES 系统中记录的指定工厂模型对象。
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 系统导入数据时名称的唯一性。
• 输出：无输出。