Расширение для УТ 11
Контроль обязательности реквизитов в документах УТ 11
Настраиваемые правила проверяют заполнение любых документов конфигурации перед проведением, показывают понятные сообщения и при необходимости запрещают проведение до исправления ошибок. Типовые сценарии — заказы клиентов и реализации.
| Конфигурация | УТ 11 | Формат поставки | Расширение |
| Документы | Любые документы конфигурации | Момент проверки | Проведение документа |
| Настройка | Без изменения документов | Тип контроля | Предупреждение или блокировка |
| Проверялось на | 1С:Предприятие 8.3.27.1936 | Версия УТ | 11.5.26.116 |
1. Задача расширения
В рабочем документе часто должны быть заполнены не только типовые обязательные поля, но и внутренние реквизиты компании: дата отгрузки, склад, контактное лицо, адрес доставки, комментарий складу, основание реализации или дополнительный реквизит.
Расширение позволяет администратору один раз описать такие требования в списке правил. При проведении документа система проверит его и сообщит пользователю, что именно нужно заполнить. Правило задаётся для конкретного вида документа — заказа, реализации, поступления, перемещения или любого другого, который есть в конфигурации.
Обычная запись документа без проведения не проверяется: незавершённый документ можно сохранить и продолжить позднее. При загрузке данных через обмен правила не применяются.
2. Что видит пользователь
Если при проведении найдены незаполненные обязательные поля, пользователь получает отдельные сообщения по каждому нарушенному правилу.
Сообщения о незаполненных обязательных реквизитах при попытке проведения заказа клиента.
Заполните желаемую дату отгрузки.
Укажите контактное лицо клиента.
Заполните комментарий складу.
| Режим | Результат | Действие пользователя |
|---|---|---|
| Блокировать | Документ не проводится. | Заполнить поле и повторить проведение. |
| Предупреждать | Сообщение показывается, документ проводится. | Проверить сообщение и при необходимости исправить документ. |
3. Список правил
Правила находятся в разделе «Администрирование», в списке «Правила контроля обязательности реквизитов(кор)». Размещение команды может отличаться, если в информационной базе настроена собственная командная панель раздела.
Список правил: документ, организация, порядок, дата начала, контролируемое поле, условие, режим нарушения и текст сообщения.
| Активно | Документ | Организация | Поле | Условие | Режим |
|---|---|---|---|---|---|
| [x] | Заказ клиента | Для всех | Дата отгрузки | Всегда | Блокировать |
| [x] | Заказ клиента | Торговый дом | Адрес доставки | Способ доставки не равен «Самовывоз» | Блокировать |
Флажок «Активно» позволяет временно отключить правило без удаления. Поле «Порядок» определяет последовательность правил и сообщений: сначала применяются правила конкретной организации, затем общие; внутри группы — по возрастанию порядка.
4. Создание правила
Откройте список правил, создайте новую запись и заполните четыре смысловых блока формы. При создании по умолчанию устанавливаются: источник — «Реквизит объекта», оператор условия — «Равно», режим проверки табличной части — «Хотя бы одна строка», режим нарушения — «Блокировать».
Карточка правила: область действия, контролируемое поле, условие применения и результат проверки.
| Область действия | |
| Активно | [x] |
| Документ | Заказ клиента |
| Организация | Не заполнено — правило для всех организаций |
| Порядок | 10 |
| Контролируемое поле | |
| Источник | Реквизит объекта |
| Путь реквизита | ДатаОтгрузки |
| Представление поля | Желаемая дата отгрузки |
| Условие применения | |
| Использовать условие | [ ] |
| Результат проверки | |
| Режим нарушения | Блокировать |
| Текст сообщения | Заполните желаемую дату отгрузки. |
Область действия
| Документ | Выбирается из списка всех документов конфигурации через форму выбора с поиском. Ручной ввод технического имени отключён. |
| Организация | Пустое поле означает правило для всех организаций. Заполненная организация ограничивает действие правила этой организацией. |
| Порядок | Число, определяющее последовательность применения правил и вывода сообщений. |
| Дата начала | Дата документа, начиная с которой применяется правило. Пустая дата начала означает, что ограничение по дате не действует. |
| Контролировать старые | Если флажок установлен, дата начала не ограничивает проверку: правило применяется и к старым документам. Если у документа не заполнена дата, правило применяется в любом случае. |
5. Выбор документа и контролируемого поля
Поле «Документ» заполняется через форму выбора со списком всех документов конфигурации и строкой поиска по имени и синониму. После выбора документа форма правила подготавливает списки реквизитов и дополнительных свойств, доступных именно для этого вида документа. При смене документа значения, которые больше не подходят, очищаются автоматически.
Форма выбора документа: список документов конфигурации и строка поиска по имени и синониму.
Источник определяет, где находится обязательное значение. Форма показывает только подходящие поля и свойства выбранного документа.
| Источник | Когда использовать | Что выбрать |
|---|---|---|
| Реквизит объекта | Поле шапки, колонки табличной части или вложенный реквизит ссылочного поля. | Путь реквизита, например «ДатаОтгрузки», «Товары.Склад» или «Контрагент.ИНН». |
| Дополнительный реквизит | Значение хранится непосредственно в документе. | Дополнительное свойство из списка, доступного для выбранного документа. |
| Дополнительное сведение | Значение хранится отдельно как дополнительное сведение. | Дополнительное свойство из отфильтрованного списка. |
Форма выбора реквизита
«Путь реквизита» выбирается из дерева по кнопке рядом с полем — вручную вводить техническое имя не требуется. Та же форма используется и для поля условия. Дерево группируется по разделам «Шапка» и табличным частям; для каждого поля показываются путь и тип.
Без поиска дерево всегда показывает три уровня вложенности: реквизиты шапки, колонки табличных частей и вложенные реквизиты ссылочных полей (например, «Контрагент.ИНН», «Товары.Номенклатура.Артикул»). Переключатель «Уровень поиска» ограничивает глубину только при вводе текста в строку поиска — на состав полного дерева он не влияет.
Форма выбора реквизита: строка поиска, переключатель «Уровень поиска» 1/2/3, полное дерево реквизитов с путями и типами.
| Возможность | Описание |
|---|---|
| Отображение дерева | Всегда три уровня: шапка, табличные части и вложенные реквизиты ссылок. Дерево собирается при открытии формы и кэшируется; при очистке поиска восстанавливается из кэша без повторной сборки на сервере. |
| Поиск | По имени, представлению, пути, разделу и типу. Несколько слов — все слова должны встречаться в реквизите. При вводе текста дерево автоматически разворачивается; при очистке строки поиска снова показывается полное дерево. |
| Уровень поиска (1 / 2 / 3, по умолчанию 2) | Действует только при активном поиске. 1 — реквизиты шапки; 2 — шапка и табличные части, без вложенных реквизитов ссылок; 3 — все уровни, включая «Контрагент.ИНН» и «Товары.Номенклатура.Артикул». Смена уровня без поиска дерево не меняет. |
| Развернуть / Свернуть | Управление отображением дерева. При повторном открытии форма позиционируется на ранее выбранном пути. |
Пример поиска: при уровне 2 запрос «ИНН» не найдёт «Контрагент.ИНН»; при уровне 3 — найдёт. Без поиска «Контрагент.ИНН» виден в дереве при любом выбранном уровне.
Служебные табличные части «Дополнительные реквизиты» и «Дополнительные сведения» в дереве не показываются — для них используются отдельные источники в правиле.
При выборе поля «Представление поля» заполняется его понятным названием. Это название используется в стандартном сообщении. Если собственный текст не задан, сообщение формируется в виде «Заполните: <представление поля>». Для пользователей обычно удобнее задать короткую инструкцию вручную, например «Укажите склад в каждой строке заказа».
6. Условия применения
Без условия правило действует всегда. Чтобы проверять поле только в определённой ситуации, установите флажок «Использовать условие» и выберите источник, поле, оператор и значение.
Пример: адрес доставки обязателен, если способ доставки не равен «Самовывоз».
Условие: Способ доставки → Не равно → Самовывоз. Контролируемое поле: Адрес доставки.
| Оператор | Назначение | Доступность |
|---|---|---|
| Заполнено, Не заполнено | Проверка наличия значения. | Для любых типов; значение условия не вводится. |
| Равно, Не равно | Сравнение с выбранным значением. | Для любых типов. |
| Больше, Больше или равно, Меньше, Меньше или равно | Сравнение величин. | Для чисел и дат. |
| Содержит | Поиск фрагмента текста. | Для строк. |
Список доступных операторов зависит от типа выбранного поля условия. Тип поля значения меняется автоматически: для даты вводится дата, для числа — число, для булева значения показывается отдельный флажок, для ссылок и перечислений используется штатный выбор 1С. Если дополнительное свойство имеет заданный набор значений, пользователь выбирает значение из этого набора.
7. Табличные части и вложенные пути
В качестве обязательного поля можно выбрать колонку табличной части, например «Товары.Склад». В этом случае нарушением считается наличие хотя бы одной строки, в которой выбранная колонка не заполнена. Путь может включать несколько уровней — например, «Товары.Номенклатура.Артикул»; такие пути доступны в полном дереве формы выбора. При поиске глубину можно сузить переключателем «Уровень поиска».
Если колонка табличной части используется в условии, появляется поле «Режим проверки табличной части».
| Режим | Когда условие считается выполненным |
|---|---|
| Хотя бы одна строка | Оператор выполнился минимум для одной строки. |
| Все строки | Оператор выполнился для каждой строки. |
Для пустой табличной части условие не выполняется в обоих режимах. Если нужно отдельно запретить документ без строк, это должно быть самостоятельным правилом или типовой проверкой документа.
8. Исключение для руководителя
Пользователю можно назначить роль «Проведение с предупреждением (кор)». Для него правила с режимом «Блокировать» продолжают показывать сообщения, но не запрещают проведение.
| Пользователь | Блокирующее правило нарушено |
|---|---|
| Менеджер без специальной роли | Получает сообщение, проведение отменяется. |
| Руководитель со специальной ролью | Получает предупреждение, проведение продолжается. |
9. Примеры правил
| Задача | Контролируемое поле | Условие | Режим |
|---|---|---|---|
| Дата отгрузки обязательна в заказе | Дата отгрузки | Без условия | Блокировать |
| Адрес нужен только при доставке | Адрес доставки | Способ доставки не равен «Самовывоз» | Блокировать |
| Склад указан во всех строках | Товары.Склад | Без условия | Блокировать |
| Заполнен внутренний комментарий | Дополнительный реквизит «Комментарий складу» | Без условия | Предупреждать |
| В реализации указано основание | Основание | Без условия | Блокировать |
| ИНН контрагента заполнен в заказе | Контрагент.ИНН | Без условия | Предупреждать |
10. Рекомендации по настройке
- Составьте короткий список действительно критичных полей.
- Создайте правила сначала в режиме «Предупреждать».
- Укажите дату начала, чтобы не затронуть старые документы.
- После периода работы с предупреждениями переведите критичные правила в режим «Блокировать».
- Для поиска вложенных реквизитов (например, «ИНН») установите уровень поиска 3; без поиска они видны в дереве сразу.
- Назначьте роль обхода только ответственным руководителям.
Не стоит сразу делать обязательными все потенциально полезные поля. Чем короче и понятнее список требований, тем реже пользователи вводят формальные значения только ради проведения документа.
Проверено на следующих конфигурациях и релизах:
- Управление торговлей, редакция 11, релизы 11.5.26.116
Вступайте в нашу телеграмм-группу Инфостарт