XDTO-пакеты

image_pdfimage_print
Печать (Ctrl+P)

XDTO-пакеты

Механизм XDTO является универсальным способом представления данных для взаимодействия с различными внешними источниками данных и программными системами.

Импорт схемы XML в глобальную фабрику XDTO

Для того чтобы импортировать схему XML из файла .xsd в глобальную фабрику XDTO, следует выделить в дереве конфигурации ветку XDTO и выполнить команду контекстного меню Импорт XML-схемы…

Импорт XML-схемы

После указания требуемого файла .xsd будет выполнена проверка существования в дереве конфигурации пакетов XDTO, пространства имен которых совпадают с импортируемыми из файла. Если такие пакеты существуют, то будет отображен список этих пакетов и предложено указать те пакеты, которые должны быть обновлены (по умолчанию существующие пакеты не обновляются).

Выбор пространств имен

После этого будет выполнен импорт, в результате которого новые пакеты XDTO будут добавлены в дерево конфигурации, а пакеты, отмеченные для
обновления, обновлены.

Экспорт схемы XML-данных конфигурации

Для того чтобы экспортировать схему XML, соответствующую типам данных конфигурации (без учета пакетов XDTO, созданных в дереве конфигурации), в файл .xsd, следует выделить в дереве конфигурации ветку XDTO и выполнить команду контекстного меню Экспорт XML-схемы данных  конфигурации…

После выбора каталога и указания имени файла будет выполнен экспорт схемы XML в указанный файл.

Экспорт схемы XML-пакета XDTO

Для того чтобы экспортировать схему XML, соответствующую существующему пакету XDTO, в файл .xsd, следует выделить в дереве конфигурации требуемый пакет XDTO и выполнить команду контекстного меню Экспорт XML-схемы.  После этого будет выполнена проверка выгружаемого пакета XDTO. Если будут обнаружены ошибки, соответствующие сообщения будут выведены в  окно сообщений, а процедура экспорта будет прервана.


В случае успешной проверки будет предложено выбрать каталог и имя файла .xsd, после чего схема XML будет экспортирована в указанный файл.

Проверка пакета XDTO

Для того чтобы проверить пакет XDTO, следует выделить в дереве конфигурации требуемый пакет XDTO и выполнить команду контекстного меню Проверить пакет.
В результате будет выполнена проверка модели пакета XDTO,
Если будут обнаружены ошибки, соответствующие сообщения будут выведены в окно сообщений.

Окно редактирования пакета XDTO

Редактирование пакета XDTO выполняется в окне редактирования пакета XDTO.

Окно редактирования пакета XDTO

При добавлении нового пакета XDTO в дерево конфигурации окно редактирования пакета XDTO открывается автоматически.
Для того чтобы открыть окно редактирования для существующего пакета XDTO, следует выделить в дереве конфигурации требуемый пакет XDTO и выполнить команду контекстного меню Открыть пакет.

Иерархическая структура пакета XDTO

Окно редактирования пакета XDTO содержит иерархическую структуру пакета XDTO, отображенную в виде дерева. В корне дерева расположен идентификатор пакета XDTO, содержащий URI пространства имен данного пакета.


На первом уровне иерархии могут располагаться следующие элементы пакета:
Директивы импорта – перечень директив импорта. Каждая директива импорта представляет собой ссылку на другой пакет, содержащий типы, на которые так или иначе ссылается данный пакет. При работе с данным пакетом XDTO средствами встроенного языка данный перечень директив импорта будет доступен в виде объекта КоллекцияПакетовXDTO, содержащегося в свойстве Зависимости пакета XDTO.
Типы значений – перечень типов значений XDTO, которые содержит пакет XDTO.
Типы объектов – перечень типов объектов XDTO, которые содержит пакет XDTO.
Свойства – перечень свойств пакета XDTO. Представляет собой объявления объектов/значений, которые могут являться корневыми элементами документов XML, принадлежащих URI пространству имен данного пакета XDTO.
● Каждый тип значения XDTO описывается иерархической структурой и может содержать в своем составе следующие элементы:
Образец – описывает один фасет XDTO типа Образец.
Перечисление – описывает один фасет XDTO типа Перечисление.

Каждый тип объекта XDTO описывается иерархической структурой, которая может содержать в своем составе набор свойств объекта.

Свойства пакета XDTO

Редактирование свойств пакета XDTO выполняется в палитре свойств.
Если палитра свойств открыта для пакета XDTO, выделенного в дереве конфигурации, то в ней будут содержаться следующие свойства: Имя, Синоним, Комментарий и URI пространства имен. Кроме этого, палитра свойств будет содержать ссылку Пакет, по которой можно перейти в окно редактирования пакета XDTO.

Свойства пакета XDTO

Если палитра свойств открыта для пакета XDTO, выделенного в окне редактирования пакета XDTO (корневой элемент), то она содержит единственное свойство – URI пространства имен. Это свойство задает URI пространства имен пакета XDTO, к которому принадлежат все определенные в этом пакете типы.
Свойства директивы импорта
Редактирование свойств директивы импорта выполняется в палитре свойств. Для директивы импорта палитра свойств содержит единственное свойство – Пространство имен. Это свойство задает URI пространства имен импортируемого пакета.

Свойства директивы импорта

Свойства типа значения XDTO
Редактирование свойств типа значения XDTO выполняется в палитре свойств.

Свойства значения XDTOДля типа значения XDTO палитра свойств содержит следующие свойства:
Имя – имя типа значения XDTO.
Базовый тип – базовый тип для данного типа значения XDTO.
Вариант – вариант простого типа (атомарный тип, список, объединение). Если значение установлено, то должно не противоречить значениям Тип элемента и Типы объединения.
Тип элемента – тип элемента списка в случае, когда тип значения XDTO определяется списком. При этом все фасеты и свойство Типы подчиненных
должны быть пустыми.
Типы объединения – список типов, образующих объединение в случае, когда тип значения XDTO определяется объединением. Объединяться могут
только типы значений XDTO. При этом все фасеты и свойство Тип элемента должны быть пустыми.
Длина – фасет длины.
Минимальная длина – фасет минимальной длины.
Максимальная длина – фасет максимальной длины.
Пробельные символы – фасет пробельного символа.
Минимум, включающий границу – фасет минимума, включающего границу.
Минимум, не включающий границу – фасет минимума, не включающего границу.
Максимум, включающий границу – фасет максимума, включающего границу.
Максимум, не включающий границу – фасет максимума, не включающего границу.
Общее количество цифр – фасет общего количества цифр.
Количество цифр дробной части – фасет количества цифр дробной части.

Свойства типа объекта XDTO
Редактирование свойств типа объекта XDTO выполняется в палитре свойств.

Для типа объекта XDTO палитра свойств содержит следующие свойства:
Имя – имя типа объекта XDTO.
Базовый тип – базовый тип для данного типа объекта XDTO. Это может быть только тип объекта XDTO.
Открытый – признак, является ли тип объекта XDTO открытым. Данное свойство показывает, может ли экземпляр объекта XDTO содержать дополнительные свойства, не определенные в его типе.
Абстрактный – признак, является ли тип объекта XDTO абстрактным.
Смешанный – свойство показывает, имеет ли соответствующий объект XDTO смешанное содержание. Если значение свойства Смешанный равно Истина, то значение Последовательный обязательно равно Истина, так как смешанное содержание невозможно смоделировать без применения последовательности XDTO.
Упорядоченный – признак, является ли порядок следования элементов, представляющих значения свойств, строго соответствующим порядку следования свойств в типе объекта XDTO. Если свойство Упорядоченный имеет значение Ложь, то на входе порядок следования элементов XML не контролируется, а на выходе определяется порядком следования свойств, если только свойство Последовательный не имеет значение Истина.
Последовательный – это свойство показывает, содержит ли экземпляр соответствующего объекта XDTO последовательность XDTO. Данный признак
равен значению Истина в тех случаях, когда порядок следования вложенных элементов XML не может однозначно определяться порядком следования свойств в типе или соответствующий объект XDTO имеет смешанное содержание. Последовательность XDTO позволяет задать в явном виде порядок следования элементов, как они будут представлены в документе XML. Для объектов типов, у которых свойство Последовательный установлено в значение Ложь, порядок следования вложенных элементов соответствует порядку следования свойств.
Свойства свойств типа объекта XDTO
Редактирование свойства свойств типа объекта XDTO выполняется в палитре свойств.

Палитра свойств типа XDTO

Для типа объекта XDTO палитра свойств содержит следующие свойства:
Имя – имя свойства. В пределах одного типа объекта XDTO имена свойств должны быть уникальными.
Тип – тип свойства. Может быть как типом значения XDTO, так и типом объекта XDTO.
Минимальное количество – минимальное количество значений свойства. Минимальное количество значений свойства может принимать значения >= 0. Естественно, значение Минимальное количество должно быть меньше или равно значению Максимальное количество (если, конечно, Максимальное количество не равно -1);
Максимальное количество – свойство типа объекта XDTO может быть определено как содержащее одно или множество значений. Свойство считается содержащим одно значение, если свойство Максимальное количество равно 1. Если же свойство Максимальное количество больше 1, то считается, что свойство может содержать множество значений. Такое свойство в структуре объекта моделируется как список. Свойство Максимальное количество показывает максимальное количество значений свойства. Максимальное количество > 1 может быть задано только для свойств,
представляемых в виде элемента XML.
Возможно пустое – показывает, может ли свойство принимать неопределенное значение. Свойство Возможно пустое, равное Истина, может быть определено только для свойств с формой представления Элемент. Если Максимальное количество > 1, неопределенное значение является допустимым для элемента списка значений свойства.
Фиксированное – указывает, является ли значение свойства фиксированным. Если установлено в значение Истина, то само фиксированное значение можно получить через свойство По умолчанию.
По умолчанию – значение свойства по умолчанию. Тип значения по умолчанию может быть только типом значения XDTO. При этом данное значение должно быть совместимо с типом свойства (быть того же типа, что и тип свойства или же унаследованного типа). При создании объекта XDTO свойство, если оно допускает единственное значение, принимает значение по умолчанию. Для свойств с множеством значений список значений
изначально пуст, независимо от того, определено или нет значение по умолчанию.
Форма – форма представления свойства в XML. Это может быть Текст, Элемент или Атрибут. Если формой представления является Атрибут или
Текст, то значение свойства Максимальное количество не может быть больше 1. Если свойство принимает значение Текст, то значение свойства
Минимальное количество также должно быть равным 1. У одного типа только одно свойство может иметь форму представления Текст, при этом
остальные свойства должны иметь форму представления Атрибут.
Локальное имя – локальное имя, используемое для представления свойства. Для свойств с формой представления Текст – пустая строка.

Глобальное свойство

Редактирование свойств глобального свойства выполняется в палитре свойств.

Палитра свойств глобального свойства

Для глобального свойства палитра свойств содержит следующие свойства:
Имя – имя глобального свойства. В пределах одного типа объекта XDTO имена глобальных свойств должны быть уникальными.
Ссылка – ссылка на корневое определение свойства пакета.
Тип – тип глобального свойства.
Минимальное количество – минимальное количество значений свойства. Если Минимальное количество = 0, то значение свойства может быть не установлено.
Максимальное количество – максимальное количество значений свойства. Если Максимальное количество равно -1, то количество значений свойства неограниченно.
Возможно пустое – показывает, может ли свойство принимать неопределенное значение.
Фиксированное – указывает, является ли значение свойства фиксированным.
По умолчанию – значение свойства по умолчанию. Лексическое представление значения свойства должно соответствовать правилам проверки типа
данного свойства.
Форма – форма представления свойства в XML. Это может быть Текст, Элемент или Атрибут.
Локальное имя – локальное имя, используемое для представления свойства.

One Reply to “XDTO-пакеты”

  1. Boris

    Чтобы указать типы, возможные к использованию – используется список, библиотека типов – которую называют фабрика XDTO 1С.

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *