Structure d'article
Structure d'article est une configuration prédéfinie du composant Liste des éléments. La structure d'article contient une structure arborescente qui affiche la relation hiérarchique entre un article ou un document CAO et ses descendants. Pour chaque élément de l'arborescence, la structure d'article affiche les attributs que vous pouvez choisir via la configuration. Les attributs par défaut sont Numéro, Nom et Etat.
Vous pouvez configurer la structure d'article pour définir le niveau de développement initial de l'arborescence. Par défaut, le niveau de développement initial est défini sur 3. Les utilisateurs peuvent développer et réduire les éléments de l'arborescence.
L'arborescence de la structure d'article inclut l'indentation pour afficher visuellement le niveau de la structure. Vous pouvez définir la première colonne qui s'affiche dans le tableau via la configuration. Par défaut, la première colonne est Numéro.
Structure d'article présente les mêmes fonctionnalités d'exportation que Liste d'éléments. Le fichier exporté inclut une colonne indiquant le niveau numérique de chaque élément de la structure et inclut l'indentation pour indiquer le niveau de la structure.
La capture d'écran suivante vous donne un aperçu de la configuration prédéfinie Structure d'article :
* 
Si l'utilisateur visualisant la structure arborescente ne dispose pas des droits d'accès à un élément de la structure, cet élément n'est pas visible et le message suivant s'affiche : "Certains éléments sont masqués car vous ne disposez pas des droits suffisants pour les afficher."
Propriétés de liaison 
Pour plus d'informations sur la liaison d'une structure d'article, consultez la rubrique sur le composant Liste des éléments.
* 
Pour Structure d'article, la propriété de liaison d'entrée prend en charge les types d'objet PTC.ProdMgmt.Part et PTC.CADDocumentMgmt.CADDocument.
La sortie de la propriété de liaison selectedItems contient des éléments avec les types d'objet PTC.ProdMgmt.PartStructureItem et PTC.CADDocumentMgmt.CADStructure.
Propriétés de configuration 
Pour obtenir la liste de toutes les propriétés de configuration disponibles pour la Structure d'article, consultez le tableau Propriétés de configuration du composant Liste des éléments. Le tableau suivant fournit des informations supplémentaires spécifiques à la Structure d'article concernant les propriétés de configuration.
Pour plus d'informations sur la structure de la configuration, consultez la rubrique Structure de configuration du composant.
Pour plus d'informations sur les sous-propriétés, consultez la rubrique Sous-propriétés et clés de conteneur.
Nom de propriété
Description
Type de propriété
Valeur par défaut
Obligatoire ou facultatif ?
attributes
Pour plus d'informations, consultez la rubrique Liste des éléments.
Accepte les attributs des types d'objet PTC.ProdMgmt.PartStructureItemet PTC.CADDocumentMgmt.CADStructure.
Par défaut, l'arborescence de la structure d'article est triée selon le premier attribut, c'est-à-dire selon l'attribut présentant la valeur ordinale non négative la plus basse.
N/A
Obligatoire
Exemple de configuration 
{
"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"
}
}
Services de personnalisation 
En plus de la configuration, chaque composant prend en charge l'extension de sa logique métier afin de le personnaliser. La logique métier de chaque composant inclut des services substituables dans un modèle d'objet que vous pouvez étendre et remplacer. Les services substituables pour ce composant sont détaillés dans le tableau suivant.
Vous trouverez des exemples de renvois et de paramètres pour chaque service à la rubrique Exemples d'entrée/sortie pour les services de personnalisation.
Nom
Description
ComputeMessages
Calcule les messages à afficher dans la structure d'article. Il reçoit le JSON des messages actuels et le JSON des messages suggérés, et renvoie du JSON de messages de notification contenant les messages à afficher dans la Liste des éléments.
Paramètres :
getItemsResponse (obligatoire) : objet JSON au format CCO contenant les éléments renvoyés par le service getItems.
currentMessages (obligatoire) : objet JSON contenant les messages de notification actuels affichés dans l'interface utilisateur.
suggestedMessages (obligatoire) : objet JSON contenant un ensemble de messages suggérés. Il est recommandé d'utiliser les messages suggérés.
input (facultatif) : JSON au format CCO qui inclut l'ID d'entrée de l'élément à la racine de la structure.
configuration (facultatif) : JSON contenant la configuration.
scope (facultatif) : JSON qui indique l'étendue des données dans getItemsResponse. L'objet JSON contient une clé scope qui accepte les valeurs root et child. Pertinent pour les données hiérarchiques. Exemple :
{
"scope": "root"
}
Renvois : un objet JSON contenant des messages à afficher dans la grille Liste des éléments. Exemple :
"INFO":{
{
"messages":[
"[[PTC.Nav.ItemList.HiddenItemsBecauseAccessRightMessage]]"
]
}
}
DefHookAttributesTypesInfo
Renvoie un tableau JSON contenant les informations sur l'adaptateur et les types d'objet des attributs pris en charge par la structure d'article.
Paramètres : aucun
Renvois : tableau JSON
GetChildren
Reçoit un article ou un document CAO et renvoie du JSON au format CCO contenant les enfants de cet élément, c'est-à-dire tous les éléments qui se trouvent un niveau en dessous de cet article ou document CAO dans la structure de données hiérarchique. Le JSON renvoyé contient les enfants sous la forme d'une liste plate et non de données hiérarchiques.
Paramètres :
input (facultatif) : JSON au format CCO qui inclut l'ID d'entrée pour l'article ou le document CAO à la racine de la structure.
configuration (obligatoire) : JSON contenant la configuration.
item (obligatoire) : JSON qui contient l'élément parent dont les enfants doivent être renvoyés.
Renvois : JSON au format CCO
GetConfigurations
Renvoie les configurations disponibles pour la structure d'article.
Paramètres : aucun
Renvois : JSON
GetImplementationSettings
Renvoie les données des paramètres d'implémentation de la structure d'article. Les implémentations peuvent remplacer ce service afin de fournir leurs propres paramètres. Pour plus d'informations, consultez la rubrique Informations supplémentaires sur le service GetImplementationSettings pour la liste des éléments.
Paramètres : aucun
Renvois : objet JSON
GetItems
Renvoie la structure de l'article ou du document CAO spécifié dans l'entrée.
Paramètres :
input (obligatoire) : JSON au format CCO qui comprend l'ID d'entrée pour les données à récupérer du système principal et les informations d'adaptateur pour le système principal.
configuration (obligatoire) : JSON avec la configuration fusionnée finale obtenue à partir de la ressource de gestionnaire de personnalisations.
Renvois : JSON au format CCO
GetItemsByExpansionPath
Renvoie un CCO de structure hiérarchique qui contient tous les éléments sur le chemin de la racine à l'élément demandé, y compris tous les attributs demandés, itemIdentifierKeys et itemExpansionKeys. Le CCO de structure hiérarchique inclut tous les frères sur le chemin.
Le service est appelé lorsque la propriété de liaison selectedItems reçoit une entrée spécifiant un élément qui n'est pas chargé.
Paramètres :
input (facultatif) : JSON au format CCO qui inclut l'ID d'entrée pour l'article ou le document CAO à la racine de la structure.
configuration (obligatoire) : JSON contenant la configuration.
itemExpansionValues (obligatoire) : tableau JSON contenant itemExpansionKeys de l'article ou du document CAO pour lequel le développement est demandé. Les valeurs du tableau sont classées en fonction du chemin dans l'arborescence, en commençant par l'article ou le document CAO racine.
Renvois : JSON au format CCO
GetStructureSkeleton
Renvoie tous les niveaux d'une structure hiérarchique au format CCO, où chaque article ou document CAO de la structure inclut à la fois itemIdentifierKeys et itemExpansionKeys, comme défini dans le service GetImplementationSettings.
Paramètres :
input (facultatif) : JSON au format CCO qui inclut l'ID d'entrée pour l'article ou le document CAO à la racine de la structure.
configuration (obligatoire) : JSON contenant la configuration.
Renvois : JSON au format CCO
MapItemToInputObject
Mappe un élément de structure d'article ou un élément de structure de document CAO à une entrée d'article ou de document CAO, qui peut ensuite être utilisé par le service GetItems.
Paramètres :
input (facultatif) : JSON au format CCO qui inclut l'ID d'entrée pour l'article ou le document CAO à la racine de la structure.
item (obligatoire) : JSON qui inclut l'article ou le document CAO à mapper.
Renvois : JSON au format CCO avec un article ou un document CAO unique contenant uniquement l'attribut id.
Définition de l'implémentation 
{
"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"
}
]
}
Est-ce que cela a été utile ?