>Zina: /* Как создать новый генератор документов */

2022-07-28T11:01:14Z

Как создать новый генератор документов

Нова сторінка

← [[Google Apps Script]]

Система на основе Google Apps скриптов для создания документов по шаблону из данных в Google таблицах.

== Структура ==

Генератор документов состоит из четырех типов файлов:

* '''библиотека''' '''[https://script.google.com/home/projects/1G2L4fiwiM8MQ62Yc-aLktmbxTuOY4SHyoH-vCRRMbETUJQudh_vFYA5E/edit Zina Docs Generator Library]'''
* '''таблица''' Google Sheets с данными и подписанными заголовками столбцов;
* '''скрипт''', основанный на библиотеке — подключается к таблице
* '''шаблон''' Google Docs (один или несколько, указываются в скрипте), на основе которых скрипт будет создавать документы.

== Как создать новый генератор документов ==

# Создаем таблицу Google Sheets или используем существующую — например, ту, в которую сохраняются данные из Google Form.
# В первой строке таблицы пишем названия столбцов — типа «'''Название компании'''». Это чисто для себя, чтобы удобней было ориентироваться.
# Во второй строке пишем по-английски и без пробелов заголовки столбцов — они же подстановки, которые будут использоваться в шаблонах документов — типа '''<code>COMPANY_NAME</code>''' (регистр не имеет значения).
# Создаем шаблон документа в Google Docs (т.е. просто новый документ Google Docs) и вставляем в него подстановки для последующей замены. Подстановки обязательно писать в фигурных скобках типа '''<code><nowiki>{COMPANY_NAME}</nowiki></code>'''.
# Возвращаемся в таблицу, меню '''Tools''' — '''Script editor''' и добавляем код скрипта '''[https://script.google.com/home/projects/15-pxhi5Ccouc2V5G57_a8AfwGT1IXuuwxE39AH-OXd5xbLIG7uTcG1ey/edit из примера]'''
# Правим в коде переменные в блоке настроек в верхней части. Как минимум:
#* в строке '''<code>templates.push</code>''' пишем ID шаблона,
#* в строке '''<code>var patternsRow</code>''' пишем номер строки в таблице, в которой находятся заголовки столбцов (в этом примере — 2).
# Подключаем библиотеку: меню Resources — Libraries... — Add a library — вставляем ID нашей библиотеки Zina Docs Generator: <pre>1G2L4fiwiM8MQ62Yc-aLktmbxTuOY4SHyoH-vCRRMbETUJQudh_vFYA5E</pre> и выбираем версию (последнюю).
# Выполняем один раз скрипт через кнопку '''Выполнить''' на панели инструментов — при этом в таблицу добавится пункт меню <code>Шаблоны</code>.

После этого переходим в таблицу, кликаем по строке с данными, выбираем в меню '''Шаблоны — Создать документ из шаблона''' (это можно переименовать в начале скрипта) и появится окошко с предложением создать документ из шаблона.

== Доступы ==

Чтобы новый пользователь мог воспользоваться этим генератором, нужно предоставить доступы к таким элементам:

* к самой таблице — на редактирование;
* к каждому из шаблонов в массиве <code>templates</code> — на чтение;
* к папке, куда складываются документы, в переменной <code>folder</code> — на запись.

Массив <code>templates</code> и переменная <code>folder</code> указаны в начале скрипта, в блоке настроек.

== Дополнительные опции ==

В блоке настроек можно заполнить массив CHOICES:

<source lang="javascript">
var CHOICES = []; // Дополнительные опции
CHOICES.push('Первая');
CHOICES.push('Вторая');
</source>

Затем, в зависимости от того, что выбрал пользователь, можно сделать какие-то особые замены в шаблоне.

== Примеры ==

Используется в наших скриптах:

=== Генератор коммерческих предложений и брифов ===

* [https://docs.google.com/spreadsheets/d/131H4F7VSaN0JutcPvbaM4N55bjha1Vbs92Rkgd_yDB8/edit таблица]
* [https://script.google.com/home/projects/1ugUtb6KrXb87juKtwdf-i-57lKjWL2YlLfGdazTAC8-LmLwyK0PzEcth/edit скрипт]
* [https://drive.google.com/drive/folders/1KjNp8XmTAIchN5I5GXzqRZsa3tZBq8WP папка шаблонов]
** [https://docs.google.com/document/d/1VHpjANw7cPcMbtN6R_qHGccTMcAt6n6lqjkUHw-zUrA/edit#heading=h.z1eldbeqaihr <nowiki>[TPL]</nowiki> Коммерческое предложение создания сайта]
** [https://docs.google.com/document/d/1raqxxSo1gBp1GgACBrZ-adu2NPggS8G-ZCh_iTrkFaU/edit#heading=h.olzcrrpk5v0h <nowiki>[TPL]</nowiki> Бриф на разработку сайта]
** [https://docs.google.com/document/d/1wLIcb5xIrQbe9mV5Xl52ucsRLRmQBVDGmqlU9YzgTIk/edit <nowiki>[TPL]</nowiki> КП (NEW) - создание сайта]
* папка готовых документов: [https://drive.google.com/drive/folders/0BzUprvumr-cBMHJDSFFyTzFZWGc Лиды]

=== Генератор договорів за реквізитами клієнтів ===

* [https://docs.google.com/spreadsheets/d/1B5dLCPjvImEnZZNaLDzvpeIx2-PHiwxVXWg_Ckwk34I/edit таблица]
* [https://script.google.com/home/projects/15-pxhi5Ccouc2V5G57_a8AfwGT1IXuuwxE39AH-OXd5xbLIG7uTcG1ey/edit скрипт]
* [https://drive.google.com/drive/u/0/folders/1CwhhIOe431eVJvvYk2WMXO1XRPmqKV3h папка шаблонов «Договори»]:
** [https://docs.google.com/document/d/1O_fIsDIdjlwL90wDlb2dlJ_ufxqZUo3pwWsILDsdbL8/edit <nowiki>[TPL]</nowiki> Договір на розробку сайту]
** [https://docs.google.com/document/d/1Wlsecto91L-KypYUkJSupLAglEUClP0bpf88aCOBUwI/edit# <nowiki>[TPL]</nowiki> Договір на надання послуг з реєстрації доменного імені (імен)]

Zina Docs Generator Library - Історія редагувань

>Zina: /* Как создать новый генератор документов */