Войти

Описание блоков элементов настроечных файлов

Данная статья содержит описание следующих блоков элементов «Structure», «Elements», «Types», «Mappers» и «Validation». 

Structure

Блок structure : object – обязательный блок элементов настроечного файла имеет следующую структуру:

Ключ

Тип

Обязательное присутствие

Описание

Условие

[mode] :

array

Список отображаемых блоков. mode - режим

Допустимые варианты значений:

·         "request" - запрос

·         "resonse" - ответ

В [mode] входят следующие элементы:

Ключ

Тип

Обязательное присутствие

Описание

Условие

source :

string

Источник данных

допустимые варианты значений:

·         "message" - сообщение

from :

string

Уточнение расположения данных

Допустимые варианты значений для источника message:

"Content" - всё сообщение (не директивный вид сведений)

"General" - общая часть сообщения (директивный вид сведений)

"Registry" - реестровая часть сообщения (директивный вид сведений)

element :

string

Идентификатор корневого элемента, для отображения блока

dynamicRouting :

boolean

Наличие блока динамической маршрутизации

attachments :

object

Настройки блока вложений

В attachments входят следующие элементы:

Ключ

Тип

Обязательное присутствие

Описание

Условие

pasportIds :

array

Список допустимых значений идентификаторов паспортов

pasportIds :

 

Elements

В блоке elements : object описываются элементы настроечного файла, которые в дальнейшем распределяются по запросной или ответной части вида сведения и имеет следующую структуру:

Ключ

Тип

Обязательное присутствие

Описание

Условие

[id] :

object

Элемент id – уникальный идентификатор элемента (в списке элементов)

[id] : в свою очередь имеет следующую структуру:

Ключ

Тип

Обязательное присутствие

Описание

Условие

path :

string

Путь к узлу дерева XML - как правило соответствует имени тега, который описывает элемент

typeId :

string

Идентификатор типа - ссылка на тип (по умолчанию используется простой тип, с "base" : "string")

caption :

string

Название элемента, отображаемое пользователю

description :

string

Расширенное описание поля

required :

boolean

Обязательность заполнения данных (по умолчанию false)

repeatable :

object

Описание повторяемости элемента

readOnly :

boolean

Доступность элементов для редактирования (по умолчанию false)

default :

string

Значение элемента по умолчанию

В repeatable входят следующие элементы:

Ключ

Тип

Обязательное присутствие

Описание

Условие

path

string

путь к повторяющемуся узлу дерева XML - как правило соответствует имени тега, который описывает повторяющийся элемент

min :

number

Минимальное количество элементов [0 - 1] (по умолчанию 0)

max :

number

Максимальное количество элементов [1 - 2^7] или unbounded (по умолчанию unbounded)

caption :

string

Заголовок повторяемого элемента с добавление текущего индекса начиная с 1 (по умолчанию название головного элемента)

addCaption :

string

Название кнопки для добавления повторяемого элемента (по умолчанию "Добавить")

removeCaption :

string

Название кнопки для удаления повторяемого элемента (по умолчанию "Удалить")

 

Types 

В блоке types : object описываются типы элементов настроечного файла

Ключ

Тип

Обязательное присутствие

Описание

Условие

[id] :

object

Элемент id – уникальный идентификатор элемента (в списке элементов)

[id] : в свою очередь имеет следующую структуру:

Ключ

Тип

Обязательное присутствие

Описание

Условие

description :

string

Расширенное описание поля

base :

string

Базовый тип

Допустимые варианты значений:

·                      "boolean" - логический

·                      "number" - числовой

·                      "string" - строковый

content :

object

содержимое типа

restriction :

object

описание ограничений

widget :

object

виджет

В content входят следующие элементы

Ключ

Тип

Обязательное присутствие

Описание

Условие

mode :

string

Режим обработки содержимого

допустимые варианты значений:

·                   "sequence" - последовательно

·                   "choice" - выборочно, только один

elementIds :

array

Список идентификаторов элементов в порядке отображения

xmlOrder :

array

Список идентификаторов элементов в порядке, требуемом форматом XML (по умолчанию используется порядок из elementIds)

В restruction входят следующие элементы:

Ключ

Тип

Обязательное присутствие

Описание

Условие

enumeration :

object

Список вариантов

pattern :

string

Регулярное выражение

whitespace :

string

Обработка пробелов

допустимые варианты значений:

·         "preserve" - сохранение всех white space символов

·         "collapse" - замена всех white space символов, устранение повторяющихся пробелов на единичные

·         "replace" - замена всех white space символов

length :

number

Длина текста

minLength :

number

Минимальная длина текста

maxLength :

number

Максимальная длина текста

minInclusive :

number

Минимальное числовое значение включая указанное

maxInclusive :

number

Максимальное числовое значение включая указанное

minExclusive :

number

Минимальное числовое значение исключая указанное

maxExclusive :

number

Максимальное числовое значение исключая указанное

totalDigits :

number

Точное число разрешенных цифр [1- 2^7]

fractionDigits :

number

Максимальное допустимое число десятичных знаков [0 - 2^7]

В enumeration входят следующие элементы:

Ключ

Тип

Обязательное присутствие

Описание

Условие

[value] :

string

Человекочитаемаый текст. value - значение

В widget входят следующие элементы:

Ключ

Тип

Обязательное присутствие

Описание

Условие

name :

string

имя

params :

object

параметр

... : структура зависит от виджета

 

Mappers 

В блоке mappers : object описывают соответствие данных между потенциально различными семантиками одного объекта или разных объектов. В данный блок входят следующие элементы:

Ключ

Тип

Обязательное присутствие

Описание

Условие

[id] :

object

Маппер id – название маппера

class :

string

Класс маппера

допустимые варианты значений:

- "DateFormat" - форматированное значение даты и время

params :

object

Перечень параметров зависит от класса

В params входят следующие элементы:

Ключ

Тип

Обязательное присутствие

Описание

Условие

[name] :

string

Значение параметра. name – название параметра

 

Validation

В блоке validation : object описывается валидация с возможностью межреквизитного контроля.

Ключ

Тип

Обязательное присутствие

Описание

Условие

validation :

object

Валидация с возможностью межреквизитного контроля

В блок validation входят следующие элементы:

Ключ

Тип

Обязательное присутствие

Описание

Условие

[elementId] :

array

Список ошибок.  elementId идентификатор корневого элемента для применения правил

В elementId входят следующие элементы:

Ключ

Тип

Обязательное присутствие

Описание

Условие

rule :

string

Правило поиска ошибочных вариантов

message :

string

Сообщение

Авторизуйтесь, чтобы оставить комментарий к статье