Формат назначения версий на основе XML-файла
XML-файл, загружаемый для использования при назначении версий на основе файла, должен иметь следующий формат:
<?xml version="1.0" encoding="UTF-8"?>
<scheme>
<series name = "name1">
<value>P1</value>
<value>P2</value>
<value>P3</value>
</series>
</scheme>
|
|
Необходимо иметь минимум два элемента value в XML-файле.
|
Имя последовательности в XML-файле может содержать любые буквенно-цифровые символы, кроме точки (.) или символа @. Имя последовательности, определенное в XML-файле, надо добавить в wt.series.HarvardSeries, чтобы сформировать имя, используемое в аргументе содержимого правила управления версиями. Например, если имя последовательности - "name1", следует включить аргумент "wt.series.HarvardSeries.name1". Дополнительные сведения см. в разделе
Назначение версий объектов.
Значения, содержащиеся в элементах <value>, могут представлять собой любой набор уникальных значений со следующими характеристиками:
• Для количества символов, определенных в каждом значении, не существует верхнего предела; однако если использовать длинные значения, полное имя объекта может содержать количество символов, превышающее длину поля интерфейса пользователя, в котором оно показано.
• Значение не может быть пустым; оно должно содержать по крайней мере один символ, не являющийся пробелом.
• Значение не может содержать разделитель последовательности, заданный в свойстве wt.properties wt.series.HarvardSeries.delimiter. Разделителем последовательности по умолчанию является точка (.).
• Любой пробел до или после значения удаляется перед использованием значения.
• Значения, определенные для меток ревизии, должны быть уникальными в пределах всей последовательности, запрещается определять одинаковые значения много раз; однако можно использовать значения из одной последовательности в другой последовательности.
Порядок значений в файле определяет порядок использования значений в качестве обозначений версий при создании новых версий объекта.
|
|
При создании новой версии схемы убедитесь, что используемые значения не удалены. Удаление имени последовательности или значений из нее после ее использования может привести к проблемам, если последовательность или ее значение используется существующим объектом. Например, эти объекты могут не поддаваться исправлению и просмотр истории итерации объекта может стать невозможным. Информацию о том, как разрешить символы, которые больше не присутствуют в схеме назначения версий и в метках версии существующих объектов, см. в разделе Использование унаследованных значений в метках ревизий. |
Можно загрузить только один 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>
В этом разделе не описаны стандартные загружаемые правила инициализации объектов, которые устанавливают схему назначения версий на основе файла и стандартные шаблоны жизненного цикла, использующие назначение версий на основе файла.
