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

Ключ

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

Rename sheet 

Action group

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

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

Описание

...

Description

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

...

Icon


...

Settings

Свойство

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.ExcelEXCEL_INSTANCEДаYes
Sheet identification
Способ идентификации
Identification method

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

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

Robin.StringДа

A dropdown 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Имя листа
Sheet Name
Наименование листа, к которому будет применено действие. Если параметр указывает на скрытый лист, то действие завершится с ошибкой.Robin.StringНетИндекс листа
Sheet index
Порядковый номер листа, к которому будет применено действие. Нумерация начинается с "1". Если параметр указывает на скрытый лист, то действие завершится с ошибкой.Robin.NumericНетНовое имя листа
New sheet name
Новое наименование листа.  Длина имени не должна превышать 31-го символа, содержать The new name of the sheet.  The name must not exceed 31 characters in length, contain ":", "/", "\", "?", "*", "[" и and "]", иначе действие завершится с ошибкойotherwise the action will fail.Robin.StringДа

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

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

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

 

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

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

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

Image Removed

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

Реализация:

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

Результат:

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

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


Example of use  


Task: you need to rename the first sheet in an Excel document to "New sheet". 

Image Added

Solution: use the actions "Open", "Rename sheet", "Save".Solution: use the actions "Open", "Rename sheet", "Save".

Implementation:

  1. Assemble a robot scheme from the actions:Image Added
  2. Customize the "Open" action parameter.
    Image Added
  3. Customize the parameters of the "Rename sheet" action.
    Image Added
  4. Customize the "Save" action parameter. 
    Image Added
  5. Launch the robot using the "Start" button in the top panel. 

Result:

The software robot worked successfully. 

Image Added

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