항목 목록에 대한 GetImplementationSettings 서비스 관련 추가 정보
이 항목에서는 항목 목록에 사용할 수 있는 사용자 지정 서비스인 GetImplementationSettings 서비스에 대해 설명합니다. 일반 목록과 달리, 이 서비스는 일반적으로 항목 목록에서 구조 트리에 데이터를 표시할 때 사용됩니다. 예를 들어, 항목 목록의 사전 정의된 구성인 부품 구조와 문서 구조 모두 이 서비스를 사용합니다.
또한 selectedItems 입력 바인딩 속성을 사용 가능하도록 하려면 이 서비스를 구현해야 합니다. 이 selectedItems 속성을 사용하면 항목 목록에서 항목을 미리 선택할 수 있습니다.
GetImplementationSettings 서비스에는 다음 세 개의 속성이 포함될 수 있습니다. 객체 유형당 속성이 하나만 있는 경우 각 속성은 항목당 하나 이상의 속성을 보유할 수 있습니다.
• itemIdentifierKeys
이 필수 키에는 각 입력 항목에서 항목을 선택할 수 있는 속성이 포함되어 있습니다. selectedItems의 입력에 지정된 다른 속성은 무시됩니다. 지정된 첫 번째 속성만 고려되며 추가 속성은 무시됩니다.
속성 값이 각 항목에 대해 고유한 경우 selectedItems를 사용할 때 단일 항목만 선택됩니다. 고유하지 않으면 해당 속성에 해당 값이 있는 모든 항목이 선택됩니다.
• itemExpansionKeys
이 선택적 키는 항목 목록에 계층적 데이터가 표시되는 경우에만 관련이 있습니다. selectedItems를 사용하여 축소된 항목을 선택할 때 구조 트리에서 처음에 축소된 항목(예: 기본 확장 수준으로 인해)을 확장할 수 있습니다. itemExpansionKeys의 속성은 구조에서 누락된 항목을 식별하는 데 사용됩니다. 속성 값은 항목을 식별하는 데 사용되므로 속성 값은 각 항목에 대해 고유해야 합니다.
다음 서비스의 기본 구현은
GetStructureSkeleton:
GetItemsByExpansionPath,
MapItemToInputObject,
GetChildren,
itemExpansionKeys를 사용합니다. 자세한 내용은
항목 목록 항목의
사용자 지정 서비스 섹션을 참조하십시오.
• hasChildrenKeys
이 선택적 키는 항목 목록에 계층적 데이터가 표시되는 경우에만 관련이 있습니다.
hasChildrenKeys에는 항목에 하위 항목이 있는지 여부를 결정하는 데 사용되는 각 항목의 속성 이름이 포함되어 있습니다. 항목에 대해 이 속성이 누락되었거나 속성 값이 false인 경우 항목에 하위 항목이 없는 것으로 간주됩니다.
hasChildrenKeys가 포함되어 있지 않으면 트리 구조를 표시하기 위해 항목 데이터 CCO의 각 항목에 대한
PTC.Nav.Descendants 키 아래에 있는 항목 섹션의 현재 상태가 하위 항목의 표시기로 사용됩니다. 자세한 내용은
Common Communication Object 구조를 참조하십시오.
GetImplementationSettings에 대한 샘플 코드
부품 구조 항목이 포함된 샘플
단일 객체 유형의 항목에 대한 샘플 코드:
"implementationSettings":{
...
"itemIdentifierKeys":[
{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"PartUseId",
"ordinal":0
}
],
"objectType":"PTC.ProdMgmt.PartStructureItem"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
}
],
"itemExpansionKeys":[
{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"PathId",
"ordinal":0
}
],
"objectType":"PTC.ProdMgmt.PartStructureItem"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
}
],
"hasChildrenKeys":[
{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"HasChildren",
"ordinal":0
}
],
"objectType":"PTC.ProdMgmt.PartStructureItem"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
}
]
}
여러 객체 유형의 항목에 대한 샘플 코드:
"implementationSettings":{
...
"itemIdentifierKeys":[
{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"PartUseId",
"ordinal":0
}
],
"objectType":"PTC.ProdMgmt.PartStructureItem"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
},
{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"PVTreeId",
"ordinal":0
}
],
"objectType":"PTC.CADDocumentMgmt.CADStructure"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
}
],
"itemExpansionKeys":[
{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"PathId",
"ordinal":0
}
],
"objectType":"PTC.ProdMgmt.PartStructureItem"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
},
{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"PVTreeId",
"ordinal":0
}
],
"objectType":"PTC.CADDocumentMgmt.CADStructure"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
}
],
"hasChildrenKeys":[
{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"HasChildren",
"ordinal":0
}
],
"objectType":"PTC.ProdMgmt.PartStructureItem"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
},
{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"HasChildren",
"ordinal":0
}
],
"objectType":"PTC.CADDocumentMgmt.CADStructure"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
}
]
}
문서 구조 항목이 포함된 샘플
"implementationSettings":{
"..."
"itemIdentifierKeys":[
{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"DocumentUseID",
"ordinal":0
}
],
"objectType":"PTC.DocMgmt.DocStructure"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
}
],
"hasChildrenKeys":[
{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"HasChildren",
"ordinal":0
}
],
"objectType":"PTC.DocMgmt.DocStructure"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
}
],
"overrideItemsDataForExport":{
"value":false
}
}