Инструмент реализован для создания, загрузки и отправки трансмитталов (TRM/Transmittal). Представляет собой функционал по автоматическому созданию zip-архива, содержащего выбранные файлы документов комплекта и отдельный файл с подробными сведениями о направляемых документах. Документы добавляются в TRM из тех документов, которые есть в системе Pilot. TRM формируется на основе шаблона, оформленного с помощью макросов.
¶ Описание файла шаблона и макросов трансмиттала
Файл шаблона нужен для формирования и загрузки TRM, так как по указанным в нём макросам программа записывает информацию о документах и их файлах, о самом TRM-документе в xlsx-файл при формировании TRM (формирование исходящего трансмиттала), и, в то же время, распознаёт куда занести значения атрибутов документа и файлы и самого TRM-документа при его загрузке (разбор входящего трансмиттала).
Для работы с трансмитталом (TRM) необходимо создать в Pilot элемент шаблон с прикреплённым в нём xlsx-файлом шаблона формирования TRM. Пример такого файла можно взять в архиве с дистрибутивом модуля (файл «Generate TRM Template».xlsx)
Файл шаблона формирования трансмиттала (TRM) содержит макросы, описывающие сам TRM-элемент и документы с файлами. Файл шаблона визуально делится на две части:
- верхняя часть - это "шапка" шаблона, описывающая сам трансмиттал (TRM)
- нижняя часть - таблица, названия колонок которой это названия атрибутов документов и файлов, связанных с этим TRM.
Шаблон должен отвечать следующим требованиям:
- макросы в шаблоне оформляются в соответствии с правилами формирования макросов, описанными в главе Макросы настоящего руководства пользователя;
- макросы для заполнения шапки шаблона TRM могут быть расположены c 1 строчки и до строчки содержащей макросы, отвечающие за табличную часть;
- макросы, отвечающие за табличную часть, могут быть только для атрибутов типа, выступающего в качестве документа и пользовательские;
- колонки таблицы, расположенные после колонок с макросами, должны быть пустыми;
- перед началом импорта данных файл шаблона должен быть закрыт.
Рис. 25 Пример шаблона для формирования трансмиттала
¶ Создание шаблона TRM в Pilot
- В Pilot в дереве проекта открыть папку «Шаблоны» и нажать на кнопку на панели инструментов Создать Шаблон Excel
- В открывшемся окне создания ввести название в поле Наименование.
- В правой нижней части обозревателя перейти на вкладку «Файлы», нажать кнопку «Добавить исходный файл» и выбрать файл шаблона TRM.
- В поле «Номер строки начала таблицы» нужно ввести номер строки xlsx-шаблона, на которой введены макросы для атрибутов документов и файлов, связанных с объектом TRM.
Для разных типов документа могут быть созданы разные шаблоны. По умолчанию модулем используется шаблон с наименованием «Generate TRM Template», в том числе в случае когда стандартная конфигурация не была добавлена в общих настройках.
Для загрузки входящего трансмиттала (TRM) нужно использовать тот же самый шаблон, что и для формирования исходящего: для обновления значений атрибутов и файлов.
Рис. 26. Окно создания шаблона TRM
¶ Алгоритм создания TRM
- Перейти к комплекту: в Pilot в дереве проекта выбрать необходимый проект и комплект. На панели инструментов нажать кнопку «Создать», из предложенных вариантов выбрать «TRM».
- Выбрать тип TRM
- Опционально выбрать шаблон TRM. Если оставить поле выбора незаполненным, то будет использован тот шаблон, название которого прописано в конфигурации общих настроек модуля, или шаблон с наименованием «Generate TRM Template» в случае когда конфигурация модуля не была добавлена в общих настройках.
- Заполнить необходимые поля, нажать кнопку «Создать».
Для того чтобы сформировать TRM и отправить TRM, необходимо выбрать тип Исходящий в карточке создания трансмиттала.
Рис. 27 Окно создания TRM
¶ Работа с исходящим трансмитталом. Формирование TRM
После создания объекта TRM типа «Исходящий» нужно связать этот трансмиттал во вкладке «Связи» нажатием кнопки «Добавить» с документами, файлами или папками, которые будет содержать в себе сформированный TRM.
Чтобы сформировать TRM, на панели инструментов нужно нажать кнопку Сформировать TRM. Откроется окно выбора файлов, которые попадут в сформированный TRM. Это могут быть файлы документов (из вкладки документа «Файлы») типа pdf или всех типов, связанные с документом файлы (из вкладки документа «Связи») типа pdf или всех типов и исходные файлы. Затем нажать в окне на кнопку «Сформировать». В правой нижней части обозревателя проекта во вкладке «Файлы» появятся файл формата .xlsx и .zip с данными сформированного трансмиттала. В сформированном .zip находятся файлы документов, связанных с данным объектом TRM, и .xlsx файл, содержащий сведения о документах и их файлах. Последняя колонка .xlsx файла - имя соответствующего файла в архиве.
Рис. 28 Формирование TRM
Рис. 29 Сформированный Excel и .zip с данными TRM
¶ Работа с исходящим трансмитталом. Отправка TRM по почте
¶ Создание шаблона письма
Для отправки TRM по почте необходимо чтобы был создан общий шаблон письма в папке «Шаблоны» (пример можно взять в архиве с дистрибутивом модуля). Чтобы создать общий шаблон письма нужно:
- Оформить шаблон письма используя макросы (подробнее в главе Макросы настоящего руководства пользователя). Сохранить файл в формате .eml. Для получения шаблона письма в формате .eml можно воспользоваться почтой. Например, в Google-почте открыть письмо, нажать на 3 точки в правом верхнем углу и выбрать «<> Показать оригинал». Затем, в открывшейся вкладке, нажать на «Скачать оригинал».
Рис. 30 Загрузка сообщения для шаблона
- В Pilot в дереве проекта открыть папку «Шаблоны». Выбрать на панели инструментв Создать Шаблон письма. В открывшемся окне создания ввести наименование. По умолчанию модулем используется шаблон с наименованием «EMail TRM Template», в том числе в случае когда стандартная конфигурация не была добавлена в общих настройках. Добавить через кнопку «Добавить исходный файл» шаблон письма в формате .eml, созданный в предыдущем шаге. Нажать на "Создать"
Помимо общего шаблона можно создать другие шаблоны письма, при необходимости используя макросы.
Рис. 31 Создание шаблона письма
¶ Отправка по почте
Кнопка «Отправка TRM» находится в меню инструментов объекта типа TRM, под кнопкой «Сформировать TRM». Становится доступна, если значение атрибута «Тип» объекта TRM «Исходящий». При нажатии на кнопку производится поиск шаблона по следующем правилам:
- Если у компании, указанной в поле «Кому» во вкладке «Связи» нет связи с Шаблоном письма, то будет браться общий шаблон.
- Если ни один шаблон не найден - будет выдана соответствующая ошибка, в случае если шаблон найден на его основе будет формироваться eml файл (файл электронного письма).
Файл содержит следующие сведения:
- вложения: zip и xlsx файлы, связанные с текущим документом TRM;
- тему письма: строится на основе темы письма шаблона (может содержать макросы);
- текст письма: строится на основе текста письма шаблона (может содержать макросы);
- получателя: состоит из 2х атрибутов: ФИО Получателя и E-mail получателя (обязательный в данной паре).
¶ Загрузка TRM
Для загрузки TRM необходимо, чтобы TRM имел тип «Входящий». Кнопка «Загрузить TRM» находится в меню инструментов объекта типа TRM.
Во вкладке «Файлы» должны быть приложены 2 документа: zip-архив с загружаемыми файлами и xlsx-файл шаблона загрузки, в котором указаны атрибуты файлов из zip-архива. Если ячейки атрибутов самого TRM из шапки xlsx-шаблона заполнены, то обновятся соответствующие атрибуты TRM.
В случае, если .xlsx файл не прошел валидацию, будет открыта временная папка с данным файлом. В правой колонке не прошедшего валидацию файла будут проставлены статусы (ошибки).
Рис. 32 Кнопка загрузки входящего трансмиттала
¶ Действия, производящиеся в результате загрузки/распаковки TRM в систему
- Если документ с указанным обозначением не найден в комплекте, то в этом комплекте будет создан документ с данным обозначением, и к нему будет подвязан исходный файл, указанный в .xlsx файле. Созданный документ будет подвязан к документу TRM.
- Если документ с указанным обозначением найден в комплекте и подвязан к TRM, то его исходный файл будет обновлен файлом, указанным в xlsx файле.
- Если документ с указанным обозначением найден в комплекте и не подвязан к TRM, то исходный файл данного документа будет обновлен, а сам документ подвязан к документу TRM.
- Подвязанные к трансмитталу документы, о которых не было сведений в .xlsx файле, будут отвязаны от TRM.
¶ Различия Web-редакции
¶ Формирование TRM
В веб редакции кнопка «Сформировать TRM» открывает аналогичное окно с параметрами, как и в Desktop-редакции. После нажатия кнопки "Сформировать" в появившимся окне, будет создано фоновое задание, а не открыто окно прогресса.
Фоновое задание создается в папке типа Фоновые задания, если данной папки нет - будет выведена соответствующая ошибка, если папок несколько - задание будет создано в первой папке. После создания фонового задания во вкладке “Связи” созданного фонового задания будет находиться соответствующий TRM. После того как фоновое задание будет успешно выполнено на соответствующем TRM во вкладке “Файлы” появится xlsx и zip файл (если данные файлы уже были до запуска фонового задания, то они будут перезаписаны). Как управлять фоновым заданием смотрите в главе Фоновые задания данного руководства пользователя.
¶ Загрузка TRM
Кнопка «Загрузить TRM» создает фоновое задание, а не открывает окно прогресса как это реализовано в desktop-редакции.
Фоновое задание создается в папке типа Фоновые задания, если данной папки нет - будет выведена соответствующая ошибка, если папок несколько - задание будет создано в первой папке. После создания фонового задания во вкладке “Связи” созданного фонового задания будет находиться соответствующий TRM. Как управлять фоновым заданием смотрите в главе Фоновые задания данного руководства пользователя.