Zina Docs Generator Library
Система на основе Google Apps скриптов для создания документов по шаблону из данных в Google таблицах.
Генератор документов состоит из четырех типов файлов:
- библиотека Zina Docs Generator Library
- таблица Google Sheets с данными и подписанными заголовками столбцов;
- скрипт, основанный на библиотеке — подключается к таблице
- шаблон Google Docs (один или несколько, указываются в скрипте), на основе которых скрипт будет создавать документы.
- Создаем таблицу Google Sheets или используем существующую — например, ту, в которую сохраняются данные из Google Form.
- В первой строке таблицы пишем названия столбцов — типа «Название компании». Это чисто для себя, чтобы удобней было ориентироваться.
- Во второй строке пишем по-английски и без пробелов заголовки столбцов — они же подстановки, которые будут использоваться в шаблонах документов — типа
COMPANY_NAME(регистр не имеет значения). - Создаем шаблон документа в Google Docs (т.е. просто новый документ Google Docs) и вставляем в него подстановки для последующей замены. Подстановки обязательно писать в фигурных скобках типа
{COMPANY_NAME}. - Возвращаемся в таблицу, меню Tools — Script editor и добавляем код скрипта из примера
- Правим в коде переменные в блоке настроек в верхней части. Как минимум:
- в строке
templates.pushпишем ID шаблона, - в строке
var patternsRowпишем номер строки в таблице, в которой находятся заголовки столбцов (в этом примере — 2).
- в строке
- Подключаем библиотеку: меню Resources — Libraries... — Add a library — вставляем ID нашей библиотеки Zina Docs Generator:
1G2L4fiwiM8MQ62Yc-aLktmbxTuOY4SHyoH-vCRRMbETUJQudh_vFYA5E
и выбираем версию (последнюю). - Выполняем один раз скрипт через кнопку Выполнить на панели инструментов — при этом в таблицу добавится пункт меню
Шаблоны.
После этого переходим в таблицу, кликаем по строке с данными, выбираем в меню Шаблоны — Создать документ из шаблона (это можно переименовать в начале скрипта) и появится окошко с предложением создать документ из шаблона.
Чтобы новый пользователь мог воспользоваться этим генератором, нужно предоставить доступы к таким элементам:
- к самой таблице — на редактирование;
- к каждому из шаблонов в массиве
templates— на чтение; - к папке, куда складываются документы, в переменной
folder— на запись.
Массив templates и переменная folder указаны в начале скрипта, в блоке настроек.
В блоке настроек можно заполнить массив CHOICES:
var CHOICES = []; // Дополнительные опции
CHOICES.push('Первая');
CHOICES.push('Вторая');
Затем, в зависимости от того, что выбрал пользователь, можно сделать какие-то особые замены в шаблоне.
Используется в наших скриптах:
- таблица
- скрипт
- папка шаблонов
- папка готовых документов: Лиды