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

Ключ

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

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

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

...

Описание

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

Иконка

Image Modified

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

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

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

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

Настройки 

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

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

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

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

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

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

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

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

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

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

Настройки 

Свойство

Свойство

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

Описание

Тип

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

Контекст

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 Modified.

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

Решение

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

Реализация

...

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

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

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

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

Результат

...

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

Image Modified

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

Image Modified