Изменение контента исходящих документов
Плагин позволяет вносить небольшие изменения в контент УПД без написания подключаемого модуля и доступа в конфигуратор. Например: добавить инфополя, удалить банковские реквизиты или перезаполнить основание передачи.
Вы можете создать несколько правил, описать условия их срабатывания и логику работы.
Поддерживаемые сценарии
В плагине поддерживаются следующие сценарии:
ДополнительныеСведения
Позволяет заполнить ИнфПолФХЖ1 и ИнфПолФХЖ2 в AdditionalInfoId.
Возможные варианты заполнения:
Через визуальные настройки в отдельных таблицах для шапки и табличной части документа. Указывается имя и ссылка со значением дополнительного сведения, см. на скрине. В качестве значения будет регистр сведений «ДополнительныеСведения» или «Значения свойств объектов».
Через произвольный код, написанный в текстовом поле на 1С.
ЗаполнениеКодовОСУ
Заполняет код ОСУ в УПД и УКД, а также доп.сведение «СвВыбытияМарк».
В сценарии используется таблица значений «ТаблицаТоваров». Предзаполненные поля в таблице берутся из контента документа:
Номенклатура,
Характеристика,
Серия,
Упаковка,
ЕдиницаИзмерения,
Количество.
Для вычисления кода ОСУ заполните дополнительные колонки в этой таблице:
GTIN (Строка),
Числитель (Число или Неопределено),
Знаменатель (Число или Неопределено),
ПризнакОСУ (Булево или Неопределено),
КодТовара.
Примеры вариантов заполнения колонок можно посмотреть во вкладке «Выполняемый код».
КодТовара
Позволяет выбрать, откуда заполнять поле ItemVendorCode. Оно отвечает за формирование колонки Б в печатной форме УПД.
Возможные варианты заполнения:
Дополнительные сведения.
Реквизит справочника «Номенклатура».
Реквизит справочника «Характеристика номенклатуры».
Регистр сведений для хранения штрихкода.
Произвольный код.
ОснованиеОтгрузки
Перезаполняет первое значение в массиве TransferBases. Позволяет разобрать на составные части строку из произвольного реквизита метаданных.
ОчисткаКолонок_2_4
Удаляет из табличной части Unit, UnitName, Price, Quantity (см. Item) для выбранных типов документов и перечисленных контрагентов. Эти поля отвечают за формирование колонок 2, 3, 4 в печатной форме УПД.
ОчисткаКонтактныхДанных
Удаляет банковские реквизиты, телефоны и email участников сделки: продавца, покупателя, грузоотправителя и грузополучателя.
СведенияОТранспортировкеИГрузе
Позволяет переопределить заполнение TransferTextInfo в коде на вкладке «Выполняемый код».
Строка5А
Добавляет текст «№ п/п» в документ отгрузки. Работает только для случаев, когда клиент на каждый документ реализации создает отдельный счет-фактуру. Для сводных счетов-фактур реализуется в подключаемом модуле.
УступочнаяНадпись
Заполняет текст уступочной надписи для выбранных типов документов и перечисленных контрагентов.
Общие настройки правил
Для каждого правила настраиваются:
Краткое описание, что делает это правило. Например, «Добавить номер заказа для ООО Ромашка».
Типы документов, для которых применимо это правило: акт, счет-фактура, ТОРГ-12, УПД.
Фильтр контрагентов. По умолчанию правило распространяется на всех контрагентов, но можно ограничить выбранными.
Выгрузка правил в файл и загрузка из файла
Примечание
Актуально в плагине с версии 0.6.3
Сохранять настройки плагина в файл и загружать из файла можно с помощью кнопок в главном окне плагина:
Список всех настроенных правил выгружается в формате «.json». Выгрузка используется для резервного копирования настроек.
Способы задания правил
Логика правил может быть задана:
Кодом.
Визуальной настройкой, если сценарий поддерживает ее. Например, добавление инфополей или кода товара.
В основном модуле без возможности изменения. Например, очистка контактных данных.
Написание кода и отладка
Для сценариев, в которых присутствует вкладка «Выполняемый код», есть шаблоны кода. Текст шаблона по умолчанию подставляется в поле «Выполняемый код» при создании нового правила. Например, так выглядит код для перезаполнения основания передачи:
ДоговорНаименование = ДокументРеализации.ДоговорКонтрагента.Наименование; // договор-оферта №1234567 от 09.02.2021 (руб.)
Результат.Наименование = Строки_ЧастьДо(ДоговорНаименование, "№");
Результат.Номер = Строки_ЧастьМежду(ДоговорНаименование, "№", " от ");
Результат.Дата = Строки_ЧастьПосле(ДоговорНаименование, " от ");
Результат.ДопИнформация = ДокументРеализации.ДоговорКонтрагента.Комментарий;
Текст шаблона по умолчанию подставляется в поле «Выполняемый код» при создании нового правила.
В разделе «Подсказки по сценарию» описаны переменные, к которым можно обращаться в коде.
В разделе «Подсказки по используемым функциям» описаны функции, которые можно вызывать из кода, и примеры использования.
Для упрощения отладки возможно выполнять каждое правило отдельно и смотреть на результат. Для этого нужно:
В общих настройках плагина, в разделе «Отладочные данные», поставьте флаг «Сохранить последний документ». Сохраните настройки.
В модуле в режиме «1С:Предприятие» откройте интересующий документ для отправки в разделе «Для отправки». При открытии плагин запомнит его. Саму отправку делать не надо.
Снова откройте настройки плагина. В разделе «Отладочные данные» появится ссылка на документ.
В окне настройки правила нажмите на кнопку «Выполнить сценарий». Он будет применен для текущего документа. Нажмите на табло в нижней части формы, чтобы появился список переменных, которые были доступны коду сценария:
Дважды кликните по нужной строке. Откроется окно «Браузер объектов». Здесь вы можете в пользовательском режиме просматривать поля составных и ссылочных переменных: таблиц значений, структур, справочников, ссылок на документы.
Обработка ошибок
Если при выполнении правила возникла ошибка, она добавится к ошибкам валидации модуля. Это обезопасит пользователя от отправки некорректно заполненных документов.
