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

1. Введение

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

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

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

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

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

2. Создайте проект скрипта приложений.

Сначала создайте проект 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 Sheet, а затем обновляете его для вызова созданного ранее проекта Apps Script.

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

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

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

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

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

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

Затем вы создаете автоматизацию Appsheet и вызываете сценарий.

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

5037cdd726e326e9.png

  1. Нажмите « Отправить уведомление», чтобы отредактировать его.
  2. Измените имя на Call a script .

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

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

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

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

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

  1. Выберите logThis(msg) из списка «Имя функции» . Выбор функции скрипта приложений «logThis()» в раскрывающемся списке.

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

  1. В качестве аргумента msg введите следующее выражение с помощью Expression Assistant: «Привет из AppSheet».

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

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

68471f4646fc8fbe.png

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

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

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

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

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

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

6. Необязательные дополнительные шаги

В качестве дополнительного шага в этом семинаре просмотрите проект «Примеры сценариев приложений» и запустите некоторые примеры из AppSheet.

Начните работу с примеров сценариев приложений

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

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

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

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