Reports namespace, Outlook model update (Calendars nav prop and etc)

Author: vgrem

examples/Outlook/ListCals.php

@@ -0,0 +1,29 @@
+<?php
+
+
+use Office365\GraphServiceClient;
+use Office365\Outlook\Calendars\Calendar;
+use Office365\Runtime\Auth\AADTokenProvider;
+use Office365\Runtime\Auth\UserCredentials;
+
+require_once '../vendor/autoload.php';
+
+function acquireToken()
+{
+    $resource = "https://graph.microsoft.com";
+    $settings = include('../../tests/Settings.php');
+    $provider = new AADTokenProvider($settings['TenantName']);
+    return $provider->acquireTokenForPassword($resource, $settings['ClientId'],
+        new UserCredentials($settings['UserName'], $settings['Password']));
+}
+
+$client = new GraphServiceClient("acquireToken");
+
+$userCals = $client->getMe()->getCalendars()->get()->executeQuery();
+/** @var Calendar $cal */
+foreach ($userCals as $cal){
+    echo "Calendar name: \n" . $cal->getName();
+}
+
+
+

examples/Reports/getReports.php

@@ -0,0 +1,26 @@
+<?php
+
+
+use Office365\GraphServiceClient;
+use Office365\Runtime\Auth\AADTokenProvider;
+use Office365\Runtime\Auth\ClientCredential;
+
+
+require_once '../vendor/autoload.php';
+
+function acquireToken()
+{
+    $resource = "https://graph.microsoft.com";
+    $settings = include('../../tests/Settings.php');
+    $provider = new AADTokenProvider($settings['TenantName']);
+    return $provider->acquireTokenForClientCredential($resource,
+        new ClientCredential($settings['ClientId'], $settings['ClientSecret']),["/.default"]);
+}
+
+$client = new GraphServiceClient("acquireToken");
+$result = $client->getReports()->getOffice365ActivationCounts()->executeQuery();
+var_dump($result->getValue());
+
+
+
+

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.21221.12006",
-    "timestamp": "2021-05-05T14:47:20+00:00",
+    "version": "16.0.21611.12002",
+    "timestamp": "2021-08-22T17:22:47+03:00",
     "placeholder": "This file was generated by phpSPO model generator",
     "typeMappings": {
         "SP.List": "SP.SPList",

generator/composer.json

@@ -7,8 +7,8 @@
     ],
     "autoload": {
         "psr-4": {
-            "Office365\\": "../src/",
-            "Office365\\Generator\\": ""
+            "Office365\\Generator\\": "./generator/",
+            "Office365\\": "../src/"
         }
     },
     "name": "vgrem/php-office365-sdk-generator",

generator/metadata/SharePoint.xml

@@ -13,6 +13,7 @@
 use Office365\OneDrive\Drives\DriveCollection;
 use Office365\OneNote\Onenote;
 use Office365\Outlook\Calendars\Calendar;
+use Office365\Outlook\Calendars\CalendarGroup;
 use Office365\Outlook\Contacts\Contact;
 use Office365\Outlook\Events\Event;
 use Office365\Outlook\MailboxSettings;
@@ -1020,4 +1021,26 @@ public function getMailFolders()
             new EntityCollection($this->getContext(),
                 new ResourcePath("MailFolders", $this->getResourcePath()),MailFolder::class));
     }
+
+    /**
+     * Get all the user's calendars
+     * @return EntityCollection
+     */
+    public function getCalendars()
+    {
+        return $this->getProperty("Calendars",
+            new EntityCollection($this->getContext(),
+                new ResourcePath("Calendars", $this->getResourcePath()),Calendar::class));
+    }
+
+    /**
+     * Get the user's calendar groups.
+     * @return EntityCollection
+     */
+    public function getCalendarGroups()
+    {
+        return $this->getProperty("CalendarGroups",
+            new EntityCollection($this->getContext(),
+                new ResourcePath("CalendarGroups", $this->getResourcePath()),CalendarGroup::class));
+    }
 }

src/Directory/Users/User.php

@@ -11,6 +11,7 @@
 use Office365\OneDrive\DriveItems\DriveItem;
 use Office365\OneDrive\Drives\DriveCollection;
 use Office365\OneDrive\Sites\Site;
+use Office365\Reports\ReportRoot;
 use Office365\Runtime\ClientRuntimeContext;
 use Office365\Runtime\Actions\DeleteEntityQuery;
 use Office365\Runtime\Http\HttpMethod;
@@ -138,6 +139,13 @@ public function getWorkbooks(){
         return new EntityCollection($this,new ResourcePath("workbooks"),DriveItem::class);
     }
 
+    /**
+     * @return ReportRoot
+     */
+    public function getReports(){
+        return new ReportRoot($this,new ResourcePath("reports"));
+    }
+
     /**
      * @return string
      */

src/GraphServiceClient.php

@@ -7,8 +7,14 @@
 
 use Office365\Runtime\ClientValue;
 /**
- *  "With Microsoft Graph, you can access Office 365 usage reports resources to get the information about how people in your business are using Office 365 services. For example, you can identify who is using a service a lot and reaching quotas, or who may not need an Office 365 license at all."
+ *  With Microsoft Graph, you can access Office 365 usage reports resources to get the information
+ * about how people in your business are using Office 365 services. For example, you can identify who is using
+ * a service a lot and reaching quotas, or who may not need an Office 365 license at all.
  */
 class Report extends ClientValue
 {
+    /**
+     * @var string
+     */
+    public $Content;
 }

src/Reports/Report.php

@@ -6,6 +6,47 @@
 namespace Office365\Reports;
 
 use Office365\Entity;
+use Office365\Runtime\Actions\InvokeMethodQuery;
+use Office365\Runtime\Actions\InvokePostMethodQuery;
+use Office365\Runtime\ClientResult;
+use Office365\Runtime\Http\RequestOptions;
+
 class ReportRoot extends Entity
 {
+    /**
+     * Get details about users who have activated Microsoft 365.
+     * @return ClientResult
+     */
+    function getOffice365ActivationsUserDetail(){
+        $qry = new InvokePostMethodQuery($this, "getOffice365ActivationsUserDetail");
+        $reportResult = new ClientResult($this->getContext(),new Report());
+        $this->getContext()->addQueryAndResultObject($qry, $reportResult);
+        return $reportResult;
+    }
+
+    /**
+     * Get the count of Microsoft 365 activations on desktops and devices.
+     * @return ClientResult
+     */
+    function getOffice365ActivationCounts(){
+        $qry = new InvokeMethodQuery($this, "getOffice365ActivationCounts");
+        $this->getContext()->getPendingRequest()->beforeExecuteRequestOnce(function (RequestOptions $request){
+            $request->FollowLocation = true;
+        });
+        $reportResult = new ClientResult($this->getContext(),new Report());
+        $this->getContext()->addQueryAndResultObject($qry, $reportResult);
+        return $reportResult;
+    }
+
+    /**
+     * Get the count of users that are enabled and those that have activated the Office subscription on
+     * desktop or devices or shared computers.
+     * @return ClientResult
+     */
+    function getOffice365ActivationsUserCounts(){
+        $qry = new InvokePostMethodQuery($this, "getOffice365ActivationsUserCounts");
+        $reportResult = new ClientResult($this->getContext(),new Report());
+        $this->getContext()->addQueryAndResultObject($qry, $reportResult);
+        return $reportResult;
+    }
 }