Файл списка объектов
Описан XML-файл списка объектов для сравнения конфигураций и работы с хранилищем конфигурации BAS, его элементы, атрибуты и примеры использования.. Общее описание. Элемент <Objects>. Элемент <Configuration>. Элемент <Object>. Примеры
Общее описание
Этот файл используется для определения списка объектов, применяемых при операциях сравнения конфигураций или работы с хранилищем конфигурации.
Файл списка объектов является XML-файлом со следующей структурой:
<Objects…>
<Configuration…/>
<Object…>
<Subsystem…/>
</Object>
</Objects>
Пространство имён: http://bas-soft.eu/8.3/config/objects.
Элемент <Objects>
Корневой элемент файла. Этот элемент может содержать не более одного элемента <Configuration> и один или несколько элементов <Object>.
Элемент может содержать следующие атрибуты:
version обязательный
Версия списка файлов.
Тип: String/Строка.
Поддерживается только версия 1.0. Для любой другой версии будет сформирована ошибка Версия файла списка объектов x.x не поддерживается данной версией платформы.
Элемент <Configuration>
Описывает корневой объект конфигурации. Элемент может отсутствовать или быть указан только один раз.
Элемент может содержать следующие атрибуты:
includeChildObjects обязательный
Использовать в операции, для которой применяется файл, подчинённые объекты корневого элемента конфигурации на полную глубину.
Тип: Boolean/Булево.
Элемент <Object>
Описывает один объект конфигурации, возможно вместе с подчинёнными объектами, который участвует в операции. Элемент может отсутствовать или может быть указано несколько элементов. Элементу может подчиняться не более одного элемента <Subsystem>.
Элемент может содержать следующие атрибуты:
fullName
Полное имя объекта в первой конфигурации.
Используется как для настройки сравнения конфигураций, так и для работы с хранилищем конфигурации. При настройке сравнения конфигураций следует указать один из атрибутов: fullName или fullNameInSecondConfiguration. При работе с хранилищем конфигурации атрибут является обязательным.
Тип: String/Строка.
fullNameInSecondConfiguration
Полное имя объекта во второй конфигурации.
Используется только для настройки сравнения конфигураций. При настройке сравнения конфигураций следует указать один из атрибутов: fullName или fullNameInSecondConfiguration.
Тип: String/Строка.
includeChildObjects обязательный
Использовать в операции, для которой применяется файл, подчинённые объекты на полную глубину для объекта конфигурации, указанного в атрибуте fullName.
Для подсистемы подчинёнными являются подчинённые подсистемы, а не объекты, входящие в подсистему. Чтобы включить объекты, входящие в состав подсистемы, следует воспользоваться вложенным тегом <Subsystem>.
Тип: Boolean/Булево.
Элемент <Subsystem>
Определяет необходимость включения в операцию объектов, входящих в состав подсистемы, выбранной родительским элементом <Object>. Этот элемент применяется только для элементов <Object>, которые описывают объект подсистемы. Элемент может отсутствовать или быть указан только один раз.
Элемент может содержать следующие атрибуты:
includeObjectsFromSubordinateSubsystems обязательный
Если атрибут указан, в список объектов для обработки попадут все объекты вместе с подчинёнными, входящие в состав подсистемы, описанной родительским элементом.
Тип: Boolean/Булево.
Configuration необязательный
Определяет, из какой конфигурации брать состав подсистемы при настройке сравнения конфигураций.
Тип: String/Строка.
Возможные значения:
- Main – взять из основной конфигурации. Используется по умолчанию.
- Second – взять из второй конфигурации.
Примеры
Использовать все объекты конфигурации.
<Objects xmlns="http://bas-soft.eu/8.3/config/objects" version="1.0">
<Configuration includeChildObjects = "true"/>
</Objects>
Использование справочника Номенклатура с подчинёнными объектами.
<Objects xmlns="http://bas-soft.eu/8.3/config/objects" version="1.0">
<Object fullName = "Catalog.Номенклатура" includeChildObjects= "true" />
</Objects>
Использовать подсистему Администрирование без подчинённых подсистем и объекты вместе с подчинёнными, входящие только в подсистему Администрирование.
<Objects xmlns=«http://bas-soft.eu/8.3/config/objects" version="1.0">
<Object fullName = "Subsystems.Администрирование" includeChildObjects= "false">
<Subsystem includeObjectsFromSubordinateSubsystems = "true"/>
</Object>
</Objects>
Использовать корневой объект конфигурации без подчинённых объектов, подсистему ТоварныйУчёт с подчинёнными подсистемами и объекты, входящие в состав подсистемы ТоварныйУчёт и подчинённых подсистем.
<Objects xmlns="http://bas-soft.eu/8.3/config/objects" version="1.0">
<Configuration includeChildObjects = "false"/>
<Object fullName = "Subsystems.ТоварныйУчёт" includeChildObjects= "true">
<Subsystem includeObjectsFromSubordinateSubsystems = "true"/>
</Object>
</Objects>
