Planner API new types and methods

Author: vgrem

examples/Planner/ExportPlans.php

@@ -0,0 +1,39 @@
+<?php
+
+/**
+ *
+ * Description:
+ * - List all groups containing Planner plans
+ * - Identify plans accessible to the specific group
+ * - Extract all tasks from qualifying plans
+ *
+ * Permissions:
+ * Accessing group plans requires both Group.Read.All and Tasks.Read.All permissions.
+ */
+
+
+use Office365\Directory\Groups\Group;
+use Office365\GraphServiceClient;
+use Office365\Planner\Plans\PlannerPlan;
+
+require_once '../vendor/autoload.php';
+
+$settings = include('../../tests/Settings.php');
+$client = GraphServiceClient::withClientSecret($settings['TenantName'], $settings['ClientId'], $settings['ClientSecret']);
+
+# 1. Get all Microsoft 365 groups (that might contain plans)
+$groups = $client->getGroups()->get()->top(10)->filter("groupTypes/any(c:c eq 'Unified')")->executeQuery();
+
+/** @var Group $grp */
+foreach ($groups as $grp) {
+    echo sprintf("\nProcessing group: %s \n", $grp->getProperty("DisplayName"));
+    $plans = $grp->getPlanner()->getPlans()->get()->executeQuery();
+
+    /** @var PlannerPlan $plan */
+    foreach ($plans as $plan) {
+        echo sprintf("\tPlan: %s \n", $plan->getProperty("Title"));
+    }
+}
+
+
+

generator/GenerateModel.php

@@ -140,7 +140,7 @@ function syncSharePointMetadataFile($fileName){
 
 try {
 
-    $modelName = "SharePoint";
+    $modelName = "MicrosoftGraph";
     if (count($argv) > 1)
         $modelName = $argv[1];
 

generator/Settings.SharePoint.json

@@ -6,8 +6,8 @@
     "docsRoot": "https:\/\/docs.microsoft.com\/en-us\/openspecs\/sharepoint_protocols\/ms-csomspt\/",
     "rootNamespace": "Office365\\SharePoint",
     "entityRootNamespace": "SP",
-    "version": "16.0.26330.12011",
-    "timestamp": "2025-08-15T21:03:47+00:00",
+    "version": "16.0.26330.12012",
+    "timestamp": "2025-08-17T09:30:06+00:00",
     "placeholder": "Generated ",
     "typeMappings": {
         "SP.List": "SP.SPList",

src/Planner/Planner.php

@@ -7,6 +7,7 @@
 
 use Office365\Entity;
 use Office365\Planner\Plans\PlannerPlanCollection;
+use Office365\Planner\Tasks\PlannerTaskCollection;
 use Office365\Runtime\ResourcePath;
 
 class Planner extends Entity
@@ -16,8 +17,18 @@ class Planner extends Entity
      */
     public function getPlans()
     {
-        return $this->getProperty("plans",
+        return $this->getProperty("Plans",
             new PlannerPlanCollection($this->getContext(),
-                new ResourcePath("plans", $this->getResourcePath()), $this));
+                new ResourcePath("Plans", $this->getResourcePath()), $this));
+    }
+
+    /**
+     * @return PlannerTaskCollection
+     */
+    public function getTasks()
+    {
+        return $this->getProperty("Tasks",
+            new PlannerTaskCollection($this->getContext(),
+                new ResourcePath("Tasks", $this->getResourcePath()), $this));
     }
 }

src/Planner/PlannerGroup.php

@@ -16,9 +16,9 @@ class PlannerGroup extends Entity
      */
     public function getPlans()
     {
-        return $this->getProperty("plans",
+        return $this->getProperty("Plans",
             new PlannerPlanCollection($this->getContext(),
-                new ResourcePath("plans", $this->getResourcePath()), $this));
+                new ResourcePath("Plans", $this->getResourcePath()), $this));
     }
 
 }

src/Planner/PlannerUser.php

@@ -18,18 +18,18 @@ class PlannerUser extends Entity
      */
     public function getTasks()
     {
-        return $this->getProperty("tasks",
+        return $this->getProperty("Tasks",
             new PlannerTaskCollection($this->getContext(),
-                new ResourcePath("tasks", $this->getResourcePath())));
+                new ResourcePath("Tasks", $this->getResourcePath())));
     }
 
     /**
      * @return EntityCollection
      */
     public function getPlans()
     {
-        return $this->getProperty("plans",
+        return $this->getProperty("Plans",
             new EntityCollection($this->getContext(),
-                new ResourcePath("plans", $this->getResourcePath()),PlannerPlan::class));
+                new ResourcePath("Plans", $this->getResourcePath()),PlannerPlan::class));
     }
 }

src/Planner/Plans/PlannerPlan.php

@@ -7,6 +7,7 @@
 
 use Office365\Directory\Identities\IdentitySet;
 use Office365\Entity;
+use Office365\Planner\Tasks\PlannerTaskCollection;
 use Office365\Runtime\Http\RequestOptions;
 use Office365\Runtime\ResourcePath;
 /**
@@ -81,6 +82,19 @@ public function getDetails()
             new PlannerPlanDetails($this->getContext(),new ResourcePath("Details", $this->getResourcePath())));
     }
 
+    /**
+     * @return PlannerTaskCollection
+     */
+    public function getTasks()
+    {
+        return $this->getProperty("Tasks",
+            new PlannerTaskCollection($this->getContext(),
+                new ResourcePath("Tasks", $this->getResourcePath()), $this));
+    }
+
+    /**
+     * @return $this
+     */
     public function deleteObject()
     {
         parent::deleteObject();