.bom

.bom addcategory "catégorie"
.bom setcolumn "categorie" "section" "colonne" [...]
.bom data catégorie" "section" "colonne=valeur" [...]
La commande .bom ajoute des données à la nomenclature (BOM) d'une génération. Elle permet d'ajouter des catégories, des sections, et des données.
Catégories
Une catégorie est un en-tête figurant dans le fichier BOM. Utilisez l'option addcategory pour les indiquer.
.bom addcategory "catégorie"
Sections
Une section définit les colonnes de données au sein d'une même catégorie. Utilisez l'option setcolumn pour indiquer les sections et les colonnes dans les sections. Les noms de sections ne sont pas inclus. L'ensemble des en-têtes de colonne de la section figure au début de la section. Vous pouvez imbriquer les sections en utilisant l'option -p et en identifiant la section parente.

Les sections et les colonnes doivent être définies avant que les options données ne tentent d'y ajouter des données.

.bom setcolumn "catégorie" "section" "columnheader" [...]
.bom setcolumn "catégorie" "section" -p parentsection"columnheader" [...]
Données
Les données renseignent les colonnes définies dans une section. La section et les colonnes doivent déjà être définies à l'aide de setcolumn.
.bom data catégorie" "section" "colonne=valeur" [...]

L'exemple suivant présente l'ordre dans lequel les catégories, les sections et les colonnes, ainsi que les données, doivent être indiquées.


.bom addcategory "Vaisseaux spatiaux"
.bom setcolumn "Vaisseaux spatiaux" "Section1" "ShipName" "WarpSpeed" "Tonnage"
.bom setcolumn "Vaisseaux spatiaux" "Subsection1" -p "Section1" "ShippingDate" "ShippingManifest"
.bom data "Vaisseaux spatiaux" "Section1" "ShipName=SpaceShipOne" "WarpSpeed=9" "Tonnage=10000"
.bom data "Vaisseaux spatiaux" "Subsection1" "ShippingDate=123" "ShippingManifest=456"
.bom data "Vaisseaux spatiaux" "Section1" "ShipName=Freighter" "WarpSpeed=6" "Tonnage=20000" 

Cet exemple apparaît comme suit dans le BOM :

Nom vaisseau      Vitesse de distorsion   Tonnage
VaisseauSpatial1      9        10000
                                   DateExpédition       Manifeste d'expédition
                                       123                  456
Cargo         6        20000
Comme avec les autres commandes point, vous pouvez utiliser des variables d'environnement dans cette commande. Une commande telle que
.bom data "Spaceships" "${SECTION}" "ShipName=${NAME}" "WarpSpeed=${SPEED}" "Tonnage=${TONNAGE}"

insère dans le fichier BOM les données chargées dans les variables d'environnement par des commandes antérieures.

Vous pouvez créer tout nombre de colonnes, mais le système n'écrit pas de ligne dans le fichier BOM tant que la dernière colonne n'est pas renseignée.

Si vous omettez une colonne d'une ligne de données, le système utilise la valeur de la ligne précédente, comme l'indique l'exemple suivant.
.bom addcategory "Vaisseaux spatiaux"
.bom setcolumn "Vaisseaux spatiaux" "Section1" "ShipName" "WarpSpeed" "Tonnage"
.bom data "Vaisseaux spatiaux" "Section1" "ShipName=SpaceShipTwo" "WarpSpeed=3" "Tonnage=30000"
.bom data "Spaceships" "Section1" "ShipName=Tanker" "Tonnage=50000"

Cela a pour résultat une répétition de la valeur WarpSpeed de SpaceShipOne :
Nom vaisseau      Vitesse de distorsion   Tonnage
SpaceShipTwo      3        30000
Tanker            3        50000

Commentaires en retour