Настройки конвертации документов

Используется справочник «КонтурЛогистика_НастройкиКонвертацииДокументов».

Каждый элемент этого справочника объясняет подсистеме каким образом требуется вводить конкретный логистический титул (документ подсистемы) из учетного документа основной конфигурации. Или наоборот, как вводить/находить/дополнять документ основной конфигурации из логистического титула (документа подсистемы).

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

Как открыть

Настройки конвертации документов можно открыть одним из вариантов:

• На рабочем столе нажмите на кнопку «Настройки» → «Конвертация документов (титулов)».

  

• Панель разделов → Контур.Логистика → настройка «Конвертация документов» в блоке «Настройки».

  

• В меню «Все функции» откройте справочник «Настройки конвертации документов (Контур.Логистика)».

  

Список настроек конвертации документов

Каждый элемент справочника — это настройка одной связи между документом основной конфигурации и документом Логистики (титулом), в списке это колонки «Учетный Документ (Тип)» и «Документ Логистика (Тип)». Также в списке выведены колонки «Направление конвертации» (что из чего вводим) и «Сценарий» — это тоже ключевые поля настроек конвертации.

Карточка настройки конвертации документа

Чтобы открыть карточку настройки конвертации документа, в списке настроек конвертации нажмите дважды на нужную строку документа.

Ключевой реквизит «ТипДокументаЛогистика» — показывает к какому документу подсистемы относится настройка (что будем вводить или из чего в зависимости от того исходящий или входящий титул ЭПД).

Ключевой реквизит «ТипДокумента1С» — показывает какой документ основной конфигурации ассоциирован с титулом (из какого документа типовой конфигурации будем вводить титул/какой будем связывать по входящему титулу). Может быть пустым — означает, что логистический документ будет вводиться из предыдущего логистического документа цепочки. Например, Титул 2 (перевозчика) может вводиться на основании полученного (от грузоотправителя) Титула 1 без участия документа основной конфигурации.

Ключевой реквизит «Родитель» — позволяет организовать иерархию настроек конвертации документа. Иерархия используется, когда алгоритм конвертации отличается в зависимости от типа дополнительного документа, участвующего в заполнении логистического документа-титула. Например, титул 1 ЭТрН вводится из документа основной конфигурации Транспортная накладная, у которой в качестве документа основания может быть как Реализация, так и Перемещение (Реализация и Перемещение в этом примере — это и есть Дополнительный документ). Алгоритм заполнения титула различный для этих дополнительных документов.

Настройка «Выбор направления конвертации» — определяет в каком направлении будет идти конвертация: из 1С в Логистику, из Логистики в 1С или в обоих направлениях:

• Выберите «Учетный документ → Документ Логистика», если вы собираетесь отправлять исходящие ЭПД, созданные на основании учетного документа основной конфигурации.
• Выберите «Документ Логистика → Учетный документ», если на этом этапе обработки ЭПД вы будете загружать этот тип титула и обрабатывать его (или без обработки). Под обработкой понимается поиск/создание и заполнение/дополнение учетного документа основной конфигурации из реквизитов ЭПД.
• В сложном сценарии, когда требуется и отправка, и получение, выберите «Учетный документ <-> Документ Логистика».

Важный реквизит «Сценарий» — с учетом выбранного направления конвертации, уточняет, как требуется обрабатывать документы:

• Отправка.
• Загрузка, Обработка.
• Загрузка. Не обрабатывать.
• Получение черновика — Отправка подписанного.
• Получение черновика, Обработка — Редактирование, Отправка подписанного.
• Получение черновика, Обработка — Редактирование, Отправка черновика.
• Отправка черновика - (сервис: редактирование, подтверждение) - Загрузка изменений.
• Обработка — редактирование, Отправка подписанного.

Ключевой реквизит «Действие с документом по умолчанию» — с учетом выбранного направления конвертации, уточняет, какое действие с документом будет выведено пользователю как основное:

• Отправить черновик в фоне.
• Отправить черновик.
• Подписать и отправить.
• Подписать, отправить в фоне.
• Создать черновик.
• Обработать.

Блок «Возможности» (внешний вид зависит от выбранного направления) — определяет базовые особенности поведения документов-титулов: какое поведение будет по умолчанию, можно ли отправлять неподписанный титул, можно ли отправлять фоновым заданием. Для входящих и исходящих отображается по-разному.

Блок «Настройки»

Содержит страницы с отдельными вкладками настроек, ответственными за:

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

Вкладка «Основные»

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

Вкладки «Маппинг: /Главный документ(для ЭТРН) /ДокументТитул /Таб. часть Товары /Прочие таб. части» — позволяют в режиме конструктора собрать наполнение реквизитов логистического документа из документа основной конфигурации.

Содержат колонки:

• «Реквизит титула» — какой реквизит логистического документа заполняем.
• «Комментарий» — описание реквизита логистического документа.
• «Тип значения» — Значение какого типа ожидается в этом реквизите после выполнения вычисления (в том числе после выполнения конвертации).
• «Способ маппинга» — определяет как будем рассчитывать реквизит, доступно несколько типовых вариантов, например, Реквизит документа основания — из документа основания (основной конфигурации).
• «Выражение вычисления» — работает в связке с предыдущей колонкой и уточняет расчет. Например, при способе маппинга Реквизит документа основания, здесь указывается из какого конкретно реквизита документа основания нужно извлечь значение (можно ходить «через точку»).
• «Способ конвертации» — поручает механизму преобразовать (через установленные соответствия) рассчитанное значение в справочник логистики.
• Ошибки заполнения (не указано выражение вычисления при указанном способе) подкрашиваются красным текстом.
• Редактирование «Вычисления выражения» доступно через отдельную форму-помощник, где удобно выбрать и способ расчета и выражение вычисления.

  

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

Пример при вводе титула 1 ЭТрН из документа «УчетнаяСистема_ТранспортнаяНакладная»:

Реквизит тилула1 — «Водитель», с типом значения — «Сотрудники и физические лица (Контур.Логистика)», вычисляется как «Реквизит документа основания» из реквизита «ЗаданиеНаПеревозку» (реквизит документа «УчетнаяСистема_ТранспортнаяНакладная» основной конфигурации) и «через точку от него» реквизит «Водитель».

После чего, это значение через соответствия, указанные в справочнике «КонтурЛогистика_Сотрудники», заменяется на соответствующий элемент справочника «КонтурЛогистика_Сотрудники» и подставляется в документ Титул 1.

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

Вкладка «Реквизиты» (для входящих титулов ЭПД) — используется для задания конвертации реквизитов и обработки заполнения документа основной конфигурации из ЭПД.

• Доступна только для входящих титулов ЭПД.
• Аналогично вкладкам Маппинга дает сконструировать заполнение реквизитов документа с некоторыми особенностями (связанными с тем что направление конвертации встречное).
• Доступны:
  • формирование структуры параметра для метода ОбработкаЗаполнения,
  • маппинг реквизита документа,
  • выполнение произвольного кода (Выполнить обработчик).

Вкладка «Переменные» — позволяет в процессе заполнения документа Логистики вычислить промежуточные значения и использовать их для упрощения выражений вычисления реквизитов на вкладках маппинга (предыдущие этой инструкции пункты).

• Вы сможете обращаться к ним в настроке конвертации конкретного реквизита через «Переменные.<Имя>».
• Рекомендуется сложные обработчики выносить в отдельные расширения и здесь только вызывать их.

Вкладка «Документ учетной системы» — служит для настройки поиска учетного документа основной конфигурации по входящему (полученному из сервиса) логистическому документу или при вводе нового титула из предыдущего. Например, как искать документ-поступление основной конфигурации при вводе Титула 3 (приемка) грузополучателем или как при оформлении техосмотре путевого листа сослаться на тот же исходный документ-основание, что и был для певого титула путевого листа.

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

Можно задать дополнительный алгоритм определения Дополнительных Докумнетов оснований для случая, когда один логистический документ вводится на основании нескольких докумнетов-оснований. Для активации этого механизма требуется дополнительно включить общую настройку, например, для Т1 ЭТРН:

Блок «Валидации»

• Можно написать свои собственные (кастомные) проверки, препятствующие отправке титула.
• Их можно включать или отключать.
• Если они сработают, то попадут в общую с другими валидациями зону индикации ошибок.
• В примере: выключена валидация, следящая за тем, чтобы документ-основание был проведен, и включена валидация, чтобы в нем был установлен флажок «ЕстьРазрешение» (предполагается, что в процессе оформления есть некий флажок, разрешающий отгрузку и без него нельзя отправлять документ).

Копирование сделанных настроек

Рекомендуем выгружать сделанные настройки при помощи обработки «КонтурЛогистика_ВыгрузкаЗагрузкаНастроек». Для этого:

1. В панели разделов 1С нажмите «Контур.Логистика» → «Выгрузка и загрузка настроек (Контур.Логистика)».
    

   

   
   Либо в меню «Все функции» обработка «Выгрузка и загрузка настроек (Контур.Логистика)».

   

2. На вкладке «Выгрузка» укажите путь до папки на компьютере, куда будет сохранен файл, и впишите имя файла выгрузки.

   

3. Выберите пункт «Настройки и объекты в настройках».
4. Отметьте все настройки выгрузки в разделе «Из каких справочников выгружать».

   

5. Для «Настройки (Контур.Логистика)» снимите галочку с элементов «Логин авторизации Диадок API» и «Пароль авторизации Диадок API».

   

6. Нажмите на кнопку «Выгрузить настройки». В указанную папку будет выгружен файл в формате JSON.

Если настройки будут случайно испорчены, вы сможете восстановить их из файла выгрузки на вкладке «Загрузка».

Что делать, если не появляются или появляются не все задачи на Титул 1

Если не появляются или появляются не все задачи на Титул 1, хотя сделана настройка конвертации, то для решения проблемы проверьте:

• Выполнение главного условия построения списка задач — организация и перевозчик (контрагент) в 1С для документа ЭТрН должны быть сопоставлены с организациями из справочника «Организации Диадок».
• Выбран верный период задач и отборы в списке.

  

• Признак — выводить в списке задач все или только проведенные документы. Если выбран «Только проведенные», тогда в списке будет отсутствовать ЭТрН на основании непроведенной Транспортной накладной в 1С.