Документация для разработчиков
Темная тема

Kanbanitem

Методы для работы со стадиями Канбана.

Scope: task Права на выполнение: для всех

Таблица стадий

Параметр Описание
ID Идентификатор стадии
TITLE Заголовок
SORT Индекс сортировки (только для чтения)
COLOR Цвет в формате RGB, пример: FFAAEE.
SYSTEM_TYPE Системный код, пока может быть или null или NEW - означающий, что данная стадия является стадией по умолчанию (только для чтения)
ENTITY_TYPE Тип сущности, к которой относится стадия (G - группа, U - пользователь) (только для чтения, а также указывается при добавлении)
ENTITY_ID ID сущности, к которой относится стадия (группа или пользователь) (только для чтения)

Методы

Метод Описание С версии
task.stages.add Метод добавляет стадии Канбана / Моего плана.
task.stages.canmovetask Метод определяет, может ли текущий пользователь перемещать задачи в указанной сущности
task.stages.delete Метод удаляет стадии Канбана / Моего плана.
task.stages.get Метод получает стадии Канбана / Моего плана.
task.stages.movetask Метод перемещает задачи из одной стадии в другую.
task.stages.update Метод обновляет стадии Канбана / Моего плана.

Выборка задач

Выборка задач из стадий осуществляется методом task.task.get. Есть особенности.

  1. Выборка из стадий Канбана группы. В массиве фильтра передаем ключ STAGE_ID с ID нужной вам стадии. Но если вы выбираете задачи из стадии по-умолчанию (она идет первой), вам требуется передать для STAGE_ID массив значений, состоящий из 0 и ID вашей стадии ([0, ]). Дополнительно надо отфильтровать еще и по группе данную выборку.
  2. Выборка из Моего плана. В массиве фильтра передаётся ключ STAGES_ID с ID нужной вам стадии. Передавать массив значений не требуется.


© «Битрикс», 2001-2024, «1С-Битрикс», 2024