Просмотреть исходный

Найти текст Версия 8 (Net)

Группа действий: Google Sheets

Описание

Действие возвращает адрес ячейки, которая содержит заданный текст.

Иконка

Параметры действия

Входные параметры

Контекст Идентификатор сеанса, к которому будет применено действие

ID документа Идентификатор документа, к которому необходимо применить действие

Лист Наименование рабочего листа

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

Строка начальной ячейки Строка начальной ячейки, от которой будет выполняться поиск

Столбец конечной ячейки Столбец конечной ячейки, до которой будет выполняться поиск

Строка конечной ячейки Строка конечной ячейки, до которой будет выполняться поиск

Пропускать скрытые Скрытые ячейки не будут участвовать в поиске

Текст Текст, поиск которого будет осуществляться

Метод поиска Метод поиска

Выходные параметры

Результат Словарь с элементами - найденными ячейками

Настройки

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Идентификатор сеанса, к которому будет применено действие.	Идентификатор сеанса работы с Google таблицами	GoogleTablesInstance	Да
ID документа	Идентификатор документа, к которому необходимо применить действие.	Строка	12Q3VXVkv-6Y2IMH	Да
Лист	Наименование рабочего листа. По умолчанию первый лист документа.	Строка	Лист1	Нет
Столбец начальной ячейки	Столбец начальной ячейки, от которой будет выполняться поиск. По умолчанию применяются границы используемой области из контекста.	Строка		Нет
Строка начальной ячейки	Строка начальной ячейки, от которой будет выполняться поиск. По умолчанию применяются границы используемой области из контекста.	Число		Нет
Столбец конечной ячейки	Столбец конечной ячейки, до которой будет выполняться поиск. По умолчанию применяются границы используемой области из контекста	Строка		Нет
Строка конечной ячейки	Строка конечной ячейки, до которой будет выполняться поиск. По умолчанию применяются границы используемой области из контекста.	Число		Нет
Пропускать скрытые	Скрытые ячейки не будут участвовать в поиске.	Чек-бокс		Нет
Текст	Текст, поиск которого будет осуществляться.	Строка		Да
Метод поиска	Метод поиска. По умолчанию будет применен полнотекстовый поиск. Выпадающий список: полнотекстовый поиск, поиск по включению, начиная с текста, окончание с текстом	Строка		Нет
Результат
Результат	Словарь с элементами - найденными ячейками: ключ элемента = адрес ячейки, значение элемента = значение ячейки.	Словарь

Особые условия использования

В Google Sheets API есть лимит до 60 read-запросов на пользователя в минуту. Для того, чтобы действие сразу не выдавало ошибку при достижении лимита количества запросов, в действие включена операция цикла, которая в течение минуты будет повторно отправлять запросы.

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

Пример использования

Задача

Имеется таблица с значениями:

Необходимо подключиться к Google Sheets и найти текст "Test2".

Решение

Воспользоваться действиями "Настройки подключения", "Найти текст", "Получить значение".

Реализация

Собрать схему робота состоящую из следующих действий:
Настроить параметры для действия "Настройки подключения":

Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive)
Настроить параметры для действия "Найти текст":

В поле "ID документа" указать часть ссылки таблицы.
Выполнить проверку отработки действия, использовав действие "Получить значение". Текст в словаре должен быть под ключом В3.
Запустить робота по кнопке "Старт" в верхней панели.

Результат

Программный робот отработал успешно.

Искомый текст сохранен из ячейки В3.