Teilestruktur
Die Teilestruktur ist eine vordefinierte Konfiguration der Komponente "Elementliste". Die Teilestruktur enthält einen Strukturbaum, der die hierarchische Beziehung zwischen einem Teil oder CAD-Dokument und dessen untergeordneten Elementen anzeigt. Für jedes Element im Baum zeigt die Teilestruktur Attribute an, die Sie über die Konfiguration auswählen können. Die Standardattribute sind Nummer, Name und Lebenszyklusstatus.
Sie können die Teilestruktur konfigurieren, um die anfängliche Erweiterungsebene der Baumstruktur festzulegen. Standardmäßig ist die anfängliche Erweiterungsebene auf 3 festgelegt. Benutzer können Elemente im Baum erweitern und verkleinern.
Der Teilestrukturbaum enthält einen Einzug, um die Strukturebene optisch zu verdeutlichen. Sie können über die Konfiguration festlegen, welche Spalte zuerst in der Tabelle angezeigt wird. Standardmäßig ist die erste Spalte "Nummer".
Die Teilestruktur verfügt über dieselben Exportfunktionen wie die Elementliste. Die exportierte Datei enthält eine Spalte, welche die numerische Ebene für jedes Element in der Struktur anzeigt. Außerdem enthält sie einen Einzug zur Verdeutlichung der Strukturebene.
Die folgende Beispielabbildung zeigt die vordefinierte Konfiguration "Teilestruktur":
* 
Wenn ein Benutzer, der einen Strukturbaum anzeigt, keine Zugriffsrechte für ein Element in der Struktur besitzt, so wird dieses Element nicht angezeigt. Es wird die folgende Meldung angezeigt: "Einige Elemente sind ausgeblendet, da Sie nicht über die entsprechenden Zugriffsrechte verfügen."
Bindende Eigenschaften 
Informationen zum Binden der "Teilestruktur" finden Sie in der Komponente Elementliste.
* 
Für Teilestruktur unterstützt die Eingabe-Bindungseigenschaft die Objekttypen PTC.ProdMgmt.Part und PTC.CADDocumentMgmt.CADDocument.
Die Ausgabe für die Bindungseigenschaft selectedItems enthält Elemente mit den Objekttypen PTC.ProdMgmt.PartStructureItem und PTC.CADDocumentMgmt.CADStructure.
Konfigurationseigenschaften 
Eine Liste aller verfügbaren Konfigurationseigenschaften für "Teilestruktur" finden Sie in der Tabelle "Konfigurationseigenschaften" für die Komponente Elementliste. Die folgende Tabelle enthält zusätzliche Informationen, die für "Teilestruktur" in Bezug auf die Konfigurationseigenschaften spezifisch sind.
Weitere Informationen zur Struktur der Konfiguration finden Sie unter Konfigurationsstruktur von Komponenten.
Weitere Informationen zu Untereigenschaften finden Sie unter Untereigenschaften und Container-Schlüssel.
Eigenschaftsname
Beschreibung
Eigenschaftstyp
Standardwert
Erforderlich oder optional
attributes
Weitere Informationen finden Sie unter Elementliste.
Akzeptiert Attribute der Objekttypen PTC.ProdMgmt.PartStructureItem und PTC.CADDocumentMgmt.CADStructure.
Standardmäßig wird der Teilestrukturbaum nach dem ersten Attribut sortiert, d.h. dem Attribut mit dem niedrigsten nicht negativen Ordinalwert.
-/-
Erforderlich
Beispielkonfiguration 
{
"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"
}
}
Anpassungsdienste 
Zusätzlich zur Konfiguration unterstützt jede Komponente das Anpassen durch Erweitern ihrer Geschäftslogik. Die Geschäftslogik jeder Komponente umfasst überschreibbare Dienste in einer Dingvorlage, die Sie erweitern und überschreiben können. Die überschreibbaren Dienste für diese Komponente sind in der nachfolgenden Tabelle aufgeführt.
Beispiele für Rückgaben und Parameter für jeden Dienst finden Sie unter Beispiele für Eingaben/Ausgaben für Anpassungsdienste.
Name
Beschreibung
ComputeMessages
Berechnet die gewünschten Meldungen, die in "Teilestruktur" angezeigt werden sollen. Empfängt die JSON mit aktuellen Meldungen und die JSON mit vorgeschlagenen Meldungen, und gibt eine Benachrichtigungsmeldungen-JSON zurück, die die in der Elementliste anzuzeigenden Meldungen enthält.
Parameter:
getItemsResponse (Erforderlich) – JSON-Objekt im CCO-Format, das die vom Dienst getItems zurückgegebenen Elemente enthält
currentMessages (Erforderlich) – JSON-Objekt, das aktuelle Benachrichtigungen, die in der Benutzeroberfläche angezeigt werden, enthält
suggestedMessages (Erforderlich) – JSON-Objekt, das einen Satz vorgeschlagener Meldungen enthält. Es wird empfohlen, die vorgeschlagenen Meldungen zu verwenden.
input (Optional) – JSON im CCO-Format, die die Eingabe-ID für das Element im Strukturstamm enthält
configuration (Optional) – JSON mit der Konfiguration
scope (Optional) – JSON, die den Geltungsbereich der Daten in getItemsResponse angibt. Das JSON-Objekt enthält einen scope-Schlüssel, der die Werte root und child akzeptiert. Relevant für hierarchische Daten. Beispiel:
{
"scope": "root"
}
Gibt zurück: JSON-Objekt mit den im Elementlistenraster anzuzeigenden Meldungen. Beispiel:
"INFO":{
{
"messages":[
"[[PTC.Nav.ItemList.HiddenItemsBecauseAccessRightMessage]]"
]
}
}
DefHookAttributesTypesInfo
Gibt ein JSON-Array mit Adapterinformationen und den von "Teilestruktur" unterstützten Objekttypen der Attribute zurück.
Parameter: Keine
Gibt zurück: JSON-Array
GetChildren
Empfängt ein Teil oder CAD-Dokument, und gibt eine JSON im CCO-Format zurück, die die Kinder dieses Elements enthält, d.h. alle Elemente, die sich in der hierarchischen Datenstruktur eine Ebene unterhalb dieses Teils oder CAD-Dokuments befinden. Die zurückgegebene JSON enthält die Kinder als flache Liste, nicht als hierarchische Daten.
Parameter:
input (Optional) – JSON im CCO-Format, die die Eingabe-ID für das Teil oder CAD-Dokument im Strukturstamm enthält
configuration (Erforderlich) – JSON mit der Konfiguration
item (Erforderlich) – JSON, die das Elternelement enthält, dessen Kinder zurückgegeben werden sollen
Gibt zurück: JSON im CCO-Format
GetConfigurations
Gibt die verfügbaren Konfigurationen für die Teilestruktur zurück.
Parameter: Keine
Gibt zurück: JSON
GetImplementationSettings
Gibt die Einstellungsdaten der Teilestruktur-Implementierung zurück. Implementierungen können diesen Dienst überschreiben, um ihre eigenen Einstellungen festzulegen. Weitere Informationen finden Sie im Thema Zusätzliche Informationen zum Dienst "GetImplementationSettings" für die Elementliste.
Parameter: Keine
Gibt zurück: JSON-Objekt
GetItems
Gibt die Struktur für das Teil oder CAD-Dokument zurück, das in der Eingabe angegeben wurde.
Parameter:
input (Erforderlich) – JSON im CCO-Format, das die Eingabe-ID für die aus dem Backend-System abzurufenden Daten sowie die Adapterinformationen für das Backend-System enthält
configuration (Erforderlich) – JSON mit der endgültigen zusammengeführten Konfiguration, die aus der Anpassungsmanager-Ressource abgerufen wurde
Gibt zurück: JSON im CCO-Format
GetItemsByExpansionPath
Gibt eine hierarchische CCO-Struktur zurück, die alle Elemente im Pfad vom Stamm bis zum angeforderten Element enthält, einschließlich aller angeforderten Attribute, itemIdentifierKeys und itemExpansionKeys. Die hierarchische CCO-Struktur schließt alle gleichgeordneten Elemente im Pfad ein.
Der Dienst wird aufgerufen, wenn die Bindungseigenschaft selectedItems eine Eingabe erhält, die ein nicht geladenes Element angibt.
Parameter:
input (Optional) – JSON im CCO-Format, die die Eingabe-ID für das Teil oder CAD-Dokument im Strukturstamm enthält
configuration (Erforderlich) – JSON mit der Konfiguration
itemExpansionValues (Erforderlich) – Ein JSON-Array, das die itemExpansionKeys des Teils oder CAD-Dokuments enthält, für das die Erweiterung angefordert wird. Die Array-Werte werden entsprechend dem Pfad im Baum sortiert, beginnend beim Stammteil bzw. CAD-Dokument.
Gibt zurück: JSON im CCO-Format
GetStructureSkeleton
Gibt alle Ebenen einer hierarchischen Struktur im CCO-Format zurück, wobei jedes Teil oder CAD-Dokument in der Struktur sowohl itemIdentifierKeys als auch itemExpansionKeys enthält, wie im Dienst GetImplementationSettings definiert.
Parameter:
input (Optional) – JSON im CCO-Format, die die Eingabe-ID für das Teil oder CAD-Dokument im Strukturstamm enthält
configuration (Erforderlich) – JSON mit der Konfiguration
Gibt zurück: JSON im CCO-Format
MapItemToInputObject
Ordnet ein Teilestrukturelement oder ein CAD-Dokumentstrukturelement einem Teil oder einer CAD-Dokumenteingabe zu, die dann vom Dienst GetItems verwendet werden kann.
Parameter:
input (Optional) – JSON im CCO-Format, die die Eingabe-ID für das Teil oder CAD-Dokument im Strukturstamm enthält
item (Erforderlich) – JSON, die das zuzuordnende Teil oder CAD-Dokument enthält
Gibt zurück: JSON im CCO-Format mit einem einzelnen Teil oder CAD-Dokument, das nur das Attribut id enthält
Implementierungsdefinition 
{
"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"
}
]
}
War dies hilfreich?