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

package/README.md

@@ -84,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
@@ -98,10 +105,10 @@ 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**: Detailed task description
@@ -117,14 +124,19 @@ Optional fields:
 
 ### 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. You can update:
+To update a task:
+1. Select the **Task** from the dropdown
+2. Update any of these fields:
 - Title
 - Description
 - Priority (via dropdown)
@@ -134,15 +146,14 @@ To update a task, provide the Task ID and the fields you want to update. You can
 - 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
 
@@ -156,6 +167,27 @@ Tested with n8n version 1.0.0 and above.
 
 ## Version History
 
+### 1.2.1
+- Fixed Plans not loading (improved API endpoint to fetch from groups)
+- Allow manual ID input in all dropdown fields
+- You can now choose from dropdown OR paste IDs manually
+- Added placeholders and better descriptions for all ID fields
+- Improved error handling for plans loading
+
+### 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)

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

@@ -1,5 +1,15 @@
-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<{
+                name: any;
+                value: 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,67 @@ class MicrosoftPlanner {
                 ...TaskDescription_1.taskFields,
             ],
         };
+        this.methods = {
+            loadOptions: {
+                async getPlans() {
+                    try {
+                        // Try to get plans from groups the user is member of
+                        const groups = await GenericFunctions_1.microsoftApiRequestAllItems.call(this, 'value', 'GET', '/me/memberOf/microsoft.graph.group?$filter=groupTypes/any(c:c+eq+%27Unified%27)');
+                        const plans = [];
+                        for (const group of groups) {
+                            try {
+                                const groupPlans = await GenericFunctions_1.microsoftApiRequest.call(this, 'GET', `/groups/${group.id}/planner/plans`);
+                                if (groupPlans.value && groupPlans.value.length > 0) {
+                                    plans.push(...groupPlans.value);
+                                }
+                            }
+                            catch (error) {
+                                // Skip groups without plans
+                                continue;
+                            }
+                        }
+                        return plans.map((plan) => ({
+                            name: plan.title || plan.id,
+                            value: plan.id,
+                        }));
+                    }
+                    catch (error) {
+                        console.error('Error loading plans:', error);
+                        return [];
+                    }
+                },
+                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();

package/dist/nodes/MicrosoftPlanner/TaskDescription.js

@@ -52,9 +52,12 @@ exports.taskFields = [
     //         task:create
     // ----------------------------------
     {
-        displayName: 'Plan ID',
+        displayName: 'Plan',
         name: 'planId',
         type: 'string',
+        typeOptions: {
+            loadOptionsMethod: 'getPlans',
+        },
         required: true,
         displayOptions: {
             show: {
@@ -63,12 +66,16 @@ exports.taskFields = [
             },
         },
         default: '',
-        description: 'The ID of the plan to which the task belongs',
+        description: 'The plan to which the task belongs. Choose from the dropdown or enter a Plan ID manually.',
+        placeholder: 'Select from dropdown or paste Plan ID',
     },
     {
-        displayName: 'Bucket ID',
+        displayName: 'Bucket',
         name: 'bucketId',
         type: 'string',
+        typeOptions: {
+            loadOptionsMethod: 'getBuckets',
+        },
         required: true,
         displayOptions: {
             show: {
@@ -77,7 +84,8 @@ exports.taskFields = [
             },
         },
         default: '',
-        description: 'The ID of the bucket to which the task belongs',
+        description: 'The bucket to which the task belongs. Choose from the dropdown or enter a Bucket ID manually.',
+        placeholder: 'Select from dropdown or paste Bucket ID',
     },
     {
         displayName: 'Title',
@@ -176,9 +184,12 @@ exports.taskFields = [
     //         task:get
     // ----------------------------------
     {
-        displayName: 'Task ID',
+        displayName: 'Task',
         name: 'taskId',
         type: 'string',
+        typeOptions: {
+            loadOptionsMethod: 'getTasks',
+        },
         required: true,
         displayOptions: {
             show: {
@@ -187,7 +198,8 @@ exports.taskFields = [
             },
         },
         default: '',
-        description: 'The ID of the task',
+        description: 'The task to operate on. Choose from the dropdown or enter a Task ID manually.',
+        placeholder: 'Select from dropdown or paste Task ID',
     },
     {
         displayName: 'Additional Fields',
@@ -259,18 +271,26 @@ exports.taskFields = [
         },
         options: [
             {
-                displayName: 'Plan ID',
+                displayName: 'Plan',
                 name: 'planId',
                 type: 'string',
+                typeOptions: {
+                    loadOptionsMethod: 'getPlans',
+                },
                 default: '',
-                description: 'Filter tasks by plan ID',
+                description: 'Filter tasks by plan. Choose from the dropdown or enter a Plan ID manually.',
+                placeholder: 'Select from dropdown or paste Plan ID',
             },
             {
-                displayName: 'Bucket ID',
+                displayName: 'Bucket',
                 name: 'bucketId',
                 type: 'string',
+                typeOptions: {
+                    loadOptionsMethod: 'getBuckets',
+                },
                 default: '',
-                description: 'Filter tasks by bucket ID',
+                description: 'Filter tasks by bucket. Choose from the dropdown or enter a Bucket ID manually.',
+                placeholder: 'Select from dropdown or paste Bucket ID',
             },
         ],
     },

package/package.json

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