Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

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

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

...

Описание

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

Иконка

...

Image Added

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Настройки 

Свойство

Англ. наименование

Описание

Тип

Пример заполненияОбязательность заполнения поля
Параметры

Контекст

Context

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

Идентификатор сеанса работы с Google таблицами

GoogleTablesInstanceДа

ID документа

Document ID

Идентификатор документа, к которому необходимо применить действие.Строка12Q3VXVkv-6Y2IMHДа

Лист

Sheet

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

По умолчанию первый лист документа.

СтрокаЛист1Нет

Столбец начальной ячейки

Start cell column
Столбец начальной ячейки, от которой будет выполняться поиск. По умолчанию применяются границы используемой области из контекста.Строка
Нет

Строка начальной ячейки

Start сell row

Строка начальной ячейки, от которой будет выполняться поиск. По умолчанию применяются границы используемой области из контекста.Число
Нет
Столбец конечной ячейки
Destination cell column
Столбец конечной ячейки, до которой будет выполняться поиск. По умолчанию применяются границы используемой области из контекстаСтрока
Нет
Строка конечной ячейки
Destination cell string
Строка конечной ячейки, до которой будет выполняться поиск. По умолчанию применяются границы используемой области из контекста.Число
Нет
ТекстТекст, поиск которого будет осуществляться.Строка
Да
Пропускать скрытые
Skip hidden
Скрытые ячейки не будут участвовать в поиске.Чек-бокс
Нет
ТекстTextТекст, поиск которого будет осуществляться.СтрокаДа
Метод поиска
Search method

Метод поиска. По умолчанию будет применен полнотекстовый поиск.


Выпадающий список: полнотекстовый поиск, поиск по включению, начиная с текста, окончание с текстом

Строка
Нет
Результат
Результат
Result
Словарь с элементами - найденными ячейками: ключ элемента = адрес ячейки, значение элемента = значение ячейки.Словарь

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

...

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

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

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

Задача

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

image2024-1-24_14-28-5.pngImage Added

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

Решение

Воспользоваться : воспользоваться действиями "Настройки подключенияContext Google tables", "Найти текстFind Text", "Получить значениеGet value". 

Реализация

...

  1. Собрать схему робота состоящую из следующих действий: "Настройки подключения", "Найти текст", "Получить значение". 
    Image Removed
    Image Added

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

  3. Настроить параметры для действия "Найти текст":
    Image RemovedImage Added
    В поле "Контекст" указать контект подключения к Google Sheets.
    В поле "ID документа" указать часть ссылки таблицы.
    Image Removed
    В поле "Лист" указать наименование листа, на котором находятся данные.
    В поле "Текст" указать текст для поиска.
    В поле "Метод поиска" указать "Полнотекстовый поиск". Image Added

  4. Выполнить проверку отработки действия, использовав действие "Получить значение". Текст в словаре должен быть под ключом В3. 
    Указать в поле "Словарь" переменную типа словарь. 
    В поле "Ключ" указать ячейку, из которой был сохранен текст.
    В поле "Результат" указать переменную типа объект.
    Image Removed
    Image Added

  5. Запустить робота по кнопке "Старт" в верхней панели. 

...

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

Image Removed

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

Image RemovedImage Added