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