Формирование документа Google Docs из шаблона используя Google Apps Script

25.08.20

Интеграция - WEB-интеграция

В статье опишу работу скрипта для формирования документа с публикацией по HTTP.

Вводные

  • Нужно сформировать документ со сложной версткой на основе шаблона.
  • Нужно дать возможность пользователям самим менять шаблоны
  • При возможности на использовать локально установленные программы

К написанию статьи подтолкнула статья по формированию договоров //infostart.ru/public/1132491/, в которой отсутствовал код скрипта и в самой обработке присутствовали ключи аутентификации "по умолчанию".

 

Решение

Общая схема

В качестве платформы использовал Google Docs потому что он доступен бесплатно для пользователей и у него есть API. Локальной альтернативой является ONLYOFFICE + OwnCloud, но в их API не разбирался.

 

Функциональное решение

Формирование документа по шаблону может быть реализовано вариантами

  • Копированием шаблона и замены строк (replace) определенного формата например {v8 ...} на нужные значения. В рамках Google Doc разобрался как менять на текст и на картинки.
  • Созданием пустого файла и объединением в нем элементов взятых из шаблона (merge), с дальнейшей заменой строк. Применяется если присутствует составные элементы таблицы и списки. В рамках Google Doc разобрался с таблицами, списки для первой версии реализации не критичны.
    • В рамках анализа решений просматривал вариант реализованный для word с применением переменных (1С:УНФ), но как выделяются области не вникал, если знаете как работает - пишите в комментарии, дополню статью для полноты картины.
  • Собрать кодом из элементов, но даже в документации рекомендуют собирать из элементов шаблона.

Запрос отправляю на фиксированный URL, POST запросом со списком замен или списком элементов и замен. Для получения структуры шаблона отправляю GET запрос на тот же URL.

Результатом работы будет на выбор:

  • индентификатор объекта с которым дальше взаимодействую через REST API
  • base64 кодированные бинарные данные PDF формата. Он нормально открывается MS Word и преобразуется в DOCX.

 

Описание работы со стороны Google

Документы Google Docs (как и скрипты) являются объектами в Google Drive, часть операций производятся через его API.

Нужно различать REST API к сервису и API предоставляемое сервисом для Google Script App, у второго функционал существенно шире.

Google Script App можно опубликовать в качестве web приложения или в рамках Google Cloud Platform (GCP), после неудачных попыток вызвать скрипт через Google Script App REST API (на сколько понял для нормальной работы нужно GSuite которого у меня нет) остановился на варианте с web приложением.

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

 

Права доступа

Работа со скриптом ведется под правами пользователя Google. Аутентификация может пройти через cookie или через токен доступа который формируется через Oauth запрос.  Для использования приложения нужно делегировать права пользователя web-приложению и Oauth приложению от которого выдан ключ на формирование токена.

Получение Auth0 токена описано в документации к УНФ https://its.1c.ru/db/metod81#content:7551:hdoc техническая составляющая в статье //infostart.ru/1c/articles/1247448/, для делегирования прав web приложению нужно запустить из браузера GET https://script.google.com/macros/s/{{script_id}}/exec и пройти процесс делегирования.

 
 Скриншот результата делегирования прав

 

В рабочих запросах указываю Bearer токен, полученный при POST https://www.googleapis.com//oauth2/v4/token c grant_type=authorization_code

 

Инструменты

  • Консоль управления скриптами с возможностью редактировать код https://script.google.com/
  • Тестировал с помощью Postman

 

Реализация скрипта

 
 Код скрипта

 

При публикации скрипта как web приложения можно использовать две точки входа, функции doGet и doPost  (документация), doGet отвечает за получение структуры шаблона по id, doPost за формирование файла из шаблона.

Ответ формируется через "ContentService.createTextOutput", он не поддерживает коды состояния HTTP, поэтому они вынесены в тело запроса, реализовано в обертке createResponse().

Создание файлов реализовано в

  • createDocFromTemplate() - создание через копию и замену
  • mergeDocFromTemplate() - создание нового и объединение

Замена реализована в функции replacesInElement(), .replaceText() и .findText() применим как к всему телу документа, так и к его элементам.

Масштабирование картинки под нужный размер реализовано в функции replaceTextToImageInElement(), картинка вставляется как addPositionedImage, есть вариант (не реализовывал) с вставкой в отдельную линию.

Для вставки картинок используется тип Blob для которого указывается MIMEType двоичных данных.

Объединение элементов реализовано в mergeElementsFromTemplate(), ограничения:

  • не реализовывал работу со списками и разделителями строк
  • не реализовывал работу с заголовком и подвалом

Для экспорта документа в PDF используется doc.getAs("application/pdf"), реализовано в base64ToBlob().

 

Варианты использования

Для формирования через копирование и замену:

Отправляю запрос POST https://script.google.com/macros/s/{{script_id}}/exec

 
 Пример тела запроса, в {{}} переменные Postman

 

Для формирования через объединение и замену:

Получаю структуру документа через GET https://script.google.com/macros/s/{{script_id}}/exec?templateDocId={{template_doc_id}}

 
 Пример ответа

 

Отправляю запрос POST https://script.google.com/macros/s/{{script_id}}/exec

 
 Пример тела запроса

 

При формировании списка идентификаторов элементов беру идентификаторы между элементами с "match": ["{v8 Область ..., подход аналогичен формированию по шаблону Word из УТ 11.

 

Итог

Получился универсальный с точки зрения места запуска и вариантов использования инструмент.

Репозиторий на GitHub (ссылка) \scripts\ReplaceDoc.js

Благодарю за внимание.

Google

См. также

WEB-интеграция Анализ продаж Системный администратор Программист Пользователь Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Управленческий учет Платные (руб)

Модуль "Подсистема интеграции AmoCRM с 1С" позволяет обеспечить единое информационное пространство, в котором пользователи могут эффективно управлять клиентской базой, следить за статусами сделок и поддерживать актуальность данных как в AmoCRM, так и в 1С.

60000 руб.

07.05.2019    34472    65    45    

26

WEB-интеграция Администрирование веб-серверов Платные (руб)

Веб-портал обеспечивает удобный доступ к конфигурации 1С:ITIL, 1С:ITILIUM, Управление IT-отделом 8 через интернет с любого устройства посредством браузера, увеличивая эффективность работы пользователей и снижая нагрузку на сервер. Быстрая инсталляция портала за пару часов, удобный и интуитивно понятный интерфейс и безопасность данных помогут упростить работу с порталом и ускорить выполнение бизнес-процессов компании.

128000 руб.

19.12.2023    2452    2    0    

9

Оптовая торговля Розничная торговля WEB-интеграция 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 Платные (руб)

Онлайн-заказ - это решение для автоматизации процесса оформления заказов на сайте в торговых организациях. Продукт обеспечивает легкое взаимодействие между компанией и клиентами через веб-интерфейс, интегрированный с 1С:Предприятие. Система позволяет снизить операционные расходы, повысить лояльность клиентов и оптимизировать работу отдела продаж.

57600 руб.

26.11.2024    2187    1    1    

4

Сайты и интернет-магазины WEB-интеграция Системный администратор Программист Пользователь Платформа 1С v8.3 1C:Бухгалтерия 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

Интеграционный модуль обмена между конфигурацией Альфа Авто 5 и Альфа Авто 6 и порталом AUTOCRM. Данный модуль универсален. Позволяет работать с несколькими обменами AUTOCRM разных брендов в одной информационной базе в ручном и автоматическом режиме.

36000 руб.

03.08.2020    18974    21    22    

18

WEB-интеграция Программист Руководитель проекта Платформа 1С v8.3 1C:Бухгалтерия 1С:Франчайзи, автоматизация бизнеса Платные (руб)

Расширение значительно упрощает написание API на 1С. Веб программисты получают простой и понятный доступ к 1С. Описание API создаётся автоматически и представляется в виде удобном как для человека, так и для программной обработки.

24000 руб.

27.09.2024    3825    3    2    

4

WEB-интеграция Программист Платформа 1С v8.3 Бухгалтерский учет 1С:Бухгалтерия 3.0 Бытовые услуги, сервис Платные (руб)

Внешняя обработка разрабатывалась для загрузки документов из Ветменеджер в 1С: Бухгалтерия 3.0

12000 руб.

02.02.2021    18732    53    50    

29

WEB-интеграция Программист Бизнес-аналитик Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 1С:Розница 3.0 Оптовая торговля, дистрибуция, логистика ИТ-компания Платные (руб)

Модуль "Экспортер" — это расширение для 1С, предназначенное для автоматизации процессов выгрузки данных. Оно позволяет эффективно извлекать, преобразовывать и передавать данные из систем 1С в интеграционную платформу Spot2D. Подсистема упрощает настройку, снижает количество ручных операций и обеспечивает удобный контроль данных.

14400 руб.

20.12.2024    757    3    1    

5

Обмен с ГосИС WEB-интеграция Бухгалтер Пользователь Платформа 1С v8.3 Управляемые формы 1С:Комплексная автоматизация 1.х 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия государственного учреждения 1С:Документооборот 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Платные (руб)

Обработка является альтернативой механизму, разработанному фирмой 1С и заполняющему реквизиты контрагента по ИНН или наименованию. Не требуется действующей подписки ИТС. Вызывается как внешняя дополнительная обработка, т.е. используется, непосредственно, из карточки контрагента. Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС (egrul.nalog.ru) для БП 2.0, БП 3.0, БГУ 1.0, БГУ 2.0, УТ 10.3, УТ 11.x, КА 1.1, КА 2.x, УПП 1.x, ERP 2.x, УНФ 1.5, УНФ 1.6, УНФ 3.0, ДО 2.1

2400 руб.

28.04.2016    92807    188    217    

342
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. O_W 14.05.21 17:51 Сейчас в теме
Пожалуйста исправьте ошибку в заголовке на Google Docs
2. malikov_pro 1330 14.05.21 19:54 Сейчас в теме
(1) Не понял в чем ошибка.
3. xlmel 20.07.21 15:34 Сейчас в теме
Замечательная работа.
Оставьте свое сообщение