← На главную

При работе с платформой 1С:Предприятие 8.3 часто возникает задача доработки типового функционала без изменения основной конфигурации. Расширения предоставляют мощный инструмент для решения таких задач. Однако, программное добавление новых элементов на форму, таких как флажки или поля ввода, может столкнуться с неожиданными сложностями. В этой статье мы подробно рассмотрим, как программно добавить флажок на форму документа через расширение и какие типичные проблемы могут возникнуть на этом пути, а также как их эффективно решать. Для реализации изменений без программирования можно использовать платформу для создания программных роботов OneRPA с визуальным конструктором сценариев.

Представим, что у нас стоит задача добавить на форму документа Заказ покупателя новый флажок Отгрузка разрешена. Этот флажок должен быть добавлен через расширение и при его установке отключать все проверки при проведении документа. Мы добавили новый булев реквизит документа Опл_РазрешитьОтгрузку в наше расширение. Теперь попробуем добавить его как реквизит формы программно, но сталкиваемся с тем, что элемент не отображается на форме, хотя кнопка, добавленная аналогичным образом, видна.

Анализ ситуации: почему элемент формы не появляется?

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

1. Недостаточность прав доступа. Это одна из самых частых и коварных причин. Если у пользователя, под которым открывается форма, нет соответствующих прав на новый реквизит расширения, платформа просто не будет его отображать. По умолчанию, если расширение не содержит собственных ролей, доступ к объектам расширения может предоставляться всем пользователям, однако это не всегда работает корректно, особенно в более старых версиях платформы или при сложных комбинациях ролей. Начиная с платформы 8.3.14, поведение в отношении прав изменилось, и иногда требуется явное назначение прав даже для администраторов.

2. Отсутствие связанного реквизита объекта. Для того чтобы элемент формы (ПолеФормы) отображался, он должен быть связан с существующим реквизитом формы или реквизитом объекта, доступным на этой форме. Если реквизит Объект.Опл_РазрешитьОтгрузку не был создан в расширении для основного объекта (документа Заказ покупателя), то элемент формы не сможет с ним связаться и, соответственно, не будет отображен.

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

4. Проблемы с размещением элемента на форме. Хотя в нашем случае кнопка добавляется успешно, а флажок нет, это может быть связано с тем, что флажок не помещается на видимой области формы или не имеет явно указанного родителя (группы). Элемент может быть добавлен в самый низ формы, за пределами видимости, или в неактивную/скрытую группу.

5. Кэш или некорректное состояние расширения. Иногда проблемы могут быть вызваны кэшем. После изменений в расширении или конфигурации кэш 1С может сохранять устаревшие данные, что приводит к некорректному поведению. Также может помочь удаление формы из расширения и её повторное добавление.

6. Особенности поведения платформы в разных версиях. Механизм расширений постоянно развивается. В разных версиях платформы 1С (например, 8.3.12, 8.3.14, 8.3.18, 8.3.19 и выше) могут быть свои нюансы в работе с расширениями, в том числе при программном изменении форм и управлении правами.

7. Неправильная связь реквизита объекта с реквизитом формы. Если реквизит создан в расширении, а форма заимствована, но реквизит формы Объект (или его аналог) не перенесен в расширение или не настроен корректно, может возникнуть проблема с отображением.

8. Отсутствие колонок для табличной части. Как общий принцип, если вы программно добавляете табличную часть в расширении и она не отображается, убедитесь, что вы также программно добавляете в нее хотя бы одну колонку. Без колонок табличная часть может быть невидима, даже если сам элемент табличной части создан. Этот принцип можно экстраполировать на другие сложные элементы.

Пошаговое решение проблемы

Теперь, когда мы понимаем потенциальные причины, давайте разберем по шагам, как правильно добавить флажок на форму документа через расширение и устранить возможные проблемы.

1. Шаг 1: Добавление реквизита документа в расширение

   Прежде всего, убедитесь, что вы добавили необходимый реквизит в сам объект документа (например, ЗаказПокупателя) в вашем расширении.

   Для нашего примера это реквизит Опл_РазрешитьОтгрузку типа Булево. Убедитесь, что он добавлен именно к тому объекту, форму которого вы расширяете. Если этого не сделать, то программно созданный элемент формы не сможет связаться с данными и не будет отображен.

2. Шаг 2: Программное добавление элемента формы

   Используем обработчик события формы, который выполняется на сервере, например, ПриСозданииНаСервереПосле или ПриСозданииНаСервере. Это гарантирует, что элемент будет создан до того, как форма будет полностью сформирована на клиенте.

   Скопировать код

   
   &НаСервере
   Процедура Опл_ПриСозданииНаСервереПосле(Отказ, СтандартнаяОбработка)
       // Добавляем новый элемент формы типа "ПолеФлажка"
       НовыйЭлемент = Элементы.Добавить("Опл_ФлагРазрешитьОтгрузку", Тип("ПолеФормы"));
       
       // Указываем путь к данным - наш реквизит документа, добавленный в расширении
       НовыйЭлемент.ПутьКДанным = "Объект.Опл_РазрешитьОтгрузку";
       
       // Устанавливаем вид элемента как "ПолеФлажка"
       НовыйЭлемент.Вид = ВидПоляФормы.ПолеФлажка;
       
       // Явно устанавливаем видимость и доступность элемента
       НовыйЭлемент.Доступность = Истина;
       НовыйЭлемент.Видимость = Истина;
       
       // Опционально: задаем заголовок для флажка
       НовыйЭлемент.Заголовок = "Отгрузка разрешена";
   
       // Тестовое сообщение для проверки выполнения кода и наличия элемента на сервере
       Сообщить("Флажок 'Опл_ФлагРазрешитьОтгрузку' добавлен на серверной стороне!");
       
       // Для отладки можем вывести путь к данным
       Сообщить("Путь к данным для флажка: " + НовыйЭлемент.ПутьКДанным);
   КонецПроцедуры
   

   Обратите внимание на имя элемента: используйте уникальный префикс (например, Опл_) для всех добавляемых вами объектов, реквизитов и элементов формы в расширении, чтобы избежать конфликтов с основной конфигурацией. Это хорошая практика разработки. Для стандартизации кода можно использовать модуль расширения со стандартизированными функциями добавления элементов формы.

   Как мы видим из обсуждения, важно убедиться, что код действительно выполняется. Тестовое сообщение Сообщить() поможет вам в этом на этапе отладки.

3. Шаг 3: Корректное размещение элемента на форме

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

   Рекомендуем явно указать родительскую группу при добавлении или после него, используя метод Элементы.Переместить():

   Скопировать код

   
   &НаСервере
   Процедура Опл_ПриСозданииНаСервереПосле(Отказ, СтандартнаяОбработка)
       НовыйЭлемент = Элементы.Добавить("Опл_ФлагРазрешитьОтгрузку", Тип("ПолеФормы"));
       НовыйЭлемент.ПутьКДанным = "Объект.Опл_РазрешитьОтгрузку";
       НовыйЭлемент.Вид = ВидПоляФормы.ПолеФлажка;
       НовыйЭлемент.Доступность = Истина;
       НовыйЭлемент.Видимость = Истина;
       НовыйЭлемент.Заголовок = "Отгрузка разрешена";
   
       // Перемещаем элемент в нужную группу
       // Предполагаем, что на форме есть группа с именем "ГруппаОсновное"
       // Вы можете выбрать любую подходящую группу, например, ГруппаДополнительныеРеквизиты
       Если Элементы.Найти("ГруппаОсновное") <> Неопределено Тогда
           Элементы.Переместить(НовыйЭлемент, Элементы.ГруппаОсновное);
       Иначе
           // Если основной группы нет, можно попробовать добавить в корень или другую известную группу
           Сообщить("Группа 'ГруппаОсновное' не найдена. Элемент добавлен в корень формы.");
       КонецЕсли;
   
       Сообщить("Флажок 'Опл_ФлагРазрешитьОтгрузку' добавлен и перемещен.");
   КонецПроцедуры
   

   Убедитесь, что группа, в которую вы перемещаете элемент (например, ГруппаОсновное), существует и доступна на форме. Иначе метод Переместить() может вызвать ошибку или не привести к желаемому результату.

4. Шаг 4: Настройка прав доступа к новому реквизиту

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

   Пошаговая настройка прав в расширении:

   1. Импортируйте роли в расширение: Откройте ваше расширение в конфигураторе. В дереве объектов расширения найдите ветку "Роли". Щелкните правой кнопкой мыши и выберите "Добавить в расширение" -> "Роли". Заимствуйте необходимые роли из основной конфигурации, которые имеют доступ к документу ЗаказПокупателя. Обычно это роли Пользователь, АдминистраторСистемы, ПолныеПрава или другие специфические роли, используемые в вашей системе.
   2. Настройте права на реквизит: Для каждой заимствованной роли откройте её свойства. Перейдите на вкладку "Права". Найдите в списке объектов наш расширенный документ (например, Документ.ЗаказПокупателя_Расширение1). Разверните его и найдите наш новый реквизит Опл_РазрешитьОтгрузку. Установите флажки "Просмотр", "Чтение" и "Изменение" для этого реквизита. Без этих прав элемент не будет виден или будет недоступен.
   3. Проверьте флажок "Устанавливать права для реквизитов и табличных частей": В свойствах каждой заимствованной роли в расширении убедитесь, что установлен флажок "Устанавливать права для реквизитов и табличных частей" (или аналогичный, название может немного отличаться в разных версиях платформы). Этот флажок позволяет отдельно настраивать права на подчиненные объекты (реквизиты) и является ключевым для корректной работы с расширенными данными.
   4. Назначьте роль пользователю (если создали новую): Если вы создали в расширении новую роль, а не использовали заимствованные, убедитесь, что эта роль назначена соответствующим группам доступа в режиме 1С:Предприятия и, следовательно, пользователю, под которым вы тестируете функционал. Иногда после добавления новой роли в расширение требуется переназначить профили групп доступа или явно указать роль через конфигуратор для пользователей.
   5. Перепроверьте права в режиме Предприятия: Запустите 1С:Предприятие, зайдите под пользователем и проверьте его действующие права на документ и его реквизиты через стандартные средства (например, отчет по правам доступа). Убедитесь, что на реквизит Опл_РазрешитьОтгрузку у пользователя есть все необходимые права.

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

5. Шаг 5: Отладка и проверка жизненного цикла формы

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

   1. Установите точку останова в процедуре ПриСозданииНаСервереПосле. Запустите отладку и убедитесь, что переменная НовыйЭлемент успешно создается, имеет корректный ПутьКДанным (например, Объект.Опл_РазрешитьОтгрузку), Вид, Доступность и Видимость (все Истина).
   2. На этом же этапе проверьте коллекцию Элементы формы. Убедитесь, что ваш элемент присутствует в этой коллекции после его добавления. Вы можете использовать выражение типа ЭтаФорма.Элементы.Найти("Опл_ФлагРазрешитьОтгрузку") в окне отладчика.
   3. Переместитесь на клиентскую сторону (например, установите точку останова в процедуре ПриОткрытии). Снова проверьте коллекцию ЭтаФорма.Элементы. Если элемента нет, это указывает на то, что он был удален, скрыт или не передан на клиентскую сторону на этапе перехода от сервера к клиенту, или последующими обработчиками.

   Если элемент исчезает между серверным и клиентским этапом, внимательно изучите все обработчики, которые могут влиять на состав элементов формы (как в основной конфигурации, так и в других расширениях). Это могут быть процедуры ПриЗагрузкеДанныхИзНастроекНаСервере, ПередЗагрузкойДанныхИзНастроекНаСервере, ПриОткрытии и другие, которые могут изменять коллекцию элементов.

6. Шаг 6: Проверка версии платформы и режима совместимости

   Как уже упоминалось, механизм расширений постоянно развивается. В разных версиях платформы (например, в 8.3.15.1489, как у автора, или более новых 8.3.18, 8.3.19) могут быть свои нюансы в работе с расширениями, особенно касающиеся прав доступа и программного изменения форм. Убедитесь, что вы работаете на достаточно актуальной версии платформы, и если используются режимы совместимости, проверьте, не создают ли они проблем с новыми механизмами расширений.

7. Шаг 7: Очистка кэша и переподключение расширения

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

   1. Очистите кэш 1С: Для этого можно удалить папки кэша из профиля пользователя (обычно находятся в %AppData%\1C\1CE\ и %LocalAppData%\1C\1CE\) или использовать утилиту 1cestart.exe /ClearCache.
   2. Удалите и заново добавьте расширение: В режиме 1С:Предприятия перейдите в "Администрирование" -> "Печатные формы, отчеты и обработки" -> "Расширения". Удалите ваше расширение, затем добавьте его заново из файла.
   3. Перезапустите 1С:Предприятие: Всегда перезапускайте клиентское приложение после внесения существенных изменений в расширение или его подключение/отключение. Для регулярного технического обслуживания нескольких баз удобно автоматизировать архивирование и тестирование 1С с помощью специальной программы.

8. Шаг 8: Общий принцип: добавление связанных элементов

   Помните, что для сложных элементов, таких как табличные части, может потребоваться не только создание самого элемента, но и добавление его составных частей. Например, если вы программно добавляете табличную часть в расширении и она не отображается, убедитесь, что вы также программно добавляете в нее хотя бы одну колонку. Без колонок табличная часть может быть невидима, даже если сам элемент табличной части создан. Этот принцип может быть полезен и для других составных элементов формы. Для более детального изучения работы с динамическими элементами подойдёт обработка с примером динамического создания и удаления элементов формы.

Следуя этим шагам и внимательно отлаживая ваш код, вы сможете успешно программно добавлять реквизиты на формы документов через расширения в 1С:Предприятие 8.3. Наиболее частой причиной проблем является некорректная настройка прав доступа, поэтому всегда начинайте отладку с проверки этого аспекта.