Merge pull request #36 from microsoftgraph/august-update

August update for Graph changes through 8/4

Author: Caitlin Bales (MSFT)

CONTRIBUTING.md

@@ -0,0 +1,37 @@
+# Contributing to the Microsoft Graph PHP SDK
+Thanks for considering making a contribution! Read over our guidelines and we will do our best to see your PRs merged successfully.
+
+**NOTE**: A signed a contribution license agreement is required for all contributions and is checked automatically on new pull requests. You will be asked to read and sign the agreement https://cla.microsoft.com/ after submitting a request to this repository.
+
+There are a few different recommended paths to get contributions into the released version of this library.
+
+## File issues
+The best way to get started with a contribution is to start a dialog with us. Sometimes features will be under development or out of scope for this library and it's best to check before starting work on contribution, especially for large work items.
+
+## Pull requests
+If you are making documentation changes, feel free to submit a pull request against the **master** branch. All other pull requests should be submitted against the **dev** branch or a specific feature branch. The master branch is intended to represent the code released in the most-recent composer package.
+
+When a new package is about to be released, changes in dev will be merged into master. The package will be generated from master.
+
+Some things to note about this project:
+
+### How the library is built
+The PHP SDK has a handwritten set of core files and a folder of autogenerated models. These models are generated using the [MSGraph SDK Code Generator](https://github.com/microsoftgraph/MSGraph-SDK-Code-Generator). **Changes made to the ```Models``` folder will be overwritten** the next time the generator is run. 
+
+If you would like to make changes to the models, you can either file an issue or make a PR in the [MSGraph SDK Code Generator](https://github.com/microsoftgraph/MSGraph-SDK-Code-Generator) to the [templates](https://github.com/microsoftgraph/MSGraph-SDK-Code-Generator/tree/master/Templates/PHP/Model). Although there is a lot of logic in the generator, the code used for PHP is fairly minimal.
+
+### How the generator works
+You can view the [README](https://github.com/microsoftgraph/MSGraph-SDK-Code-Generator/blob/master/README.md) for a full run-through of its capabilities.
+
+For the purposes of the PHP library, the generator runs through an OData-compliant metadata file published by Microsoft Graph (https://graph.microsoft.com/v1.0/$metadata) and builds up a list of models. These models are converted into PHP code using T4 templates, which use C# to programmatically define what PHP code is written to the file.
+
+### When new features are added to the library
+Generation happens as part of a manual process that occurs once a significant change or set of changes has been added to the Graph. This may include:
+ - A new workload comes to v1.0 of Graph (Microsoft Teams, Batching, etc.)
+ - There is significant addition of functionality (Delta Queries, etc.)
+ 
+However, this is evaluated on a case-by-case basis. If the library is missing v1.0 Graph functionality that you wish to utilize, please [file an issue](https://github.com/microsoftgraph/msgraph-sdk-php/issues).
+
+We do our best to prevent breaking changes from being introduced into the library during this process. If you find a breaking change, please file an issue and we will work to get this resolved ASAP.
+
+

README.md

@@ -96,12 +96,16 @@ tests to do not restore state of the account.*
 
 * [Examples](https://github.com/microsoftgraph/msgraph-sdk-php/wiki/Example-calls)
 
-* [Microsoft Graph website](https://graph.microsoft.io)
+* [Microsoft Graph website](https://developer.microsoft.com/en-us/graph/)
 
 ## Issues
 
 View or log issues on the [Issues](https://github.com/microsoftgraph/msgraph-sdk-php/issues) tab in the repo.
 
+## Contribute
+
+Please read our [Contributing](https://github.com/microsoftgraph/msgraph-sdk-php/blob/master/CONTRIBUTING.md) guidelines carefully for advice on how to contribute to this repo.
+
 ## Copyright and license
 
 Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT [license](LICENSE).

src/Core/GraphConstants.php

@@ -24,7 +24,7 @@ final class GraphConstants
     const REST_ENDPOINT = "https://graph.microsoft.com/";
 
     // Define HTTP request constants
-    const SDK_VERSION = "1.0.0";
+    const SDK_VERSION = "1.0.3";
 
     // Define error constants
     const MAX_PAGE_SIZE = 999;

src/Model/BaseItem.php

@@ -28,6 +28,7 @@ class BaseItem extends Entity
 {
     /**
     * Gets the createdBy
+    * Identity of the user, device, or application which created the item. Read-only.
     *
     * @return IdentitySet The createdBy
     */
@@ -46,6 +47,7 @@ public function getCreatedBy()
 
     /**
     * Sets the createdBy
+    * Identity of the user, device, or application which created the item. Read-only.
     *
     * @param IdentitySet $val The createdBy
     *
@@ -59,6 +61,7 @@ public function setCreatedBy($val)
 
     /**
     * Gets the createdDateTime
+    * Date and time of item creation. Read-only.
     *
     * @return \DateTime The createdDateTime
     */
@@ -77,6 +80,7 @@ public function getCreatedDateTime()
 
     /**
     * Sets the createdDateTime
+    * Date and time of item creation. Read-only.
     *
     * @param \DateTime $val The createdDateTime
     *
@@ -117,6 +121,7 @@ public function setDescription($val)
 
     /**
     * Gets the eTag
+    * ETag for the item. Read-only.
     *
     * @return string The eTag
     */
@@ -131,6 +136,7 @@ public function getETag()
 
     /**
     * Sets the eTag
+    * ETag for the item. Read-only.
     *
     * @param string $val The eTag
     *
@@ -144,6 +150,7 @@ public function setETag($val)
 
     /**
     * Gets the lastModifiedBy
+    * Identity of the user, device, and application which last modified the item. Read-only.
     *
     * @return IdentitySet The lastModifiedBy
     */
@@ -162,6 +169,7 @@ public function getLastModifiedBy()
 
     /**
     * Sets the lastModifiedBy
+    * Identity of the user, device, and application which last modified the item. Read-only.
     *
     * @param IdentitySet $val The lastModifiedBy
     *
@@ -175,6 +183,7 @@ public function setLastModifiedBy($val)
 
     /**
     * Gets the lastModifiedDateTime
+    * Date and time the item was last modified. Read-only.
     *
     * @return \DateTime The lastModifiedDateTime
     */
@@ -193,6 +202,7 @@ public function getLastModifiedDateTime()
 
     /**
     * Sets the lastModifiedDateTime
+    * Date and time the item was last modified. Read-only.
     *
     * @param \DateTime $val The lastModifiedDateTime
     *
@@ -206,6 +216,7 @@ public function setLastModifiedDateTime($val)
 
     /**
     * Gets the name
+    * The name of the item. Read-write.
     *
     * @return string The name
     */
@@ -220,6 +231,7 @@ public function getName()
 
     /**
     * Sets the name
+    * The name of the item. Read-write.
     *
     * @param string $val The name
     *
@@ -233,6 +245,7 @@ public function setName($val)
 
     /**
     * Gets the parentReference
+    * Parent information, if the item has a parent. Read-write.
     *
     * @return ItemReference The parentReference
     */
@@ -251,6 +264,7 @@ public function getParentReference()
 
     /**
     * Sets the parentReference
+    * Parent information, if the item has a parent. Read-write.
     *
     * @param ItemReference $val The parentReference
     *
@@ -264,6 +278,7 @@ public function setParentReference($val)
 
     /**
     * Gets the webUrl
+    * URL that displays the resource in the browser. Read-only.
     *
     * @return string The webUrl
     */
@@ -278,6 +293,7 @@ public function getWebUrl()
 
     /**
     * Sets the webUrl
+    * URL that displays the resource in the browser. Read-only.
     *
     * @param string $val The webUrl
     *

src/Model/Calendar.php

@@ -117,6 +117,118 @@ public function setChangeKey($val)
         return $this;
     }
 
+    /**
+    * Gets the canShare
+    *
+    * @return bool The canShare
+    */
+    public function getCanShare()
+    {
+        if (array_key_exists("canShare", $this->_propDict)) {
+            return $this->_propDict["canShare"];
+        } else {
+            return null;
+        }
+    }
+    
+    /**
+    * Sets the canShare
+    *
+    * @param bool $val The canShare
+    *
+    * @return Calendar
+    */
+    public function setCanShare($val)
+    {
+        $this->_propDict["canShare"] = boolval($val);
+        return $this;
+    }
+    
+    /**
+    * Gets the canViewPrivateItems
+    *
+    * @return bool The canViewPrivateItems
+    */
+    public function getCanViewPrivateItems()
+    {
+        if (array_key_exists("canViewPrivateItems", $this->_propDict)) {
+            return $this->_propDict["canViewPrivateItems"];
+        } else {
+            return null;
+        }
+    }
+    
+    /**
+    * Sets the canViewPrivateItems
+    *
+    * @param bool $val The canViewPrivateItems
+    *
+    * @return Calendar
+    */
+    public function setCanViewPrivateItems($val)
+    {
+        $this->_propDict["canViewPrivateItems"] = boolval($val);
+        return $this;
+    }
+    
+    /**
+    * Gets the canEdit
+    *
+    * @return bool The canEdit
+    */
+    public function getCanEdit()
+    {
+        if (array_key_exists("canEdit", $this->_propDict)) {
+            return $this->_propDict["canEdit"];
+        } else {
+            return null;
+        }
+    }
+    
+    /**
+    * Sets the canEdit
+    *
+    * @param bool $val The canEdit
+    *
+    * @return Calendar
+    */
+    public function setCanEdit($val)
+    {
+        $this->_propDict["canEdit"] = boolval($val);
+        return $this;
+    }
+    
+    /**
+    * Gets the owner
+    *
+    * @return EmailAddress The owner
+    */
+    public function getOwner()
+    {
+        if (array_key_exists("owner", $this->_propDict)) {
+            if (is_a($this->_propDict["owner"], "Microsoft\Graph\Model\EmailAddress")) {
+                return $this->_propDict["owner"];
+            } else {
+                $this->_propDict["owner"] = new EmailAddress($this->_propDict["owner"]);
+                return $this->_propDict["owner"];
+            }
+        }
+        return null;
+    }
+    
+    /**
+    * Sets the owner
+    *
+    * @param EmailAddress $val The owner
+    *
+    * @return Calendar
+    */
+    public function setOwner($val)
+    {
+        $this->_propDict["owner"] = $val;
+        return $this;
+    }
+    
 
      /** 
      * Gets the events

src/Model/Device.php

@@ -527,6 +527,7 @@ public function setRegisteredUsers($val)
 
      /** 
      * Gets the extensions
+    * The collection of open extensions defined for the device. Read-only. Nullable.
      *
      * @return array The extensions
      */
@@ -541,6 +542,7 @@ public function getExtensions()
 
     /** 
     * Sets the extensions
+    * The collection of open extensions defined for the device. Read-only. Nullable.
     *
     * @param Extension $val The extensions
     *