Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

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 documentsExcel 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-го символа и не должны содержать двоеточий, косых черт, вопросительных знаков, звездочек и квадратных скобок.

 

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

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


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".


Example of use  


Task: you need to rename the first sheet in an Excel document to "New sheetЗадача: необходимо переменовать первый лист в Excel-документе на "Новый лист". 

Image Modified

Решение: воспользоваться действиями "ОткрытьSolution: use the actions "Open", "Переименовать листRename sheet", "СохранитьSave". 

РеализацияImplementation:

  1. Assemble a robot scheme from the actions:Собрать схему робота из действий: 
  2. Настроить параметр действия "Открыть"Customize the "Open" action parameter.

    Настроить параметры действия "
  3. Customize the parameters of the "Rename sheet" action.Переименовать лист". 
  4. Настроить параметр действия "Сохранить"Customize the "Save" action parameter
  5. Запустить робота по кнопке "Старт" в верхней панелиLaunch the robot using the "Start" button in the top panel

РезультатResult:

Программный робот отработал успешноThe software robot worked successfully

Первый лист в документе переименованThe first sheet in the document has been renamed.