Formato del fichero XML de asignación de versiones basada en lista
El fichero XML que se utiliza para definir un esquema de versiones basado en lista debe ajustarse al formato siguiente:
<?xml version="1.0" encoding="UTF-8"?>
<scheme>
<series name = "myListSeries">
<value>P1</value>
<value>P2</value>
<value>P3</value>
</series>
</scheme>
<scheme>
<series name = "myListSeries">
<value>P1</value>
<value>P2</value>
<value>P3</value>
</series>
</scheme>
 |
Se debe tener lo siguiente:
• Al menos una serie
• Para cada serie, un mínimo de dos elementos value
La semilla no es obligatoria para un esquema basado en lista, pero sí para un esquema basado en estado.
|
El nombre de la serie del fichero XML puede contener cualquier carácter alfanumérico excepto el punto (.) o el símbolo arroba (@). El nombre de la serie especificado en el fichero XML es el mismo que se debe incorporar a wt.series.HarvardSeries para formar el nombre utilizado en el argumento del contenido de la regla de la asignación de versiones. Por ejemplo, si el nombre de serie es "myListSeries", el argumento que se debe incluir es "wt.series.HarvardSeries.myListSeries".
Para obtener más información, consulte la sección objrules/ObjRuleObjectVersioning.html.
Al cargar el fichero XML, el esquema de entrada se valida con el XSD definido. Los valores incluidos en los elementos <value> pueden ser un conjunto de valores exclusivos con las calificaciones siguientes:
• Un valor no puede estar vacío; debe contener al menos un carácter que no sea un espacio en blanco.
• No se puede utilizar un punto (.) en un valor.
• Se eliminan todos los espacios en blanco delante y detrás del valor antes de utilizarlo.
• Los valores especificados para los rótulos de revisión deben ser exclusivos dentro de la serie completa. No está permitido especificar el mismo valor varias veces, pero se pueden usar los valores de una serie en otra.
 |
Se recomienda utilizar un número mínimo de caracteres para el valor de modo que cuando se muestren los identificadores de objeto completos, no sea demasiado detallado.
|
El orden de los valores del fichero determinará el orden en el que se utilizan los valores como designadores de la versión durante la creación de una nueva versión del objeto.
|
|
Si el usuario revisa el método, debe asegurarse de no eliminar ningún valor que ya esté en uso. Igualmente, eliminar un nombre de serie o un valor de una serie después de que ésta se haya utilizado provoca problemas en todos los objetos existentes que utilizan esa serie o su valor. Por ejemplo, no podrán crearse nuevas versiones de esos objetos ni podrá mostrarse el historial de iteraciones del objeto. Para obtener más información acerca de cómo permitir caracteres que ya no se encuentran en un método de asignación de versiones en los rótulos de revisión de objetos existentes, consulte la Adaptación de valores de legados en rótulos de revisión.
|
El fichero XML que se va a cargar solo puede contener un esquema. El esquema puede contener varias series. Si existen varias series en el fichero, cada una de ellas debe ser distinta. Por ejemplo, el siguiente fichero XML tiene definidas dos series:
<?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>
<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>
No existen reglas de inicialización de objetos estándar cargadas que definan la asignación de versiones en asignación de versiones basada en lista tal como se explica en esta sección, ni plantillas estándar del ciclo de vida que utilicen asignación de versiones basada en lista.