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