История страницы
Найти текст
...
Версия 13 (Net)
Группа действий: Excel
...
Описание
Действие возвращает Находит адрес ячейки по тексту, который написан в этой ячейке.
, которая содержит заданный текст
Иконка действия
Параметры и их настройки
...
Свойство |
Англ. наименование
Описание | Тип | Пример заполнения | Обязательность заполнения поля | |
Параметры | ||||
Контекст |
Context
Уникальный идентификатор сеанса, к которому будет применено действие.
Идентификатор контекста Excel
Контекст действия для работы с Excel-документом | Robin.Excel | Контекст excel | Да |
Имя столбца начальной ячейки | Имя столбца |
начальной ячейки, от которой будет выполняться поиск. |
Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.
Если поле не заполнено, то берется значение из поля "Индекс столбца начальной ячейки" | Robin.String | Нет | ||
Индекс столбца начальной ячейки | Индекс столбца начальной ячейки, от которой будет выполняться поиск. Если поле не заполнено, то берется граница используемой области | Robin.Numeric | Нет | |
Строка начальной ячейки | Строка начальной ячейки, от которой будет выполняться поиск. По умолчанию применяются границы используемой области |
Строка
из контекста | Robin.Numeric | Нет |
Имя столбца конечной ячейки | Имя столбца конечной ячейки, до которой будет выполняться поиск. |
Если поле не заполнено, то берется значение из поля "Индекс столбца конечной ячейки" | Robin.String | Нет | ||
Индекс столбца конечной ячейки | Индекс столбца конечной ячейки, до которой будет выполняться поиск. Если поле не заполнено, то берется граница используемой области | Robin.Numeric | Нет | |
Строка конечной ячейки | Строка конечной ячейки, до которой будет выполняться поиск. |
Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки.
По умолчанию применяются границы используемой области из контекста | Robin.Numeric |
Строка
Нет |
Пропускать скрытые |
Скрытые ячейки не будут участвовать в поиске |
Robin.Boolean | true | Нет | |
Текст |
Текст, поиск которого будет осуществляться |
Строка
Robin.String | Да | ||
Метод поиска |
Search method
Принцип соответствия введенного текста значениям ячеек.
Выпадающий список:
- Полное - xsFull
- Содержит - xsContains
- Начинается - xsStart
- Заканчивается - xsEnd
По умолчанию xsFull
Метод поиска. По умолчанию будет применён полнотекстовый поиск | Robin.String |
Нет | ||||
Результаты | ||||
Результат |
Словарь |
Название ключа - это адрес ячейки, которая была найдена. В словаре может быть не единственный элемент. Т.е., например, если в таблице есть несколько ячеек, в которых можно найти указанный текст, то в результирующем словаре будет столько ключей, сколько было найдено таких ячеек
с элементами - найденными ячейками: ключ элемента = адрес ячейки, значение элемента = значение ячейки | Robin.Dictionary |
Особые условия использования
Если поле диапазон поиска не задан, то поиск осуществляется по всей используемой области на листе.
Пример использования
Задача
: Существует Excel-документ. Excel.xlsx.
Необходимо найти конкретное слово “RUB” или текст в этом документе.
...
Решение
Решение: Для реализации действия нужны следующие действия - "Открыть", "Найти текст".
Реализация
...
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. Параметры действия "Найти текст"
- Собрать схему робота, состоящую из действий.
- Укажем параметры в действии “Открыть 1”.
- Укажем параметры в действии “Найти текст”.
- Укажем параметры в действии “Сохранить”.
- Нажмем на кнопку “Старт” и посмотрим результат.
Результат
Необходимое слово было успешно найдено.
Результат:
Текст найден. В логах отображается результат в количестве найденных слов или текста.
Рис.3. Результат поиска.