Skip to content

Conversation

@ibi420
Copy link
Contributor

@ibi420 ibi420 commented Aug 22, 2025

Description

This PR adds the Planner Task Puller PowerShell script, which connects to Microsoft Graph to retrieve tasks from Microsoft Planner. It supports pulling all tasks or only those assigned to users, with details including:

  • Task title
  • Assigned users (with roles: Main Contributor / Reviewer)
  • Bucket name
  • Attachments (GitHub links prioritized)

Connection details can be saved in config.txt for multiple plans, enabling easy switching.

Fixes # (issue)


Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation (update or new)

How Has This Been Tested?

  • Verified authentication with Microsoft Graph using device code login.
  • Tested fetching tasks from an existing Planner plan via Plan ID.
  • Confirmed CSV export with Name, Role, Task, Bucket, and Attachments.
  • Checked handling of unassigned tasks and tasks without references.

🎥 Demo: View Script Demo


Testing Checklist

  • Tested in PowerShell 7 (Windows)
  • Tested in latest Chrome (CSV preview/download)
  • Tested in latest Safari
  • Tested in latest Firefox

Checklist

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have commented my code in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have requested a review from ... on the Pull Request

--

This PR focuses mainly on the changes to the new directory reports-scripts, but the renaming of the BAC.md file is a must, as the ":" is currently breaking git on Windows.

@netlify
Copy link

netlify bot commented Aug 22, 2025

Deploy Preview for ontrackdocumentation failed.

Name Link
🔨 Latest commit 4006b30
🔍 Latest deploy log https://app.netlify.com/projects/ontrackdocumentation/deploys/68d7cd8c834d6600084c7e98

Copy link
Contributor

@theiris6 theiris6 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Clear and well-structured – nice work! Thanks for putting in the effort to make this easy to follow and review.

@ibi420 ibi420 requested a review from theiris6 September 4, 2025 08:27
Copy link
Contributor

@theiris6 theiris6 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Ibi, The documents are clean and clear. Nice work! Thanks for the contribution.

Copy link

@Oliver-Quail Oliver-Quail left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Ibi,
This is a super useful PR which the whole company is glad to have. I think a few minor things should be changed and this will be production ready

Copy link

@Oliver-Quail Oliver-Quail left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I approve this PR

Copy link

@AB-Deakin AB-Deakin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Checked and approved by Alex Brown 24/09/2025 looks great

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants