Struttura parti
Struttura parti è una configurazione predefinita del componente Elenco elementi. Struttura parti contiene un albero struttura che visualizza la relazione gerarchica tra una parte o un documento CAD e i relativi discendenti. Per ogni elemento nell'albero, Struttura parti visualizza gli attributi che è possibile scegliere tramite configurazione. Gli attributi di default sono Numero, Nome e Stato del ciclo di vita.
È possibile configurare Struttura parti per impostare il livello di espansione iniziale dell'albero. Per default, il livello di espansione iniziale è impostato su 3. Gli utenti possono espandere e comprimere gli elementi nell'albero.
L'albero Struttura parti include i rientri per mostrare visivamente il livello della struttura. È possibile definire quale colonna appaia per prima nella tabella tramite la configurazione. Per default, la prima colonna è Numero.
Struttura parti presenta le stesse funzionalità di esportazione di Elenco elementi. Il file esportato include una colonna che mostra il livello numerico di ciascun elemento nella struttura e include i rientri per visualizzare il livello della struttura.
Di seguito è riportata un'immagine di esempio che mostra la configurazione predefinita Struttura parti:
* 
Se un utente che visualizza un albero struttura non dispone dei diritti di accesso per un elemento nella struttura, tale elemento non viene visualizzato e viene mostrato il seguente messaggio: "Alcuni elementi sono nascosti perché non disponi dei relativi diritti di accesso".
Proprietà di associazione 
Per informazioni sull'associazione di Struttura parti, vedere il componente Elenco elementi.
* 
Per Struttura parti, la proprietà di associazione di input supporta i tipi di oggetto PTC.ProdMgmt.Part e PTC.CADDocumentMgmt.CADDocument.
L'output della proprietà di associazione selectedItems contiene elementi con i tipi di oggetto PTC.ProdMgmt.PartStructureItem e PTC.CADDocumentMgmt.CADStructure.
Proprietà di configurazione 
Per un elenco di tutte le proprietà di configurazione disponibili per Struttura parti, vedere la tabella Proprietà di configurazione per il componente Elenco elementi. Nella tabella riportata di seguito vengono fornite informazioni aggiuntive specifiche di Struttura parti relative alle proprietà di configurazione.
Per ulteriori informazioni sulla struttura della configurazione, vedere Struttura di configurazione del componente.
Per ulteriori informazioni sulle sottoproprietà, vedere Sottoproprietà e chiavi contenitore.
Nome proprietà
Descrizione
Tipo di proprietà
Valore di default
Obbligatoria o facoltativa
attributes
Per ulteriori informazioni, vedere Elenco elementi.
Accetta gli attributi dei tipi di oggetto PTC.ProdMgmt.PartStructureItem e PTC.CADDocumentMgmt.CADStructure.
Per default, l'albero Struttura parti viene ordinato in base al primo attributo, ovvero l'attributo con il valore ordinale non negativo più basso.
N/D
Obbligatoria
Configurazione di esempio 
{
"attributes":{
"inTailoring":true,
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"Part|Number",
"ordinal":0
},
{
"id":"Part|Name",
"ordinal":1
},
{
"id":"Part|State#Display",
"ordinal":2
}
],
"objectType":"PTC.ProdMgmt.PartStructureItem"
},
{
"items":[
{
"id":"CADDocument|Number",
"ordinal":0
},
{
"id":"CADDocument|Name",
"ordinal":1
},
{
"id":"CADDocument|State#Display",
"ordinal":2
}
],
"objectType":"PTC.CADDocumentMgmt.CADStructure"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
}
},
"defaultExpansionLevel":{
"selectedKey":[
"3"
],
"inTailoring":true
},
"label":{
"value":""
},
"selectionType":{
"selectedKey":"multi"
},
"showExportAction":{
"additionalData":{
"itemListExportDefinition":{
"exportTypes":{
"selected":[
{
"key":"exportToCsv"
},
{
"key":"exportToExcel"
}
]
},
"exportUnFilteredData":{
"value":true
}
}
},
"value":true
},
"waitForInput":{
"value":true
},
"baseConfigurationVersion":{
"value":"nav.3"
},
"implementationConfigurationVersion":{
"value":"nav.1"
}
}
Servizi di personalizzazione 
Oltre alla configurazione, ogni componente supporta l'estensione della logica aziendale per personalizzare il componente. La logica aziendale di ciascun componente include servizi ignorabili in un modello di oggetto che è possibile estendere e sostituire. I servizi ignorabili per questo componente sono descritti in dettaglio nella tabella seguente.
Per esempi di elementi restituiti e parametri per ogni servizio, vedere Esempi di input/output per i servizi di personalizzazione.
Nome
Descrizione
ComputeMessages
Calcola i messaggi desiderati da visualizzare in Struttura parti. Riceve il JSON dei messaggi correnti e il JSON dei messaggi suggeriti e restituisce un JSON dei messaggi di notifica che contiene i messaggi da visualizzare nell'elenco di elementi.
Parametri:
getItemsResponse (obbligatorio) - Oggetto JSON in formato CCO contenente gli elementi restituiti dal servizio getItems.
currentMessages (obbligatorio) - Oggetto JSON contenente i messaggi di notifica correnti visualizzati nell'interfaccia utente.
suggestedMessages (obbligatorio) - Oggetto JSON contenente un insieme di messaggi suggeriti. Si consiglia di utilizzare i messaggi suggeriti.
input (facoltativo) - JSON in formato CCO che include l'ID input per l'elemento alla radice della struttura.
configuration (facoltativo) - JSON con la configurazione.
scope (facoltativo) - JSON che indica l'ambito dei dati in getItemsResponse. L'oggetto JSON contiene una chiave scope che accetta i valori root e child. Pertinente per i dati gerarchici. Esempio:
{
"scope": "root"
}
Restituisce: oggetto JSON contenente i messaggi da visualizzare nella griglia dell'elenco di elementi. Esempio:
"INFO":{
{
"messages":[
"[[PTC.Nav.ItemList.HiddenItemsBecauseAccessRightMessage]]"
]
}
}
DefHookAttributesTypesInfo
Restituisce una matrice JSON contenente le informazioni sull'adattatore e i tipi di oggetto degli attributi supportati da Struttura parti.
Parametri: nessuno
Restituisce: matrice JSON
GetChildren
Riceve una parte o un documento CAD e restituisce un JSON in formato CCO contenente i figli dell'elemento, ovvero tutti gli elementi che si trovano a un livello inferiore alla parte o al documento CAD nella struttura dati gerarchica. Il JSON restituito contiene i figli come elenco semplice, non dati gerarchici.
Parametri:
input (facoltativo) - JSON in formato CCO che include l'ID input per la parte o il documento CAD alla radice della struttura.
configuration (obbligatorio) - JSON con la configurazione.
item (obbligatorio) - JSON che include l'elemento padre i cui figli devono essere restituiti.
Restituisce: JSON in formato CCO
GetConfigurations
Restituisce le configurazioni disponibili per Struttura parti.
Parametri: nessuno
Restituisce: JSON
GetImplementationSettings
Restituisce i dati delle impostazioni di implementazione di Struttura parti. Le implementazioni possono sostituire questo servizio per fornire le proprie impostazioni. Per ulteriori informazioni, vedere l'argomento Informazioni aggiuntive sul servizio GetImplementationSettings per Elenco elementi.
Parametri: nessuno
Restituisce: oggetto JSON
GetItems
Restituisce la struttura per la parte o il documento CAD specificato nell'input.
Parametri:
input (obbligatorio) - JSON in formato CCO che include l'ID input per i dati da recuperare dal sistema di back-end e le informazioni sull'adattatore per il sistema di back-end.
configuration (obbligatorio) - JSON con la configurazione unita finale ottenuta dalla risorsa per la gestione delle personalizzazioni.
Restituisce: JSON in formato CCO
GetItemsByExpansionPath
Restituisce un CCO di struttura gerarchica che contiene tutti gli elementi del percorso dalla radice all'elemento richiesto, inclusi tutti gli attributi richiesti, itemIdentifierKeys e itemExpansionKeys. Il CCO di struttura gerarchica include tutti gli elementi di pari livello sul percorso.
Il servizio viene chiamato quando la proprietà di associazione selectedItems riceve un input che specifica un elemento non caricato.
Parametri:
input (facoltativo) - JSON in formato CCO che include l'ID input per la parte o il documento CAD alla radice della struttura.
configuration (obbligatorio) - JSON con la configurazione.
itemExpansionValues (obbligatorio) - Una matrice JSON che contiene itemExpansionKeys della parte o del documento CAD per cui è richiesta l'espansione. I valori della matrice vengono ordinati in base al percorso nella struttura, a partire dalla parte radice o dal documento CAD.
Restituisce: JSON in formato CCO
GetStructureSkeleton
Restituisce tutti i livelli di una struttura gerarchica in formato CCO, dove ogni parte o documento CAD della struttura include sia itemIdentifierKeys che itemExpansionKeys, come definito nel servizio GetImplementationSettings.
Parametri:
input (facoltativo) - JSON in formato CCO che include l'ID input per la parte o il documento CAD alla radice della struttura.
configuration (obbligatorio) - JSON con la configurazione.
Restituisce: JSON in formato CCO
MapItemToInputObject
Mappa un elemento di struttura parti o un elemento di struttura documento CAD a un input di parte o documento CAD, che può quindi essere utilizzato dal servizio GetItems.
Parametri:
input (facoltativo) - JSON in formato CCO che include l'ID input per la parte o il documento CAD alla radice della struttura.
item (obbligatorio) - JSON che include la parte o il documento CAD da mappare.
Restituisce: JSON in formato CCO con una singola parte o documento CAD contenente solo l'attributo id.
Definizione di implementazione 
{
"array": [
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"directDefinition": [
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "actionBarConfigurationJSON"
}
]
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.DefinitionGroup"
},
"mandatory": false,
"key": "actionBarConfiguration"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"additionalDefinition": [
{
"directDefinition": [
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "fieldTitleOverride"
}
],
"key": "itemListAttributesDefinition"
},
{
"directDefinition": [],
"key": "implementationAttributesDefinition"
}
],
"updateServiceName": "",
"minimumSelectedAttributes": null,
"supportedTypes": {
"data": [
{
"itemListsData": [
{
"selectionGroupIds": [
"PSI"
],
"objectType": "PTC.ProdMgmt.PartStructureItem"
},
{
"selectionGroupIds": [
"CS"
],
"objectType": "PTC.CADDocumentMgmt.CADStructure"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"allowSubsetForTailoring": false
},
"addServiceName": "",
"maximumSelectedAttributes": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": true,
"key": "attributes"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"options": [
{
"label": "-1",
"key": "-1"
},
{
"label": "1",
"key": "1"
},
{
"label": "2",
"key": "2"
},
{
"label": "3",
"key": "3"
},
{
"label": "4",
"key": "4"
},
{
"label": "5",
"key": "5"
},
{
"label": "6",
"key": "6"
},
{
"label": "7",
"key": "7"
},
{
"label": "8",
"key": "8"
},
{
"label": "9",
"key": "9"
}
],
"updateServiceName": null,
"addServiceName": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Dropdown"
},
"mandatory": false,
"key": "defaultExpansionLevel"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"additionalDefinition": [
{
"directDefinition": [
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"options": [
{
"description": "Sort column in ascending order",
"label": "[[PTC.Nav.ItemList.SortOrder.Asc]]",
"key": "asc"
},
{
"description": "Sort column in descending order",
"label": "[[PTC.Nav.ItemList.SortOrder.Dsc]]",
"key": "dsc"
}
],
"updateServiceName": null,
"addServiceName": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.RadioButton"
},
"mandatory": false,
"key": "defaultSortDirection"
}
],
"key": "itemListDefaultSortFieldDefinition"
}
],
"updateServiceName": "",
"minimumSelectedAttributes": null,
"supportedTypes": {
"data": [
{
"itemListsData": [
{
"selectionGroupIds": [
"PSI"
],
"objectType": "PTC.ProdMgmt.PartStructureItem"
},
{
"selectionGroupIds": [
"CS"
],
"objectType": "PTC.CADDocumentMgmt.CADStructure"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"allowSubsetForTailoring": false
},
"addServiceName": "",
"maximumSelectedAttributes": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": false,
"key": "defaultSortFields"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"default": true,
"true": {
"additionalDefinition": [
{
"directDefinition": [
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "searchHintText"
}
],
"key": "itemListSearchDefinition"
}
],
"label": "[[PTC.Nav.Yes]]"
},
"false": {
"additionalDefinition": [],
"label": "[[PTC.Nav.No]]"
}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Toggle"
},
"mandatory": false,
"key": "enableSearch"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"additionalDefinition": [
{
"directDefinition": [
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"dynamicallySetTypeServiceName": "GetFilterTypeDefinitionForFilterField",
"type": {
"enum": {
"options": [],
"updateServiceName": null,
"dynamicallySetOptionsServiceName": null,
"addServiceName": null,
"multiSelect": null
}
}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.FieldFilter"
},
"mandatory": false,
"key": "defaultSelectedFilterValues"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "filterLabelOverride"
}
],
"key": "itemListFilterFieldDefinition"
}
],
"updateServiceName": "",
"minimumSelectedAttributes": 0,
"supportedTypes": {
"data": [
{
"itemListsData": [
{
"selectionGroupIds": [
"PSI"
],
"objectType": "PTC.ProdMgmt.PartStructureItem"
},
{
"selectionGroupIds": [
"CS"
],
"objectType": "PTC.CADDocumentMgmt.CADStructure"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"allowSubsetForTailoring": false
},
"addServiceName": "",
"maximumSelectedAttributes": 1
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": false,
"key": "filterFields"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.DefinitionGroup"
},
"mandatory": false,
"key": "implementationConfiguration"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "label"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"minValue": 50,
"default": 500,
"maxValue": 10000,
"step": 50
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Number"
},
"mandatory": false,
"key": "maxNumberOfRowsInGrid"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"options": [
{
"description": "Disallow items selection",
"label": "[[PTC.Nav.ItemList.SelectionType.None]]",
"key": "none"
},
{
"description": "Allow single item selection",
"label": "[[PTC.Nav.ItemList.SelectionType.Single]]",
"key": "single"
},
{
"description": "Allow multiple items selection",
"label": "[[PTC.Nav.ItemList.SelectionType.Multiple]]",
"key": "multi"
}
],
"updateServiceName": null,
"addServiceName": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.RadioButton"
},
"mandatory": false,
"key": "selectionType"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"default": true,
"true": {
"additionalDefinition": [
{
"directDefinition": [
{
"property": {
"options": [
[
{
"label": "[[PTC.Nav.ItemList.ExportCSVActionLabel]]",
"key": "exportToCsv"
},
{
"label": "[[PTC.Nav.ItemList.ExportCSVAsExcelActionLabel]]",
"key": "exportToExcel"
}
]
]
},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"default": "",
"overflow": null,
"minimumSelectedItems": null,
"options": [],
"updateServiceName": null,
"addServiceName": null,
"constraints": {}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.CheckboxArray"
},
"mandatory": false,
"key": "exportTypes"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"default": false,
"true": {
"additionalDefinition": [],
"label": null
},
"false": {
"additionalDefinition": [],
"label": null
}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Toggle"
},
"mandatory": false,
"key": "exportUnFilteredData"
}
],
"key": "itemListExportDefinition"
}
],
"label": "[[PTC.Nav.Yes]]"
},
"false": {
"additionalDefinition": [],
"label": "[[PTC.Nav.No]]"
}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Toggle"
},
"mandatory": false,
"key": "showExportAction"
},
{
"property": {},
"value": {
"initializationData": {
"version": "1.0.0",
"constraints": {},
"properties": {
"default": false,
"true": {
"additionalDefinition": [],
"label": "[[PTC.Nav.Yes]]"
},
"false": {
"additionalDefinition": [],
"label": "[[PTC.Nav.No]]"
}
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Toggle"
},
"mandatory": false,
"key": "waitForInput"
}
]
}
È stato utile?