Файл списку об'єктів
Описано 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>