SharePoint new types and model updates, List export method introduced

Author: vgrem

examples/onedrive/drives/get_for_user.py

@@ -0,0 +1,19 @@
+"""
+Demonstrates how to get a drive for a user.
+"""
+
+from office365.graph_client import GraphClient
+from tests import (
+    test_client_id,
+    test_client_secret,
+    test_tenant,
+    test_user_principal_name,
+)
+
+client = GraphClient.with_client_secret(test_tenant, test_client_id, test_client_secret)
+site = (
+    client.users.get_by_principal_name(test_user_principal_name)
+    .get_my_site()
+    .execute_query()
+)
+print("Drive url: {0}".format(site.web_url))

examples/sharepoint/lists/export_list.py

@@ -0,0 +1,25 @@
+import os
+import tempfile
+
+from office365.sharepoint.client_context import ClientContext
+from office365.sharepoint.files.file import File
+from office365.sharepoint.listitems.listitem import ListItem
+from tests import test_client_credentials, test_team_site_url
+
+
+def print_progress(item):
+    # type: (ListItem|File) -> None
+    if isinstance(item, ListItem):
+        print("List Item has been exported...")
+    else:
+        print("File has been downloaded...")
+
+
+ctx = ClientContext(test_team_site_url).with_credentials(test_client_credentials)
+
+list_title = "Orders"
+lib = ctx.web.lists.get_by_title(list_title)
+export_path = os.path.join(tempfile.mkdtemp(), "{0}.zip".format(list_title))
+with open(export_path, "wb") as f:
+    lib.export(f, True, print_progress).execute_query()
+print("List has been export into {0} ...".format(export_path))

generator/import_metadata.py

@@ -26,13 +26,13 @@ def export_to_file(path, content):
     "--endpoint",
     dest="endpoint",
     help="Import metadata endpoint",
-    default="graph",
+    default="sharepoint",
 )
 parser.add_argument(
     "-p",
     "--path",
     dest="path",
-    default="./metadata/MicrosoftGraph.xml",
+    default="./metadata/SharePoint.xml",
     help="Import metadata endpoint",
 )
 

generator/metadata/MicrosoftGraph.xml

@@ -25913,6 +25913,9 @@
          <EntityType Name="administrativeUnit" BaseType="graph.directoryObject" OpenType="true">
             <Property Name="description" Type="Edm.String"/>
             <Property Name="displayName" Type="Edm.String"/>
+            <Property Name="membershipRule" Type="Edm.String"/>
+            <Property Name="membershipRuleProcessingState" Type="Edm.String"/>
+            <Property Name="membershipType" Type="Edm.String"/>
             <Property Name="visibility" Type="Edm.String"/>
             <NavigationProperty Name="members" Type="Collection(graph.directoryObject)"/>
             <NavigationProperty Name="scopedRoleMembers" Type="Collection(graph.scopedRoleMembership)" ContainsTarget="true"/>

generator/metadata/SharePoint.xml

@@ -193,6 +193,16 @@ def get_mail_tips(self, email_addresses, mail_tips_options=None):
         self.context.add_query(qry)
         return return_type
 
+    def get_my_site(self):
+        """Gets user's site"""
+        return_type = Site(self.context)
+
+        def _loaded():
+            return_type.set_property("webUrl", self.my_site)
+
+        self.ensure_property("mySite", _loaded)
+        return return_type
+
     def send_mail(
         self,
         subject,
@@ -535,11 +545,21 @@ def chats(self):
     @property
     def given_name(self):
         # type: () -> Optional[str]
-        """
-        The given name (first name) of the user. Maximum length is 64 characters.
-        """
+        """The given name (first name) of the user. Maximum length is 64 characters"""
         return self.properties.get("givenName", None)
 
+    @property
+    def my_site(self):
+        # type: () -> Optional[str]
+        """The URL for the user's site."""
+        return self.properties.get("mySite", None)
+
+    @property
+    def office_location(self):
+        # type: () -> Optional[str]
+        """The office location in the user's place of business."""
+        return self.properties.get("officeLocation", None)
+
     @property
     def user_principal_name(self):
         # type: () -> Optional[str]

office365/directory/users/user.py

@@ -0,0 +1,41 @@
+from office365.onedrive.sites.site import Site
+from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.paths.service_operation import ServiceOperationPath
+from office365.sharepoint.client_context import ClientContext
+from office365.sharepoint.entity import Entity
+from office365.sharepoint.webs.web import Web
+
+
+class AppContextSite(Entity):
+    """ """
+
+    def __init__(self, context, site_url):
+        # type: (ClientContext, str) -> None
+        """"""
+        static_path = ServiceOperationPath(
+            "SP.AppContextSite",
+            {"siteUrl": site_url},
+        )
+        super(AppContextSite, self).__init__(context, static_path)
+
+    @property
+    def site(self):
+        """"""
+        return self.properties.get(
+            "Site",
+            Site(
+                self.context,
+                ResourcePath("Site", self.resource_path),
+            ),
+        )
+
+    @property
+    def web(self):
+        """"""
+        return self.properties.get(
+            "Web",
+            Web(
+                self.context,
+                ResourcePath("Web", self.resource_path),
+            ),
+        )

office365/sharepoint/apps/context_site.py

@@ -16,9 +16,7 @@ def change_type_name(self):
 
     @property
     def change_token(self):
-        """
-        Returns an ChangeToken that represents the change.
-        """
+        """Returns an ChangeToken that represents the change."""
         return self.properties.get("ChangeToken", ChangeToken())
 
     @property

office365/sharepoint/changes/change.py

@@ -22,6 +22,7 @@ def _resolve_change_type(self, properties):
         from office365.sharepoint.changes.item import ChangeItem
         from office365.sharepoint.changes.list import ChangeList
         from office365.sharepoint.changes.user import ChangeUser
+        from office365.sharepoint.changes.view import ChangeView
         from office365.sharepoint.changes.web import ChangeWeb
 
         if "ItemId" in properties and "ListId" in properties:
@@ -40,3 +41,5 @@ def _resolve_change_type(self, properties):
             self._item_type = ChangeAlert
         elif "FieldId" in properties:
             self._item_type = ChangeField
+        elif "ViewId" in properties:
+            self._item_type = ChangeView

office365/sharepoint/changes/collection.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.changes.change import Change
 
 
@@ -6,8 +8,12 @@ class ChangeFolder(Change):
 
     @property
     def unique_id(self):
+        # type: () -> Optional[str]
+        """Identifies the folder that has changed."""
         return self.properties.get("UniqueId", None)
 
     @property
     def web_id(self):
+        # type: () -> Optional[str]
+        """Identifies the site that contains the changed folder."""
         return self.properties.get("WebId", None)