Изменить формат диапазона Р7 Версия 1 (Python)
Группа действий: P7-Офис
Описание
Действие изменяет формат значений в указанном диапазоне ячеек
Параметры действия
Входные параметры
Контекст Контекст документа табличного типа, открытого в Р7-Офис.
Имя столбца начальной ячейки Имя столбца начальной ячейки диапазона. Если поле не заполнено, начальный столбец будет определен по значению из поля "Индекс столбца начальной ячейки".
Индекс столбца начальной ячейки Порядковый номер столбца начальной ячейки диапазона. Нумерация начинается с 1. Если поле не заполнено, будет взят индекс первого столбца в используемой области.
Индекс строки начальной ячейки Порядковый номер строки начальной ячейки диапазона. Нумерация начинается с 1. Если поле не заполнено, будет взят индекс первой строки в используемой области.
Имя столбца конечной ячейки Имя столбца конечной ячейки диапазона. Если поле не заполнено, конечный столбец будет определен по значению из поля "Индекс столбца конечной ячейки".
Индекс столбца конечной ячейки Порядковый номер столбца конечной ячейки диапазона. Нумерация начинается с 1. Если поле не заполнено, будет взят индекс последнего столбца в используемой области.
Индекс строки конечной ячейки Порядковый номер строки конечной ячейки диапазона. Нумерация начинается с 1. Если поле не заполнено, будет взят индекс последней строки в используемой области.
Выпадающий список "Формат" Формат, который будет установлен в ячейках диапазона.
Маска формата Маска для создания пользовательского формата. Указанная маска будет применена, только если в поле Формат" выбрано значение "Пользовательский".
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Контекст документа табличного типа, открытого в Р7-Офис | P7-Офис таблицы | Да | |
Имя столбца начальной ячейки | Starting cell column name | Имя столбца начальной ячейки диапазона. Если поле не заполнено, начальный столбец будет определен по значению из поля "Индекс столбца начальной ячейки" | Строка | Нет | |
Индекс столбца начальной ячейки | Starting cell column index | Порядковый номер столбца начальной ячейки диапазона. Нумерация начинается с 1. Если поле не заполнено, будет взят индекс первого столбца в используемой области | Число | Нет | |
Индекс строки начальной ячейки | Row index of the starting cell | Порядковый номер строки начальной ячейки диапазона. Нумерация начинается с 1. Если поле не заполнено, будет взят индекс первой строки в используемой области | Число | Нет | |
Имя столбца конечной ячейки | End cell column name | Имя столбца конечной ячейки диапазона. Если поле не заполнено, конечный столбец будет определен по значению из поля "Индекс столбца конечной ячейки" | Строка | Нет | |
Индекс столбца конечной ячейки | End cell column index | Порядковый номер столбца конечной ячейки диапазона. Нумерация начинается с 1. Если поле не заполнено, будет взят индекс последнего столбца в используемой области | Число | Нет | |
Индекс строки конечной ячейки | End cell row index | Порядковый номер строки конечной ячейки диапазона. Нумерация начинается с 1. Если поле не заполнено, будет взят индекс последней строки в используемой области | Число | Нет | |
Формат | Format | Формат, который будет установлен в ячейках диапазона | Строка | Да | |
Маска формата | Format mask | Маска для создания пользовательского формата. Указанная маска будет применена, только если в поле "Формат" выбрано значение "Пользовательский" | Строка | Нет | |
Результаты | |||||
Результат | Result | Переменная логического типа, содержащая результат действия. | Логический | Логическая_переменная | Нет |
Особые условия использования
- Если имя начального/конечного столбца не заполнено, то берется значение индекса начального/конечного столбца.
- Если заполнено имя и индекс столбца, то берется значение имени столбца.
- Форматы, которые можно изменить в ячейках: Общий, Числовой, Научный, Финансовый, Денежный, Дата, Время, Процентный, Дробный, Текстовый, Пользовательский.
Для корректного запуска действий из под ОС Windows необходимо добавить плагин в "Р-7 Офис":
- Открыть "Р-7 Офис".
- Перейти на вкладку "Плагины".
- Перейти в "Настройки".
- В открывшемся окне нажать на кнопку "Добавить плагин".
- В открывшемся окне Проводника, выбрать файл плагина.
- После вышеперечисленных действий в окошке появится плагин для работы с платформой "Robin".
- "Р-7 Офис" готов к работе с платформой "Robin".
Плагин передается пользователю при поставке студии.
При работе с ОС Linux необходимо руководствоваться инструкциями по работе Студии с ОС Linux.
Пример использования
Задача
Существует табличный документ, в ячейках которого установлен "числовой" формат.
Установить "денежный" формат ячеек в табличном документе.
Решение
Установить на рабочую область действия "Открыть", "Изменить формат диапазона", "Сохранить".
Заполнить параметры действий
Запустить робота.
Реализация
- Собрать схему робота, состоящую из действий:
- Настроить параметры для действия "Открыть".
- Поле "Путь к файлу". Указать путь к табличному документу, который необходимо открыть.
- Поле "Путь к файлу". Указать путь к табличному документу, который необходимо открыть.
- Настроить параметры для действия "Установить формат диапазона".
- Поле "Контекст". Указать контекст открытого табличного документа.
- Поле "Имя столбца начальной ячейки". Указать имя столбца начальной ячейки диапазона, в котором будет устанавливаться новый формат.
- Поле "Строка начальной ячейки". Указать номер начальной строки диапазона, в котором будет устанавливаться новый формат.
- Поле "Имя столбца конечной ячейки". Указать имя столбца конечной ячейки диапазона, в котором будет устанавливаться новый формат.
- Поле "Строка конечной ячейки". Указать номер конечной строки диапазона, в котором будет устанавливаться новый формат.
- Поле "Формат". Указать формат, который будет установлен в выбранных ячейках.
- Настроить параметры для действия "Сохранить".
- Поле "Контекст". Указать контекст открытого табличного документа.
- Поле "Контекст". Указать контекст открытого табличного документа.
- Запустить робота по кнопке "Старт" в верхней панели.
Результат
Робот отработал успешно.
Действие установило "денежный" формат в выбранном диапазоне.