Возможности и принцип работы

Как работать с TH таблицами в BotHunter

Принципы работы не отличаются от Google таблиц, чтобы ваш переход на TH Таблицы был максимально бесшовным.

Если вы работаете с интеграцией Google на уровне уверенного пользователя, можете закрывать статью, вы уже все знаете.

Блок работы с интеграцией находится в блоке Действия - Действия с интеграциями.

Выберите ранее подключенную интеграцию.

Если интеграция еще не подключена, прочите статью ниже

TH таблицы

Принцип работы и основные понятия

Диапазон ячеек

Диапазон в таблице — это просто несколько выбранных значений. Указывается так — начальнаякоордината:конечнаякоордината

Начальная координата — это координата левой верхней ячейки из выбранных. Конечная координата — это координата правой нижней ячейки из выбранных.

Что такое координата: Координата «Имя» на примере снизу равна А1 Координата «Фамилия» равна B1.

К примеру сейчас выбраны ячейки A1 и B1:

Их диапазон записывается так: A1:B1

На скриншоте слева сверху видно как раз эту запись.

Ещё пример:

Сейчас выбран диапазон A2:D4

Если мы хотим записать что-то в 1 ячейку, то в поле «Диапазон ячеек» можно указать только координату ячейки для записи

Например, записать просто F1, если мы хотим работать с ячейкой F1

-------

Диапазон для столбца

Также мы можем в диапазоне указывать весь столбец B такой записью: B:B

Диапазон для строки

Чтобы указать всю строку 2, существует такая запись: 2:2

Общие поля

В блоке интеграции в каждом действии с таблицей нужно указать 2 обязательных поля:

• в поле «Таблица» выберите из списка или вставьте ссылку на вашу таблицу;

• в поле «Лист» выберите из списка или напишите название листа.

Также в методах, которые вставляют значения, есть такое поле:

Тип вставки значений:

По умолчанию — все значения будут приводиться к текстовой форме

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

В любое поле, где можно написать текст, — можно вставлять переменные.

Методы

На текущий момент интеграция предоставляет возможности:

1. Добавить строку в конец таблицы

2. Вставить значение в ячейку

3. Найти и заменить

4. Получить строчку

5. Получить значение

6. Очистить ячейку

7. Удалить строки/столбцы

8. Создать лист

9. Получить информацию о листе

10. Получить все листы таблицы

11. Удалить лист

Добавить строку в конец таблицы

Добавляет строку из указанных значений в конец таблицы (после последней заполненной строки)

Возвращаемые значения

{"updated_range":"'Лист 1'!A5:C5","updated_row":5,"message":"Строка добавлена","result_code":1}

// updated_range - диапазон, в который были вставлены значения
// updated_row - номер строки, в который были вставлены значения

Вставить значение в ячейку

Имеет 2 типа: 1) по координате ячейки 2) по заданным строке и столбцу

По координате ячейки: вставляет значение в введённую ячейку

По заданным строке и столбцу: вставляет значение в пересечение введённых строки и столбца

Найти и заменить

Находит все искомые данные и заменяет их на введенное значение замены

Получить строчку

Повышенный уровень сложности. Возвращает массив из элементов найденной строки

Информация по работе с ответом описана здесь:

Сложные переменные

Можно ограничить зону поиска на листе таблицы, указав нужный диапазон в поле "Название листа". Несколько вариантов, которые можно указать в этом поле: Лист1 — будет искать совпадения по всему листу "Лист1" в таблице Лист1!A:C — будет искать совпадения только по столбцам A, B, C на листе "Лист1" в таблице Лист1!A2:C3 — будет искать совпадения только в ячейках A2, B2, C2, A3, B3, C3 на листе "Лист1" в таблице.

Также можете исключить из поиска определенные номера строк. Для этого в блоке есть поле с соответствующим названием.

Если ищете одну строку, то можете выбрать, какую именно строку получить: первую найденную или одну случайную из найденных.

Возвращаемые значения

Для 1 строки
{"row_index":2,"message":"Строка найдена и возвращена","not_found":0,"row_values":["Иван","Гелист","73422200331","Пермь","42"],"result_code":1}

Для нескольких строк 
{"rows_indexes":[3,4],"count_rows":2,"message":"Строки найдены и возвращены","not_found":0,"row_values":[["Петр","Захаров","79190045600","Санкт-Петербург","15"],["Елизавета","а","79190045600","","15"]],"result_code":1}

Получить значение

Позволяет получить значение из указанной ячейки. Полученное значение будет доступно в переменной {%i.value%}. Если в пункте "В какую переменную сохранить ответ" вы меняли i на своё название, то вместо i в примере выше также подставьте своё название.

Если значение одно, то в переменной будет лежать само значение. Если в поиске был указан диапазон ячеек, то придет массив значений по аналогии с методом получения строчки. Если не указывать диапазон ячеек, то будут получены все значения с листа (если не будет превышен лимит символов).

Очистить ячейку

Удаляет значения из ячеек в указанном диапазоне

Полностью удалить строку/столбец

В отличие от метода «Очистить ячейку» удаляет полностью всю строку/столбец по найденному значению и заполняет пустое место, сдвигая рядом стоящие строки/столбцы

Создать лист

Создает лист в указанной таблице с названием, которое вы написали в блоке.

Возвращаемые значения

{"id":"83fa7bd4-1e62-491f-8ae7-716cf1deb535","title":"Лист 2","message":"Лист создан","result_code":1}

Получить информацию о листе

Ищет по названию информацию о листе в таблице и возвращает важные параметры, если найден.

Пример возвращаемых значений

{"found":1,"result":{"id":"a070e627-f910-4495-8e1a-943ec1f84a59","title":"Лист 1"},"count_filled_rows":997,"count_filled_cols":8,"message":"Информация о листе получена","result_code":1}

Получить информацию о всех листах

Получает параметры всех листов в таблице

Пример возвращаемых значений

{"result":[{"id":"a070e627-f910-4495-8e1a-943ec1f84a59","title":"Лист 1"},{"id":"83fa7bd4-1e62-491f-8ae7-716cf1deb535","title":"Лист 2"}],"message":"Информация о листах получена","result_code":1}

Удалить лист

Ищет лист по названию и удаляет его из таблицы

Пример возвращаемых значений

{"deleted":1,"message":"Лист удален","result_code":1}