Модификация управляемых форм

01.03.24

Разработка - Инструментарий разработчика

Подсистема позволяет изменять управляемые формы типовой конфигурации с помощью макета табличного документа или текстового документа в формате JSON, что позволяет упростить процесс обновления. Версия платформы: 8.3.6 и выше. С небольшими доработками будет работать на 8.2.

Скачать файлы

Наименование Файл Версия Размер
Расширение модификация управляемых форм: версия от 01.03.2024
.cfe 20,98Kb
0
.cfe 20,98Kb Скачать
Модификация управляемых форм: версия от 01.03.2024
.cf 40,43Kb
4
.cf 40,43Kb 4 Скачать

1. Модификации управляемых форм

Подсистема модификации управляемых форм позволяет изменять свойства формы с помощью макета, который создается для каждой формы объекта метаданных или общего макета для общих форм. Для использования подсистемы необходимо перенести в свою конфигурацию модуль: ОбщийМодуль.МодификацияУправляемыхФорм Для применения к форме макета изменений, необходимо сделать вызов

МодификацияУправляемыхФорм.ПрименитьМакетИзменений(Форма)

перед первым использованием добавленных объектов формы. Если в конфигурации предусмотрена процедура общего модуля, которая вызывается из всех форм (например ОбщийМодуль.МодификацияКонфигурацииПереопределяемый.ПриСозданииНаСервере для конфигурации 1C:ERP) – следует добавить вызов в нее, чтобы не добавлять во все модифицируемые формы. Если для формы не предусмотрен вызов общей процедуры или вызов происходит слишком поздно - необходимо добавить следующий фрагмент в раздел инициализации модуля формы (после определения всех процедур и фунций):

#Если Сервер Тогда
МодификацияУправляемыхФорм.ПрименитьМакетИзменений(ЭтаФорма);
#КонецЕсли

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

1.1. Формат описания изменений формы

Макет изменений может быть указан либо в виде макета табличного документа либо в виде макета тестового документа в формате JSON. При работе с Git рекомендуется использовать формат JSON, т.к. он позволяет выполнять 3-х стороннее объединение. Для упрощения редактирования макета изменений в формате JSON, а рекомендуется использовать расширение конфигурации, которое содержит форму для редактирования макета изменений в виде табличного документа. Пример можно посмотреть в макете: Документ.Приход.Макет.МОД_Модификация_ФормаДокумента

Макет изменений состоит из 3-х областей, любая из которых не является обязательной, порядок расположения также не важен. Рекомендуется для каждой области использовать свой формат строк.

  • Реквизиты – описывается добавление новых или корректировка существующих реквизитов формы. К добавленным реквизитам в модуле формы нужно обращаться с помощью ЭтаФорма.<имя реквизита>
    • Колонки
      • Имя – имя нового или существующего реквизита. Для имени может использоваться несколько подряд идущих колонок с таким именем, либо с объединенной шапкой. С помощью нескольких колонок имени можно добавлять колонки в коллекции данных формы.
      • ОписаниеТипов(ТипЗначения) – тип значения нового реквизита
      • <описание имени свойства> - свойство реквизита
    • Описание каждого реквизита выполняется в отдельной строке. В ячейках указывается <описание значения свойства>
  • Команды – описывается добавление новых или корректировка существующих команд формы
    • Колонки
      • Имя – имя новой или существующей команды
      • <описание имени свойства> - свойство команды
    • Описание каждой команды выполняется в отдельной строке. В ячейках указывается <описание значение свойства>
  • Элементы – описывается добавление новых или корректировка существующих команд формы
    • Колонки
      • Имя – имя нового или существующего элемента. Если Имя = Форма, колонки описывают изменения свойств формы.
        • Для новых элементов типа ПолеФормы вид поля формы зависит от типа реквизита, с которым связан элемент
          • Для реквизита с единственным типом «Булево»: Вид = ВидПоляФормы.ПолеФлажка
          • В остальных случаях Вид = ВидПоляФормы.ПолеВвода
        • Для новых элементов типа ГруппаФормы, которые расположены в других группах или на страницах по-умолчанию устанавливаются следующие значения свойств: Вид = ВидГруппыФормы.ОбычнаяГруппа, Отображение = ОтображениеОбычнойГруппы.Нет, ОтображатьЗаголовок = Ложь
      • Тип – имя типа элемента формы
      • ПутьКДанным – заполнение является обязательным для элементов типа «ПолеФормы». При необходимости вывода на форму полей ссылочного реквизита с вложенностью более 1 необходимо свойство «ПутьКДанным» указать в следующем формате <путь к реквизиту>/<путь к данным реквизита>
      • <описание имени свойства> - свойство элемента
    • Описание каждого элемента выполняется в отдельной строке. В ячейках указывается <описание значения свойства>

Допускаются следующие варианты <описание имени свойства>:

  • <имя свойства> - в качестве значения свойства используется строка из ячейки.
    • Если в ячейке есть символ %, то он заменяется на значение ячейки родителя
  • (<имя свойства>) – в качестве значения свойства устанавливается результат выражения из ячейки, выполняемого с помощью функции Вычислить()
  • <имя конструктора>(<имя свойства>) – для вычисления значения свойства используется специальный конструктор. Поддерживаются следующие конструкторы
    • ОписаниеТипов – в ячейке перечисляются типы через запятую, также как они передаются в конструктор объекта ОписаниеТипов. Для примитивных типов поддерживается указание квалификаторов
      • Число(<длина>, <точность>, <имя значения перечисления ДопустимаяДлина>)
      • Строка(<длина>, <имя значения перечисления ДопустимаяДлина >)
      • Дата(<имя значения перечисления ЧастиДаты>)
    • ПараметрыВыбора – в ячейке определяется список параметров выбора, разделенный запятыми <имя параметра выбора>(<значение параметра выбора>), где <значение параметра выбора> это вычисляемое выражение на языке 1С
      • Если <имя параметра выбора> = "*" добавляются параметры выбора, заданные в конфигураторе, и с помощью префиксов "+" и "-" можно добавить новые / удалить существующие
    • СвязиПараметровВыбора – в ячейке определяется список параметров выбора, разделенный запятыми <имя параметра выбора>(<путь к данным формы>).
      • Если <имя параметра выбора> = "*" добавляются связи параметров выбора, заданные в конфигураторе, и с помощью префиксов "+" и "-" можно добавить новые / удалить существующие
  • <имя операции>() – необходимо выполнить операцию над объектом формы. Поддерживаются следующие операции:
    • МестоРасположения – в ячейке задается имя элемента формы, перед которым необходимо разместить текущий элемент. Родитель указанного элемента должен находится в одной из подгрупп родителя текущего элемента
    • Родитель – в ячейке задается имя элемента, которые необходимо установить в качестве родителя для текущего элемента. Новый родитель должен находится в одной из подгрупп родителя текущего элемента. Игнорируется если для текущего элемента указана операция МестоРасположения
  • <имя перечисления>(<имя свойства>) – строка из ячейки используется как имя значения системного перечисления <имя перечисления>
  • [<имя действия>] – в ячейке указывается имя процедуры, которая устанавливается для действия <имя действия>.
    • Если в ячейке установлено значение %, оно заменяется на <имя элемента><имядействия>.
    • Если в ячейке есть значение % оно заменяется на <имя действия> Если <имя свойства> начинается с точки (.), то описывается изменение свойств значения реквизита формы. Например для динамического списка можно менять свойства объекта ДинамическийСписок

1.2. Ручное применение изменений формы

При необходимости ручного применения изменений формы, необходимо выполнить вызов

МодификацияУправляемыхФорм.ИзменитьФорму(Форма, МакетИзменений, ИмяШаблона, ...)

Макет изменений текущей формы можно получить с помощью функции

МодификацияУправляемыхФорм.ПолучитьМакетИзменений(Форма)

В макете изменений можно использовать параметры %1...%5, значения которых передаются при ручном применении изменений формы

1.3. Существующие ограничения

  • невозможно изменить свойства реквизитов формы добавленных в конфигураторе. В том числе такое важное свойство как ТипЗначения
  • невозможность назначить источник действий для командной панели. Из-за этого для форматированного документа необходимо добавлять в форму конфигуратора командную панель, реквизит форматированного документа и элемент формы, который связан с реквизитом

1.4. Использование расширения

С помощью расширения можно выполнять редактирование макета изменений и применять их без перезапуска приложения. После применения расширения в главном меню появляется команда "Модификация управляемой формы". На старых версиях платформы данную команду можно добавить в меню избранное из обработки "Модификация управляемой формы". После ее вызова открывается оно редактирования последней открытой управляемой формы, если она была подключена к подсистеме модификации управляемых форм 

Описание команд:

Загрузить изменения - загрузить макет изменений формы записанный ранее в текущем сеансе

Записать изменения - записать макет изменений, после чего он будет использоваться при открытии форм данного вида. Изменения будут доступны до заверешния текущего сеанса, поэтому не нужно забывать их необходимо сохранить в конфигурации

Удалить изменения - удалить изменения макета текущей формы, после чего будет использоваться макет указанный в конфигураторе

Получить JSON - получить макет изменений в формате JSON

Нормализовать - привести макет изменений в виде таблицы к формату удобному для последующего редактирования вручную

2. Ограничение изменения реквизитов управляемой формы

Подсистема предназначена для ограничения измененения реквизитов управляемой формы на основании других реквизитов. Разные ограничивать доступ к реквизитам в зависимости от статусов или функциональных ролей. Ограничение рекомендуется делать при первом открытии формы и после каждой записи, т.к. нет смысла ограничивать реквизиты внутри одного сеанса работы с формой.

Для работы с механизмом необходимо добавить следующий фрагмент в раздел инициализации формы (после всех процедур и функций)

#Если Сервер Тогда
МодификацияУправляемыхФорм.ИнициализироватьОграничениеИзмененияРеквизитов(ЭтаФорма);
#КонецЕсли

Ограничение выполняется с помощью вызова на клиенте:

МодификацияУправляемыхФорм.ОграничитьИзменениеРеквизитов(ЭтаФорма, <описание ограничений>)

По-умолчанию, если описание ограничений не указано, будут ограничен доступ ко всем элементам формы, связанных с данными объекта или реквизитами. В описании ограничений можно указать отклонение от этого правила с помощью настройки доступа к отдельным уровням дерева элементов. Например, для ограничения доступа ко всем элементам кроме поля "Утвержден" необходимо выполнить

МодификацияУправляемыхФорм.ОграничитьИзменениеРеквизитов(ЭтаФорма, "Утвержден")

По-умолчанию кнопки формы связанные с командами, у которых не установлен признак "ИзменяетСохраняемыеДанные" ограничиваться не будут, для их ограничения необходимо явно указать запрет, либо на кнопку, либо на все командную панель, например:

МодификацияУправляемыхФорм.ОграничитьИзменениеРеквизитов(ЭтаФорма, "-ФормаКоманднаяПанель.*")

Для предоставления доступа ко всем элементам таблицы "Товары", сроме колонки "Цена" цена необходимо выполнить

МодификацияУправляемыхФорм.ОграничитьИзменениеРеквизитов(ЭтаФорма, "Товары.*,-ТоварыЦена")

Для предоставления доступа только к таблице "Проверка" необходимо выполнить

МодификацияУправляемыхФорм.ОграничитьИзменениеРеквизитов(ЭтаФорма, "*,-Проверка")

В общем случае каждый элемент описания ограничений имеет следующий формат (<префикс>)<имя элемента>(.*) где <префикс> - если не указан или "+" - предоставить доступ, если "-" - ограничить доступ .* означает, что описание ограничения влияет в том числе на подчиненные элементы, при этом * означает все элементы Ограничение, установленное на более высоком уровне дерева элементов, имеет приоритет ниже, чем у ограничения, установленных на более низком уровне уровне.

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

МодификацияУправляемыхФорм.ВосстановитьОграничениеИзмененияРеквизитов(ЭтаФорма)

Для отмены ограничения доступа необходимо выполнить на клиенте

МодификацияУправляемыхФорм.ОтменитьОграничениеИзмененияРеквизитов(ЭтаФорма)

 

См. также

SALE! 20%

Infostart Toolkit: Инструменты разработчика 1С 8.3 на управляемых формах

Инструментарий разработчика Роли и права Запросы СКД Платформа 1С v8.3 Управляемые формы Запросы Система компоновки данных Конфигурации 1cv8 Платные (руб)

Набор инструментов программиста и специалиста 1С для всех конфигураций на управляемых формах. В состав входят инструменты: Консоль запросов, Консоль СКД, Консоль кода, Редактор объекта, Анализ прав доступа, Метаданные, Поиск ссылок, Сравнение объектов, Все функции, Подписки на события и др. Редактор запросов и кода с раскраской и контекстной подсказкой. Доработанный конструктор запросов тонкого клиента. Продукт хорошо оптимизирован и обладает самым широким функционалом среди всех инструментов, представленных на рынке.

13000 10400 руб.

02.09.2020    122182    673    389    

714

SALE! 25%

Infostart PrintWizard

Пакетная печать Печатные формы Инструментарий разработчика Платформа 1С v8.3 Запросы 1С:Зарплата и кадры бюджетного учреждения 1С:Конвертация данных 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 Платные (руб)

Инструмент, позволяющий абсолютно по-новому взглянуть на процесс разработки печатных форм. Благодаря конструктору можно значительно снизить затраты времени на разработку печатных форм, повысить качество и "прозрачность" разработки, а также навести порядок в многообразии корпоративных печатных форм.

18000 15300 руб.

06.10.2023    7302    22    6    

39

SALE! 20%

Infostart УДиФ: Управление данными и формами

Инструменты администратора БД Инструментарий разработчика Роли и права Платформа 1С v8.3 Конфигурации 1cv8 Россия Платные (руб)

Расширение позволяет без изменения кода конфигурации выполнять проверки при вводе данных, скрывать от пользователя недоступные ему данные, выполнять код в обработчиках. Не изменяет данные конфигурации, легко устанавливается практически на любую конфигурацию на управляемых формах.

10000 8000 руб.

10.11.2023    3547    11    1    

34

SALE! 30%

PowerTools

Инструментарий разработчика Инструменты администратора БД Платформа 1С v8.3 Управляемые формы Конфигурации 1cv8 Россия Платные (руб)

Универсальный инструмент программиста для администрирования конфигураций. Сборник наиболее часто используемых обработок под единым интерфейсом.

3600 2520 руб.

14.01.2013    177762    1074    0    

849

Многопоточность. Универсальный «Менеджер потоков» 2.1

Инструментарий разработчика Платформа 1С v8.3 Конфигурации 1cv8 Россия Платные (руб)

Восстановление партий или взаиморасчетов, расчет зарплаты, пакетное формирование документов или отчетов - теперь все это стало доступнее. * Есть желание повысить скорость работы медленных алгоритмов! Но... * Нет времени думать о реализации многопоточности? * о запуске и остановке потоков? * о поддержании потоков в рабочем состоянии? * о передаче данных в потоки и как получить ответ из потока? * об организации последовательности? Тогда ЭТО - то что надо!!!

5000 руб.

07.02.2018    99350    239    97    

296

[ЕХТ] Фреймворк для Расширений 1С

Инструментарий разработчика Платформа 1С v8.3 Управляемые формы Платные (руб)

"Фреймворк для Расширений 1С" это универсальное и многофункциональное решение, упрощающее разработку и поддержку создаваемых Расширений. Поставляется в виде комплекта из нескольких Расширений с открытым исходным кодом. Работает в любых Конфигурациях в режиме Управляемого приложения с режимом совместимости 8.3.12 и выше без необходимости внесения изменений в Конфигурацию.

3000 руб.

27.08.2019    18120    6    8    

40

1С HTML Шаблоны / HTML Templates

Инструментарий разработчика Платформа 1С v8.3 Конфигурации 1cv8 Платные (руб)

Быстрая и удобная обработка для работы с шаблонами HTML. Позволяет легко и быстро формировать код HTML.

2040 руб.

27.12.2017    28111    3    10    

15

Выполнение произвольного кода или запроса с параметрами через Web-сервис (замена COM-подключений)

Инструментарий разработчика Обмен между базами 1C Платформа 1С v8.3 Платные (руб)

В процессе работы в 1С часто возникает потребность получить данные из другой базы.  Обычно это делается через COM-соединение, и время выполнения запроса при этом оставляет желать лучшего. В данной публикации представлено универсальное решение, позволяющее практически моментально выполнить произвольный код или запрос с параметрами в другой информационной базе через Web-сервис.

2400 руб.

24.09.2019    23605    15    15    

32
Комментарии
В избранное Подписаться на ответы Сортировка: Древо развёрнутое
Свернуть все
1. adapter 417 16.10.19 11:49 Сейчас в теме
Привет. Интересное решение! плюсую. А содержимое макета изменений нужно вручную писать? На ИС есть много наработок по декомпиляции и сравнение форм. Вот бы объединить. Чтобы было примерно так

- копируешь форму, добавляешь спец. префикс в имя формы
- модифицируешь копию, добавляешь элементы и т.д.
- обработка сравнивает обе формы и генерит макет изменений
- при открытии происходит программная модификация по макету изменений
2. vadim1980 131 16.10.19 13:59 Сейчас в теме
Да, макет изменений создается вручную. В большей степени как замена модификации формы кодом
Ваше предложение интересное, но есть вариант реализации лучше - в расширении делать измененную форму, выгружать расширение в файлы, результат выгрузки парсить и на основании текущей версии макета изменений формировать новую версию.
3. kalyaka 1053 10.12.19 09:49 Сейчас в теме
(2) еще можно рассмотреть вариант разработки в EDT, тогда форма сразу хранится в XML и доступна для парсинга!
Оставьте свое сообщение