작업 모음

속성 이름	설명		유형	기본값	필수 사항 또는 선택 사항
maxItemsToShow	표시되는 최대 작업 버튼 수입니다. 작업 버튼 개수가 지정된 값보다 많은 경우 드롭다운 메뉴에서 추가 작업이 채워집니다.		정수	2	필수 사항
modelThingName	다음 서명이 있는 서비스를 포함하는 사물의 이름입니다. public JSONObject GetActions(@ThingworxServiceParameter(name = "ccoJson", baseType = "JSON") JSONObject ccoJson) 이 서비스는 단일 항목을 포함하는 CCO 형식의 입력을 받습니다. 그런 다음 사용 가능한 작업의 ID를 백 엔드에서 받은 해당 레이블에 매핑하는 배열을 포함하는 JSONObject를 반환합니다. 아래의 샘플 JSON 구성에 있는 예를 참조하십시오.		문자열	"PTC.ActionBar Model.Thing"	필수 사항
actions	작업 모음에서 사용할 수 있는 작업입니다. 다음 하위 속성을 참조하십시오.		문자열	해당 없음	필수 사항
actions	id	백 엔드 시스템에서 받은 작업의 ID입니다. 하위 속성은 다음 표를 참조하십시오.	문자열	해당 없음	필수 사항
objectType	작업을 가져올 객체 유형입니다.		문자열	해당 없음	필수 사항
adapter	백 엔드 시스템에 대한 소스 구성입니다. 다음 하위 속성을 참조하십시오.		문자열	해당 없음	필수 사항
	instanceName	백 엔드 시스템에 연결하는 데 사용할 커넥터를 의미하는 커넥터 인스턴스입니다.	문자열	"windchill"	필수 사항
	thingName	데이터를 검색할 백 엔드 시스템 또는 어댑터의 이름입니다.	문자열	"PTC.WCAdapter"	필수 사항

id 아래의 구성 필드
속성 이름	설명		유형	기본값	필수 사항 또는 선택 사항
overrideLabel	여기에 설정된 값은 작업 버튼의 레이블로 표시되며 백 엔드 시스템에서 가져온 값을 재정의합니다. 로컬리제이션하려면 이중 괄호 안에 값을 넣으십시오.		문자열	해당 없음	선택 사항
actionButtonVisibility	작업 버튼이 표시되는 조건 및 상태를 결정합니다. 옵션은 AlwaysShown, DisableUnavailable, HideUnavailable입니다. AlwaysShown의 경우 버튼은 항상 표시되고 활성화됩니다. DisableUnavailable의 경우 버튼은 항상 표시되지만 지정된 선택에 대해 작업을 사용할 수 없을 때 비활성화됩니다. HideUnavailable의 경우 버튼은 지정된 선택에 대해 작업을 사용할 수 있을 때에만 표시됩니다. 참고: 버튼의 활성화 또는 비활성화에 영향을 주는 다른 구성이 있습니다.		문자열	해당 없음	필수 사항
buttonStyle	버튼의 표시 스타일을 결정합니다. 옵션은 primary, secondary, tertiary, danger, transparent입니다.		문자열	해당 없음	필수 사항
overrideSetDisabled	이 필드를 설정하면 해당 값이 버튼의 활성화/비활성화 여부를 결정하는 유일한 요소가 됩니다. 옵션은 true, false입니다. true이면 버튼이 비활성화되고, false이면 버튼이 활성화됩니다.		부울	해당 없음	선택 사항
activityType	이 작업에서 서비스를 실행할지 아니면 팝업 매쉬업을 표시할지를 결정합니다. 옵션은 popup, service입니다. 팝업 및 서비스에 대한 필수 하위 속성은 아래 표를 참조하십시오.		문자열	해당 없음	필수 사항
fireEventOnFinish	이 필드를 true로 설정하면 서비스가 실행을 마칠 때 EventTriggered 이벤트가 트리거되고 팝업이 닫히면 PopupClosed 이벤트가 트리거됩니다.		부울	해당 없음	선택 사항
inputConstraints	작업에 대한 입력 제약 조건을 결정합니다. 옵션은 InputRequired, SingleInputOnly 및 NoInputRequired입니다. InputRequired: 이 작업은 작동을 위해 입력을 수신해야 합니다. 입력이 비어 있고 아무 항목도 없으면 이 작업의 버튼이 비활성화됩니다. SingleInputOnly: 이 작업은 작동을 위해 단일 입력을 받아야 합니다. 입력이 비어 있거나 단일 항목이 둘 이상 있으면 이 작업의 버튼이 비활성화됩니다. NoInputRequired: 이 작업은 입력 없이 또는 입력을 사용하여 작동할 수 있습니다.		문자열	해당 없음	선택 사항
ordinal	작업 버튼이 표시되는 순서입니다. 서수가 가장 낮은 작업이 초기 맨 왼쪽 위치에 표시됩니다. 음수 값이 허용됩니다.		정수	해당 없음	필수 사항
iconWhenEnabled	이 필드가 지정되면 작업 버튼이 활성화될 때 작업의 버튼에 레이블 왼쪽의 아이콘이 포함됩니다.		문자열	해당 없음	선택 사항
iconWhenEnabled	entityName	아이콘으로 사용할 미디어 엔티티의 이름입니다.	문자열	해당 없음	선택 사항
iconWhenDisabled	이 필드가 지정되면 작업 버튼이 비활성화될 때 작업의 버튼에 레이블 왼쪽의 아이콘이 포함됩니다.		문자열	해당 없음	선택 사항
iconWhenDisabled	entityName	아이콘으로 사용할 미디어 엔티티의 이름입니다.	문자열	해당 없음	선택 사항

popup의 activityType에 대한 하위 속성
속성 이름	설명	유형	기본값	필수 사항 또는 선택 사항
mashupName	팝업으로 나타나는 매쉬업의 이름입니다.	문자열	해당 없음	필수 사항
redirectAfterPopupSuccess	작업이 성공한 후 팝업이 닫히면 다른 매쉬업으로 리디렉션합니다. 팝업에서 수행한 작업의 성공 여부를 작업 모음에 알리려면 PTC.ActionBar.popupCloseParameters라는 세션 매개 변수가 성공 또는 실패를 표시하도록 설정해야 합니다. 예를 들어, 팝업 매쉬업에서 팝업이 수행한 작업이 완료된 후 실행되는 표현식이 있을 수 있으며 이 표현식에서 세션 매개 변수가 설정됩니다. 다음 예에서는 작업이 성공했으므로 JSON 속성 operationSuccessful이 true로 설정됩니다. sessionStorage.setItem("PTC.ActionBar.popupCloseParameters", JSON.stringify( { operationSuccessful: true } ));	문자열	해당 없음	선택 사항
popupWidth	표시되는 팝업의 너비를 지정합니다. 이 필드를 비워 두면 팝업의 기본 너비는 1024가 됩니다.	정수	해당 없음	선택 사항
popupHeight	표시되는 팝업의 너비를 지정합니다. 이 필드를 비워 두면 팝업의 기본 너비는 640이 됩니다.	정수	해당 없음	선택 사항

service의 activityType에 대한 하위 속성
속성 이름	설명	유형	기본값	필수 사항 또는 선택 사항
thingWithService	실행할 서비스를 포함하는 사물의 이름입니다.	문자열	해당 없음	필수 사항
serviceName	실행할 서비스의 이름입니다.	문자열	해당 없음	필수 사항
parameters	이 선택적 필드를 사용하면 하드 코딩된 매개 변수를 서비스에 전달할 수 있습니다. 매개 변수는 JSONObject에서 정의되지만 이스케이프된 인용구를 사용하여 JSON 객체의 문자열로 형식을 지정해야 합니다. 매개 변수는 구성 파일에 "{\"myParamName\": \"hardcodedValue\"}" 형식으로 입력해야 합니다. 아래 추가 정보를 참조하십시오.	StringRepresentationOfJSONObject	해당 없음	선택 사항

서비스에서 자동으로 가져오는 두 매개 변수 serviceParam_InputCco 및 serviceParam_ActionId가 있습니다(해당 매개 변수를 받을 수 있는 서비스 서명을 정의할 경우). serviceParam_InputCco 매개 변수는 JSONObject이고, 작업 모음에 제공된 입력입니다. serviceParam_ActionId 매개 변수는 클릭한 작업의 ID가 포함되는 문자열입니다. 서비스의 서명에 이 매개 변수가 없으면 사용할 수 없습니다. 이러한 매개 변수를 사용하려면 다음을 사용하여 두 매개 변수 중 하나 또는 둘 다를 사용하도록 서비스 서명을 정의합니다.

@ThingworxServiceDefinition(name = "MyService", category = "MyCategory")
public void MyService(
@ThingworxServiceParameter(name = "serviceParam_InputCco", baseType = "JSON")
JSONObject serviceParam_InputCco,
@ThingworxServiceParameter(name = "serviceParam_ActionId", baseType = "STRING")
String serviceParam_ActionId)

{
"maxItemsToShow": {
"value": 3
},
"modelThingName": {
"entityName": "PTC.ActionBarModel.Thing"
},
"actions": {
"selectedValues": {
"data": [{
"itemListsData": [{
"items": [{
"id": "Approve",
"additionalData": {
"actionConfiguration": {
"overrideLabel": {
"value": ""
},
"actionButtonVisibility": {
"selectedKey": "HideUnavailable"
},
"buttonStyle": {
"selectedKey": "primary"
},
"activityType": {
"selectedKey": "popup"
},
"mashupName": {
"mashupName": "PTC.AccessApp.WindchillServices.RoutingOptionMashup"
},
"fireEventOnFinish": {
"value": false
},
"inputConstraints": {
"selectedKey": "SingleInputOnly"
}
}
},
"ordinal": 1
}, {
"id": "Reject",
"additionalData": {
"actionConfiguration": {
"overrideLabel": {
"value": ""
},
"actionButtonVisibility": {
"selectedKey": "HideUnavailable"
},
"buttonStyle": {
"selectedKey": "primary"
},
"activityType": {
"selectedKey": "popup"
},
"mashupName": {
"mashupName": "PTC.AccessApp.WindchillServices.RoutingOptionMashup"
},
"fireEventOnFinish": {
"value": false
},
"inputConstraints": {
"selectedKey": "SingleInputOnly"
}
}
},
"ordinal": 2
}, {
"id": "Analyze",
"additionalData": {
"actionConfiguration": {
"overrideLabel": {
"value": ""
},
"actionButtonVisibility": {
"selectedKey": "HideUnavailable"
},
"buttonStyle": {
"selectedKey": "primary"
},
"activityType": {
"selectedKey": "popup"
},
"mashupName": {
"mashupName": "PTC.AccessApp.WindchillServices.RoutingOptionMashup"
},
"fireEventOnFinish": {
"value": false
},
"inputConstraints": {
"selectedKey": "SingleInputOnly"
}
}
},
"ordinal": 3
}, {
"id": "Reassign",
"additionalData": {
"actionConfiguration": {
"overrideLabel": {
"value": "Reassign"
},
"actionButtonVisibility": {
"selectedKey": "AlwaysShown"
},
"buttonStyle": {
"selectedKey": "primary"
},
"activityType": {
"selectedKey": "popup"
},
"mashupName": {
"mashupName": "PTC.AccessApp.WindchillServices.ReassignActionMashup"
},
"fireEventOnFinish": {
"value": false
},
"inputConstraints": {
"selectedKey": "InputRequired"
}
}
},
"ordinal": 4
}
],
"objectType": "WT.WorkItem.Actions"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
}