История страницы

Найти текст

...

Версия 13 (Net)

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

...

Описание

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

Image Removed

, которая содержит заданный текст

Иконка действия

Image Added

Параметры и их настройки

...

Свойство

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

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

Context

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

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

EXCEL_INSTANCEДа

Контекст действия для работы с Excel-документом	Robin.Excel	Контекст excel	Да
Имя столбца начальной ячейки	Имя столбца

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

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

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

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

.

Строка

A1

из контекста

Robin.Numeric

Нет

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

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

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

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

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

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

.

Строка

B3

из контекста

Robin.Numeric

Нет

Пропустить

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

ячейкиSkip hidden

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

Robin.

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

Boolean

Логический

true	Нет
Текст

Text

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

.

Строка

10

	Robin.String		Да
Метод поиска

Search method

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

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

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

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

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

Robin.String

СтрокаxsFull

		Нет
Результаты
Результат

Result

Словарь

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

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

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

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

Robin.Dictionary

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

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

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

Задача

: Существует Excel-документ. Excel.xlsx.
Image Added
Необходимо найти конкретное слово “RUB” или текст в этом документе.

Решение

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

Реализация

...

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

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

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

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

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

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

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

Image Removed

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

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

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

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

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

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

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

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

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

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

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

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

Image Removed