Найти текст Версия 9 (Net)
Группа действий: Google Sheets
Описание
Действие возвращает адрес ячейки, которая содержит заданный текст
Иконка действия
Параметры и их настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|
Параметры | ||||
Контекст | Идентификатор сеанса, к которому будет применено действие | GoogleTablesInstance | Да | |
ID документа | Идентификатор документа, к которому необходимо применить действие | Строка | 12Q3VXVkv-6Y2IMH | Да |
Лист | Наименование рабочего листа По умолчанию первый лист документа | Строка | Лист1 | Нет |
Столбец начальной ячейки | Столбец начальной ячейки, от которой будет выполняться поиск. По умолчанию применяются границы используемой области из контекста | Строка | Нет | |
Строка начальной ячейки | Строка начальной ячейки, от которой будет выполняться поиск. По умолчанию применяются границы используемой области из контекста | Число | Нет | |
Столбец конечной ячейки | Столбец конечной ячейки, до которой будет выполняться поиск. По умолчанию применяются границы используемой области из контекста | Строка | Нет | |
Строка конечной ячейки | Строка конечной ячейки, до которой будет выполняться поиск. По умолчанию применяются границы используемой области из контекста | Число | Нет | |
Текст | Текст, поиск которого будет осуществляться | Строка | Да | |
Пропускать скрытые | Скрытые ячейки не будут участвовать в поиске | Чекбокс | Нет | |
Метод поиска | Метод поиска. По умолчанию будет применен полнотекстовый поиск Выпадающий список: полнотекстовый поиск, поиск по включению, начиная с текста, окончание с текстом | Строка | Нет | |
Результат | ||||
Результат | Словарь с элементами - найденными ячейками: ключ элемента = адрес ячейки, значение элемента = значение ячейки. | Словарь |
Особые условия использования
В Google Sheets API есть лимит до 60 read-запросов на пользователя в минуту. Для того, чтобы действие сразу не выдавало ошибку при достижении лимита количества запросов, в действие включена операция цикла, которая в течение минуты будет повторно отправлять запросы:
- Если за это время запрос выполниться, то действие завершится успешно;
- Если за это время запрос не удастся отправить, то робот завершится с ошибкой.
Пример использования
Задача
Имеется таблица с значениями.
Необходимо подключиться к Google Sheets и найти текст "Test2".
Решение
Воспользоваться действиями "Настройки подключения", "Найти текст", "Получить значение".
Реализация
- Собрать схему робота состоящую из следующих действий.
- Настроить параметры для действия "Настройки подключения".
Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive). - Настроить параметры для действия "Найти текст".
В поле "ID документа" указать часть ссылки таблицы. - Выполнить проверку отработки действия, использовав действие "Получить значение". Текст в словаре должен быть под ключом В3.
- Запустить робота по кнопке "Старт" в верхней панели.
Результат
Программный робот отработал успешно.
Искомый текст сохранен из ячейки "В3".