@blickwerk/n8n-nodes-microsoft-planner 1.1.0 → 1.2.0

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**
@@ -80,6 +84,13 @@ Configure the Microsoft Planner OAuth2 API credentials in n8n:
 4. Click **Connect my account**
 5. Complete the OAuth flow
 
+## Features
+
+- **Dynamic Dropdowns**: Automatically loads and displays your Plans, Buckets, and Tasks - no need to manually copy IDs!
+- **User Assignment**: Assign tasks to users by email address
+- **Priority Management**: Easy-to-use priority dropdown (Urgent, Important, Medium, Low)
+- **Full CRUD Operations**: Create, Read, Update, and Delete tasks
+
 ## Operations
 
 ### Task
@@ -94,38 +105,55 @@ Configure the Microsoft Planner OAuth2 API credentials in n8n:
 
 ### Creating a Task
 
-To create a task, you need:
-- **Plan ID**: The ID of the plan
-- **Bucket ID**: The ID of the bucket within the plan
-- **Title**: The task title
+To create a task:
+1. Select a **Plan** from the dropdown (automatically loaded from your Microsoft 365)
+2. Select a **Bucket** from the dropdown (loads buckets from the selected plan)
+3. Enter the **Title** of the task
 
 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
 
-You can retrieve tasks by:
-- **Task ID**: Get a specific task
-- **Plan ID**: Get all tasks in a plan
-- **Bucket ID**: Get all tasks in a bucket
+**Get a single task:**
+- Select the task from the dropdown (automatically loaded from your plans)
+
+**Get many tasks:**
+- Filter by **Plan** (select from dropdown)
+- Or filter by **Bucket** (select from dropdown)
+- Set a limit or return all tasks
 
 ### Updating a Task
 
-To update a task, provide the Task ID and the fields you want to update.
+To update a task:
+1. Select the **Task** from the dropdown
+2. Update any of these fields:
+- 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
+### How Dynamic Dropdowns Work
 
-You can find Plan IDs and Bucket IDs using the Microsoft Graph Explorer:
+The node automatically fetches your data from Microsoft 365:
+- **Plans**: Loaded from your account when you open the Plan dropdown
+- **Buckets**: Dynamically loaded based on the selected Plan
+- **Tasks**: Loaded from the selected Plan or Bucket
 
-1. Go to [Microsoft Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer)
-2. Sign in with your Microsoft account
-3. Use these queries:
-   - Get all plans: `GET https://graph.microsoft.com/v1.0/me/planner/plans`
-   - Get buckets in a plan: `GET https://graph.microsoft.com/v1.0/planner/plans/{plan-id}/buckets`
+No need to manually look up IDs anymore! Just select from the dropdown menus.
 
 ## Compatibility
 
@@ -139,10 +167,34 @@ Tested with n8n version 1.0.0 and above.
 
 ## Version History
 
+### 1.2.0
+- **Major UX Improvement**: Added dynamic dropdowns for Plans, Buckets, and Tasks
+- No more manual ID lookup - select from dropdown menus
+- Plans load automatically from your Microsoft 365 account
+- Buckets load dynamically based on selected Plan
+- Tasks load from selected Plan or Bucket
+- Improved user experience with clearer field labels
+
+### 1.1.1
+- Fixed startDateTime not being set (was returning null)
+- Fixed user assignment by adding User.Read.All permission requirement
+- Added error logging for failed user lookups
+- Improved README documentation with all required permissions
+
+### 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.js

@@ -70,6 +70,8 @@ async function getUserIdByEmail(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;
     }
 }

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

@@ -1,5 +1,12 @@
-import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+import { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
 export declare class MicrosoftPlanner implements INodeType {
     description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getPlans(this: ILoadOptionsFunctions): Promise<any>;
+            getBuckets(this: ILoadOptionsFunctions): Promise<any>;
+            getTasks(this: ILoadOptionsFunctions): Promise<any>;
+        };
+    };
     execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
 }

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

@@ -43,6 +43,47 @@ class MicrosoftPlanner {
                 ...TaskDescription_1.taskFields,
             ],
         };
+        this.methods = {
+            loadOptions: {
+                async getPlans() {
+                    const plans = await GenericFunctions_1.microsoftApiRequestAllItems.call(this, 'value', 'GET', '/me/planner/plans');
+                    return plans.map((plan) => ({
+                        name: plan.title,
+                        value: plan.id,
+                    }));
+                },
+                async getBuckets() {
+                    const planId = this.getNodeParameter('planId', 0);
+                    if (!planId) {
+                        return [];
+                    }
+                    const buckets = await GenericFunctions_1.microsoftApiRequestAllItems.call(this, 'value', 'GET', `/planner/plans/${planId}/buckets`);
+                    return buckets.map((bucket) => ({
+                        name: bucket.name,
+                        value: bucket.id,
+                    }));
+                },
+                async getTasks() {
+                    const planId = this.getNodeParameter('planId', 0);
+                    const bucketId = this.getNodeParameter('bucketId', 0);
+                    let endpoint = '';
+                    if (bucketId) {
+                        endpoint = `/planner/buckets/${bucketId}/tasks`;
+                    }
+                    else if (planId) {
+                        endpoint = `/planner/plans/${planId}/tasks`;
+                    }
+                    else {
+                        return [];
+                    }
+                    const tasks = await GenericFunctions_1.microsoftApiRequestAllItems.call(this, 'value', 'GET', endpoint);
+                    return tasks.map((task) => ({
+                        name: task.title,
+                        value: task.id,
+                    }));
+                },
+            },
+        };
     }
     async execute() {
         const items = this.getInputData();
@@ -68,11 +109,13 @@ 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;
@@ -86,10 +129,16 @@ class MicrosoftPlanner {
                                 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
@@ -162,11 +211,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;
@@ -183,10 +234,16 @@ class MicrosoftPlanner {
                                 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

@@ -52,9 +52,12 @@ exports.taskFields = [
     //         task:create
     // ----------------------------------
     {
-        displayName: 'Plan ID',
+        displayName: 'Plan',
         name: 'planId',
-        type: 'string',
+        type: 'options',
+        typeOptions: {
+            loadOptionsMethod: 'getPlans',
+        },
         required: true,
         displayOptions: {
             show: {
@@ -63,12 +66,15 @@ exports.taskFields = [
             },
         },
         default: '',
-        description: 'The ID of the plan to which the task belongs',
+        description: 'The plan to which the task belongs',
     },
     {
-        displayName: 'Bucket ID',
+        displayName: 'Bucket',
         name: 'bucketId',
-        type: 'string',
+        type: 'options',
+        typeOptions: {
+            loadOptionsMethod: 'getBuckets',
+        },
         required: true,
         displayOptions: {
             show: {
@@ -77,7 +83,7 @@ exports.taskFields = [
             },
         },
         default: '',
-        description: 'The ID of the bucket to which the task belongs',
+        description: 'The bucket to which the task belongs',
     },
     {
         displayName: 'Title',
@@ -176,9 +182,12 @@ exports.taskFields = [
     //         task:get
     // ----------------------------------
     {
-        displayName: 'Task ID',
+        displayName: 'Task',
         name: 'taskId',
-        type: 'string',
+        type: 'options',
+        typeOptions: {
+            loadOptionsMethod: 'getTasks',
+        },
         required: true,
         displayOptions: {
             show: {
@@ -187,7 +196,7 @@ exports.taskFields = [
             },
         },
         default: '',
-        description: 'The ID of the task',
+        description: 'The task to operate on',
     },
     {
         displayName: 'Additional Fields',
@@ -259,18 +268,24 @@ exports.taskFields = [
         },
         options: [
             {
-                displayName: 'Plan ID',
+                displayName: 'Plan',
                 name: 'planId',
-                type: 'string',
+                type: 'options',
+                typeOptions: {
+                    loadOptionsMethod: 'getPlans',
+                },
                 default: '',
-                description: 'Filter tasks by plan ID',
+                description: 'Filter tasks by plan',
             },
             {
-                displayName: 'Bucket ID',
+                displayName: 'Bucket',
                 name: 'bucketId',
-                type: 'string',
+                type: 'options',
+                typeOptions: {
+                    loadOptionsMethod: 'getBuckets',
+                },
                 default: '',
-                description: 'Filter tasks by bucket ID',
+                description: 'Filter tasks by bucket',
             },
         ],
     },

package/package.json

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