Elemento <instance>
L'elemento <instance> è un figlio dell'elemento <sbom>. L'elemento <sbom> può contenere qualsiasi numero di elementi <instance> oppure essere vuoto. Un elemento <instance> della distinta base ricambi può fare riferimento a un elemento di origine nella distinta base di progettazione oppure esistere soltanto nella distinta base ricambi.
Ogni nodo dell'albero della distinta base ricambi contiene un elemento <instance>. Ogni <instance> rappresenta una o più parti nella distinta base ricambi in un determinato stato di manutenzione. Tali parti possono essere annidate gerarchicamente per creare la struttura dell'albero della distinta base ricambi.
Gli attributi e i figli di <instance> codificano le informazioni di manutenzione per le parti nella distinta base ricambi. Possono ad esempio comunicare le seguenti informazioni sulle parti della distinta base ricambi:
Nomi di parte
Numeri di parte
Se le parti della distinta base ricambi sono referenziate nella distinta base di progettazione
Se le parti sono dettagliate e sostituibili
Se le parti vengono fornite preassemblate o in un kit
Quando le informazioni di manutenzione per le parti nella distinta base ricambi vengono modificate, è possibile modificare gli elementi <instance> della distinta base ricambi. Si possono ad esempio aggiungere, rimuovere (nascondere) o modificare i valori degli attributi nell'elemento <instance> oppure modificare i valori dei relativi elementi figlio.
Sintassi di <instance>
<instance type="FOLDER" qty="1">
<name />
<ebom />
<attribute name="" />
<attribute name="" />
...
<attribute name="" />
<instance />
<instance />
...
<instance />
</instance>
Attributi di <instance>
type
Specifica il tipo di istanza.
FOLDER
Tipo di istanza di default.
REPLACEABLE
L'istanza è una parte valida, utilizzabile e dettagliabile.
COLLAPSED
L'istanza è combinata con il relativo nodo padre. Non è dettagliabile.
PREASSEMBLED
L'istanza è un insieme di parti gestite come singola unità. Il nodo padre dell'istanza è type="REPLACEABLE". Tutti i figli dell'istanza sono type="COLLAPSED" per default.
qty
Specifica il numero (quantità) di istanze da creare. Se omesso, il valore di default è 1.
Elementi figlio di <instance>
<name>
Nome facoltativo dell'istanza in formato di testo non strutturato.
<ebom>
<attribute>
Un elemento <instance> può contenere zero o più elementi attribute figlio. I valori degli attributi negli elementi attribute sostituiscono i valori in qualsiasi nodo della distinta base di progettazione referenziato. Possono inoltre aggiungere nuovi attributi all'istanza della distinta base ricambi.
<instance>
Un elemento <instance> può contenere zero o più elementi <instance> figlio. Ad esempio, un elemento <instance> per un nodo di assieme può contenere un elemento <instance> figlio per ogni parte dell'assieme.
Esempio 1 di <instance>
Questo esempio mostra come utilizzare gli elementi figlio attribute e <name> per assegnare un nome visualizzato a un'istanza, assegnare un nuovo attributo esclusivo della distinta base ricambi e nascondere (eliminare) un attributo.
<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"/>
Esempio 2 di <instance>
Questo esempio mostra come definire gerarchicamente le istanze. Di seguito è riportato un esempio di un'istanza di assieme. Se l'istanza fa riferimento a un elemento della distinta base di progettazione che è anch'esso un assieme, l'intero contenuto di tale assieme viene riportato sotto forma di elementi <instance> figlio.
<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>
Come sopra illustrato, un elemento type="PREASSEMBLED" specifica un assieme che viene copiato dalla distinta base di progettazione mantenendo intatta la struttura. Tutti i relativi figli vengono contrassegnati come combinati (ovvero type="COLLAPSED"). Qualsiasi definizione di figlio nel file XML modificherà la distinta base ricambi creata nell'azione padre. Nell'esempio precedente si individua uno degli elementi tramite la corrispondenza di proprietà. Il relativo elemento <name> viene modificato e si modifica inoltre type in REPLACEABLE (ovvero, non COLLAPSED).
Esempio 3 di <instance>
Questo esempio mostra l'istanza di default type="FOLDER". Viene creata un'istanza di cartella denominata "bolts", che contiene un'istanza figlio denominata BOLT che rappresenta 12 bulloni (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>
È stato utile?