@blickwerk/n8n-nodes-microsoft-planner 1.0.1 → 1.1.1

package/README.md

@@ -14,7 +14,7 @@ Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes
 
 1. Go to **Settings > Community Nodes** in your n8n instance
 2. Select **Install**
-3. Enter `n8n-nodes-microsoft-planner` in **Enter npm package name**
+3. Enter `@blickwerk/n8n-nodes-microsoft-planner` in **Enter npm package name**
 4. Agree to the [risks](https://docs.n8n.io/integrations/community-nodes/risks/) of using community nodes
 5. Select **Install**
 
@@ -22,10 +22,10 @@ After installing the node, you can use it like any other node in your workflows.
 
 ### Manual Installation
 
-To install manually from source:
+To install manually:
 
 ```bash
-npm install n8n-nodes-microsoft-planner
+npm install @blickwerk/n8n-nodes-microsoft-planner
 ```
 
 ## Prerequisites
@@ -36,6 +36,7 @@ You need to have:
 - Azure AD App Registration with the following API permissions:
   - `Tasks.ReadWrite` - Read and write tasks
   - `Group.ReadWrite.All` - Read and write all groups (required for Planner)
+  - `User.Read.All` - Read all users (required for user assignment by email)
 
 ## Setting up Azure AD App
 
@@ -54,10 +55,13 @@ You need to have:
 3. Select **Microsoft Graph**
 4. Select **Delegated permissions**
 5. Add the following permissions:
-   - `Tasks.ReadWrite`
-   - `Group.ReadWrite.All`
+   - `Tasks.ReadWrite` - Read and write tasks
+   - `Group.ReadWrite.All` - Read and write all groups (required for Planner)
+   - `User.Read.All` - Read all users' basic profiles (required for user assignment)
 6. Click **Grant admin consent**
 
+**Note**: The `User.Read.All` permission is required if you want to assign tasks to users by email address.
+
 ### Create Client Secret
 
 1. Go to **Certificates & secrets**
@@ -100,11 +104,16 @@ To create a task, you need:
 - **Title**: The task title
 
 Optional fields:
-- Description
-- Priority (0-10, where 0 is most urgent)
-- Due Date Time
-- Start Date Time
-- Percent Complete
+- **Description**: Detailed task description
+- **Priority**: Select from dropdown
+  - Urgent (highest priority)
+  - Important
+  - Medium (default)
+  - Low
+- **Assigned To**: Comma-separated list of user emails (e.g., `user1@domain.com, user2@domain.com`)
+- **Due Date Time**: When the task should be completed
+- **Start Date Time**: When work on the task should begin
+- **Percent Complete**: Task completion percentage (0-100)
 
 ### Getting Tasks
 
@@ -115,7 +124,15 @@ You can retrieve tasks by:
 
 ### Updating a Task
 
-To update a task, provide the Task ID and the fields you want to update.
+To update a task, provide the Task ID and the fields you want to update. You can update:
+- Title
+- Description
+- Priority (via dropdown)
+- Assigned users (via email list)
+- Due Date Time
+- Start Date Time
+- Percent Complete
+- Move to different bucket
 
 ### Finding Plan and Bucket IDs
 
@@ -139,10 +156,20 @@ Tested with n8n version 1.0.0 and above.
 
 ## Version History
 
+### 1.1.0
+- Added priority dropdown (Urgent, Important, Medium, Low) instead of number input
+- Added user assignment functionality (assign tasks by email)
+- Improved user experience with better field descriptions
+
+### 1.0.1
+- Fixed DateTime format handling (automatic conversion to ISO 8601)
+- Improved error handling for invalid date formats
+
 ### 1.0.0
 - Initial release
 - Support for creating and retrieving Planner tasks
 - OAuth2 authentication
+- CRUD operations (Create, Read, Update, Delete)
 
 ## License
 

package/dist/nodes/MicrosoftPlanner/GenericFunctions.d.ts

@@ -3,3 +3,6 @@ export declare function microsoftApiRequest(this: IHookFunctions | IExecuteFunct
 export declare function microsoftApiRequestAllItems(this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions, propertyName: string, method: IHttpRequestMethods, endpoint: string, body?: IDataObject, query?: IDataObject): Promise<any>;
 export declare function cleanETag(eTag: string): string;
 export declare function formatDateTime(dateTime: string | undefined): string | undefined;
+export declare function getUserIdByEmail(this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions, email: string): Promise<string | null>;
+export declare function parseAssignments(assignmentsString: string): string[];
+export declare function createAssignmentsObject(userIds: string[]): IDataObject;

package/dist/nodes/MicrosoftPlanner/GenericFunctions.js

@@ -4,6 +4,9 @@ exports.microsoftApiRequest = microsoftApiRequest;
 exports.microsoftApiRequestAllItems = microsoftApiRequestAllItems;
 exports.cleanETag = cleanETag;
 exports.formatDateTime = formatDateTime;
+exports.getUserIdByEmail = getUserIdByEmail;
+exports.parseAssignments = parseAssignments;
+exports.createAssignmentsObject = createAssignmentsObject;
 const n8n_workflow_1 = require("n8n-workflow");
 async function microsoftApiRequest(method, resource, body = {}, qs = {}, uri, headers = {}) {
     const options = {
@@ -61,3 +64,33 @@ function formatDateTime(dateTime) {
     }
     return date.toISOString();
 }
+async function getUserIdByEmail(email) {
+    try {
+        const response = await microsoftApiRequest.call(this, 'GET', `/users/${encodeURIComponent(email)}`);
+        return response.id;
+    }
+    catch (error) {
+        // Log error for debugging
+        console.error(`Failed to get user ID for email ${email}:`, error.message || error);
+        return null;
+    }
+}
+function parseAssignments(assignmentsString) {
+    if (!assignmentsString || assignmentsString.trim() === '') {
+        return [];
+    }
+    return assignmentsString
+        .split(',')
+        .map((email) => email.trim())
+        .filter((email) => email.length > 0);
+}
+function createAssignmentsObject(userIds) {
+    const assignments = {};
+    for (const userId of userIds) {
+        assignments[userId] = {
+            '@odata.type': '#microsoft.graph.plannerAssignment',
+            orderHint: ' !',
+        };
+    }
+    return assignments;
+}

package/dist/nodes/MicrosoftPlanner/MicrosoftPlanner.node.js

@@ -68,15 +68,37 @@ class MicrosoftPlanner {
                         if (additionalFields.priority !== undefined) {
                             body.priority = additionalFields.priority;
                         }
-                        if (additionalFields.dueDateTime) {
-                            body.dueDateTime = (0, GenericFunctions_1.formatDateTime)(additionalFields.dueDateTime);
+                        const formattedDueDateTime = (0, GenericFunctions_1.formatDateTime)(additionalFields.dueDateTime);
+                        if (formattedDueDateTime) {
+                            body.dueDateTime = formattedDueDateTime;
                         }
-                        if (additionalFields.startDateTime) {
-                            body.startDateTime = (0, GenericFunctions_1.formatDateTime)(additionalFields.startDateTime);
+                        const formattedStartDateTime = (0, GenericFunctions_1.formatDateTime)(additionalFields.startDateTime);
+                        if (formattedStartDateTime) {
+                            body.startDateTime = formattedStartDateTime;
                         }
                         if (additionalFields.percentComplete !== undefined) {
                             body.percentComplete = additionalFields.percentComplete;
                         }
+                        // Handle assignments
+                        if (additionalFields.assignments) {
+                            const emails = (0, GenericFunctions_1.parseAssignments)(additionalFields.assignments);
+                            const userIds = [];
+                            for (const email of emails) {
+                                const userId = await GenericFunctions_1.getUserIdByEmail.call(this, email);
+                                if (userId) {
+                                    userIds.push(userId);
+                                }
+                                else {
+                                    console.warn(`Could not find user ID for email: ${email}`);
+                                }
+                            }
+                            if (userIds.length > 0) {
+                                body.assignments = (0, GenericFunctions_1.createAssignmentsObject)(userIds);
+                            }
+                            else if (emails.length > 0) {
+                                console.warn('No valid user IDs found for assignment. Check if User.Read.All permission is granted.');
+                            }
+                        }
                         const responseData = await GenericFunctions_1.microsoftApiRequest.call(this, 'POST', '/planner/tasks', body);
                         // Add description if provided
                         if (additionalFields.description) {
@@ -148,11 +170,13 @@ class MicrosoftPlanner {
                         if (updateFields.priority !== undefined) {
                             body.priority = updateFields.priority;
                         }
-                        if (updateFields.dueDateTime) {
-                            body.dueDateTime = (0, GenericFunctions_1.formatDateTime)(updateFields.dueDateTime);
+                        const formattedDueDateTime = (0, GenericFunctions_1.formatDateTime)(updateFields.dueDateTime);
+                        if (formattedDueDateTime) {
+                            body.dueDateTime = formattedDueDateTime;
                         }
-                        if (updateFields.startDateTime) {
-                            body.startDateTime = (0, GenericFunctions_1.formatDateTime)(updateFields.startDateTime);
+                        const formattedStartDateTime = (0, GenericFunctions_1.formatDateTime)(updateFields.startDateTime);
+                        if (formattedStartDateTime) {
+                            body.startDateTime = formattedStartDateTime;
                         }
                         if (updateFields.percentComplete !== undefined) {
                             body.percentComplete = updateFields.percentComplete;
@@ -160,6 +184,26 @@ class MicrosoftPlanner {
                         if (updateFields.bucketId) {
                             body.bucketId = updateFields.bucketId;
                         }
+                        // Handle assignments
+                        if (updateFields.assignments) {
+                            const emails = (0, GenericFunctions_1.parseAssignments)(updateFields.assignments);
+                            const userIds = [];
+                            for (const email of emails) {
+                                const userId = await GenericFunctions_1.getUserIdByEmail.call(this, email);
+                                if (userId) {
+                                    userIds.push(userId);
+                                }
+                                else {
+                                    console.warn(`Could not find user ID for email: ${email}`);
+                                }
+                            }
+                            if (userIds.length > 0) {
+                                body.assignments = (0, GenericFunctions_1.createAssignmentsObject)(userIds);
+                            }
+                            else if (emails.length > 0) {
+                                console.warn('No valid user IDs found for assignment. Check if User.Read.All permission is granted.');
+                            }
+                        }
                         const responseData = await GenericFunctions_1.microsoftApiRequest.call(this, 'PATCH', `/planner/tasks/${taskId}`, body, {}, undefined, {
                             'If-Match': eTag,
                         });

package/dist/nodes/MicrosoftPlanner/TaskDescription.js

@@ -119,9 +119,35 @@ exports.taskFields = [
             {
                 displayName: 'Priority',
                 name: 'priority',
-                type: 'number',
+                type: 'options',
+                options: [
+                    {
+                        name: 'Urgent',
+                        value: 0,
+                    },
+                    {
+                        name: 'Important',
+                        value: 1,
+                    },
+                    {
+                        name: 'Medium',
+                        value: 5,
+                    },
+                    {
+                        name: 'Low',
+                        value: 9,
+                    },
+                ],
                 default: 5,
-                description: 'Priority of the task (0-10, where 0 is most urgent)',
+                description: 'Priority of the task',
+            },
+            {
+                displayName: 'Assigned To (User IDs)',
+                name: 'assignments',
+                type: 'string',
+                default: '',
+                placeholder: 'user1@domain.com, user2@domain.com',
+                description: 'Comma-separated list of user emails or IDs to assign the task to',
             },
             {
                 displayName: 'Due Date Time',
@@ -284,9 +310,35 @@ exports.taskFields = [
             {
                 displayName: 'Priority',
                 name: 'priority',
-                type: 'number',
+                type: 'options',
+                options: [
+                    {
+                        name: 'Urgent',
+                        value: 0,
+                    },
+                    {
+                        name: 'Important',
+                        value: 1,
+                    },
+                    {
+                        name: 'Medium',
+                        value: 5,
+                    },
+                    {
+                        name: 'Low',
+                        value: 9,
+                    },
+                ],
                 default: 5,
-                description: 'Priority of the task (0-10, where 0 is most urgent)',
+                description: 'Priority of the task',
+            },
+            {
+                displayName: 'Assigned To (User IDs)',
+                name: 'assignments',
+                type: 'string',
+                default: '',
+                placeholder: 'user1@domain.com, user2@domain.com',
+                description: 'Comma-separated list of user emails or IDs to assign the task to',
             },
             {
                 displayName: 'Due Date Time',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blickwerk/n8n-nodes-microsoft-planner",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "n8n node for Microsoft Planner - Create and retrieve tasks",
   "keywords": [
     "n8n-community-node-package",