Изменение контента исходящих документов

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

Вы можете создать несколько правил, описать условия их срабатывания и логику работы.

Поддерживаемые сценарии

В плагине поддерживаются следующие сценарии:

ДополнительныеСведения

Позволяет заполнить ИнфПолФХЖ1 и ИнфПолФХЖ2 в AdditionalInfoId.

Возможные варианты заполнения:

  • Через визуальные настройки в отдельных таблицах для шапки и табличной части документа. Указывается имя и ссылка со значением дополнительного сведения, см. на скрине. В качестве значения будет регистр сведений «ДополнительныеСведения» или «Значения свойств объектов».

  • Через произвольный код, написанный в текстовом поле на 1С.

../_images/plaginIK_0.png

ЗаполнениеКодовОСУ

Заполняет код ОСУ в УПД и УКД, а также доп.сведение «СвВыбытияМарк».

В сценарии используется таблица значений «ТаблицаТоваров». Предзаполненные поля в таблице берутся из контента документа:

  • Номенклатура,

  • Характеристика,

  • Серия,

  • Упаковка,

  • ЕдиницаИзмерения,

  • Количество.

Для вычисления кода ОСУ заполните дополнительные колонки в этой таблице:

  • GTIN (Строка),

  • Числитель (Число или Неопределено),

  • Знаменатель (Число или Неопределено),

  • ПризнакОСУ (Булево или Неопределено),

  • КодТовара.

Примеры вариантов заполнения колонок можно посмотреть во вкладке «Выполняемый код».

КодТовара

Позволяет выбрать, откуда заполнять поле ItemVendorCode. Оно отвечает за формирование колонки Б в печатной форме УПД.

Возможные варианты заполнения:

  • Дополнительные сведения.

  • Реквизит справочника «Номенклатура».

  • Реквизит справочника «Характеристика номенклатуры».

  • Регистр сведений для хранения штрихкода.

  • Произвольный код.

ОснованиеОтгрузки

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

ОчисткаКолонок_2_4

Удаляет из табличной части Unit, UnitName, Price, Quantity (см. Item) для выбранных типов документов и перечисленных контрагентов. Эти поля отвечают за формирование колонок 2, 3, 4 в печатной форме УПД.

ОчисткаКонтактныхДанных

Удаляет банковские реквизиты, телефоны и email участников сделки: продавца, покупателя, грузоотправителя и грузополучателя.

СведенияОТранспортировкеИГрузе

Позволяет переопределить заполнение TransferTextInfo в коде на вкладке «Выполняемый код».

Строка5А

Добавляет текст «№ п/п» в документ отгрузки. Работает только для случаев, когда клиент на каждый документ реализации создает отдельный счет-фактуру. Для сводных счетов-фактур реализуется в подключаемом модуле.

УступочнаяНадпись

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

../_images/plaginIK_01.png

Общие настройки правил

Для каждого правила настраиваются:

  • Краткое описание, что делает это правило. Например, «Добавить номер заказа для ООО Ромашка».

  • Типы документов, для которых применимо это правило: акт, счет-фактура, ТОРГ-12, УПД.

  • Фильтр контрагентов. По умолчанию правило распространяется на всех контрагентов, но можно ограничить выбранными.

../_images/plaginIK_1.png

Выгрузка правил в файл и загрузка из файла

Примечание

Актуально в плагине с версии 0.6.3

Сохранять настройки плагина в файл и загружать из файла можно с помощью кнопок в главном окне плагина:

../_images/plaginIK_2.png

Список всех настроенных правил выгружается в формате «.json». Выгрузка используется для резервного копирования настроек.

Способы задания правил

Логика правил может быть задана:

  • Кодом.

  • Визуальной настройкой, если сценарий поддерживает ее. Например, добавление инфополей или кода товара.

  • В основном модуле без возможности изменения. Например, очистка контактных данных.

Написание кода и отладка

Для сценариев, в которых присутствует вкладка «Выполняемый код», есть шаблоны кода. Текст шаблона по умолчанию подставляется в поле «Выполняемый код» при создании нового правила. Например, так выглядит код для перезаполнения основания передачи:

ДоговорНаименование = ДокументРеализации.ДоговорКонтрагента.Наименование;  // договор-оферта №1234567 от 09.02.2021 (руб.)

Результат.Наименование = Строки_ЧастьДо(ДоговорНаименование, "№");
Результат.Номер = Строки_ЧастьМежду(ДоговорНаименование, "№", " от ");
Результат.Дата = Строки_ЧастьПосле(ДоговорНаименование, " от ");

Результат.ДопИнформация = ДокументРеализации.ДоговорКонтрагента.Комментарий;

Текст шаблона по умолчанию подставляется в поле «Выполняемый код» при создании нового правила.

В разделе «Подсказки по сценарию» описаны переменные, к которым можно обращаться в коде.

В разделе «Подсказки по используемым функциям» описаны функции, которые можно вызывать из кода, и примеры использования.

../_images/plaginIK_20.png

Для упрощения отладки возможно выполнять каждое правило отдельно и смотреть на результат. Для этого нужно:

  1. В общих настройках плагина, в разделе «Отладочные данные», поставьте флаг «Сохранить последний документ». Сохраните настройки.

../_images/plaginIK_3.png
  1. В модуле в режиме «1С:Предприятие» откройте интересующий документ для отправки в разделе «Для отправки». При открытии плагин запомнит его. Саму отправку делать не надо.

  2. Снова откройте настройки плагина. В разделе «Отладочные данные» появится ссылка на документ.

../_images/plaginIK_4.png
  1. В окне настройки правила нажмите на кнопку «Выполнить сценарий». Он будет применен для текущего документа. Нажмите на табло в нижней части формы, чтобы появился список переменных, которые были доступны коду сценария:

../_images/plaginIK_5.png
  1. Дважды кликните по нужной строке. Откроется окно «Браузер объектов». Здесь вы можете в пользовательском режиме просматривать поля составных и ссылочных переменных: таблиц значений, структур, справочников, ссылок на документы.

Обработка ошибок

Если при выполнении правила возникла ошибка, она добавится к ошибкам валидации модуля. Это обезопасит пользователя от отправки некорректно заполненных документов.

../_images/plaginIK_6.png