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

Ключ

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

...

Определяет через имя или индекс будет определен лист,

Выпадающий список:

  • Имя листа
  • Индекс листа

После выбора значения этого поля, действие будет обращаться либо к значению поля "Имя опорного листа", либо к значению поля "Индекс опорного листа".

Свойство

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

Описание

Тип

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

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

Параметры

КонтекстContextУникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДа
Имя нового листаNew sheet name

Имя нового листа, который будет создан.

Robin.StringЛист2ДаИдентификатор листаSheet identifier
Robin.String

Индекс листа

ДаИмя опорного листаStarting sheet name

Имя листа, после которого будет создан новый лист.

Данный параметр имеет приоритет перед параметром  "Индекс опорного листа"

Robin.StringЛист1Нет
Индекс опорного листаStarting sheet index

Порядковый номер листа, после которого будет создан новый лист.

Порядковый номер отсчитывается от "1"

Robin.Numeric1Нет

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

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

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

Задача:

Существует Excel-документ "Test.xlsx".

Необходимо добавить в документ новый лист. Наименование нового листа - "Реестр".

Решение:

  1. Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
  2. Добавить новый лист.
  3. Сохранить документ.

Реализация:

  1. Открываем группу действий "Excel".
  2. Открываем подгруппу "Листы"
  3. Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть"). 
  4. Помещаем в рабочее пространство студии действие "Добавить новый лист". 
    Настройка действия: 
    1. Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
    2. Параметр "Имя нового листа". Указываем наименование нового листа в документе.
    3. Параметр "Имя листа". Указываем лист по отношению к которому добавляется лист.
  5. Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ"). 
  6. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Документ "Test.xlsx" содержит новый лист.

Лист будет добавлен после текущего листа и сразу активирован.

Удалить лист / Delete sheet

...

Удаляет страницу лист из документа.  

Настройки

Свойство

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

Описание

Тип

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

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

Параметры

КонтекстContextУникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДа
Идентификатор листаSheet identifier

Определяет через имя или индекс будет определен лист.


Выпадающий список:

  • Имя листа
  • Индекс листа

После выбора значения этого поля, действие будет обращаться либо к значению поля "Имя листа", либо к значению поля "Индекс листа".

Robin.String

Индекс листа

Да
Имя листаSheet name

Наименование листа, к которому будет применено действие.

Данный параметр имеет приоритет перед параметром  "Индекс листа".

Robin.String
Лист2
Лист1Нет
Индекс листаSheet index

Порядковый номер листа, к которому будет применено действие.
Порядковый номер начинается с "1".

Robin.Numeric
2
1Нет


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

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

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

Задача:

Существует Excel-документ "Test.xlsx".

Image Removed

Необходимо удалить из документа заданный лист. 

Решение:

  1. Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
  2. Удалить лист.
  3. Сохранить документ.

Реализация:

  1. Открываем группу действий "Excel".
  2. Открываем подгруппу "Листы"
  3. Помещаем в рабочее пространство студии действие "Открыть" (см. описание действия "Открыть"). 
  4. Помещаем в рабочее пространство студии действие "Удалить лист". 
    Настройка действия: 
    1. Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
    2. Параметр "Имя листа". Указываем наименование удаляемого листа из документа.
      Image Removed
  5. Помещаем в рабочее пространство студии действие "Сохранить документ" (см. описание действия "Сохранить документ"). 
  6. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Из документа "Test.xlsx" удален лист.
Image Removed

...

Отсутствуют.

Активировать лист / Activate sheet

...

Указывает страницу, к которой необходимо применить действия алгоритма. 

Настройки

Свойство

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

Описание

Тип

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

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

Параметры

КонтекстContextУникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДа
Идентификатор листаSheet identifier

Определяет через имя или индекс будет определен лист.


Выпадающий список:

  • Имя листа
  • Индекс листа

После выбора значения этого поля, действие будет обращаться либо к значению поля "Имя листа", либо к значению поля "Индекс листа".

Robin.String

Индекс листа

Да
Имя листаSheet name

Наименование листа, к которому будет применено действие

.Данный параметр имеет приоритет перед параметром  "Индекс листа"

.

Robin.String
Лист2
Лист1Нет
Индекс листаSheet index

Порядковый номер листа, к которому будет применено действие.
Порядковый номер начинается с "1".

Robin.Numeric1Нет


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

Если данный блок отсутствует - по умолчанию робот будет работать с последней активной страницей

...

.

Если

...

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

Если оба параметра "Имя листа" и "Индекс листа" не указаны, будет

...

вызвана ошибка.

Получить информацию о документе / Get document information

...

Получает список и количество листов документа

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

Задача:

Существует Excel-документ "Test.xlsx" с рабочим листом "Лист1".

Image Removed

Необходимо указать Лист2 рабочим листом и установить в ячейку "b2" значение переменной "Телефон".

Решение:

  1. Для любых действий с конкретным Excel-документом, необходимо сперва открыть документ, создать его уникальный идентификатор (Контекст), чтобы в дальнейшем обращать действия именно к конкретному документу. Открыть документ "Test.xlsx".
  2. Установить рабочий лист.
  3. Установить в ячейке значение.
  4. Сохранить документ.

Реализация:

  1. Открываем группу действий "Excel".
  2. Открываем подгруппу "Листы"
  3. Помещаем в рабочее пространство студии действие "Открыть". 
  4. Помещаем в рабочее пространство студии действие "Установить рабочий лист". 
    Настройка действия: 
    1. Параметр "Контекст". Выбираем из выпадающего списка контекст соответствующий файлу "Test.xlsx".
    2. Параметр "Имя листа". Указываем наименование нового рабочего листа в документе.
      Image Removed
  5. Помещаем в рабочее пространство студии действие "Установить значение ячейки". 
  6. Помещаем в рабочее пространство студии действие "Сохранить" . 
  7. Запускаем робота по кнопке "Запуск" в верхней панели.

Результат:

Документ содержит на рабочем листе "Лист2" в ячейке "B2" значение "89265555517".

Image Removed

Получить имя листа / Get sheet name

...


Настройки

Порядковый номер листа, к которому будет применено действие.
Порядковый номер начинается с "1"NumericResult имя листаStringResult

Свойство

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

Описание

Тип

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

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

Параметры

КонтекстContextУникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДаИндекс листаSheet index
Результаты
Список листовList of sheetsПеременная, в которую будет записаны имена всех листов документа.Robin.Collection1Да
Результаты
List of sheets
Количество листовNumber of sheetsРезультатПеременная, в которую будет записано количество листов в документе.Robin.NumericNumber of sheets

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

Отсутствуют.

...

 Узнать активный лист / Get

...

active sheet information

...

Получить

...

имя и индекс листа

Настройки

Свойство

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

Описание

Тип

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

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

Параметры

КонтекстContextУникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДа
Результаты
Результат
Имя листа
Result
Sheet nameПеременная, в которую будет записано
количество листов в документе
имя активного листа.Robin.StringSheet name
Индекс листаSheet indexПеременная, в которую будет записан индекс активного листа.Robin.Numeric
Result
Sheet index

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

Отсутствуют.

Скрыть лист / Hide sheet

Получить имя листа / Get sheet name

...

Получить имя листа. Скрыть страницу из документа.

Настройки

Свойство

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

Описание

Тип

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

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

Параметры

КонтекстContextУникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДа
Идентификатор
Индекс листаSheet
identifier

Определяет через имя или индекс будет определен лист.

Выпадающий список:

  • Имя листа
  • Индекс листа
После выбора значения этого поля, действие будет обращаться либо к значению поля "Имя опорного листа", либо к значению поля "Индекс опорного листа"
index

Порядковый номер листа, к которому будет применено действие.
Порядковый номер начинается с "1".

Robin.
String
Numeric
Индекс листа
1Да
Результаты
Имя листа
Результат
Sheet name
Result

Имя листа, после которого будет создан новый лист.

Данный параметр имеет приоритет перед параметром  "Индекс опорного листа"
Переменная, в которую будет записано имя листа.Robin.String
Лист1НетИндекс листаSheet index

Порядковый номер листа, после которого будет создан новый лист.

Порядковый номер отсчитывается от "1"

Robin.Numeric1Нет
Result

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

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

Показать скрытый лист / Show hidden sheet

Отсутствуют.

Получить количество листов / Get sheets number

...

Получить количество листов в документе. Открывает скрытый лист в Excel-документ.

Настройки

Свойство

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

Описание

Тип

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

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

Параметры

КонтекстContextУникальный идентификатор сеанса, к которому будет применено действие.Robin.ExcelEXCEL_INSTANCEДа
Идентификатор листа
Результаты
Sheet identifier

Определяет через имя или индекс будет определен лист.

Выпадающий список:

  • Имя листа
  • Индекс листа

После выбора значения этого поля, действие будет обращаться либо к значению поля "Имя опорного листа", либо к значению поля "Индекс опорного листа".

Robin.String

Индекс листа

ДаИмя листаSheet name

Имя листа, после которого будет создан новый лист.

Данный параметр имеет приоритет перед параметром  "Индекс опорного листа"

Robin.StringЛист1НетИндекс листаSheet index

Порядковый номер листа, после которого будет создан новый лист.

Порядковый номер отсчитывается от "1"

Robin.Numeric1Нет

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

...

РезультатResult

Переменная, в которую будет записано количество листов в документе.

Robin.NumericResult


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

Отсутствуют.