Добавить новый лист / Add new sheet
Добавляет новый лист в Excel-документ.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Имя нового листа | New sheet name | Имя нового листа, который будет создан. | Robin.String | Лист2 | Да |
Имя опорного листа | 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 name | Наименование листа, к которому будет применено действие. Данный параметр имеет приоритет перед параметром "Индекс листа". | Robin.String | Лист2 | Нет |
Индекс листа | Sheet index | Порядковый номер листа, к которому будет применено действие. Порядковый номер начинается с "1". | Robin.Numeric | 2 | Нет |
Особые условия использования
Если оба параметра "Имя листа" и "Индекс листа" не указаны, будет удален активный лист.
Пример использования
Задача:
Существует Excel-документ "Test.xlsx".
Необходимо удалить из документа заданный лист.
Решение:
- Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
- Удалить лист.
- Сохранить документ.
Реализация:
- Открываем группу действий "Excel".
- Открываем подгруппу "Листы"
- Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть").
- Помещаем в рабочее пространство студии действие "Удалить лист".
Настройка действия:- Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
- Параметр "Имя листа". Указываем наименование удаляемого листа из документа.
- Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ").
- Запускаем робота по кнопке "Запуск" в верхней панели.
Результат:
Из документа "Test.xlsx" удален лист.
Установить рабочий лист / Set active sheet
Указывает страницу, к которой необходимо применить действия алгоритма.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Имя листа | Sheet name | Наименование листа, к которому будет применено действие. Данный параметр имеет приоритет перед параметром "Индекс листа". | Robin.String | Лист2 | Нет |
Индекс листа | Sheet index | Порядковый номер листа, к которому будет применено действие. | Robin.Numeric | 1 | Нет |
Особые условия использования
Если данный блок отсутствует - по умолчанию робот будет работать с последней активной страницей.
Параметр "Индекс листа" определяется только по видимым листам.
Если параметры "Имя листа" и "Индекс листа" указывают на разные листы, приоритет будет отдан параметру "Имя листа".
Если параметр "Имя листа" указывает на скрытый лист, действие завершится ошибкой.
Если оба параметра "Имя листа" и "Индекс листа" не указаны, будет установлен рабочим активный лист.
Пример использования
Задача:
Существует 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 | Порядковый номер листа, к которому будет применено действие. | Robin.Numeric | 1 | Да |
Результаты | |||||
Результат | Result | Переменная, в которую будет записано имя листа. | Robin.String | Result |
Особые условия использования
Отсутствуют.
Получить количество листов / Get sheets number
Получить количество листов в документе.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Результаты | |||||
Результат | Result | Переменная, в которую будет записано количество листов в документе. | Robin.Numeric | Result |
Особые условия использования
Отсутствуют.