Добавить новый лист / 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 | Нет |
Порядок (Вставка "перед") | "Before" insertion | Вставить новый лист перед опорным листом. По умолчанию false - лист вставляется после опорного листа. | Robin.Boolean | true | Нет |
Особые условия использования
Отсутствуют.
Пример использования
Задача:
Существует 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 | Да |
Особые условия использования
Отстутствуют.