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