Elément <instance>
L'élément <instance> est un enfant de l'élément <sbom>. L'élément <sbom> peut contenir un nombre infini d'éléments <instance>, ou il peut être vide. L'élément <instance> d'une nomenclature de service peut référencer un élément source dans la nomenclature d'étude, ou il peut exister dans la nomenclature de service uniquement.
A chaque noeud de l'arborescence de nomenclature de service correspond un élément <instance>. Chaque élément <instance> représente une ou plusieurs pièces de la nomenclature de service dans un état de service donné. Ils peuvent être imbriqués hiérarchiquement pour créer la structure de l'arborescence de nomenclature de service.
Les attributs et les enfants de l'élément <instance> encodent les informations de service client des pièces dans la nomenclature de service. Ils peuvent par exemple fournir les informations suivantes sur les pièces de la nomenclature de service :
Noms de pièce
Numéros de pièces
Si les pièces de la nomenclature de service sont référencées dans la nomenclature d'étude
Si les pièces sont détaillées et remplaçables
Si les pièces sont préassemblées ou fournies en kit
En cas de modification des informations de service client des pièces dans la nomenclature de service, vous pouvez modifier les éléments <instance> de la nomenclature de service. Par exemple, vous pouvez ajouter, supprimer (masquer) ou modifier les valeurs des attributs de l'élément <instance> lui-même, ou modifier les valeurs de ses éléments enfant.
Syntaxe de l'élément <instance>
<instance type="FOLDER" qty="1">
<name />
<ebom />
<attribute name="" />
<attribute name="" />
...
<attribute name="" />
<instance />
<instance />
...
<instance />
</instance>
Attributs de l'élément <instance>
type
Spécifie le type d'instance :
FOLDER
Type d'instance par défaut.
REPLACEABLE
L'instance est une pièce valide, utilisable, pouvant être détaillée.
COLLAPSED
L'instance est combinée avec son noeud parent. Elle ne peut pas être détaillée.
PREASSEMBLED
L'instance est un ensemble de pièces gérées en tant qu'unité unique. Le noeud parent de cette instance est un élément type="REPLACEABLE". Tous les enfants de cette instance sont des éléments type="COLLAPSED" par défaut.
qty
Spécifie le nombre (quantité) d'instances à créer. La valeur par défaut (en cas d'omission) est 1.
Eléments enfants de l'élément <instance>
<name>
Nom du texte de forme libre facultatif de cette instance.
<ebom>
Consultez la section Elément <ebom>.
<attribute>
Un élément <instance> peut contenir zéro ou plusieurs éléments attribute enfants. Les valeurs des attributs des éléments attribute remplacent les valeurs de tous les noeuds référencés dans la nomenclature d'étude. Ils permettent également d'ajouter de nouveaux attributs à l'instance de nomenclature de service.
<instance>
Un élément <instance> peut contenir zéro ou plusieurs éléments <instance> enfants. Par exemple, l'élément <instance> d'un noeud d'assemblage peut contenir un élément <instance> enfant pour chaque pièce de l'assemblage.
Exemple 1 d'élément <instance>
Cet exemple montre comment utiliser les éléments enfants <name> et attribute pour attribuer un nom affiché à une instance, attribuer un nouvel attribut uniquement réservé à la nomenclature de service et pour masquer (supprimer) un attribut.
<sbom>
<instance>
<!-- assign a display name -->
<name>my sbom instance</name>
<!-- include a new attribute on the sBOM instance -->
<attribute name="PartNo" type="symbol" category=“custom”>123-4567</attribute>
<!-- hide (delete) an attribute from an instance -->
<attribute name="Designer" type="symbol" category="PROE Parameters" hidden="true"/>
Exemple 2 d'élément <instance>
Cet exemple montre comment définir des instances hiérarchiquement. Voici un exemple d'instance d'assemblage. Si l'instance référence un élément de nomenclature d'étude qui est également un assemblage, tous les contenus de cet assemblage sont traités en tant qu'éléments <instance> enfants.
<instance qty="1" type="PREASSEMBLED">
<name>tree </name>
<!-- The copyasm=true flag specifies that the entire ebom instance
and all children should be copied across -->
<ebom copyasm="true">
<refpart name=“CustomId” category=" id-db " type="symbol">321-7654</refpart>
</ebom>
<!-- Any instances declared inside this assembly instance (above)
override the items that were copied over as part of the parent
operation. In this case, this specified reference instance has
been given a specific display name and assigned the
REPLACEABLE type.-->
<instance qty="1" type="REPLACEABLE">
<name>replacable child </name>
<ebom>
<refpart name=“CustomId” category=" id-db " type="symbol">432-8765</refpart>
</ebom>
</instance>
</instance>
Comme indiqué ci-dessus, un élément type="PREASSEMBLED" spécifie un assemblage copié à partir de la nomenclature d'étude qui garde sa structure d'origine. Tous ses enfants sont marqués comme combinés (type="COLLAPSED"). Toute définition d'enfant dans le fichier XML modifie la nomenclature de service créée dans l'action parent. Dans l'exemple ci-dessus, nous recherchons l'un des éléments par correspondance de propriétés. Nous modifions l'élément <name> qui y est associé, et définissons son type sur REPLACEABLE (autrement dit, pas COLLAPSED).
Exemple 3 d'élément <instance>
Cet exemple montre l'instance par défaut type="FOLDER". Une instance de dossier appelée "bolts" est créée. Elle contient une instance enfant nommée BOLT représentant 12 boulons (qty="12").
<instance type=”FOLDER”>
<name>bolts</name>
<instance qty="12" type="REPLACEABLE">
<name>BOLT</name>
<ebom>
<refpart name=“CustomId” category=" id-db " type="string">ab-3344</refpart>
</ebom>
<property name="PartNo" type="symbol" category=“custom”> 789-3344</property>
</instance>
Est-ce que cela a été utile?