Формат XML-файла назначения версий на основе списка
XML-файл, используемый для определения схемы версий на основе списка, должен соответствовать следующему формату:
<?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>
 |
Необходимо иметь следующее:
• По крайней мере одну последовательность.
• Для каждой последовательности не менее двух value элементов.
Первоисточник не требуется для схемы на основе списка, но требуется для схемы на основе состояния.
|
Имя последовательности в XML-файле может содержать любые буквенно-цифровые символы, кроме точки (.) или символа @. Имя последовательности, указанное в XML-файле, надо добавить в wt.series.HarvardSeries, чтобы сформировать имя, используемое в аргументе содержимого правила управления версиями. Например, если имя последовательности myListSeries, следует включить аргумент wt.series.HarvardSeries.myListSeries.
При загрузке XML-файла схема входных данных проверяется на соответствие определенному XSD-файлу. Значения, содержащиеся в элементах <value>, могут представлять собой любой набор уникальных значений со следующими характеристиками:
• Значение не может быть пустым; оно должно содержать по крайней мере один символ, не являющийся пробелом.
• Точка (.) не может использоваться в значении.
• Любой пробел до или после значения удаляется перед использованием значения.
• Значения, указанные для меток ревизии, должны быть уникальными в пределах всей последовательности; запрещается указывать одинаковые значения несколько раз. Однако можно использовать значения из одной последовательности в другой.
 |
Рекомендуется использовать минимальное число символов для значения, чтобы при отображении полных идентификаторов объектов оно не было слишком подробным.
|
Порядок значений в файле определяет порядок использования значений в качестве обозначений версий при создании новых версий объекта.
|
|
При создании новой версии схемы убедитесь, что используемые значения не удалены. Удаление имени последовательности или значений из нее после ее использования может привести к проблемам, если последовательность или ее значение используется существующим объектом. Например, эти объекты могут не поддаваться исправлению и просмотр истории итерации объекта может стать невозможным. Информацию о том, как разрешить символы, которые больше не присутствуют в схеме назначения версий и в метках версии существующих объектов, см. в разделе Использование унаследованных значений в метках ревизий.
|
Загружаемый XML-файл может содержать только одну схему. Схема может содержать несколько последовательностей. Если в одном файле содержится несколько последовательностей, имя каждой последовательности должно быть уникальным. Например, следующий файл XML имеет две определенные последовательности:
<?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>
В этом разделе не описаны стандартные загружаемые правила инициализации объектов, которые устанавливают схему назначения версий на основе списка и стандартные шаблоны жизненного цикла, использующие назначение версий на основе списка.