장비 변환기 사물의 서비스
이 통합에 사용되는 다음 서비스가 장비 변환기 사물(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) - 서비스에서 반환되는 엔티티 유형입니다. 값은 소문자이며 PTC.RA.EquipmentConverter 사물에 대한 EquipmentTypeMapping 구성 테이블의 PlantModelObjectType 값(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 시스템에서 데이터를 가져올 경우 이름 고유성을 보장할 수 있으므로 사용하는 것이 좋습니다.
• 출력: 출력 없음