История страницы
...
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля | |||
---|---|---|---|---|---|---|---|---|
Параметры | ||||||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да | |||
Имя нового листа | New sheet name | Имя нового листа, который будет создан. | Robin.String | Лист2 | Да | Идентификатор листа | Sheet identifier | |
Robin.String | Индекс листа | Да | Имя опорного листа | Starting sheet name | Имя листа, после которого будет создан новый лист. Данный параметр имеет приоритет перед параметром "Индекс опорного листа" | Robin.String | Лист1 | Нет |
Индекс опорного листа | Starting sheet index | Порядковый номер листа, после которого будет создан новый лист. Порядковый номер отсчитывается от "1" | Robin.Numeric | 1 | Нет |
Особые условия использования
Если оба параметра "Имя опорного листа" и "Индекс опорного листа" не указаны, активный лист будет взят, как опорный.
Пример использования
Задача:
Существует Excel-документ "Test.xlsx".
Необходимо добавить в документ новый лист. Наименование нового листа - "Реестр".
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
- Добавить новый лист.
- Сохранить документ.
Реализация:
- Открываем группу действий "Excel".
- Открываем подгруппу "Листы"
- Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
- Помещаем в рабочее пространство студии действие "Добавить новый лист".
Настройка действия:- Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
- Параметр "Имя нового листа". Указываем наименование нового листа в документе.
- Параметр "Имя листа". Указываем лист по отношению к которому добавляется лист.
- Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Документ "Test.xlsx" содержит новый лист.
Лист будет добавлен после текущего листа и сразу активирован.
Удалить лист / Delete sheet
...
Удаляет страницу лист из документа.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Идентификатор листа | Sheet identifier | Определяет через имя или индекс будет определен лист. Выпадающий список:
После выбора значения этого поля, действие будет обращаться либо к значению поля "Имя листа", либо к значению поля "Индекс листа". | Robin.String | Индекс листа | Да |
Имя листа | Sheet name | Наименование листа, к которому будет применено действие. |
Данный параметр имеет приоритет перед параметром "Индекс листа".
Robin.String |
Лист1 | Нет | ||
Индекс листа | Sheet index | Порядковый номер листа, к которому будет применено действие. | Robin.Numeric |
1 | Нет |
Особые условия использования
Если оба параметра "Имя листа" и "Индекс листа" не указаны, будет удален активный лист.
Пример использования
Задача:
Существует Excel-документ "Test.xlsx".
Необходимо удалить из документа заданный лист.
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
- Удалить лист.
- Сохранить документ.
Реализация:
- Открываем группу действий "Excel".
- Открываем подгруппу "Листы"
- Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
- Помещаем в рабочее пространство студии действие "Удалить лист".
Настройка действия:- Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
- Параметр "Имя листа". Указываем наименование удаляемого листа из документа.
- Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Из документа "Test.xlsx" удален лист.
...
Отсутствуют.
Активировать лист / Activate sheet
...
Указывает страницу, к которой необходимо применить действия алгоритма.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Идентификатор листа | Sheet identifier | Определяет через имя или индекс будет определен лист. Выпадающий список:
После выбора значения этого поля, действие будет обращаться либо к значению поля "Имя листа", либо к значению поля "Индекс листа". | Robin.String | Индекс листа | Да |
Имя листа | Sheet name | Наименование листа, к которому будет применено действие |
. | Robin.String |
Лист1 | Нет | ||||
Индекс листа | Sheet index | Порядковый номер листа, к которому будет применено действие. | Robin.Numeric | 1 | Нет |
Особые условия использования
Если данный блок отсутствует - по умолчанию робот будет работать с последней активной страницей
...
.
Если
...
параметр указывает на скрытый лист, действие завершится ошибкой.
Если оба параметра "Имя листа" и "Индекс листа" не указаны, будет
...
вызвана ошибка.
Получить информацию о документе / Get document information
...
Получает список и количество листов документа
Пример использования
Задача:
Существует Excel-документ "Test.xlsx" с рабочим листом "Лист1".
Необходимо указать Лист2 рабочим листом и установить в ячейку "b2" значение переменной "Телефон".
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
- Установить рабочий лист.
- Установить в ячейке значение.
- Сохранить документ.
Реализация:
- Открываем группу действий "Excel".
- Открываем подгруппу "Листы"
- Помещаем в рабочее пространство студии действие "Открыть".
- Помещаем в рабочее пространство студии действие "Установить рабочий лист".
Настройка действия:- Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
- Параметр "Имя листа". Указываем наименование нового рабочего листа в документе.
- Помещаем в рабочее пространство студии действие "Установить значение ячейки".
- Помещаем в рабочее пространство студии действие "Сохранить" .
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Документ содержит на рабочем листе "Лист2" в ячейке "B2" значение "89265555517".
Получить имя листа / Get sheet name
...
.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля | ||||
---|---|---|---|---|---|---|---|---|---|
Параметры | |||||||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да | Индекс листа | Sheet index | Порядковый номер листа, к которому будет применено действие.||
Результаты | |||||||||
Список листов | List of sheets | Переменная, в которую будет записаны имена всех листов документа. | Robin. | NumericCollection | 1 | Да | |||
Результаты | |||||||||
List of sheets | |||||||||
Количество листов | Number of sheets | Результат | ResultПеременная, в которую будет записано | имя листаколичество листов в документе. | Robin. | StringNumeric | ResultNumber of sheets |
Особые условия использования
Отсутствуют.
...
Узнать активный лист / Get
...
active sheet information
...
Получить
...
имя и индекс листа.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Результаты |
Имя листа |
Sheet name | Переменная, в которую будет записано |
имя активного листа. | Robin.String | Sheet name | |
Индекс листа | Sheet index | Переменная, в которую будет записан индекс активного листа. | Robin.Numeric |
Sheet index |
Особые условия использования
Отсутствуют.
Скрыть лист / Hide sheet
Получить имя листа / Get sheet name
...
Получить имя листа. Скрыть страницу из документа.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Индекс листа | Sheet |
Определяет через имя или индекс будет определен лист.
Выпадающий список:
- Имя листа
- Индекс листа
index | Порядковый номер листа, к которому будет применено действие. | Robin. |
Numeric |
1 | Да | ||||
Результаты |
Результат |
Result |
Имя листа, после которого будет создан новый лист.
Данный параметр имеет приоритет перед параметром "Индекс опорного листа"Переменная, в которую будет записано имя листа. | Robin.String |
Порядковый номер листа, после которого будет создан новый лист.
Порядковый номер отсчитывается от "1"
Result |
Особые условия использования
Если оба параметра "Имя листа" и "Индекс листа" не указаны, будет скрыт активный лист.
Показать скрытый лист / Show hidden sheet
Отсутствуют.
Получить количество листов / Get sheets number
...
Получить количество листов в документе. Открывает скрытый лист в Excel-документ.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Результаты |
Определяет через имя или индекс будет определен лист.
Выпадающий список:
- Имя листа
- Индекс листа
После выбора значения этого поля, действие будет обращаться либо к значению поля "Имя опорного листа", либо к значению поля "Индекс опорного листа".
Индекс листа
Имя листа, после которого будет создан новый лист.
Данный параметр имеет приоритет перед параметром "Индекс опорного листа"
Порядковый номер листа, после которого будет создан новый лист.
Порядковый номер отсчитывается от "1"
Особые условия использования
...
Результат | Result | Переменная, в которую будет записано количество листов в документе. | Robin.Numeric | Result |
Особые условия использования
Отсутствуют.