Elemento <instance>
El elemento <instance> es un hijo del elemento <sbom>. El elemento <sbom> puede contener cualquier número de elementos <instance>, o bien puede estar vacío. Un elemento <instance> de LDM de servicio puede hacer referencia a un elemento de origen de la LDM de ingeniería, o puede existir solamente en la LDM de servicio.
Cada nodo del árbol de LDM de servicio tiene un elemento <instance>. Cada elemento <instance> representa una o varias piezas de la LDM de servicio con un estado de servicio concreto. Se pueden anidar de manera jerárquica para crear la estructura del árbol de LDM de servicio.
Los atributos y los hijos de <instance> codifican la información de servicio de las piezas en la LDM de servicio. Por ejemplo, pueden trasladar la siguiente información sobre las piezas en la LDM de servicio:
• Nombres de pieza
• Números de pieza
• Si se hace referencia a las piezas en la LDM de servicio en la LDM de ingeniería
• Si las piezas están enumeradas y son reemplazables
• Si las piezas se envían premontadas o en un kit
Si la información de servicio de las piezas en la LDM de servicio cambia, los elementos <instance> de la LDM de servicio se pueden editar. Por ejemplo, se pueden añadir, quitar (ocultar) o modificar los valores de atributo del elemento <instance> en sí, o bien cambiar los valores de sus elementos hijo.
Sintaxis de <instance>
Atributos de <instance>
type
Especifica el tipo de instancia:
FOLDER
Tipo de instancia por defecto.
REPLACEABLE
La instancia es una pieza válida, utilizable y enumerable.
COLLAPSED
La instancia se combina con su nodo padre. No se puede enumerar.
PREASSEMBLED
La instancia es un conjunto de piezas que se mantienen como una sola unidad. El nodo padre de esta instancia es type="REPLACEABLE". Todos los hijos de esta instancia están type="COLLAPSED" por defecto.
qty
Especifica el número (cantidad) de instancias que se va a crear. El valor por defecto (si se omite) es 1.
Elementos hijo de <instance>
<name>
Nombre opcional del texto de forma libre de esta instancia.
<ebom>
<attribute>
Un elemento <instance> puede contener varios elementos attribute hijo, o bien ninguno. Los valores de los atributos de los elementos attribute reemplazan los valores de todos los nodos de LDM de ingeniería de referencia. También pueden añadir nuevos atributos a la instancia de LDM de servicio.
<instance>
Un elemento <instance> puede contener varios elementos <instance> hijo, o bien ninguno. Por ejemplo, un elemento <instance> de un nodo de conjunto puede contener un elemento <instance> hijo para cada pieza del conjunto.
Ejemplo 1 de <instance>
En este ejemplo, se muestra cómo utilizar los elementos hijo <name> y attribute para asignar un nombre mostrado a una instancia, asignar un nuevo atributo solo de LDM de servicio y ocultar (borrar) un atributo.
Ejemplo 2 de <instance>
En este ejemplo, se muestra cómo definir instancias de manera jerárquica. A continuación, se muestra un ejemplo de una instancia de conjunto. Si la instancia hace referencia a un elemento de LDM de ingeniería que también es un conjunto, todo el contenido del conjunto se comunicará en forma de elementos <instance> hijo.
<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>
Como se ha mostrado anteriormente, un elemento type="PREASSEMBLED" especifica un conjunto que se ha copiado de la LDM de ingeniería con la estructura intacta. Todos sus hijos están marcados como combinados (es decir, type="COLLAPSED"). Cualquier definición hija del fichero XML cambiará la LDM de servicio que se ha creado en la acción padre. En el ejemplo anterior, hemos buscado uno de los elementos por coincidencia de propiedades. Le hemos cambiado el <name> y también el type por REPLACEABLE (es decir, noCOLLAPSED).
Ejemplo 3 de <instance>
En este ejemplo, se muestra la instancia type="FOLDER" por defecto. Se ha creado una instancia de carpeta denominada "bolts". Contiene una instancia hija denominada BOLT que representa 12 pernos (qty="12").