SharePoint API: initial support for syntex, Intune API changes

Author: vgrem

examples/sharepoint/load_web_fluent_api.py

@@ -4,7 +4,3 @@
 ctx = ClientContext(test_site_url).with_credentials(test_client_credentials)
 target_web = ctx.web.get().execute_query()
 print(target_web.url)
-
-#ctx.load(ctx.web).execute_query()
-#print(ctx.web.url)
-

generator/metadata/MicrosoftGraph.xml

@@ -23,3 +23,19 @@ def categories(self):
         Project management, Telecommunications, Tools, Travel, and Web design & hosting.
         """
         return self.properties.get("categories", StringCollection())
+
+    @property
+    def supported_provisioning_types(self):
+        """
+        The list of provisioning modes supported by this application
+        """
+        return self.properties.get("supportedProvisioningTypes", StringCollection())
+
+    @property
+    def supported_single_signon_modes(self):
+        """
+        The list of single sign-on modes supported by this application.
+        The supported values are oidc, password, saml, and notSupported.
+        """
+        return self.properties.get("supportedSingleSignOnModes", StringCollection())
+

generator/metadata/SharePoint.xml

@@ -1,4 +1,4 @@
-from office365.directory.audit.directory_audit import DirectoryAudit
+from office365.directory.audit.directory import DirectoryAudit
 from office365.directory.audit.provisioning_object_summary import ProvisioningObjectSummary
 from office365.directory.audit.signIn import SignIn
 from office365.entity import Entity

office365/directory/applications/template.py

@@ -40,24 +40,32 @@ def get_member_groups(self, security_enabled_only=True):
         """Return all the groups that the specified user, group, or directory object is a member of. This function is
         transitive.
 
-        :type security_enabled_only: bool"""
-        result = ClientResult(self.context)
+        :param bool security_enabled_only: true to specify that only security groups that the entity is a member
+            of should be returned; false to specify that all groups and directory roles that the entity is a member
+            of should be returned. true can be specified only for users or service principals to return security-enabled
+            groups.
+        """
+        return_type = ClientResult(self.context, StringCollection())
         payload = {
             "securityEnabledOnly": security_enabled_only
         }
-        qry = ServiceOperationQuery(self, "getMemberGroups", None, payload, None, result)
+        qry = ServiceOperationQuery(self, "getMemberGroups", None, payload, None, return_type)
         self.context.add_query(qry)
-        return result
+        return return_type
 
     def restore(self):
         """
+        Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from
+        deleted items. If an item was accidentally deleted, you can fully restore the item. This is not applicable
+        to security groups, which are deleted permanently.
 
+        A recently deleted item will remain available for up to 30 days. After 30 days, the item is permanently deleted.
         """
         qry = ServiceOperationQuery(self, "restore")
         self.context.add_query(qry)
         return self
 
     @property
     def deleted_datetime(self):
-        """ETag for the item."""
+        """Date and time when this object was deleted. Always null when the object hasn't been deleted."""
         return self.properties.get('deletedDateTime', None)

office365/directory/audit/directory_audit.py office365/directory/audit/directory.py

@@ -16,7 +16,9 @@
 from office365.directory.resource_specific_permission_grant import ResourceSpecificPermissionGrant
 from office365.directory.roles.management import RoleManagement
 from office365.directory.roles.role import DirectoryRole
-from office365.intune.organizations.org_contact import OrgContact
+from office365.intune.devices.app_management import DeviceAppManagement
+from office365.intune.devices.management import DeviceManagement
+from office365.intune.organizations.contact import OrgContact
 from office365.intune.organizations.organization import Organization
 from office365.directory.policies.root import PolicyRoot
 from office365.directory.subscriptions.subscription import Subscription
@@ -108,6 +110,16 @@ def me(self):
         """The Me endpoint is provided as a shortcut for specifying the current user"""
         return User(self, MePath())
 
+    @property
+    def device_management(self):
+        """Singleton entity that acts as a container for all device management functionality."""
+        return DeviceManagement(self, ResourcePath("deviceManagement"))
+
+    @property
+    def device_app_management(self):
+        """Singleton entity that acts as a container for all device and app management functionality."""
+        return DeviceAppManagement(self, ResourcePath("deviceAppManagement"))
+
     @property
     def drives(self):
         """Get one drives"""

office365/directory/audit/log_root.py

@@ -0,0 +1,30 @@
+from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.runtime.client_result import ClientResult
+from office365.runtime.queries.function import FunctionQuery
+from office365.runtime.types.collections import StringCollection
+
+
+class AuditEvent(Entity):
+    """A class containing the properties for Audit Event."""
+
+
+class AuditEventCollection(EntityCollection):
+
+    def __init__(self, context, resource_path=None):
+        super(AuditEventCollection, self).__init__(context, AuditEvent, resource_path)
+
+    def get_audit_categories(self):
+        return_type = ClientResult(self.context, StringCollection())
+        qry = FunctionQuery(self, "getAuditCategories", None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    def get_audit_activity_types(self, category):
+        """"""
+        return_type = ClientResult(self.context, StringCollection())
+        params = {"category": category}
+        qry = FunctionQuery(self, "getAuditActivityTypes", params, return_type)
+        self.context.add_query(qry)
+        return return_type
+

office365/directory/object.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class DeviceAppManagement(Entity):
+    """Singleton entity that acts as a container for all device and app management functionality."""

office365/graph_client.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class DeviceConfiguration(Entity):
+    """Device Configuration."""

tests/onenote/__init__.py office365/intune/audit/__init__.py

@@ -1,5 +1,25 @@
 from office365.entity import Entity
+from office365.intune.audit.event import AuditEventCollection
+from office365.runtime.paths.resource_path import ResourcePath
 
 
 class DeviceManagement(Entity):
-    pass
+    """
+    The deviceManagement resource represents a tenant's collection device identities that have been pre-staged in
+    Intune, and the enrollment profiles that may be assigned to device identities that support pre-enrollment
+    configuration.
+    """
+
+    @property
+    def audit_events(self):
+        """"""
+        return self.properties.get("auditEvents", AuditEventCollection(self.context,
+                                                                       ResourcePath("auditEvents", self.resource_path)))
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "auditEvents": self.audit_events
+            }
+            default_value = property_mapping.get(name, None)
+        return super(DeviceManagement, self).get_property(name, default_value)

office365/intune/audit/event.py

@@ -395,7 +395,7 @@ def preview(self, page, zoom=None):
         self.context.add_query(qry)
         return result
 
-    def validate_permission(self, challenge_token, password):
+    def validate_permission(self, challenge_token=None, password=None):
         """
         :type challenge_token: str
         :type password: str
@@ -404,8 +404,7 @@ def validate_permission(self, challenge_token, password):
             "challengeToken": challenge_token,
             "password": password
         }
-        result = ClientResult(self.context, ItemPreviewInfo())
-        qry = ServiceOperationQuery(self, "validatePermission", None, payload, None, result)
+        qry = ServiceOperationQuery(self, "validatePermission", None, payload)
         self.context.add_query(qry)
         return self
 

office365/intune/devices/app_management.py

@@ -347,7 +347,7 @@ def micro_service_manager(self):
     @property
     def models(self):
         """Alias to collection of SPMachineLearningModel"""
-        from office365.sharepoint.contentcenter.machinelearning.model_collection import SPMachineLearningModelCollection
+        from office365.sharepoint.contentcenter.machinelearning.models.collection import SPMachineLearningModelCollection
         return SPMachineLearningModelCollection(self, ResourcePath("models"))
 
     @property
@@ -465,7 +465,7 @@ def home_site(self):
     @property
     def publications(self):
         from office365.sharepoint.base_entity_collection import BaseEntityCollection
-        from office365.sharepoint.contentcenter.machinelearning.publication import SPMachineLearningPublication
+        from office365.sharepoint.contentcenter.machinelearning.publications.publication import SPMachineLearningPublication
         return BaseEntityCollection(self, SPMachineLearningPublication, ResourcePath("publications"))
 
     @property
@@ -499,7 +499,7 @@ def tenant_settings(self):
 
     @property
     def work_items(self):
-        from office365.sharepoint.contentcenter.machinelearning.work_item_collection import \
+        from office365.sharepoint.contentcenter.machinelearning.workitems.collection import \
             SPMachineLearningWorkItemCollection
         return SPMachineLearningWorkItemCollection(self, ResourcePath("workitems"))
 

office365/intune/devices/configuration.py

@@ -3,6 +3,14 @@
 
 class ComplianceTag(ClientValue):
 
+    def __init__(self, accept_messages_only_from_senders_or_members=None, access_type=None):
+        """
+        :param bool accept_messages_only_from_senders_or_members:
+        :param str access_type:
+        """
+        self.AcceptMessagesOnlyFromSendersOrMembers = accept_messages_only_from_senders_or_members
+        self.AccessType = access_type
+
     @property
     def entity_type_name(self):
         return "SP.CompliancePolicy.ComplianceTag"

office365/intune/devices/management.py

@@ -0,0 +1,8 @@
+from office365.sharepoint.base_entity import BaseEntity
+
+
+class SPMachineLearningEnabled(BaseEntity):
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Office.Server.ContentCenter.SPMachineLearningEnabled"

office365/intune/organizations/org_contact.py office365/intune/organizations/contact.py

@@ -1,10 +1,29 @@
+from office365.runtime.client_result import ClientResult
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.base_entity import BaseEntity
-from office365.sharepoint.contentcenter.machinelearning.model_collection import SPMachineLearningModelCollection
+from office365.sharepoint.compliance.tag import ComplianceTag
+from office365.sharepoint.contentcenter.machinelearning.enabled import SPMachineLearningEnabled
+from office365.sharepoint.contentcenter.machinelearning.models.collection import SPMachineLearningModelCollection
+from office365.sharepoint.contentcenter.machinelearning.samples.collection import SPMachineLearningSampleCollection
+from office365.sharepoint.contentcenter.syntex_models_landing_info import SyntexModelsLandingInfo
 
 
 class SPMachineLearningHub(BaseEntity):
 
+    def get_by_content_type_id(self, content_type_id):
+        """
+        :param str content_type_id:
+        """
+        return_type = SyntexModelsLandingInfo(self.context)
+        payload = {
+            "contentTypeId": content_type_id
+        }
+        qry = ServiceOperationQuery(self, "GetByContentTypeId", None, payload, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
     def get_models(self, list_id=None, model_types=None, publication_types=None,
                    include_management_not_allowed_models=None):
         """
@@ -24,6 +43,20 @@ def get_models(self, list_id=None, model_types=None, publication_types=None,
         self.context.add_query(qry)
         return return_type
 
+    def get_retention_labels(self):
+        return_type = ClientResult(self.context, ClientValueCollection(ComplianceTag))
+        qry = ServiceOperationQuery(self, "GetRetentionLabels", None, None, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "MachineLearningEnabled": self.machine_learning_enabled,
+            }
+            default_value = property_mapping.get(name, None)
+        return super(SPMachineLearningHub, self).get_property(name, default_value)
+
     @property
     def is_default_content_center(self):
         """
@@ -38,6 +71,24 @@ def machine_learning_capture_enabled(self):
         """
         return self.properties.get("MachineLearningCaptureEnabled", None)
 
+    @property
+    def machine_learning_enabled(self):
+        return self.properties.get("MachineLearningEnabled",
+                                   SPMachineLearningEnabled(self.context,
+                                                            ResourcePath("MachineLearningEnabled", self.resource_path)))
+
+    @property
+    def models(self):
+        return self.properties.get("Models",
+                                   SPMachineLearningModelCollection(self.context,
+                                                                    ResourcePath("Models", self.resource_path)))
+
+    @property
+    def samples(self):
+        return self.properties.get("Samples",
+                                   SPMachineLearningSampleCollection(self.context,
+                                                                     ResourcePath("Samples", self.resource_path)))
+
     @property
     def entity_type_name(self):
         return "Microsoft.Office.Server.ContentCenter.SPMachineLearningHub"

office365/onedrive/driveitems/driveItem.py

@@ -1,6 +1,6 @@
 from office365.runtime.paths.service_operation import ServiceOperationPath
 from office365.sharepoint.base_entity_collection import BaseEntityCollection
-from office365.sharepoint.contentcenter.machinelearning.model import SPMachineLearningModel
+from office365.sharepoint.contentcenter.machinelearning.models.model import SPMachineLearningModel
 
 
 class SPMachineLearningModelCollection(BaseEntityCollection):

office365/sharepoint/client_context.py

@@ -0,0 +1,16 @@
+from office365.runtime.paths.service_operation import ServiceOperationPath
+from office365.sharepoint.base_entity_collection import BaseEntityCollection
+from office365.sharepoint.contentcenter.machinelearning.samples.sample import SPMachineLearningSample
+
+
+class SPMachineLearningSampleCollection(BaseEntityCollection):
+
+    def __init__(self, context, resource_path=None):
+        super(SPMachineLearningSampleCollection, self).__init__(context, SPMachineLearningSample, resource_path)
+
+    def get_by_title(self, title):
+        """
+        :param str title: The title of the model to return.
+        """
+        return SPMachineLearningSample(self.context,
+                                       ServiceOperationPath("GetByTitle", [title], self.resource_path))

office365/sharepoint/compliance/tag.py

@@ -0,0 +1,10 @@
+from office365.sharepoint.base_entity import BaseEntity
+
+
+class SPMachineLearningSample(BaseEntity):
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Office.Server.ContentCenter.SPMachineLearningSample"
+
+

office365/sharepoint/contentcenter/machinelearning/enabled.py

@@ -1,5 +1,5 @@
 from office365.sharepoint.base_entity_collection import BaseEntityCollection
-from office365.sharepoint.contentcenter.machinelearning.work_item import SPMachineLearningWorkItem
+from office365.sharepoint.contentcenter.machinelearning.workitems.item import SPMachineLearningWorkItem
 
 
 class SPMachineLearningWorkItemCollection(BaseEntityCollection):

office365/sharepoint/contentcenter/machinelearning/hub.py

@@ -0,0 +1,8 @@
+from office365.sharepoint.base_entity import BaseEntity
+
+
+class SyntexModelsLandingInfo(BaseEntity):
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.Office.Server.ContentCenter.SyntexModelsLandingInfo"

office365/sharepoint/contentcenter/machinelearning/models/__init__.py

@@ -1,13 +1,30 @@
+from office365.runtime.client_value_collection import ClientValueCollection
 from office365.sharepoint.base_entity import BaseEntity
+from office365.sharepoint.sharing.shared_with_user import SharedWithUser
 
 
 class FileVersionEvent(BaseEntity):
     """Represents an event object happened on a Microsoft.SharePoint.SPFile."""
 
+    @property
+    def event_type(self):
+        """Returns the type of the event."""
+        return self.properties.get("EventType", None)
+
     @property
     def editor(self):
         """Returns the name of the user who initiated the event.
 
         :rtype: str or None
         """
         return self.properties.get("Editor", None)
+
+    @property
+    def shared_by_user(self):
+        """Returns the shared by user Information in sharing action for change log."""
+        return self.properties.get("SharedByUser", SharedWithUser())
+
+    @property
+    def shared_with_users(self):
+        """Returns the array of users that have been shared in sharing action for the change log."""
+        return self.properties.get("SharedWithUsers", ClientValueCollection(SharedWithUser))