Добавить новый лист / Add new sheet
Добавляет новый лист в Excel-документ.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Имя нового листа | New sheet name | Имя нового листа, который будет создан. | Robin.String | Лист2 | Да |
Особые условия использования
Лист будет добавлен после текущего листа и сразу активирован.
Удалить лист / Delete sheet
Удаляет лист из документа.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Идентификатор листа | Sheet identifier | Определяет способ идентификации листа через имя или индекс. Выпадающий список:
После выбора значения этого поля, действие будет обращаться либо к значению поля "Имя листа", либо к значению поля "Индекс листа". | Robin.String | Индекс листа | Да |
Имя листа | Sheet name | Наименование листа, к которому будет применено действие. | Robin.String | Лист1 | Нет |
Индекс листа | Sheet index | Порядковый номер листа, к которому будет применено действие. | Robin.Numeric | 1 | Нет |
Особые условия использования
Единственный существующий лист удалить нельзя, будет вызвана ошибка.
Активный лист не меняется, если не он был выбран на удаление.
Если был удален активный лист, то активным становится следующий по порядку, если он существует.
Если следующего листа не существует, активизируется предыдущий.
Активировать лист / Activate sheet
Устанавливает активный лист документа.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Идентификатор листа | Sheet identifier | Определяет через имя или индекс будет определен лист. Выпадающий список:
После выбора значения этого поля, действие будет обращаться либо к значению поля "Имя листа", либо к значению поля "Индекс листа". | Robin.String | Индекс листа | Да |
Имя листа | Sheet name | Наименование листа, к которому будет применено действие. | Robin.String | Лист1 | Нет |
Индекс листа | Sheet index | Порядковый номер листа, к которому будет применено действие. | Robin.Numeric | 1 | Нет |
Особые условия использования
Если параметр указывает на скрытый лист, действие завершится ошибкой.
Если оба параметра "Имя листа" и "Индекс листа" не указаны, будет вызвана ошибка.
Получить имена листов / Get sheet names
Получает список листов документа и их количество.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.Excel | EXCEL_INSTANCE | Да |
Результаты | |||||
Имена | Names | Переменная, в которую будет записаны имена всех листов документа. | Robin.Collection | List of sheets |
Особые условия использования
Отсутствуют.
Переименовать лист / Rename Sheet
Группа действий: Excel
Действие позволяет переименовать лист в Excel.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Контекст действия для работы с Excel-документами | Robin.Excel | EXCEL_INSTANCE | Да |
Способ идентификации | Identification method | Выпадающий список из элементов: "По имени листа", "По индексу листа" Выбор способа идентификации листа для переименования: по имени или индексу. | Robin.String | Да | |
Имя листа | Sheet Name | Наименование листа, к которому будет применено действие. Если параметр указывает на скрытый лист, то действие завершится с ошибкой. | Robin.String | Нет | |
Индекс листа | Sheet index | Порядковый номер листа, к которому будет применено действие. Нумерация начинается с "1". Если параметр указывает на скрытый лист, то действие завершится с ошибкой. | Robin.Numeric | Нет | |
Новое имя листа | New sheet name | Новое наименование листа. Длина имени не должна превышать 31-го символа, содержать ":", "/", "\", "?", "*", "[" и "]", иначе действие завершится с ошибкой. | Robin.String | Да |
Особые условия использования
Робот вернет ошибку, если:
- параметр указывает на скрытый лист;
- введены несуществующие данные для идентификации листа;
- введено некорректное "Новое имя листа".
- Имена листов не должны быть пустыми, не должны превышать 31-го символа и не должны содержать двоеточий, косых черт, вопросительных знаков, звездочек и квадратных скобок.
Если пользователь введет значения в оба поля "Имя листа" и "Индекс листа", робот не выдаст ошибку. Выбор будет произведен способом, указанным в "Способе идентификации".