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

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


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


Настройки

Свойство

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

Описание

Тип

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

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

Параметры
Контекст

Context

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

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

EXCEL_INSTANCEДа
Начало диапазонаStart cell

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

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


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

Строка

A1Нет
Конец диапазонаEnd cell

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

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


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

Строка

B3Нет
Пропустить скрытые ячейкиSkip hiddenСкрытые ячейки не будут участвовать в поиске.
По умолчанию false
ЛогическийtrueНет
ТекстTextТекст, поиск которого будет осуществляться.

Строка

10Да
Метод поиска
Search method

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


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

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

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

СтрокаxsFullНет
Результаты
РезультатResult

Словарь найденных ячеек. Ключ-ячейка.


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


СловарьСловарь

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

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




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

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

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

Реализация: 

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

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

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

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

      а)Параметр "Контекст". Заполняется автоматически.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    

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

Результат:

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

                                                                                                                                            Рис.3. Результат поиска.