n8n-nodes-pragma-bitrix24 1.0.0

package/dist/nodes/Bitrix24Task/Bitrix24Task.node.js

@@ -0,0 +1,444 @@
+"use strict";
+/**
+ * Bitrix24 Task — Нода управления задачами
+ *
+ * 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.Bitrix24Task = void 0;
+const Helpers_1 = require("../Bitrix24/Helpers");
+class Bitrix24Task {
+    constructor() {
+        this.description = {
+            displayName: 'Bitrix24 Задачи',
+            name: 'bitrix24Task',
+            icon: 'file:bitrix24.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Управление задачами в Битрикс24: создание, обновление, чеклисты, комментарии, делегирование',
+            defaults: {
+                name: 'Bitrix24 Задачи',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'bitrix24Api',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Операция',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Создать',
+                            value: 'create',
+                            action: 'Создать задачу',
+                        },
+                        {
+                            name: 'Получить',
+                            value: 'get',
+                            action: 'Получить задачу',
+                        },
+                        {
+                            name: 'Список',
+                            value: 'list',
+                            action: 'Получить список задач',
+                        },
+                        {
+                            name: 'Обновить',
+                            value: 'update',
+                            action: 'Обновить задачу',
+                        },
+                        {
+                            name: 'Удалить',
+                            value: 'delete',
+                            action: 'Удалить задачу',
+                        },
+                        {
+                            name: 'Добавить комментарий',
+                            value: 'add_comment',
+                            action: 'Добавить комментарий к задаче',
+                        },
+                        {
+                            name: 'Добавить пункт чеклиста',
+                            value: 'checklist_add',
+                            action: 'Добавить пункт в чеклист',
+                        },
+                        {
+                            name: 'Удалить пункт чеклиста',
+                            value: 'checklist_delete',
+                            action: 'Удалить пункт из чеклиста',
+                        },
+                        {
+                            name: 'Завершить пункт чеклиста',
+                            value: 'checklist_complete',
+                            action: 'Завершить пункт чеклиста',
+                        },
+                        {
+                            name: 'Стадии (Kanban)',
+                            value: 'stage_list',
+                            action: 'Получить стадии Kanban',
+                            description: 'Получить стадии для группы/проекта',
+                        },
+                        {
+                            name: 'Делегировать',
+                            value: 'delegate',
+                            action: 'Делегировать задачу',
+                            description: 'Переназначить задачу другому пользователю',
+                        },
+                        {
+                            name: 'Создать из шаблона',
+                            value: 'createFromTemplate',
+                            action: 'Создать задачу из шаблона',
+                        },
+                    ],
+                    default: 'create',
+                    required: true,
+                },
+                // Поля создания/обновления
+                {
+                    displayName: 'Название',
+                    name: 'title',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: 'Подготовить отчёт за месяц',
+                    displayOptions: {
+                        show: {
+                            operation: ['create'],
+                        },
+                    },
+                    description: 'Название задачи',
+                },
+                {
+                    displayName: 'Title',
+                    name: 'title',
+                    type: 'string',
+                    default: '',
+                    displayOptions: {
+                        show: {
+                            operation: ['update'],
+                        },
+                    },
+                    description: 'Task title',
+                },
+                {
+                    displayName: 'Description',
+                    name: 'description',
+                    type: 'string',
+                    default: '',
+                    displayOptions: {
+                        show: {
+                            operation: ['create', 'update'],
+                        },
+                    },
+                    description: 'Task description',
+                },
+                {
+                    displayName: 'Responsible ID',
+                    name: 'responsibleId',
+                    type: 'string',
+                    default: '',
+                    displayOptions: {
+                        show: {
+                            operation: ['create', 'update'],
+                        },
+                    },
+                    description: 'ID of the user responsible',
+                },
+                {
+                    displayName: 'Deadline',
+                    name: 'deadline',
+                    type: 'dateTime',
+                    default: '',
+                    displayOptions: {
+                        show: {
+                            operation: ['create', 'update'],
+                        },
+                    },
+                    description: 'Task deadline',
+                },
+                // ID Field for Get/Update/Delete/AddComment
+                {
+                    displayName: 'Task ID',
+                    name: 'id',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['get', 'update', 'delete', 'add_comment'],
+                        },
+                    },
+                    description: 'ID of the task',
+                },
+                // Comment Fields
+                {
+                    displayName: 'Comment Message',
+                    name: 'message',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['add_comment'],
+                        },
+                    },
+                    description: 'Text of the comment',
+                },
+                // Checklist Fields
+                {
+                    displayName: 'Checklist Text',
+                    name: 'checklistText',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['checklist_add'],
+                        },
+                    },
+                    description: 'Text of the checklist item',
+                },
+                {
+                    displayName: 'Checklist Item ID',
+                    name: 'checklistId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['checklist_delete', 'checklist_complete'],
+                        },
+                    },
+                    description: 'ID of the checklist item',
+                },
+                {
+                    displayName: 'Project ID (Group)',
+                    name: 'projectId',
+                    type: 'string',
+                    default: '0',
+                    displayOptions: {
+                        show: {
+                            operation: ['stage_list'],
+                        },
+                    },
+                    description: 'ID of the group/project. 0 for My Planner.',
+                },
+                // List Fields
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    default: 50,
+                    displayOptions: {
+                        show: {
+                            operation: ['list'],
+                        },
+                    },
+                    description: 'Max number of results',
+                },
+                {
+                    displayName: 'Filter JSON',
+                    name: 'filterJson',
+                    type: 'json',
+                    default: '{}',
+                    displayOptions: {
+                        show: {
+                            operation: ['list'],
+                        },
+                    },
+                    description: 'Filter in JSON format (e.g. {"RESPONSIBLE_ID": 1})',
+                },
+                {
+                    displayName: 'Template ID',
+                    name: 'templateId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['createFromTemplate'],
+                        },
+                    },
+                    description: 'ID of the task template',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const operation = this.getNodeParameter('operation', 0);
+        for (let i = 0; i < items.length; i++) {
+            try {
+                let endpoint = '';
+                let body = {};
+                if (operation === 'create' || operation === 'update') {
+                    endpoint = operation === 'create' ? 'tasks.task.add' : 'tasks.task.update';
+                    const fields = {};
+                    const title = this.getNodeParameter('title', i, '');
+                    if (title)
+                        fields.TITLE = title;
+                    const description = this.getNodeParameter('description', i, '');
+                    if (description)
+                        fields.DESCRIPTION = description;
+                    const responsibleId = this.getNodeParameter('responsibleId', i, '');
+                    if (responsibleId)
+                        fields.RESPONSIBLE_ID = responsibleId;
+                    const deadline = this.getNodeParameter('deadline', i, '');
+                    if (deadline)
+                        fields.DEADLINE = deadline;
+                    if (operation === 'create') {
+                        body = { fields };
+                    }
+                    else {
+                        const id = this.getNodeParameter('id', i);
+                        body = { taskId: id, fields };
+                    }
+                }
+                if (operation === 'get') {
+                    endpoint = 'tasks.task.get';
+                    const id = this.getNodeParameter('id', i);
+                    body = { taskId: id };
+                }
+                if (operation === 'delete') {
+                    endpoint = 'tasks.task.delete';
+                    const id = this.getNodeParameter('id', i);
+                    body = { taskId: id };
+                }
+                if (operation === 'add_comment') {
+                    endpoint = 'task.comment.item.add';
+                    const id = this.getNodeParameter('id', i);
+                    const message = this.getNodeParameter('message', i);
+                    body = { taskId: id, fields: { POST_MESSAGE: message } };
+                }
+                if (operation === 'checklist_add') {
+                    endpoint = 'task.checklistitem.add';
+                    const id = this.getNodeParameter('id', i);
+                    const text = this.getNodeParameter('checklistText', i);
+                    body = { taskId: id, fields: { TITLE: text } };
+                }
+                if (operation === 'checklist_delete') {
+                    endpoint = 'task.checklistitem.delete';
+                    const id = this.getNodeParameter('id', i);
+                    const itemId = this.getNodeParameter('checklistId', i);
+                    body = { taskId: id, itemId };
+                }
+                if (operation === 'checklist_complete') {
+                    endpoint = 'task.checklistitem.complete';
+                    const id = this.getNodeParameter('id', i);
+                    const itemId = this.getNodeParameter('checklistId', i);
+                    body = { taskId: id, itemId };
+                }
+                if (operation === 'stage_list') {
+                    endpoint = 'task.stages.get';
+                    const projectId = this.getNodeParameter('projectId', i); // defaults to 0
+                    body = { entityId: projectId };
+                }
+                if (operation === 'list') {
+                    endpoint = 'tasks.task.list';
+                    const limit = this.getNodeParameter('limit', i);
+                    const filterJson = this.getNodeParameter('filterJson', i, '{}');
+                    let filter = {};
+                    try {
+                        filter = JSON.parse(filterJson);
+                    }
+                    catch (e) { }
+                    body = { filter, start: 0 };
+                    // Simplified list for now, just first page or respected limit if < 50
+                }
+                if (operation === 'delegate') {
+                    endpoint = 'tasks.task.delegate';
+                    const id = this.getNodeParameter('id', i);
+                    const userId = this.getNodeParameter('responsibleId', i); // Reuse responsibleId
+                    body = { taskId: id, userId };
+                }
+                if (operation === 'createFromTemplate') {
+                    // 1. Get Template
+                    const templateId = this.getNodeParameter('templateId', i);
+                    const tmpl = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', 'tasks.task.template.get', { taskId: templateId, templateId: templateId });
+                    // API Note: tasks.task.template.get uses `taskId` param for ID in some versions, or `id`.
+                    // Retrying with standard params if needed.
+                    // 2. Extract fields
+                    const tmplResult = tmpl.result;
+                    const fields = tmplResult?.DATA || {}; // check structure
+                    // 3. Create Task
+                    endpoint = 'tasks.task.add';
+                    // Cleanup fields (remove ID, etc)
+                    delete fields.ID;
+                    delete fields.CREATED_BY;
+                    delete fields.CREATED_DATE;
+                    // Apply overrides if any? For now, straight copy.
+                    body = { fields };
+                }
+                const response = await Helpers_1.bitrixRequestWithRetry.call(this, 'POST', endpoint + '.json', body);
+                let result = response.result;
+                const resultObj = result;
+                if (operation === 'list' && resultObj?.tasks) {
+                    result = resultObj.tasks; // Task list returns object with 'tasks' array
+                }
+                if (Array.isArray(result)) {
+                    for (const item of result) {
+                        // Standard 2026: Direct Entity Link
+                        const taskItem = item;
+                        const credentials = await this.getCredentials('bitrix24Api');
+                        const domain = credentials?.webhookUrl?.split('/rest')[0];
+                        if (domain && taskItem.id) { // Tasks use lower case 'id' usually in recent API, check response
+                            taskItem.url = `${domain}/company/personal/user/${taskItem.responsibleId || 0}/tasks/task/view/${taskItem.id}/`;
+                        }
+                        returnData.push({
+                            json: taskItem,
+                            pairedItem: { item: i },
+                        });
+                    }
+                }
+                else {
+                    const item = result;
+                    // Standard 2026: Direct Entity Link
+                    if (item && (item.id || item.task?.id)) {
+                        const credentials = await this.getCredentials('bitrix24Api');
+                        const domain = credentials?.webhookUrl?.split('/rest')[0];
+                        const taskId = item.id || item.task?.id || body.taskId;
+                        // URL requires user ID, but we might not have it. Generic link?
+                        // /company/personal/user/0/tasks/task/view/ID/ redirects mostly
+                        if (domain && taskId) {
+                            item.url = `${domain}/company/personal/user/0/tasks/task/view/${taskId}/`;
+                        }
+                    }
+                    returnData.push({
+                        json: item,
+                        pairedItem: { item: i },
+                    });
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    const err = error;
+                    returnData.push({
+                        json: { error: err.message },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returnData];
+    }
+}
+exports.Bitrix24Task = Bitrix24Task;