История страницы

Rename sheet Version 2 (Net)

Action group

Переименовать лист

Группа действий: Excel

Описание

...

Description

The action allows you to rename a sheet in Действие позволяет переименовать лист в Excel.

...

Icon

Image AddedImage Removed

...

Settings of parameters

...

Англ. наименование

Property

Описание

Description

Тип

Пример заполнения

Обязательность заполнения поля

Type	Example of filling in	Obligatory to fill in the field
Parameters
Context	Action context for working with Excel documents	Excel instance

Параметры

КонтекстContextКонтекст действия для работы с Excel-документамиRobin.Excel

EXCEL_INSTANCE

ДаСпособ идентификации

Yes

Sheet identification

Identification

 method

Выпадающий список из элементов: "По имени листа", "По индексу листа"

Выбор способа идентификации листа для переименования: по имени или индексу.

A drop-down list of elements: "Via sheet name", "Via sheet index" Selects whether to identify the sheet to be renamed by name or by index	String		Yes
Sheet name	Name of the sheet to which the action will be applied. If the parameter indicates a hidden sheet, the action will cause an error.	String		No
Sheet index	The sequence number of the sheet to which the action will be applied. The numbering starts with "1". If the parameter indicates a hidden sheet, the action will cause an error.	Numeric		No
New sheet name	The new name of the sheet. The name must not exceed 31 characters in length, contain

Robin.StringДаИмя листа

Sheet Name

Наименование листа, к которому будет применено действие. Если параметр указывает на скрытый лист, то действие завершится с ошибкой.Robin.StringНетИндекс листа

Sheet index

Порядковый номер листа, к которому будет применено действие. Нумерация начинается с "1". Если параметр указывает на скрытый лист, то действие завершится с ошибкой.Robin.NumericНетНовое имя листа

New sheet name

Новое наименование листа. Длина имени не должна превышать 31-го символа, содержать

":", "/", "\", "?", "*", "["

и

and "]",

иначе действие завершится с ошибкой

otherwise the action will fail.

Robin.

String

Да

Особые условия использования

Робот вернет ошибку, если:

параметр указывает на скрытый лист;
введены несуществующие данные для идентификации листа;
введено некорректное "Новое имя листа".
- Имена листов не должны быть пустыми, не должны превышать 31-го символа и не должны содержать двоеточий, косых черт, вопросительных знаков, звездочек и квадратных скобок.

Если пользователь введет значения в оба поля "Имя листа" и "Индекс листа", робот не выдаст ошибку. Выбор будет произведен способом, указанным в "Способе идентификации".

Пример использования

Задача: необходимо переменовать первый лист в Excel-документе на "Новый лист".

Image Removed

Решение: воспользоваться действиями "Открыть", "Переименовать лист", "Сохранить".

Реализация:

Собрать схему робота из действий:
Image Removed
Настроить параметр действия "Открыть".
Image Removed
Настроить параметры действия "Переименовать лист".
Image Removed
Настроить параметр действия "Сохранить".
Image Removed
Запустить робота по кнопке "Старт" в верхней панели.

Результат:

Программный робот отработал успешно.

Image Removed

Первый лист в документе переименован.

Yes

Special conditions of use

The robot will return an error if:

a parameter indicates a hidden sheet;
non-existent data for sheet identification is entered;
an incorrect "New sheet name" is entered.
- Sheet names must not be empty, must not exceed 31 characters and must not contain colons, slashes, question marks, asterisks and square brackets.

If the user enters values in both fields "Sheet name" and "Sheet index", the robot will not generate an error. The selection will be made in the way specified in "Sheet identification method".