Запись: формы
Инструменты записи для управляемых форм: реквизиты, команды, обработчики событий и элементы, размещение и свойства элементов, исправление повторяющихся ID.
Эти инструменты добавляют управляемые формы и изменяют их реквизиты, команды, обработчики
событий и элементы. edt_form_identifiers проверяет визуальные ID формы и перенумеровывает
повторные вхождения.
Для записи нужен токен; без apply=true инструмент возвращает план. Общие правила приведены
в разделе План и применение.
| Инструмент записи | Что делает |
|---|---|
edt_add_form |
Добавляет объекту метаданных управляемую форму штатным генератором EDT – тем же, что стоит за мастером “Новая форма”. Генератор создает форму, ее элементы и модуль в XML. Для DataProcessor и ExternalDataProcessor опущенный formType выбирает OBJECT (синоним ФормаОбработки) с основным реквизитом Объект; для пустой формы передайте GENERIC. При defaultForm=true вид формы определяет основное свойство, например defaultObjectForm или defaultFolderForm справочника. Неподдерживаемое назначение отклоняется до создания. defaultForm подтверждает выполненное назначение, defaultFormProperty указывает свойство. |
edt_add_form_attribute · edt_modify_form_attribute · edt_remove_form_attribute |
Добавляет, меняет и удаляет реквизит формы, а с параметром columnOf – колонку реквизита типа ТаблицаЗначений. Идентификаторы выдает служба идентификаторов формы. Параметр main=true в edt_add_form_attribute отмечает реквизит основным (не сочетается с columnOf). Кроме грамматики типов метаданных принимаются платформенные типы, допустимые у формы (ТаблицаЗначений, СписокЗначений и другие), и объектные типы ВнешняяОбработкаОбъект.X и СправочникОбъект.X – которые используются для основного реквизита. Удаление перечисляет связанные элементы и требует force. |
edt_add_form_command · edt_modify_form_command · edt_remove_form_command |
Добавляет, меняет и удаляет команду формы, включая actionPurpose (Usual, синоним Normal, Create или Finish), associatedTable, currentRowUse и selectedRowsUse (Use, DontUse или Auto). При добавлении можно заодно записать в модуль формы заготовку процедуры-обработчика, а если модуля не было – создать его. Удаление перечисляет связанные кнопки и требует force. |
edt_add_form_handler |
Регистрирует обработчик события формы или ее элемента. Инструмент создает запись handlers в Form.form. Без нее платформа не вызывает процедуру, но валидация не сообщает об ошибке. Список допустимых событий берется из EDT; при неверном имени возвращается ошибка с этим списком. По запросу инструмент создает заготовку обработчика с сигнатурой события и директивой для его сред выполнения. |
edt_add_form_item · edt_modify_form_item · edt_remove_form_item |
Добавляет, меняет и удаляет визуальные элементы формы: поле, таблицу, кнопку, группу, декорацию. Для работы используется штатный IFormItemManagementService, который вызывает редактор форм. Таблица, связанная с реквизитом типа ТаблицаЗначений, получает колонки автоматически. Заданный таблице titleRu остается у таблицы, а сгенерированные колонки сохраняют штатный заголовок EDT. Параметр newName переименовывает элемент в модели формы, сохраняя имена процедур-обработчиков. Удаление включает все вложенные элементы и требует force. |
edt_form_identifiers |
Проверка визуальных ID во всей модели формы, включая подсказки, меню и командные панели. Возвращает пути повторных вхождений и хеш без выдачи ID. У реквизитов и команд отдельные пространства идентификаторов. С явным itemPaths показывает план перенумерации выбранных повторных вхождений. Для записи нужны текущий expectedHash и токен. Остальные ID, данные объектов и порядок сохраняются. Зарезервированные ID, неоднозначные числовые ссылки и открытый редактор этой формы блокируют исправление. |
edt_move_form_item |
Переносит существующий элемент формы по индексу или соседу с сохранением объекта, id, вложенных элементов, свойств и событий. Отклоняет циклы и переносы, требующие преобразовать вид элемента или привязку к данным. |
Размещение элементов и списки выбора
В edt_add_form_item и edt_move_form_item можно задать ровно один способ размещения:
index (от нуля), beforeItem или afterItem. При переносе индекс считается без самого
переносимого элемента. Без parent сохраняется текущий родитель; parent="" выбирает корень
формы. Добавление и изменение поддерживают groupDirection (синоним group), representation,
showTitle, united, titleLocation, maxHeight и verticalStretch, если свойство применимо
к этому виду элемента. Неизвестные значения перечислений и неприменимые свойства отклоняются.
fieldType задает InputField, RadioButtonField или CheckBoxField. choiceList заменяет
список выбора поля ввода или переключателя:
{
"choiceList": [
{
"value": "all",
"titleRu": "Все"
},
{
"value": "selected",
"titleRu": "Выбранные"
}
]
}
Значение варианта может быть строкой, числом или булевым значением; ссылки и значения
перечислений не поддерживаются. Пустой список очищает варианты. edt_form_structure возвращает
id и свойства элементов для сверки результата. Реквизит динамического списка также содержит
dynamicList с customQuery, mainTable и queryText. Параметр queryLimit ограничивает каждый
запрос (по умолчанию 20000, не более 100000 символов); queryTextTruncated отмечает усеченный текст.
Свойства управляемой формы
При kind=decoration инструмент edt_add_form_item принимает decorationType=Label или
decorationType=Picture. Если параметр опущен, инструмент выбирает Picture, когда родительский
контейнер допускает этот вид. В остальных случаях используется вид, заданный EDT по умолчанию для
контейнера. Пробный вызов проверяет контейнер и возвращает properties.decorationType. При записи
EDT создает декорацию с соответствующим extInfo.
Инструменты edt_add_form_item и edt_modify_form_item принимают fieldType=HTMLDocumentField.
EDT создает HtmlFieldExtInfo и сохраняет путь к данным при изменении вида поля.
Инструмент edt_add_form_handler определяет событие OnClick (ПриНажатии) и штатную сигнатуру обработчика.
- Для полей доступны
width,height,horizontalStretchиverticalStretch, если свойства есть в их ext-info. - Поля ввода также принимают
choiceButton,clearButton,textEditиlistChoiceMode. ОдинchoiceListне ограничивает ввод значений; для выбора только из списка нуженlistChoiceMode=true. choiceFoldersAndItemsзадает, что можно выбрать в поле ввода со ссылкой на иерархический объект:Auto,Items,FoldersилиFoldersAndItems. Другие виды полей отклоняют параметр; текущее значение показываетedt_form_structure.- Таблицы принимают
changeRowSet,autoInsertNewRow,changeRowOrder,readOnly,selectionMode(SingleRowилиMultiRow) иinitialTreeView(NoExpand,ExpandTopLevelилиExpandAllLevels). Колонки поддерживают свойства своего поля, включаяwidthиreadOnly. - Кнопки принимают
defaultButtonиbuttonImportance(Main,NormalилиSupplementary), в том числе кнопки внутриAutoCommandBar. - Свойства корня управляемой формы (
autoTitle,showTitle,showCloseButton,allowFormCustomize,titleRu,windowOpeningMode,scaleVariant,widthиheight) меняетedt_modify_objectпо FQN формы. Доступные имена и текущие значения возвращаетedt_property_reference. edt_form_structureвключает штатнуюAutoCommandBarи ее кнопки. Возвращенное имя панели можно передать вparentпри добавлении или переносе кнопки. Саму штатную панель нельзя перемещать и удалять.
Карта properties содержит прочитанные проектные значения после записи. Код формы может переопределить их во время работы.
Набор параметров проверяется целиком до первого присваивания. Неограниченная Строка получает явный пустой квалификатор строки.
Повторяющиеся ID формы
Для повторных ID сначала выполнить проверку, затем выбрать пути из audit.items.
Оставить хотя бы одно вхождение каждого повторного ID без изменения. Проверить план
с этими itemPaths, закрыть редактор этой формы и применить с текущим expectedHash.
Инструмент сбрасывает штатные кеши генераторов; такой же сброс выполняется перед добавлением
элементов, реквизитов и команд. exportAccepted подтверждает прием запроса на выгрузку.
Для проверки сохранения перечитать Form.form и повторить валидацию.
Проверка ID и ее предпросмотр не требуют токена записи.