Довідковий матеріал

Файл списку об'єктів

Описано XML-файл списку об'єктів для порівняння конфігурацій і роботи зі сховищем конфігурації BAS, його елементи, атрибути та приклади використання.. Загальний опис. Елемент <Objects>. Елемент <Configuration>. Елемент <Object>. Приклади

Структуроване дерево конфігурації з вкладених карток, з’єднаних тонкими лініями, на тлі абстрактного документа.

Загальний опис

Елемент <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>
Записатися телефоном