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

Ключ

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

Найти текст / Find text

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

...

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


Настройки

Свойство

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

Описание

Тип

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

Обязательность заполнения поля

Параметры

Контекст

Context

Уникальный идентификатор сеанса, к которому будет применено действие.

Идентификатор контекста Excel

EXCEL_INSTANCEДа

Контекст действия для работы с Excel-документом

Robin.Excel

Контекст excel

Да

Имя столбца начальной ячейки

Имя столбца

Начало диапазонаStart cellАдрес

начальной ячейки, от которой будет выполняться поиск. Если поле не заполнено, то берется значение из поля «Индекс столбца начальной ячейки».

Robin.

Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.

String


Нет

Индекс столбца начальной ячейки

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

Robin.Numeric


Нет

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

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

Строка

A1

Robin.Numeric


Нет

Конец диапазонаEnd cellАдрес

Имя столбца конечной ячейки

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

Если поле не заполнено, то берется значение из поля «Индекс столбца конечной ячейки».

Robin.String


Нет

Индекс столбца конечной ячейки

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

Robin.Numeric


Нет

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

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

Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.

B3

По умолчанию применяются границы используемой области из контекста.

Строка

Robin.Numeric


Нет

Пропустить

Пропускать скрытые

ячейкиSkip hidden

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

По умолчанию falseЛогический

Robin.Boolean

true

Нет

Текст

Text

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

Строка

10

Robin.String


Да

Метод поиска

Search method

Принцип соответствия введенного текста значениям ячеек.

Выпадающий список:

  • Полное - xsFull
  • Содержит - xsContains
  • Начинается - xsStart
  • Заканчивается - xsEnd

По умолчанию xsFull

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

Robin.String

СтрокаxsFull


Нет

Результаты

Результат

Result

Словарь

найденных ячеек. Ключ-ячейка.

Название ключа - это адрес ячейки, которая была найдена. В словаре может быть не единственный элемент. Т.е., например, если в таблице есть несколько ячеек, в которых можно найти указанный текст, то в результирующем словаре будет столько ключей, сколько было найдено таких ячеек

Словарь

с элементами - найденными ячейками: ключ элемента = адрес ячейки, значение элемента = значение ячейки.

Robin.Dictionary

Словарь




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

...

Задача: Существует Excel-документ. Excel.xlsx.   Необходимо найти конкретное слово или текст в этом документе. 

Решение: Для реализации действия нужны следующие действия - "Открыть", "Найти текст".

Реализация: 

1) Открыть группу действий "Excel"

2) Открыть подгруппу "Общие"

3) Поместить в рабочее пространство студии действие "Открыть" 

  1. Собрать схему робота, состоящую из действий:
    Image Added

2. Настроить параметры     Настройка действия "Открыть"    а)Параметр "Контекст". Заполняется автоматически.

      b)Параметр "Путь до файла". Указываем путь к файлу, который необходимо открыть. ( Изначально все ячейки окрашены в желтый цвет, заодно можно проверить, измениться ли цвет ячеек в указанном диапазоне) 

      c)Параметр "Видимый". Устанавливаем признак - true. 

Image Removed

                      Рис1. Параметры действия "Открыть"

4)Открыть подгруппу "Общие"

5)Поместить в рабочее пространство студии действие "Найти текст"

   Настройка действия "Найти текст":

    a) Параметр "Контекст". Установить связь с действием "Открыть" 

    b) Параметр "Столбец начальный". Указать конкретный столбец. Пример столбец - A.

    с) Параметр "Строка начальная". Указать конкретную строку. Пример строка - 1. 

    d) Параметр "Столбец конечный". Указать конкретный столбец. Пример столбец - D.

    e) Параметр "Столбец конечная". Указать конкретный строку. Пример строка - 10.

    f) Параметр "Пропускать скрытые". True - пропускает скрытые. False - по умолчанию, не пропускает.

    g) Параметр "Текст". Указать слово или текст, которое будет найдено.

    h) Параметр "Метод поиска". "Полнотекстовый поиск", "Поиск по включению", "Начиная с текста", "Поиск по окончанию". Выбран 1-ый вариант "Поиск по включению"

    Image Removed

Image Added

    

3. Настроить параметры действия "Найти текст".

   

    Image Added

                Рис.2. Параметры действия "Найти текст"

Результат:

Текст найден. В логах отображается результат о количестве найденных слов или текста. 

...