Переименовать лист
Группа действий: 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-го символа и не должны содержать двоеточий, косых черт, вопросительных знаков, звездочек и квадратных скобок.
Если пользователь введет значения в оба поля "Имя листа" и "Индекс листа", робот не выдаст ошибку. Выбор будет произведен способом, указанным в "Способе идентификации".
Пример использования
Задача: необходимо переменовать первый лист в Excel-документе на "Новый лист".
Решение: воспользоваться действиями "Открыть", "Переименовать лист", "Сохранить".
Реализация:
- Собрать схему робота из действий:
- Настроить параметр действия "Открыть".
- Настроить параметры действия "Переименовать лист".
- Настроить параметр действия "Сохранить".
- Запустить робота по кнопке "Старт" в верхней панели.
Результат:
Программный робот отработал успешно.
Первый лист в документе переименован.