Informazioni aggiuntive sul servizio GetImplementationSettings per Elenco elementi
In questo argomento viene descritto il servizio GetImplementationSettings, che è un servizio di personalizzazione disponibile per Elenco elementi. Questo servizio viene in genere utilizzato quando Elenco elementi visualizza i dati in un albero struttura anziché in un elenco semplice. Ad esempio, le configurazioni predefinite Struttura parti e Struttura documento di Elenco elementi utilizzano entrambe questo servizio.
Inoltre, questo servizio deve essere implementato se si desidera attivare la proprietà di associazione di input selectedItems. La proprietà selectedItems consente di preselezionare un elemento in Elenco elementi.
Il servizio GetImplementationSettings può contenere le tre proprietà riportate di seguito. Ogni proprietà può contenere uno o più attributi per elemento, purché esista un solo attributo per tipo di oggetto.
• itemIdentifierKeys
Questa chiave obbligatoria contiene l'attributo, per ogni elemento di input, con cui è possibile selezionare l'elemento. Tutti gli altri attributi forniti nell'input di selectedItems verranno ignorati. Viene considerato solo il primo attributo specificato, eventuali attributi aggiuntivi vengono ignorati.
Se il valore dell'attributo è univoco per ogni elemento, quando si utilizza selectedItems, viene selezionato solo un singolo elemento. Se non è univoco, vengono selezionati tutti gli elementi con tale valore su tale attributo.
• itemExpansionKeys
Questa chiave facoltativa è rilevante solo quando in Elenco elementi vengono visualizzati i dati gerarchici. Supporta l'espansione di elementi inizialmente compressi (ad esempio a causa di un livello di espansione di default) nell'albero struttura quando un elemento compresso viene selezionato utilizzando selectedItems. Gli attributi in itemExpansionKeys vengono utilizzati per identificare eventuali elementi mancanti nella struttura. Poiché i valori degli attributi vengono utilizzati per identificare gli elementi, devono essere univoci per ciascun elemento.
L'implementazione di default dei seguenti servizi utilizza
itemExpansionKeys:
GetChildren,
MapItemToInputObject,
GetItemsByExpansionPath,
GetStructureSkeleton. Per ulteriori informazioni, vedere la sezione
Servizi di personalizzazione nell'argomento
Elenco elementi.
• hasChildrenKeys
Questa chiave facoltativa è rilevante solo quando in Elenco elementi vengono visualizzati i dati gerarchici.
hasChildrenKeys contiene il nome dell'attributo su ogni elemento utilizzato per determinare se tale elemento dispone o meno di sottoelementi. Se questo attributo non è presente per un elemento o se il valore dell'attributo è false, si presuppone che l'elemento non disponga di sottoelementi. Se
hasChildrenKeys non è incluso, ai fini della visualizzazione di una struttura ad albero, la presenza di una sezione di elementi sotto la chiave
PTC.Nav.Descendants di ogni elemento nel CCO dati elementi viene utilizzata come indicatore di sottoelementi. Per ulteriori informazioni, vedere
Struttura CCO (Common Communication Object).
Codice di esempio per GetImplementationSettings
Esempio contenente elementi di Struttura parti
Codice di esempio per gli elementi di un singolo tipo di oggetto:
"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"
}
}
]
}
}
]
}
Codice di esempio per gli elementi di più tipi di oggetto:
"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"
}
}
]
}
}
]
}
Esempio contenente elementi di Struttura documento
"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
}
}