Группа «Сервисы Google»¶
ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive¶
Авторизироваться в Google аккаунте на сайте https://myaccount.google.com/ и создать google таблицу.
Таблица будет открыта:
Cоздать новый или использовать существующий проект в облаке google https://console.cloud.google.com/
Для создания нового проекта необходимо заполнить его название и нажать на кнопку «Create».
Проект будет создан:
Далее, необходимо подключить нужные API (к примеру, Google spreadsheet api).
В поисковой строке найти нужный API (в данном случае Google Sheets API). Так же, можно найти API для Google Drive и Google Docs.
Нажать на кнопку «Enable».
API будет подключен.
Настроить приложение и добавить используемые контексты этого API. Для этого выбрать в пункте меню APIs & Services, и далее в списке - OAuth consent screen.
На открывшейся странице выбрать значение «External» и нажать на кнопку «Create».
Заполнить поля App name и User support email в разделе App information.
Заполнить поле Email addresses в разделе Developer contact information. Нажать кнопку Save and continue.
Нажать на кнопку Add or remove scopes.
Найти по фильтру и выбрать требуемую API и нажать на кнопку Update.
Нажать на кнопку Save and continue.
Нажать на кнопку Save and continue.
Нажать на кнопку Back to dashboard.
Создать токен подключения OAuth, использовать тип приложения Desktop App. Нажать на пункт меню Credentials, далее - Create credentials, далее - OAuth client ID.
В появившемся окне заполнить поле Application type и нажать кнопку Create.
Нажать на кнопку Download JSON.
Этот токен скачивается и в роботе указывается в действии как путь к файлу в поле «Путь к файлу» действия «Настройки подключения».
В поле «Имя проекта» необходимо указать часть URL таблицы.
В действиях по обращению к Google таблице необходимо использовать id из URL.
В действиях Поключиться к Google Drive или подключиться к Google Docs путь к файлу так же должен быть указан в поле «Путь к файлу».
При первом запуске робота подтверждаем доступ к google в браузере. В дальнейшем подтверждение не потребуется.
Если при подтверждении отображается следующая ошибка:
Необходимо сделать следующие шаги:
Нажать в пункте меню APIs & Services , далее - OAuth consent screen
Далее, нажать на кнопку Add users и затем заполнить почту в соответствующем окне, далее нажать на кнопку Save.
Теперь такой ошибки не будет возникать. При первом запуске робота подтверждаем доступ. В появившемся окне необходимо нажать на кнопку «Продолжить».
В следующем окне - аналогично.
В результате робот отработал успешно.
Google Sheets¶
Вставить таблицу/Insert a table¶
Задача: существует Google таблица с значениями
Необходимо взять область значений с ячейки B1 до С4. И далее вставить полученную таблицу (область) начиная с ячейки А7.
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Взять область значений», «Вставить таблицу».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Взять область значений»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные. В поле «Ячейка от» указать наименование ячейки от которой будет взята область данных. В поле «Ячейка до» указать наименование ячейки до которой будет взята область данных. В поле «Таблица» указать переменную типа таблица, куда будут записано полученное значение.
Настроить параметры для действия «Вставить таблицу»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные.
В поле «Ячейка от» указать адрес начальной ячейки от которой будут устанавливаться значения.
В поле «Данные» указать переменную типа таблица с данными.
- Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Требуемая область значений получена и сохранена в переменную «Таблица» и вставлена на заданный лист.
Дополнительно:
Для параметра «С заголовком»:
При значении «true», действие запишет в документ строку заголовка исходной таблицы в качестве первой строки вместе с остальными основными строками таблицы. Пример: в Студии указано, что в таблице «Столбцов: 3; строк: 2», при вставке в документе окажутся заполнены 3 столбца и 3 строки.
При «false», действие запишет в документ только основные строки с содержимым исходной таблицы. Пример: в Студии указано, что в таблице «Столбцов: 3; строк: 2», при вставке в документе окажутся заполнены 3 столбца и 2 строки.
Установить цвет диапазона / Set range color¶
Задача: существует Google таблица
Необходимо установить цвет диапазона от ячейки В2 до Е4 желтым цветом.
Решение: воспользоваться действиями «Настройки подключения», «Установить цвет диапазона».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Установить цвет диапазона».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Установить цвет диапазона»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором необходимо установить цвет диапазона. В поле «Ячейка От» указать наменование ячейки от которой будет устанавливаться цвет диапазона. В поле «Ячейка До» указать наменование ячейки до которой будет устанавливаться цвет диапазона. В поле «Цвет» указать значение «желтый».
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Цвет диапазона установлен.
Установить цвет диапазона / Set range color¶
Задача: существует Google таблица
Необходимо отсортировать значения в столбце В по возрастанию.
Решение: воспользоваться действиями «Настройки подключения», «Сортировать».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Сортировать».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Сортировать»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором необходимо применить сортировку к данным. В поле «Ячейка От» указать наменование ячейки от которой будет устанавливаться сортировка. В поле «Ячейка До» указать наменование ячейки до которой будет устанавливаться сортировка. В поле «Столбец» указать значение - В (столбец, в котором данные для сортировки),
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Сортировка к данным успешно применена.
Создать новый документ / Create new document¶
Задача: необходимо создать новую Google таблицу.
Решение: воспользоваться действиями «Настройки подключения», «Создать новый документ».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Создать новый документ».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Создать новый документ»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «Имя документа» указать название документа, который будет создан. В поле «ID документа» указать переменную типа «строка», куда будет записан идентификатор созданной таблицы.
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Новый документ (таблица) создан.
Установить фильтры / Applying filter¶
Задача: существует Google таблица
Необходимо установить фильтр на значения в столбце В с условием <200.
Решение: воспользоваться действиями «Настройки подключения», «Установить фильтры».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Установить фильтры».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Установить фильтры»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором необходимо применить фильтрацию к данным. В поле «Ячейка От» указать наменование ячейки от которой будет устанавливаться фильтрация. В поле «Ячейка До» указать наменование ячейки до которой будет устанавливаться фильтрация. В поле «Столбец» указать значение - В (столбец, в котором данные для фильтрации). В поле «Критерий» указать значение критерия фильтрации.
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Фильтрация данных успешно применена.
Установить стиль текста / Set text style¶
Задача: существует Google таблица
Необходимо установить стиль текста в таблице с параметрами: стиль шрифта - курсив, рзамер -18, цвет - красный.
Решение: воспользоваться действиями «Настройки подключения», «Установить стиль текста».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Установить стиль текста».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Установить стиль текста»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором необходимо применить фильтрацию к данным. В поле «Ячейка От» указать наменование ячейки от которой будет устанавливаться стиль текста. В поле «Ячейка До» указать наменование ячейки до которой будет устанавливаться стиль текста. В поле «Стиль шрифта» указать значение - курсив. В поле «Размер шрифта» указать значение -18. В поле «Цвет» указать значение - красный.
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Стиль текста изменен.
Установить значения строки / Set row values¶
Задача: существует Google таблица
Необходимо установить значения строки № 5, используя переменную «Коллекция», в которой имеются значения 44 и 66.
Решение: воспользоваться действиями «Настройки подключения», «Установить значения строки.
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Установить значения строки».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Установить значения строки»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором необходимо установить значения строки. В поле «Индекс строки» указать номер строки, куда будут вставлены данные. В поле «Значения» указать переменную типа «коллекция» с данными.
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Значения установлены в строку 5.
Установить значения столбца / Set column values¶
Задача: существует Google таблица
Необходимо установить значения столбца С, используя переменную «Коллекция», в которой имеются значения 44 и 66.
Решение: воспользоваться действиями «Настройки подключения», «Установить значения столбца.
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Установить значения столбца».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Установить значения столбца»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором необходимо установить значения строки. В поле «Столбец» указать название столбца, куда будут вставлены данные. В поле «Значения» указать переменную типа «коллекция» с данными.
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Значения установлены в столбец С.
Установить значение ячейки/ Write cell¶
Задача: существует Google таблица
Необходимо установить значение 2 в ячейку А1.
Решение: воспользоваться действиями «Настройки подключения», «Установить значение ячейки».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Установить значение ячейки».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Установить значение ячейки»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные. В поле «Ячейка» указать наменование ячейки, куда будет вставлено значение. В поле «Значение ячейки» указать значение для вставки в ячейку.
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Значение вставлено в ячейку А1.
Удалить строку / Delete row¶
Задача: существует Google таблица
Необходимо удалить строку 4.
Решение: воспользоваться действиями «Настройки подключения», «Удалить строку».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Удалить строку».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Удалить строку»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные. В поле «Индекс строки» указать номер строки, которую необходимо удалить.
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Требуемая строка удалена.
Удалить столбец / Delete column¶
Задача: существует Google таблица
Необходимо удалить столбец А.
Решение: воспользоваться действиями «Настройки подключения», «Удалить столбец».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Удалить столбец».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Удалить столбец»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные. В поле «Столбец» указать название столбца, который необходимо удалить.
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Требуемый столбец удален.
Снять авто-фильтры / Remove auto filters¶
Задача: существует Google таблица с активными авто-фильтрами на листе. Необходимо их снять.
Решение: воспользоваться действиями «Настройки подключения», «Снять авто-фильтры».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Снять авто-фильтры».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Снять авто-фильтры»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные с применными фильтрами.
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Авто-фильтры сняты.
Проверить пустая ли ячейка / Check if the cell is empty¶
Задача: существует Google таблица с значениями
Необходимо проверить пустая ли ячейка А3.
Решение: воспользоваться действиями «Настройки подключения», «Проверить пустая ли ячейка».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Проверить пустая ли ячейка».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Проверить пустая ли ячейка»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные. В поле «Столбец ячейки» указать название столбца ячейки. В поле «Строка ячейки» указать номер строки ячейки.
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Получен результат False, что означает, что ячейка заполнена.
Получить количество строк / Get the number of rows¶
Задача: существует Google таблица с значениями
Необходимо получить в числовую переменную количество заполненных строк в столбце А.
Решение: воспользоваться действиями «Настройки подключения», «Получить количество строк».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Получить количество строк».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Получить количество строк»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные. В поле «Столбец» указать название столбца из которого нужно получить количество строк. Проставить чек-бокс «Пропустить скрытие» = true. В поле «Результат» указать переменную типа число.
- Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Получено количество заполненных строк в таблице столбца А.
Очистить область / Clear range¶
Задача: существует Google таблица с значениями
Необходимо очистить область значений с ячейки B1 до С4.
Решение: воспользоваться действиями «Настройки подключения», «Очистить область».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Очистить область».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Очистить область»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные. В поле «Ячейка от» указать наименование ячейки от которой будет взята область данных. В поле «Ячейка до» указать наименование ячейки до которой будет взята область данных.
Результат:
Программный робот отработал успешно. Требуемая область значений очищена из таблицы.
Найти текст/ Find text¶
Задача: имеется таблица с значениями
Необходимо подключиться к Google Sheets и найти текст Test2.
Решение: воспользоваться действиями «Настройки подключения», «Найти текст», «Получить значение».
Реализация:
Собрать схему робота состоящую из действий: «Настройки подключения», «Найти текст», «Получить значение».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Найти текст»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа, на котором находятся данные. В поле «Текст» указать текст для поиска. В поле «Метод поиска» указать «Полнотекстовый поиск».
- Выполнить проверку отработки действия, использовав действие «Получить значение». Текст в словаре должен быть под ключом В3.
Указать в поле «Словарь» переменную типа словарь. В поле «Ключ» указать ячейку, из которой был сохранен текст. В поле «Результат» указать переменную типа объект.
- Запустить робота по кнопке «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Исполнить формулу / Use of formulas cell¶
Задача: существует таблица со значениями
Необходимо подключиться к Google Sheets и исполнить формулу А1+В1 в ячейке С1.
Решение: воспользоваться действиями «Настройки подключения», «Исполнить формулу».
Реализация:
Собрать схему робота состоящую из действий: «Настройки подключения», «Исполнить формулу».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Исполнить формулу»:
В поле «ID документа» указать часть ссылки таблицы.
- Запустить робота по кнопке «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Добавить новый лист / Add new sheet¶
Задача: необходимо подключиться к Google Sheets и добавить в таблицу новый лист.
Решение: воспользоваться действиями «Настройки подключения», «Добавить новый лист».
Реализация:
Собрать схему робота состоящую из действий: «Настройки подключения», «Добавить новый лист».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Добавить новый лист»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Имя нового листа» указать наименование листа, который будет создан.
- Запустить робота по кнопке «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Взять область значений / Gеt area¶
Задача: существует Google таблица с значениями
Необходимо взять область значений с ячейки B1 до С4. Результат записать в переменную типа таблица.
Решение: воспользоваться действиями «Настройки подключения», «Взять область значений».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Взять область значений».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Взять область значений»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные. В поле «Ячейка от» указать наименование ячейки от которой будет взята область данных. В поле «Ячейка до» указать наименование ячейки до которой будет взята область данных. В поле «Таблица» указать переменную типа таблица, куда будут записано полученное значение.
Результат:
Программный робот отработал успешно. Требуемая область значений получена и сохранена в переменную «Таблица».
Дополнительно
Для чек-бокса «С заголовком»:
- Работа параметра: При значении «true» действие первую строку исходной таблицы сохранит в заголовок возвращаемого табличного значения, т.е. она не будет являться строкой с содержимым таблицы.
- При «false» первую строку оставит в части с содержимым таблицы, а в заголовке будут использоваться названия по умолчанию - 1, 2, 3 и т.д.
Пример:
Забираем таблицу:
При включенном параметре в логе будет указано «Столбцов: 3; строк: 2», т.к. Первая строка взятой области стала заголовком с названиями столбцов «№», «Название» и «Тесты». К этим заголовкам нельзя обратиться как к строке данных, чтобы прочитать, но можно использовать имена столбцов, чтобы обратиться к конкретной ячейке или столбцу (действиями из группы «Таблицы»). Если параметр выключен, то в логе будет указано «Столбцов: 3; строк: 3», названия столбцов в заголовке будут «1», «2» и «3».
Для чек-бокса «Убрать дубли заголовка»:
При значении «true», в заголовке табличного значения, которое действия возвращают как результат, к одинаковым названиям столбцов будут добавлены индексы. Нумерация начинается с 1. Пример №1:
Есть таблица:
При «Убрать дубли заголовка» = true, и «С заголовком» = True, действие «Взять таблицу» вернет таблицу из 10 строк и 4х столбцов. Названия столбцов этой таблицы будут «№», «Название робота», «Тесты1», «Тесты2».
Пример №2.
Есть таблица:
При «Убрать дубли заголовка» = true, и «С заголовком» = True, действие «Взять таблицу» вернет таблицу из 4х строк и 5 столбцов. Названия столбцов этой таблицы будут: «Тест31», «Тест21», «Тест22», «Тест32», «Тест1».
При значении «false», названия столбцов останутся прежними. Действия на net, которые возвращаютобрабатывают такие таблицы с задублированными названиями столбцов, будут падать с ошибкой, т.к. в net не может быть заголовка с одинаковыми названиями столбцов. Например, в исходной таблице есть столбцы «Тест1», «Тест» и «Тест». Если добавлять индексы только к текущим дублям, то названия станут такими «Тест1», «Тест1» и «Тест2», т.е. в итоге появятся новые дубли с названием «Тест1». Поэтому действие при переименовании конкретного столбца должно проверять, нет ли уже такого названия у другого столбца и при наличии таких совпадений проставлять у текущего столбца следующий по счету индекс. Т.е. в данном случае действие переименует столбцы как «Тест1», «Тест2» и «Тест3».
Взять значение ячейки / Read cell¶
Задача: существует Google таблица с значениями
Необходимо взять данные из ячейки А3 Результат вывести в диалоговое окно.
Решение: воспользоваться действиями «Настройки подключения», «Взять значение ячейки», «Сообщение».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Взять значение ячейки», «Сообщение».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Взять значение ячейки»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные. В поле «Ячейка» указать наименование строки, данные из которой нужно сохранить. В поле «Результат» указать переменную типа объект, куда будут записано полученное значение.
Настроить параметры для действия «Сообщение»:
В поле «Текст сообщения» указать переменную типа объект с содержащимся значением.
В поле «Заголовок окна» указать «Результат».
Результат:
Программный робот отработал успешно. Данные из ячейки получены.
Взять данные из строки / Get row data¶
Задача: существует Google таблица с значениями
Необходимо взять данные из строки 3 и получить значение по индексу № 2 из коллекции. Результат вывести в диалоговое окно.
Решение: воспользоваться действиями «Настройки подключения», «Взять данные из строки», «Получить значение по индексу», «Сообщение».
Реализация:
Собрать следующую схему робота, состоящую из действий: «Настройки подключения», «Взять данные из строки», «Получить значение по индексу», «Сообщение».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Взять данные из строки»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные. В поле «Индекс строки» указать наименование строки, данные из которой нужно сохранить. В поле «Результат» указать переменную типа коллекция, куда будут записаны полученные значения.
Настроить параметры для действия «Получить значение по индексу»:
В поле «Коллекция» указать коллекцию полученных значений из строки. В поле «Индекс» указать 2. (нумерация начинается с 0). В поле «Значение» указать переменную типа объект, куда будет сохранен результат.
Настроить параметры для действия «Сообщение»:
В поле «Текст сообщения» указать переменную типа объект с содержащимся значением.
В поле «Заголовок окна» указать «Результат».
Результат:
Программный робот отработал успешно. Записи из строки получены.
Взять данные из столбца / Get column data¶
Задача: существует Google таблица с значениями
Необходимо взять данные из столбца А и получить значение по индексу № 2 из коллекции. Результат вывести в диалоговое окно.
Решение: воспользоваться действиями «Настройки подключения», «Взять данные из столбца», «Получить значение по индексу», «Сообщение».
Реализация:
Соберем следующую схему робота, состоящую из действий: «Настройки подключения», «Взять данные из столбца», «Получить значение по индексу», «Сообщение».
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
Настроить параметры для действия «Взять данные из столбца»:
В поле «Контекст» указать контект подключения к Google Sheets. В поле «ID документа» указать часть ссылки таблицы.
В поле «Лист» указать наименование листа на котором находятся данные. В поле «Столбец» указать наименование столбца, данные из которого нужно сохранить. В поле «Результат» указать переменную типа коллекция, куда будут записаны полученные значения.
Настроить параметры для действия «Получить значение по индексу»:
В поле «Коллекция» указать коллекцию полученных значений из столбца. В поле «Индекс» указать 2. (нумерация начинается с 0). В поле «Значение» указать переменную типа объект, куда будет сохранен результат.
Настроить параметры для действия «Сообщение»:
В поле «Текст сообщения» указать переменную типа объект с содержащимся значением.
В поле «Заголовок окна» указать «Результат».
Результат:
Программный робот отработал успешно. Записи из столбца получены.
Настройки подключения / Context Google tables¶
Задача: Необходимо настроить подключение к Google Sheets для дальнейшей работы с таблицей.
Решение: воспользоваться действием «Настройки подключения».
Реализация:
Перетащить на рабочее пространство действие «Настройки подключения»:
Настроить параметры для действия «Настройки подключения»:
Заполнить поля «Путь к файлу» и «Имя проекта» (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive).
- Нажать на кнопку «Старт» в верхней панели действий.
Результат:
Подключение к Google Sheets выполнено успешно.
Google Docs¶
Создать новый документ / Create a new document¶
Задача: Необходимо настроить подключение к Google Docs и создать новый документ.
Решение: воспользоваться действием «Подключиться к Google Docs», «Создать новый документ».
Реализация:
Перетащить на рабочее пространство действие «Подключиться к Google Docs» и «Создать новый документ»:
Заполнить параметр «Путь к файлу» действия «Подключиться к Google Docs» (подробнее о файле в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive):
Заполнить параметры действия «Создать новый документ».
В поле «Контекст» указать контекст подключения к Google Docs. В поле «Имя документа» указать название документа, который будет созан. В поле «ID документа» указать переменную типа «строка», куда будет записан ID нового документа.
- Нажать на кнопку «Старт» в верхней панели действий.
Результат:
Подключение к Google Docs выполнено успешно. Новый документ создан.
Подключиться к Google Docs / Connect to Google Docs¶
Задача: Необходимо настроить подключение к Google Docs и создать новый документ.
Решение: воспользоваться действием «Подключиться к Google Docs», «Создать новый документ».
Реализация:
Перетащить на рабочее пространство действие «Подключиться к Google Docs» и «Создать новый документ»:
Заполнить параметр «Путь к файлу» действия «Подключиться к Google Docs» (подробнее о файле в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive):
Заполнить параметры действия «Создать новый документ».
В поле «Контекст» указать контекст подключения к Google Docs. В поле «Имя документа» указать название документа, который будет созан. В поле «ID документа» указать переменную типа «строка», куда будет записан ID нового документа.
- Нажать на кнопку «Старт» в верхней панели действий.
Результат:
Подключение к Google Docs выполнено успешно. Новый документ создан.
Google Drive¶
Скачать файл / Download file¶
Задача: Необходимо настроить подключение к Google Drive и скачать файл «Описания проблем.docx» из Google Drive на рабочий стол.
Решение: воспользоваться действием «Подключиться к Google Drive», «Скачать файл».
Реализация:
Перетащить на рабочее пространство действие «Подключиться к Google Drive» и «Скачать файл»:
Заполнить параметр «Путь к файлу» действия «Подключиться к Google Docs» (подробнее о файле в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive):
Заполнить параметры действия «Скачать файл».
В поле «Контекст» указать контекст подключения к Google Drive. В поле «Идентификатор документа» указать часть ссылки на документ
В поле «Имя документа» указать имя документа в Google Drive с расширением. В поле «Папка для скачивания» указать путь к папке, в которую будет скачан документ.
- Нажать на кнопку «Старт» в верхней панели действий.
Результат:
Подключение к Google Drive выполнено успешно. Файл скачан.
Получить список файлов / Get a list of files¶
Задача: Необходимо настроить подключение к Google Drive и получить список файлов.
Решение: воспользоваться действием «Подключиться к Google Drive», «Получить список файлов».
Реализация:
Перетащить на рабочее пространство действие «Подключиться к Google Drive» и «Получить список файлов»:
Заполнить параметр «Путь к файлу» действия «Подключиться к Google Docs» (подробнее о файле в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive):
Заполнить параметры действия «Получить список файлов».
В поле «Контекст» указать контекст подключения к Google Drive. В поле «Массив параметров файлов» указать переменную типа «коллекция».
- Нажать на кнопку «Старт» в верхней панели действий.
Результат:
Подключение к Google Drive выполнено успешно. Список файлов из Google Drive получен.
Загрузить файл / Upload file¶
Задача: Необходимо настроить подключение к Google Drive и загрузить файл «Описания проблем.docx» в новую папку.
Решение: воспользоваться действием «Подключиться к Google Drive», «Загрузить файл».
Реализация:
Перетащить на рабочее пространство действие «Подключиться к Google Drive» и «Загрузить файл»:
Заполнить параметр «Путь к файлу» действия «Подключиться к Google Docs» (подробнее о файле в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive):
Заполнить параметры действия «Загрузить файл».
В поле «Контекст» указать контекст подключения к Google Drive. В поле «Загружаемый файл» указать путь к целевому файлу. В поле «Идентификатор папки» указать - новая папка.
- Нажать на кнопку «Старт» в верхней панели действий.
Результат:
Подключение к Google Drive выполнено успешно. Файл загружен.
Подключиться к Google Drive / Connect to Google Drive¶
Задача: Необходимо настроить подключение к Google Drive и получить список файлов.
Решение: воспользоваться действием «Подключиться к Google Drive», «Получить список файлов».
Реализация:
Перетащить на рабочее пространство действие «Подключиться к Google Drive» и «Получить список файлов»:
Заполнить параметр «Путь к файлу» действия «Подключиться к Google Docs» (подробнее о файле в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive):
Заполнить параметры действия «Получить список файлов».
В поле «Контекст» указать контекст подключения к Google Drive. В поле «Массив параметров файлов» указать переменную типа «коллекция».
- Нажать на кнопку «Старт» в верхней панели действий.
Результат:
Подключение к Google Drive выполнено успешно. Список файлов из Google Drive получен.