Подключите AppSheet к скрипту приложений

1. Введение

В этом практическом задании вы создадите проект Apps Script с именем "Hello World", а затем добавите простую функцию logThis , которая будет записывать в лог сообщение, переданное ей. Затем вы создадите автоматизацию Appsheet и настроите её на вызов скрипта. После вызова скрипта вы вернетесь в редактор Apps Script и подтвердите его выполнение.

Что вы узнаете

  • Как создать проект Apps Script с простой функцией.
  • Как создать простое приложение AppSheet на основе существующей таблицы Google Sheets.
  • Как создать автоматизацию в AppSheet, которая вызывает функцию скрипта.
  • Как проверить успешность выполнения скрипта из AppSheet.

Что вам понадобится

  • Доступ к среде разработки AppSheet ( appsheet.com ).
  • Доступ к среде разработки Apps Script ( script.google.com ).

2. Создайте проект Apps Script.

Сначала создайте проект Apps Script с именем "Hello World", а затем добавьте простую функцию logThis , которая будет записывать в лог сообщение, переданное ей.

  1. Перейдите на главную страницу Apps Script , а затем нажмите кнопку «+ Новый проект» .
  2. Измените название проекта на Hello World. Переименовать диалоговое окно «Проект» новым именем.
  3. Обновите скрипт в редакторе следующим образом: 
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. Нажмите « Сохранить проект» .

Для получения более подробной информации см. раздел «Создание и удаление проектов» .

3. Создайте приложение AppSheet.

Далее вы быстро создаёте новое приложение AppSheet на основе скопированного примера таблицы Google Sheets, а затем обновляете его, чтобы оно вызывало созданный ранее проект Apps Script.

  1. Откройте электронную таблицу «Пример заказов на рубашки» , затем нажмите «Создать копию» , чтобы загрузить и открыть ее в Google Таблицах. При желании вы можете переименовать электронную таблицу (например, «Заказы на рубашки»).
  2. Войдите в AppSheet .
  3. На странице «Мои приложения» нажмите кнопку «+ Создать новое приложение» . Откроется диалоговое окно «Создать новое приложение» .
  4. Нажмите « Начать с собственных данных» . Диалоговое окно создания нового приложения.
  5. При желании можно изменить название приложения и выбрать категорию.
  6. Нажмите «Выбрать данные».

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

  1. Нажмите на Google , чтобы получить доступ к своему Google Диску.
  2. Перейдите к таблице «Заказы на рубашки» , которую вы скопировали ранее, и выберите её.

AppSheet настраивает ваше приложение. Начальное окно предварительного просмотра сгенерированного приложения.

  1. Нажмите «Настроить приложение» , чтобы открыть его в редакторе AppSheet.

4. Создайте автоматизацию

Далее вы создаете автоматизацию в таблице приложений и настраиваете ее на вызов скрипта.

  1. Выберите Автоматизация > Боты .
  2. Нажмите + Новый бот .
  3. Выберите первый пункт в списке предложений: При создании или обновлении записи о заказах рубашек отправлять уведомление.

5037cdd726e326e9.png

  1. Чтобы отредактировать уведомление, нажмите на соответствующий шаг.
  2. Измените название на Call a script .

Этапы автоматизации для вызова скрипта.

  1. В разделе «Настройки» измените тип задачи на «Вызов скрипта» .

Выберите тип задачи «Вызов скрипта» в настройках автоматизации.

  1. В поле «Проект Apps Script» нажмите кнопку «Обзор» (значок файла).
  2. Перейдите в папку Hello World Apps Script" и выберите проект на вашем Google Диске.
  3. Нажмите «Выбрать» , и если потребуется авторизация, нажмите «Авторизовать» и следуйте инструкциям.

Проект Apps Script добавлен, и поле «Имя функции» заполнено списком доступных функций.

  1. Выберите logThis(msg) из списка имен функций . Выберите функцию Apps Script 'logThis()' в раскрывающемся списке.

Отображается поле «Аргументы функции» .

  1. Для аргумента msg введите следующее выражение с помощью помощника выражений: 'Hello from AppSheet'.

Добавление аргументов к вызову функции Apps Script.

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

68471f4646fc8fbe.png

  1. Добавьте новый заказ на футболки и нажмите «Сохранить» .
  2. Нажмите «Синхронизировать» , чтобы синхронизировать изменения.

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

5. Подтвердите выполнение скрипта Apps Script.

После вызова скрипта вернитесь в редактор Apps Script и подтвердите его выполнение.

  1. Вернитесь на главную страницу Apps Script и просмотрите проект Hello World .
  2. Нажмите «Выполнения» на панели навигации, чтобы убедиться в успешном завершении функции logThis . Нажмите «Обновить», если журнал не появился.

Просмотр журналов выполнения в среде редактора Apps Script для проверки выполнения функции из вызова AppSheet.

6. Дополнительные шаги (по желанию)

В качестве дополнительного шага в этом мастер-классе ознакомьтесь с проектом Apps Script Examples и запустите несколько примеров из AppSheet.

Начните работу с примерами Apps Script.

  1. Для начала создайте копию проекта Apps Script Examples .
  2. Нажмите на значок копирования.
  3. Сохраните новый проект и нажмите «Запустить» , чтобы авторизовать приложения в проекте.

Поэкспериментируйте с несколькими примерами.

  • createCalendarEvent() - Создает новое событие в календаре.
  • createDoc() - Автоматически создает новый документ.
  • createSheet() - Создает новый лист.
  • createSlideDeck() - Создает новую презентацию, используя изображение и текст.

Для получения более подробной информации об этой важной функции см. раздел «Вызов Apps Script из автоматизации» , где представлен подробный обзор, видеоролик о функции, учебные пособия и копируемый проект Apps Script, содержащий множество рабочих примеров AppSheet-Apps Script.