Updating sBOM Files
This chapter describes the elements involved when updating a structure XML file. Export the structure update files from Creo Illustrate, then use these files (current sBOM and updated eBOM) to help create a single structure update file to import back into Creo Illustrate.
See “Importing and Updating sBOM XML Files” in the
Creo Illustrate Help Center for details about the export and import procedures.
Update structure XML file
The update requires these elements
<update>
(Required) contains one only and only one <sbom> tag
<sbom>
(Required) Defines the start, under this tag will appear <delete> and or <replace> tags.)
<delete>
(Optional) Contains a list of <oldsbom> tags, each tag defines an sBOM instance that the user wants to delete.
<replace>
(Optional) Contains a list of <pair> tags, each pair defines a part replacement (like the input for > in Creo Illustrate).
<delete> Section
Contains a list of <oldsbom> tags, each tag defines an sBOM instance that the user wants to delete.
<oldsbom>—Holds an sbomidpath attribute which defines the idpath to the sBOM instance.
Example of <delete> Section:
<delete>
<oldsbom sbomidpath="/0/0"/>
<oldsbom sbomidpath="/9/2/10"/>
<oldsbom sbomidpath="/3/0/0"/>
</delete>
<replace> Section
Contains a list of <pair> tags, each <pair> defines a part replacement.
Each <pair> includes exactly one <oldsbom> tag followed by exactly one <newebom> tag.
<oldsbom>
Contains an sbomidpath attribute that defines the idpath to the sBOM instance to replace its eBOM part.
Example:
<oldsbom sbomidpath="/3/0/10"/>
<newebom>
Includes a pvcidpath parameter that defines the idpath to the new eBOM part to attach to the sBOM instance defined in <oldsbom> tag. The data of <newebom> is either empty (in which case, the name of the eBOM instance is used), or has a new name to apply to the sBOM instance after the replacement.
Examples
<newebom pvcidpath=":0/75"/>
<newebom pvcidpath=":0/43">NewName for the part</newebom>
<newebom pvcidpath=":3/@@PV-AUTO-ID@@000/@@PV-AUTO-ID@@002"/>
<newebom pvcidpath=":3/@@PV-AUTO-ID@@000/@@PV-AUTO-ID@@002">
NewName for the part</newebom>
Example of <replace>
<replace>
<pair>
<oldsbom sbomidpath="/0/1"/>
<newebom pvcidpath=":0/43">NewName for the part</newebom>
</pair>
<pair>
<oldsbom sbomidpath="/3/0/5"/>
<newebom pvcidpath=":0/75"/>
</pair>
<pair>
<oldsbom sbomidpath="/3/0/3"/>
<newebom pvcidpath=":3/@@PV-AUTO-ID@@000/@@PV-AUTO-ID@@002">
NewName for the part</newebom>
</pair>
</replace>