Установить цвет диапазона Р7 Версия 1 (Python)

Группа действий: P7-Офис


Описание

Действие изменяет цвет ячеек в указанном диапазоне ячеек.

Параметры действия

Входные параметры

  1. Поле "Контекст" - Контекст документа табличного типа, открытого в Р7-Офис.
  2. Поле "Имя столбца начальной ячейки" - Имя столбца начальной ячейки диапазона. Если поле не заполнено, начальный столбец будет определен по значению из поля "Индекс столбца начальной ячейки".
  3. Поле "Индекс столбца начальной ячейки" - Порядковый номер столбца начальной ячейки диапазона. Нумерация начинается с 1. Если поле не заполнено, будет взят индекс первого столбца в используемой области.
  4. Поле "Индекс строки начальной ячейки" - Порядковый номер строки начальной ячейки диапазона. Нумерация начинается с 1. Если поле не заполнено, будет взят индекс первой строки в используемой области.
  5. Поле "Имя столбца конечной ячейки" - Имя столбца конечной ячейки диапазона. Если поле не заполнено, конечный столбец будет определен по значению из поля "Индекс столбца конечной ячейки".
  6. Поле "Индекс столбца конечной ячейки" - Порядковый номер столбца конечной ячейки диапазона. Нумерация начинается с 1. Если поле не заполнено, будет взят индекс последнего столбца в используемой области.
  7. Поле "Индекс строки конечной ячейки" - Порядковый номер строки конечной ячейки диапазона. Нумерация начинается с 1. Если поле не заполнено, будет взят индекс последней строки в используемой области.
  8. Выпадающий список "Цвет" - Цвет, который будет установлен в ячейках диапазона. Если выбран "Пользовательский", то необходимо заполнить поле "RGB код".
  9. Поле "RGB код" - RGB код для создания пользовательского цвета. Формат записи кода: "значение для канала R, значение для канала G, значение для канала B". Пример: "255,255,100". Допустимое значение каналов - от 0 до 255. Указанный цвет будет использован, только если в поле "Цвет" выбрано значение "Пользовательский".

Настройки

Свойство

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

Описание

Тип

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

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

Параметры

Контекст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. Если поле не заполнено, будет взят индекс последней строки в используемой областиЧисло
Нет
ЦветColor

Цвет, который будет установлен в ячейках диапазона. Если выбран "Пользовательский", то необходимо заполнить поле "RGB код".

Строка
Да
RGB кодRGB codeRGB код для создания пользовательского цвета. Формат записи кода: "значение для канала R, значение для канала G, значение для канала B". Пример: "255,255,100". Допустимое значение каналов - от 0 до 255. Указанный цвет будет использован, только если в поле "Цвет" выбрано значение "Пользовательский".Строка
Нет

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

  1. Если имя начального/конечного столбца не заполнено, то берется значение индекса начального/конечного столбца.
  2. Если заполнено имя и индекс столбца, то берется значение имени столбца
  3. Цвета, которые можно установить: Нет цвета, Белый, Черный, Коричневый, Красный, Оранжевый, Желтый, Светло-зеленый, Зеленый, Голубой, Синий, Темно-синий, Пурпурный, Пользовательский.
  4. Если пользователь выберет "Пользовательский", обязательно должно быть заполнено поле "RGB код", в котором должен быть указан rgb код цвета в формате: "значение для канала R, значение для канала G, значение для канала B". Значение для каждого канала должно находиться в диапазоне от 0 до 255. Пример: 134,108,242

Для корректного запуска действий из под ОС Windows необходимо добавить плагин в "Р-7 Офис":

  1. Открыть "Р-7 Офис".

  2. Перейти на вкладку "Плагины".
     

  3. Перейти в "Настройки".


  4. В открывшемся окне нажать на кнопку "Добавить плагин".


  5. В открывшемся окне Проводника, выбрать файл плагина.

  6. После вышеперечисленных действий в окошке появится плагин для работы с платформой "Robin".


  7. "Р-7 Офис" готов к работе с платформой "Robin".

Плагин передается пользователю при поставке студии.

При работе с ОС Linux необходимо руководствоваться инстуркциями по работе Студии с ОС Linux.

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

Задача

Существует табличный документ.

Необходимо установить синий цвет в указанном диапазоне ячеек табличного документа/

Решение

  1. Установить на рабочую область действия "Открыть", "Изменить цвет диапазона", "Сохранить".
  2. Корректно заполнить параметры действий.
  3. Запустить робота.

Реализация

  1. Собрать схему робота, состоящую из действий:

  2. Настроить параметры для действия "Открыть".
    1. Поле "Путь к файлу". Указать путь к табличному документу, который необходимо открыть.



  3. Настроить параметры для действия "Установить цвет диапазона".
    1. Поле "Контекст". Указать контекст открытого табличного документа.
    2. Поле "Имя столбца начальной ячейки". Указать имя столбца начальной ячейки диапазона, в котором будет устанавливаться новый цвет.
    3. Поле "Строка начальной ячейки". Указать номер начальной строки диапазона, в котором будет устанавливаться новый цвет.
    4. Поле "Имя столбца конечной ячейки". Указать имя столбца конечной ячейки диапазона, в котором будет устанавливаться новый цвет.
    5. Поле "Строка конечной ячейки". Указать номер конечной строки диапазона, в котором будет устанавливаться новый цвет.
    6. Поле "Цвет". Указать цвет, который будет установлен в ячейках диапазона.



  4. Настроить параметры для действия "Сохранить".
    1. Поле "Контекст". Указать контекст открытого табличного документа.



  5. Запустить робота по кнопке "Старт" в верхней панели.

Результат 

Робот отработал успешно.

Действие установило синий цвет в диапазоне ячеек.