Format du fichier XML de création de versions à partir d'une liste
Le fichier XML utilisé pour définir un schéma de version basé sur une liste doit respecter le format suivant :
<?xml version="1.0" encoding="UTF-8"?>
<scheme>
<series name = "myListSeries">
<value>P1</value>
<value>P2</value>
<value>P3</value>
</series>
</scheme>
|
Vous devez disposer des éléments suivants :
• Au moins une série
• Pour chaque série, au moins deux éléments value
L'objet initial n'est pas obligatoire pour un schéma basé sur une liste, mais l'est pour un schéma basé sur un état.
|
Dans le fichier XML, le nom de la série peut contenir n'importe quel caractère alphanumérique, sauf le point (.) et le symbole arobase (@). Le nom de série que vous indiquez dans le fichier XML est identique à celui que vous devez ajouter à la fin de l'argument wt.series.HarvardSeries afin de former le nom utilisé dans l'argument pour le contenu de la règle de création de versions. Par exemple, si le nom de la série est "myListSeries", l'argument à inclure est "wt.series.HarvardSeries.myListSeries".
Pour plus d'informations, consultez la section
objrules/ObjRuleObjectVersioning.html.
Lors du chargement du fichier XML, le schéma d'entrée est validé par rapport au XSD défini. Les valeurs contenues dans les éléments <value> peuvent être n'importe quel ensemble de valeurs uniques avec les qualifications suivantes :
• Une valeur ne peut pas être vide ; elle doit contenir au moins un caractère qui ne soit pas un espace.
• Il est impossible d'utiliser un point (.) dans une valeur.
• Tout espace vide avant ou après la valeur est supprimé avant son utilisation.
• Les valeurs que vous indiquez pour les libellés de révision doivent être uniques au sein de la série complète et l'indication de la même valeur plusieurs fois n'est pas autorisée ; en revanche, vous pouvez utiliser les valeurs d'une série dans une autre.
|
Il est recommandé d'utiliser un nombre minimal de caractères pour la valeur afin que les identificateurs d'objet complets ne soient pas excessivement longs lors de leur affichage.
|
L'ordre des valeurs dans le fichier détermine l'ordre dans lequel les valeurs sont attribuées aux indicateurs de version, lors du changement de version de l'objet.
|
Si vous modifiez le schéma, assurez-vous que vous ne supprimez aucune valeur déjà utilisée. Par ailleurs, la suppression d'un nom ou d'une valeur d'une série après l'utilisation de cette dernière cause des problèmes pour les objets existants qui utilisent la série ou la valeur de la série. Par exemple, ces objets ne pourraient pas être révisés et l'historique des itérations de l'objet ne pourrait pas être affiché. Pour plus d'informations sur la procédure permettant d'autoriser des caractères qui ne figurent plus dans un schéma de version dans les libellés de changement de version d'objets existants, reportez-vous au manuel anglais Windchill Business Administrator's Guide (Guide de l'administrateur Windchill).
|
Le fichier XML à charger ne peut contenir qu'un seul schéma. Le schéma peut contenir plusieurs séries. Lorsque le fichier comporte plusieurs séries, chaque nom de série doit être unique. Dans le fichier XML suivant, deux séries sont définies :
<?xml version="1.0" encoding="UTF-8"?>
<scheme>
<series name="name1">
<value>P1</value>
<value>P2</value>
<value>P3</value>
</series>
<series name="name2">
<value>A_1</value>
<value>A_3</value>
<value>A_5</value>
<value>A_7</value>
</series>
</scheme>
Par défaut, aucune règle d'initialisation de l'objet ne permet de créer des versions à partir d'une liste comme décrit dans cette section et aucun modèle de cycle de vie n'utilise la création de version à partir d'une liste.