n8n-nodes-pragma-bitrix24 1.0.0

package/dist/nodes/Bitrix24Scrum/Bitrix24Scrum.node.js

@@ -0,0 +1,555 @@
+"use strict";
+/**
+ * Bitrix24 Scrum — Нода управления Scrum-проектами
+ *
+ * Bitrix24 PRAGMA.by nodes for n8n
+ * Профессиональная интеграция с Битрикс24.
+ *
+ * @author PRAGMA & Азбука Решений
+ * @copyright 2026 PRAGMA (https://pragma.by/) & Азбука Решений (https://abc-solution.ru/)
+ *
+ * Контакты:
+ * 🇧🇾 PRAGMA: +375 (44) 702-70-90 | https://pragma.by/
+ * 🇷🇺 Азбука Решений: +7 (939) 555-19-60 | https://abc-solution.ru/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Bitrix24Scrum = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const Helpers_1 = require("../Bitrix24/Helpers");
+class Bitrix24Scrum {
+    constructor() {
+        this.description = {
+            displayName: 'Bitrix24 Скрам',
+            name: 'bitrix24Scrum',
+            icon: 'file:bitrix24.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["resource"] + ": " + $parameter["operation"]}}',
+            description: 'Управление Scrum-проектами: спринты, бэклог, эпики, Kanban-доска',
+            defaults: {
+                name: 'Bitrix24 Скрам',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'bitrix24Api',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Ресурс',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Спринт',
+                            value: 'sprint',
+                            description: 'Управление спринтами: создание, обновление, завершение',
+                        },
+                        {
+                            name: 'Бэклог',
+                            value: 'backlog',
+                            description: 'Элементы бэклога продукта',
+                        },
+                        {
+                            name: 'Эпик',
+                            value: 'epic',
+                            description: 'Эпики — крупные функциональные блоки',
+                        },
+                        {
+                            name: 'Kanban',
+                            value: 'kanban',
+                            description: 'Стадии Kanban-доски проекта',
+                        },
+                    ],
+                    default: 'sprint',
+                    required: true,
+                },
+                {
+                    displayName: 'Операция',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        // Операции со спринтами
+                        {
+                            name: 'Создать',
+                            value: 'create',
+                            action: 'Создать спринт',
+                            description: 'Создать новый спринт в проекте',
+                            displayOptions: { show: { resource: ['sprint'] } },
+                        },
+                        {
+                            name: 'Получить',
+                            value: 'get',
+                            action: 'Получить спринт',
+                            description: 'Получить спринт по ID',
+                            displayOptions: { show: { resource: ['sprint'] } },
+                        },
+                        {
+                            name: 'Список',
+                            value: 'list',
+                            action: 'Получить список спринтов',
+                            description: 'Получить все спринты проекта',
+                            displayOptions: { show: { resource: ['sprint'] } },
+                        },
+                        {
+                            name: 'Обновить',
+                            value: 'update',
+                            action: 'Обновить спринт',
+                            description: 'Изменить название, сроки или статус спринта',
+                            displayOptions: { show: { resource: ['sprint'] } },
+                        },
+                        {
+                            name: 'Завершить',
+                            value: 'complete',
+                            action: 'Завершить спринт',
+                            description: 'Закрыть спринт и переместить незавершённые задачи',
+                            displayOptions: { show: { resource: ['sprint'] } },
+                        },
+                        {
+                            name: 'Запустить',
+                            value: 'start',
+                            action: 'Запустить спринт',
+                            description: 'Активировать спринт для работы команды',
+                            displayOptions: { show: { resource: ['sprint'] } },
+                        },
+                        // Операции с бэклогом
+                        {
+                            name: 'Добавить элемент',
+                            value: 'add_item',
+                            action: 'Добавить в бэклог',
+                            description: 'Добавить задачу или элемент в бэклог',
+                            displayOptions: { show: { resource: ['backlog'] } },
+                        },
+                        {
+                            name: 'Список элементов',
+                            value: 'list',
+                            action: 'Получить бэклог',
+                            description: 'Получить все элементы бэклога',
+                            displayOptions: { show: { resource: ['backlog'] } },
+                        },
+                        {
+                            name: 'Переместить в спринт',
+                            value: 'move_to_sprint',
+                            action: 'Переместить в спринт',
+                            description: 'Переместить элемент бэклога в активный спринт',
+                            displayOptions: { show: { resource: ['backlog'] } },
+                        },
+                        {
+                            name: 'Приоритизировать',
+                            value: 'prioritize',
+                            action: 'Изменить приоритет',
+                            description: 'Изменить порядок элементов в бэклоге',
+                            displayOptions: { show: { resource: ['backlog'] } },
+                        },
+                        // Операции с эпиками
+                        {
+                            name: 'Создать',
+                            value: 'create',
+                            action: 'Создать эпик',
+                            description: 'Создать новый эпик проекта',
+                            displayOptions: { show: { resource: ['epic'] } },
+                        },
+                        {
+                            name: 'Получить',
+                            value: 'get',
+                            action: 'Получить эпик',
+                            description: 'Получить эпик по ID',
+                            displayOptions: { show: { resource: ['epic'] } },
+                        },
+                        {
+                            name: 'Список',
+                            value: 'list',
+                            action: 'Получить список эпиков',
+                            description: 'Получить все эпики проекта',
+                            displayOptions: { show: { resource: ['epic'] } },
+                        },
+                        {
+                            name: 'Обновить',
+                            value: 'update',
+                            action: 'Обновить эпик',
+                            description: 'Изменить название или описание эпика',
+                            displayOptions: { show: { resource: ['epic'] } },
+                        },
+                        // Операции с Kanban
+                        {
+                            name: 'Получить стадии',
+                            value: 'get_stages',
+                            action: 'Получить стадии Kanban',
+                            description: 'Получить все стадии Kanban-доски',
+                            displayOptions: { show: { resource: ['kanban'] } },
+                        },
+                        {
+                            name: 'Переместить задачу',
+                            value: 'move_task',
+                            action: 'Переместить задачу',
+                            description: 'Переместить задачу между стадиями Kanban',
+                            displayOptions: { show: { resource: ['kanban'] } },
+                        },
+                    ],
+                    default: 'list',
+                    required: true,
+                },
+                // Поля спринта
+                {
+                    displayName: 'ID проекта',
+                    name: 'groupId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: '123',
+                    displayOptions: {
+                        show: {
+                            resource: ['sprint', 'backlog', 'epic', 'kanban'],
+                        },
+                    },
+                    description: 'ID рабочей группы (проекта) в Битрикс24',
+                    hint: 'Проект должен быть в режиме Scrum для использования этих методов',
+                },
+                {
+                    displayName: 'ID спринта',
+                    name: 'sprintId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: '456',
+                    displayOptions: {
+                        show: {
+                            resource: ['sprint'],
+                            operation: ['get', 'update', 'complete', 'start'],
+                        },
+                    },
+                    description: 'Уникальный идентификатор спринта',
+                },
+                {
+                    displayName: 'Название спринта',
+                    name: 'name',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: 'Спринт 1 — MVP',
+                    displayOptions: {
+                        show: {
+                            resource: ['sprint'],
+                            operation: ['create'],
+                        },
+                    },
+                    description: 'Название спринта, отображаемое в Kanban-доске',
+                    hint: 'Рекомендуется: "Спринт N — Цель"',
+                },
+                {
+                    displayName: 'Дата начала',
+                    name: 'dateStart',
+                    type: 'dateTime',
+                    default: '',
+                    displayOptions: {
+                        show: {
+                            resource: ['sprint'],
+                            operation: ['create', 'update'],
+                        },
+                    },
+                    description: 'Дата и время начала спринта',
+                    hint: 'Формат: YYYY-MM-DD или выберите из календаря',
+                },
+                {
+                    displayName: 'Дата окончания',
+                    name: 'dateEnd',
+                    type: 'dateTime',
+                    default: '',
+                    displayOptions: {
+                        show: {
+                            resource: ['sprint'],
+                            operation: ['create', 'update'],
+                        },
+                    },
+                    description: 'Дата и время окончания спринта',
+                    hint: 'Обычно 1-4 недели после начала',
+                },
+                // Поля бэклога
+                {
+                    displayName: 'ID задачи',
+                    name: 'taskId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: '789',
+                    displayOptions: {
+                        show: {
+                            resource: ['backlog'],
+                            operation: ['add_item', 'move_to_sprint', 'prioritize'],
+                        },
+                    },
+                    description: 'ID задачи для добавления в бэклог или перемещения',
+                },
+                {
+                    displayName: 'Целевой спринт',
+                    name: 'targetSprintId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: '456',
+                    displayOptions: {
+                        show: {
+                            resource: ['backlog'],
+                            operation: ['move_to_sprint'],
+                        },
+                    },
+                    description: 'ID спринта, в который переместить задачу',
+                },
+                {
+                    displayName: 'Новый приоритет',
+                    name: 'priority',
+                    type: 'number',
+                    default: 1,
+                    displayOptions: {
+                        show: {
+                            resource: ['backlog'],
+                            operation: ['prioritize'],
+                        },
+                    },
+                    description: 'Позиция элемента в бэклоге (1 = самый высокий приоритет)',
+                    hint: 'Чем меньше число, тем выше приоритет',
+                },
+                // Поля эпика
+                {
+                    displayName: 'ID эпика',
+                    name: 'epicId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: '101',
+                    displayOptions: {
+                        show: {
+                            resource: ['epic'],
+                            operation: ['get', 'update'],
+                        },
+                    },
+                    description: 'Уникальный идентификатор эпика',
+                },
+                {
+                    displayName: 'Название эпика',
+                    name: 'epicName',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: 'Модуль авторизации',
+                    displayOptions: {
+                        show: {
+                            resource: ['epic'],
+                            operation: ['create'],
+                        },
+                    },
+                    description: 'Название эпика — крупного функционального блока',
+                    hint: 'Эпик объединяет связанные пользовательские истории',
+                },
+                {
+                    displayName: 'Описание эпика',
+                    name: 'epicDescription',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 4,
+                    },
+                    default: '',
+                    displayOptions: {
+                        show: {
+                            resource: ['epic'],
+                            operation: ['create', 'update'],
+                        },
+                    },
+                    description: 'Подробное описание эпика и его целей',
+                },
+                {
+                    displayName: 'Цвет эпика',
+                    name: 'epicColor',
+                    type: 'color',
+                    default: '#22B9FF',
+                    displayOptions: {
+                        show: {
+                            resource: ['epic'],
+                            operation: ['create', 'update'],
+                        },
+                    },
+                    description: 'Цвет для визуального выделения эпика на доске',
+                },
+                // Поля Kanban
+                {
+                    displayName: 'ID стадии',
+                    name: 'stageId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: '202',
+                    displayOptions: {
+                        show: {
+                            resource: ['kanban'],
+                            operation: ['move_task'],
+                        },
+                    },
+                    description: 'ID целевой стадии Kanban-доски',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const resource = this.getNodeParameter('resource', 0);
+        const operation = this.getNodeParameter('operation', 0);
+        for (let i = 0; i < items.length; i++) {
+            try {
+                let result = {};
+                const groupId = this.getNodeParameter('groupId', i);
+                if (resource === 'sprint') {
+                    if (operation === 'list') {
+                        // Получить список спринтов проекта
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.sprint.list', {
+                            filter: { GROUP_ID: groupId },
+                        });
+                    }
+                    else if (operation === 'get') {
+                        const sprintId = this.getNodeParameter('sprintId', i);
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.sprint.get', {
+                            id: sprintId,
+                        });
+                    }
+                    else if (operation === 'create') {
+                        const name = this.getNodeParameter('name', i);
+                        const dateStart = this.getNodeParameter('dateStart', i);
+                        const dateEnd = this.getNodeParameter('dateEnd', i);
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.sprint.add', {
+                            fields: {
+                                GROUP_ID: groupId,
+                                NAME: name,
+                                DATE_START: dateStart,
+                                DATE_END: dateEnd,
+                            },
+                        });
+                    }
+                    else if (operation === 'update') {
+                        const sprintId = this.getNodeParameter('sprintId', i);
+                        const fields = {};
+                        const name = this.getNodeParameter('name', i, '');
+                        const dateStart = this.getNodeParameter('dateStart', i, '');
+                        const dateEnd = this.getNodeParameter('dateEnd', i, '');
+                        if (name)
+                            fields.NAME = name;
+                        if (dateStart)
+                            fields.DATE_START = dateStart;
+                        if (dateEnd)
+                            fields.DATE_END = dateEnd;
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.sprint.update', {
+                            id: sprintId,
+                            fields,
+                        });
+                    }
+                    else if (operation === 'start') {
+                        const sprintId = this.getNodeParameter('sprintId', i);
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.sprint.start', {
+                            id: sprintId,
+                        });
+                    }
+                    else if (operation === 'complete') {
+                        const sprintId = this.getNodeParameter('sprintId', i);
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.sprint.complete', {
+                            id: sprintId,
+                        });
+                    }
+                }
+                else if (resource === 'backlog') {
+                    if (operation === 'list') {
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.backlog.get', {
+                            id: groupId,
+                        });
+                    }
+                    else if (operation === 'add_item') {
+                        const taskId = this.getNodeParameter('taskId', i);
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.backlog.add', {
+                            id: groupId,
+                            taskId,
+                        });
+                    }
+                    else if (operation === 'move_to_sprint') {
+                        const taskId = this.getNodeParameter('taskId', i);
+                        const targetSprintId = this.getNodeParameter('targetSprintId', i);
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.item.update', {
+                            id: taskId,
+                            fields: { ENTITY_ID: targetSprintId },
+                        });
+                    }
+                }
+                else if (resource === 'epic') {
+                    if (operation === 'list') {
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.epic.list', {
+                            filter: { GROUP_ID: groupId },
+                        });
+                    }
+                    else if (operation === 'get') {
+                        const epicId = this.getNodeParameter('epicId', i);
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.epic.get', {
+                            id: epicId,
+                        });
+                    }
+                    else if (operation === 'create') {
+                        const epicName = this.getNodeParameter('epicName', i);
+                        const epicDescription = this.getNodeParameter('epicDescription', i, '');
+                        const epicColor = this.getNodeParameter('epicColor', i, '#22B9FF');
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.epic.add', {
+                            fields: {
+                                GROUP_ID: groupId,
+                                NAME: epicName,
+                                DESCRIPTION: epicDescription,
+                                COLOR: epicColor,
+                            },
+                        });
+                    }
+                    else if (operation === 'update') {
+                        const epicId = this.getNodeParameter('epicId', i);
+                        const fields = {};
+                        const epicName = this.getNodeParameter('epicName', i, '');
+                        const epicDescription = this.getNodeParameter('epicDescription', i, '');
+                        const epicColor = this.getNodeParameter('epicColor', i, '');
+                        if (epicName)
+                            fields.NAME = epicName;
+                        if (epicDescription)
+                            fields.DESCRIPTION = epicDescription;
+                        if (epicColor)
+                            fields.COLOR = epicColor;
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.epic.update', {
+                            id: epicId,
+                            fields,
+                        });
+                    }
+                }
+                else if (resource === 'kanban') {
+                    if (operation === 'get_stages') {
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.kanban.getStages', {
+                            id: groupId,
+                        });
+                    }
+                    else if (operation === 'move_task') {
+                        const taskId = this.getNodeParameter('taskId', i);
+                        const stageId = this.getNodeParameter('stageId', i);
+                        result = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.api.scrum.kanban.moveTask', {
+                            taskId,
+                            stageId,
+                        });
+                    }
+                }
+                returnData.push({ json: result });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({ json: { error: error.message } });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), error, { itemIndex: i });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.Bitrix24Scrum = Bitrix24Scrum;

package/dist/nodes/Bitrix24Scrum/bitrix24.svg

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="32px" height="32px" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg">
+    <g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
+        <path d="M16,0 C24.8365,0 32,7.1635 32,16 C32,24.8365 24.8365,32 16,32 C7.1635,32 0,24.8365 0,16 C0,7.1635 7.1635,0 16,0" fill="#2FC7F7"/>
+        <path d="M13.3333,8 L18.6667,8 C21.6122,8 24,10.3878 24,13.3333 L24,18.6667 C24,21.6122 21.6122,24 18.6667,24 L13.3333,24 C10.3878,24 8,21.6122 8,18.6667 L8,13.3333 C8,10.3878 10.3878,8 13.3333,8" fill="#FFFFFF"/>
+    </g>
+</svg>