Изменить формат диапазона Р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 | Переменная логического типа, содержащая результат действия. | Логический | Логическая_переменная | Нет |
Особые условия использования
- Если имя начального/конечного столбца не заполнено, то берется значение индекса начального/конечного столбца.
- Если заполнено имя и индекс столбца, то берется значение имени столбца.
- Форматы, которые можно изменить в ячейках: Общий, Числовой, Научный, Финансовый, Денежный, Дата, Время, Процентный, Дробный, Текстовый, Пользовательский.
Пример использования
Задача
Существует табличный документ, в ячейках которого установлен "числовой" формат.
Установить "денежный" формат ячеек в табличном документе.
Решение
Установить на рабочую область действия "Открыть", "Изменить формат диапазона", "Сохранить".
Заполнить параметры действий
Запустить робота.
Реализация
- Собрать схему робота, состоящую из действий:
- Настроить параметры для действия "Открыть".
- Поле "Путь к файлу". Указать путь к табличному документу, который необходимо открыть.
- Поле "Путь к файлу". Указать путь к табличному документу, который необходимо открыть.
- Настроить параметры для действия "Установить формат диапазона".
- Поле "Контекст". Указать контекст открытого табличного документа.
- Поле "Имя столбца начальной ячейки". Указать имя столбца начальной ячейки диапазона, в котором будет устанавливаться новый формат.
- Поле "Строка начальной ячейки". Указать номер начальной строки диапазона, в котором будет устанавливаться новый формат.
- Поле "Имя столбца конечной ячейки". Указать имя столбца конечной ячейки диапазона, в котором будет устанавливаться новый формат.
- Поле "Строка конечной ячейки". Указать номер конечной строки диапазона, в котором будет устанавливаться новый формат.
- Поле "Формат". Указать формат, который будет установлен в выбранных ячейках.
- Настроить параметры для действия "Сохранить".
- Поле "Контекст". Указать контекст открытого табличного документа.
- Поле "Контекст". Указать контекст открытого табличного документа.
- Запустить робота по кнопке "Старт" в верхней панели.
Результат
Робот отработал успешно.
Действие установило "денежный" формат в выбранном диапазоне.
Обзор
Инструменты контента