Office365-REST-Python-Client 2.4.3__py3-none-any.whl → 2.4.4__py3-none-any.whl

office365/sharepoint/folders/folder.py

@@ -1,3 +1,5 @@
+from datetime import datetime
+
 from office365.runtime.client_result import ClientResult
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -132,18 +134,25 @@ class Folder(BaseEntity):
         self.ensure_property("ServerRelativePath", _move_folder)
         return return_type
 
-    def share_link(self, link_kind, expiration=None):
+    def share_link(self, link_kind, expiration=None, role=None, password=None):
         """Creates a tokenized sharing link for a folder based on the specified parameters and optionally
         sends an email to the people that are listed in the specified parameters.
 
         :param int link_kind: The kind of the tokenized sharing link to be created/updated or retrieved.
-        :param datetime or None expiration: A date/time string for which the format conforms to the ISO 8601:2004(E)
+        :param datetime.datetime or None expiration: A date/time string for which the format conforms to the ISO 8601:2004(E)
             complete representation for calendar date and time of day and which represents the time and date of expiry
             for the tokenized sharing link. Both the minutes and hour value MUST be specified for the difference
             between the local and UTC time. Midnight is represented as 00:00:00. A null value indicates no expiry.
             This value is only applicable to tokenized sharing links that are anonymous access links.
+        :param int role: The role to be used for the tokenized sharing link. This is required for Flexible links
+            and ignored for all other kinds.
+        :param str password: Optional password value to apply to the tokenized sharing link,
+            if it can support password protection.
         """
-        return self.list_item_all_fields.share_link(link_kind, expiration)
+        return self.list_item_all_fields.share_link(link_kind=link_kind,
+                                                    expiration=expiration,
+                                                    role=role,
+                                                    password=password)
 
     def unshare_link(self, link_kind, share_id=None):
         """
@@ -446,23 +455,24 @@ class Folder(BaseEntity):
 
     @property
     def time_created(self):
-        """Gets when the folder was created in UTC.
-
+        """
+        Gets when the folder was created in UTC.
         :rtype: datetime or None
         """
-        return self.properties.get("TimeCreated", None)
+        return self.properties.get("TimeCreated", datetime.min)
 
     @property
     def serverRelativeUrl(self):
-        """Gets the server-relative URL of the list folder.
-
+        """
+        Gets the server-relative URL of the list folder.
         :rtype: str or None
         """
         return self.properties.get("ServerRelativeUrl", None)
 
     @property
     def server_relative_path(self):
-        """Gets the server-relative Path of the list folder.
+        """
+        Gets the server-relative Path of the list folder.
         :rtype: SPResPath or None
         """
         return self.properties.get("ServerRelativePath", SPResPath())
@@ -479,7 +489,8 @@ class Folder(BaseEntity):
                 "ListItemAllFields": self.list_item_all_fields,
                 "ParentFolder": self.parent_folder,
                 "ServerRelativePath": self.server_relative_path,
-                "StorageMetrics": self.storage_metrics
+                "StorageMetrics": self.storage_metrics,
+                "TimeCreated": self.time_created
             }
             default_value = property_mapping.get(name, None)
         return super(Folder, self).get_property(name, default_value)

office365/sharepoint/forms/customization.py

@@ -0,0 +1,8 @@
+from office365.sharepoint.base_entity import BaseEntity
+
+
+class FormsCustomization(BaseEntity):
+
+    @property
+    def entity_type_name(self):
+        return "SP.Internal.FormsCustomization"

office365/sharepoint/listitems/listitem.py

@@ -48,19 +48,26 @@ class ListItem(SecurableObject):
         if parent_list is not None:
             self.set_property("ParentList", parent_list, False)
 
-    def share_link(self, link_kind, expiration=None):
+    def share_link(self, link_kind, expiration=None, role=None, password=None):
         """Creates a tokenized sharing link for a list item based on the specified parameters and optionally
         sends an email to the people that are listed in the specified parameters.
 
         :param int link_kind: The kind of the tokenized sharing link to be created/updated or retrieved.
-        :param datetime or None expiration: A date/time string for which the format conforms to the ISO 8601:2004(E)
+        :param datetime.datetime or None expiration: A date/time string for which the format conforms to the ISO 8601:2004(E)
             complete representation for calendar date and time of day and which represents the time and date of expiry
             for the tokenized sharing link. Both the minutes and hour value MUST be specified for the difference
             between the local and UTC time. Midnight is represented as 00:00:00. A null value indicates no expiry.
             This value is only applicable to tokenized sharing links that are anonymous access links.
+        :param int role: The role to be used for the tokenized sharing link. This is required for Flexible links
+            and ignored for all other kinds.
+        :param str password: Optional password value to apply to the tokenized sharing link,
+            if it can support password protection.
         """
         return_type = ClientResult(self.context, ShareLinkResponse())
-        request = ShareLinkRequest(settings=ShareLinkSettings(link_kind=link_kind, expiration=expiration))
+        request = ShareLinkRequest(settings=ShareLinkSettings(link_kind=link_kind,
+                                                              expiration=expiration,
+                                                              role=role,
+                                                              password=password))
         payload = {"request": request}
         qry = ServiceOperationQuery(self, "ShareLink", None, payload, None, return_type)
         self.context.add_query(qry)

office365/sharepoint/lists/bloom_filter.py

@@ -9,7 +9,6 @@ class ListBloomFilter(BaseEntity):
     def bloom_filter_size(self):
         """
         The length of the Bloom Filter
-
         :rtype: int or None
         """
         return self.properties.get("BloomFilterSize", None)

office365/sharepoint/lists/creation_information.py

@@ -4,19 +4,33 @@ from office365.runtime.client_value import ClientValue
 class ListCreationInformation(ClientValue):
     """Represents metadata about list creation."""
 
-    def __init__(self, title=None, description=None, base_template=None, allow_content_types=False):
+    def __init__(self, title=None, description=None, base_template=None, allow_content_types=False,
+                 custom_schema_xml=None, document_template_type=None, quick_launch_option=None,
+                 template_feature_id=None, template_type=None):
         """
-
-        :type base_template: int or None
-        :type allow_content_types: bool
+        :param int or None base_template:
+        :param bool allow_content_types:
         :poram str or None description: Specifies the description of the new list.
         :param str title: Specifies the display name of the new list.
+        :param str custom_schema_xml: Specifies the list schema of the new list.
+        :param str document_template_type: Specifies the identifier of the document template for the new list.
+        :param int quick_launch_option: Specifies whether the new list is displayed on the Quick Launch of the site
+        :param int template_feature_id: Specifies the feature identifier of the feature that contains the list schema
+            for the new list. It MUST be empty GUID if the list schema for the new list is not contained within
+            a feature.
+        :param int template_type: Specifies the list server template of the new list.
         """
         super(ListCreationInformation, self).__init__()
         self.Title = title
         self.Description = description
         self.BaseTemplate = base_template
         self.AllowContentTypes = allow_content_types
+        self.CustomSchemaXml = custom_schema_xml
+        self.DataSourceProperties = None
+        self.DocumentTemplateType = document_template_type
+        self.QuickLaunchOption = quick_launch_option
+        self.TemplateFeatureId = template_feature_id
+        self.TemplateType = template_type
 
     @property
     def entity_type_name(self):

office365/sharepoint/lists/list.py

@@ -1,3 +1,5 @@
+from datetime import datetime
+
 from office365.runtime.client_result import ClientResult
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -25,6 +27,7 @@ from office365.sharepoint.lists.bloom_filter import ListBloomFilter
 from office365.sharepoint.lists.creatables_info import CreatablesInfo
 from office365.sharepoint.lists.data_source import ListDataSource
 from office365.sharepoint.lists.rule import SPListRule
+from office365.sharepoint.navigation.configured_metadata_items import ConfiguredMetadataNavigationItemCollection
 from office365.sharepoint.pages.wiki_page_creation_information import WikiPageCreationInformation
 from office365.sharepoint.permissions.securable_object import SecurableObject
 from office365.sharepoint.principal.users.user import User
@@ -92,6 +95,20 @@ class List(SecurableObject):
         self.context.add_query(qry)
         return return_type
 
+    def get_metadata_navigation_settings(self):
+        """
+        Retrieves the configured metadata navigation settings for the list.
+        """
+        from office365.sharepoint.navigation.metadata_settings import MetadataNavigationSettings
+        return_type = ClientResult(self.context, ConfiguredMetadataNavigationItemCollection())
+
+        def _loaded():
+           MetadataNavigationSettings.get_configured_settings(self.context, self.root_folder.serverRelativeUrl,
+                                                              return_type)
+
+        self.root_folder.ensure_property("ServerRelativeUrl", _loaded)
+        return return_type
+
     def get_site_script(self, options=None):
         """Creates site script syntax
 
@@ -534,6 +551,14 @@ class List(SecurableObject):
         """
         return self.properties.get("Id", None)
 
+    @property
+    def additional_ux_properties(self):
+        """
+
+        :rtype: str
+        """
+        return self.properties.get("AdditionalUXProperties", None)
+
     @property
     def author(self):
         """Specifies the user who created the list."""
@@ -544,16 +569,22 @@ class List(SecurableObject):
     def allow_content_types(self):
         """
         Specifies whether the list supports content types.
-
         :rtype: bool or None
         """
         return self.properties.get("AllowContentTypes", None)
 
+    @property
+    def allow_deletion(self):
+        """
+        Specifies whether the list could be deleted.
+        :rtype: bool or None
+        """
+        return self.properties.get("AllowDeletion", None)
+
     @property
     def base_template(self):
         """
         Specifies the list server template of the list.
-
         :rtype: int or None
         """
         return self.properties.get("BaseTemplate", None)
@@ -563,16 +594,30 @@ class List(SecurableObject):
         """
         Specifies the base type of the list.
         It MUST be one of the following values: GenericList, DocumentLibrary, DiscussionBoard, Survey, or Issue.
-
         :rtype: int or None
         """
         return self.properties.get("BaseType", None)
 
+    @property
+    def browser_file_handling(self):
+        """
+        Specifies the override at the list level for the BrowserFileHandling property of the Web application.
+        If the BrowserFileHandling property of the Web application is BrowserFileHandling.Strict,
+        then this setting MUST be ignored. If the BrowserFileHandling property of the Web application is
+        BrowserFileHandling.Permissive, then this setting MUST be respected.
+        :rtype: int or None
+        """
+        return self.properties.get("BrowserFileHandling", None)
+
+    @property
+    def created(self):
+        """Specifies when the list was created."""
+        return self.properties.get("Created", datetime.min)
+
     @property
     def default_display_form_url(self):
         """
         Specifies the location of the default display form for the list.
-
         :rtype: str or None
         """
         return self.properties.get("DefaultDisplayFormUrl", None)
@@ -588,7 +633,6 @@ class List(SecurableObject):
     def default_view_url(self):
         """
         Specifies the server-relative URL of the default view for the list.
-
         :rtype: str or None
         """
         return self.properties.get("DefaultViewUrl", None)
@@ -598,7 +642,6 @@ class List(SecurableObject):
         """
         Specifies whether or not the crawler indexes the non-default views of the list.
         Specify a value of true if the crawler indexes the list's non-default views; specify false if otherwise.
-
         :rtype: bool or None
         """
         return self.properties.get("CrawlNonDefaultViews", None)
@@ -630,15 +673,6 @@ class List(SecurableObject):
         """
         return self.properties.get("DataSource", ListDataSource())
 
-    @property
-    def enable_folder_creation(self):
-        """
-        Specifies whether new list folders can be added to the list.
-
-        :rtype: bool or None
-        """
-        return self.properties.get("EnableFolderCreation", None)
-
     @property
     def default_edit_form_url(self):
         """
@@ -655,10 +689,66 @@ class List(SecurableObject):
         """
         return self.properties.get("DefaultItemOpenInBrowser", None)
 
+    @property
+    def default_item_open_use_list_setting(self):
+        """
+        This property returns whether to use the List setting or the server wide setting for
+        DefaultItemOpen (BrowserEnabledDocuments setting) in the Web application. This property can only be set to
+        false, thereby using the server-wide setting. To set it to use List setting, set the value for DefaultItemOpen.
+        :rtype: bool or None
+        """
+        return self.properties.get("DefaultItemOpenUseListSetting", None)
+
+    @property
+    def disable_commenting(self):
+        """
+        :rtype: bool or None
+        """
+        return self.properties.get("DisableCommenting", None)
+
+    @property
+    def disable_grid_editing(self):
+        """
+        :rtype: bool or None
+        """
+        return self.properties.get("DisableGridEditing", None)
+
+    @property
+    def enable_folder_creation(self):
+        """
+        Specifies whether new list folders can be added to the list.
+        :rtype: bool or None
+        """
+        return self.properties.get("EnableFolderCreation", None)
+
     @enable_folder_creation.setter
     def enable_folder_creation(self, value):
         self.set_property("EnableFolderCreation", value, True)
 
+    @property
+    def enable_minor_versions(self):
+        """
+        Specifies whether minor versions are enabled for the list.
+        :rtype: bool or None
+        """
+        return self.properties.get("EnableMinorVersions", None)
+
+    @property
+    def enable_moderation(self):
+        """
+        Specifies whether content approval is enabled for the list.
+        :rtype: bool or None
+        """
+        return self.properties.get("EnableModeration", None)
+
+    @property
+    def enable_versioning(self):
+        """
+        Specifies whether content approval is enabled for the list.
+        :rtype: bool or None
+        """
+        return self.properties.get("EnableVersioning", None)
+
     @property
     def items(self):
         """Get list items"""
@@ -707,11 +797,37 @@ class List(SecurableObject):
     @property
     def content_types_enabled(self):
         """Specifies whether content types are enabled for the list.
-
         :rtype: bool or None
         """
         return self.properties.get('ContentTypesEnabled', None)
 
+    @property
+    def is_private(self):
+        """
+        Specifies whether the list is a private list with restricted permissions.
+        True if the list is a private list, otherwise False.
+        :rtype: bool or None
+        """
+        return self.properties.get('IsPrivate', None)
+
+    @property
+    def is_site_assets_library(self):
+        """
+        Specifies whether the list is designated as a default asset location for images or other files which the
+        users upload to their wiki pages.
+        :rtype: bool or None
+        """
+        return self.properties.get('IsSiteAssetsLibrary', None)
+
+    @property
+    def is_system_list(self):
+        """
+        Indicates whether the list is system list that does not contain end user data and created by system account.
+        A value of True means yes.
+        :rtype: bool or None
+        """
+        return self.properties.get('IsSystemList', None)
+
     @property
     def user_custom_actions(self):
         """Gets the User Custom Actions that are associated with the list."""
@@ -746,16 +862,65 @@ class List(SecurableObject):
 
     @property
     def item_count(self):
-        """Gets a value that specifies the number of list items in the list.
-
+        """
+        Gets a value that specifies the number of list items in the list.
         :rtype: int or None
         """
         return self.properties.get('ItemCount', None)
 
     @property
-    def title(self):
-        """Gets the displayed title for the list.
+    def last_item_deleted_date(self):
+        """
+        Specifies the last time a list item was deleted from the list. It MUST return Created if no list item has
+        been deleted from the list yet.
+        """
+        return self.properties.get('LastItemDeletedDate', datetime.min)
+
+    @property
+    def last_item_modified_date(self):
+        """
+        Specifies the last time a list item, field, or property of the list was modified.
+        It MUST return Created if the list has not been modified.
+        """
+        return self.properties.get('LastItemModifiedDate', datetime.min)
+
+    @property
+    def list_form_customized(self):
+        """
+        :rtype: bool or None
+        """
+        return self.properties.get('ListFormCustomized', None)
+
+    @property
+    def list_item_entity_type_full_name(self):
+        """
+        Specifies the full type name of the list item.
+        :rtype: str or None
+        """
+        return self.properties.get('ListItemEntityTypeFullName', None)
+
+    @property
+    def major_version_limit(self):
+        """
+        Gets the maximum number of major versions allowed for an item in a document library that uses version
+        control with major versions only.
+        :rtype: int or None
+        """
+        return self.properties.get('MajorVersionLimit', None)
+
+    @property
+    def major_with_minor_versions_limit(self):
+        """
+        Gets the maximum number of major versions that are allowed for an item in a document library that uses
+        version control with both major and minor versions.
+        :rtype: int or None
+        """
+        return self.properties.get('MajorWithMinorVersionsLimit', None)
 
+    @property
+    def title(self):
+        """
+        Gets the displayed title for the list.
         :rtype: str or None
         """
         return self.properties.get('Title', None)
@@ -765,6 +930,16 @@ class List(SecurableObject):
         """Sets the displayed title for the list."""
         self.set_property('Title', val)
 
+
+    @property
+    def default_content_approval_workflow_id(self):
+        """
+        Specifies the default workflow identifier for content approval on the list. It MUST be an empty GUID
+        if there is no default content approval workflow.
+        :rtype: str
+        """
+        return self.properties.get("DefaultContentApprovalWorkflowId", None)
+
     @property
     def description(self):
         """Gets the description for the list.
@@ -790,8 +965,8 @@ class List(SecurableObject):
 
     @property
     def schema_xml(self):
-        """Specifies the list schema of the list.
-
+        """
+        Specifies the list schema of the list.
         :rtype: str or None
         """
         return self.properties.get("SchemaXml", None)
@@ -801,7 +976,6 @@ class List(SecurableObject):
         """
         Specifies the feature identifier of the feature that contains the list schema for the list.
         It MUST be an empty GUID if the list schema for the list is not contained within a feature.
-
         :rtype: str or None
         """
         return self.properties.get("TemplateFeatureId", None)
@@ -816,7 +990,6 @@ class List(SecurableObject):
     def validation_formula(self):
         """
         Specifies the data validation criteria for a list item.
-
         :rtype: str or None
         """
         return self.properties.get("ValidationFormula", None)
@@ -840,6 +1013,8 @@ class List(SecurableObject):
                 "DefaultView": self.default_view,
                 "DefaultViewPath": self.default_view_path,
                 "EventReceivers": self.event_receivers,
+                "LastItemDeletedDate": self.last_item_deleted_date,
+                "LastItemModifiedDate": self.last_item_modified_date,
                 "ParentWeb": self.parent_web,
                 "ParentWebPath": self.parent_web_path,
                 "RootFolder": self.root_folder,

office365/sharepoint/lists/render_data_parameters.py

@@ -4,13 +4,33 @@ from office365.runtime.client_value import ClientValue
 class RenderListDataParameters(ClientValue):
     """Specifies the parameters to be used to render list data as a JSON string"""
 
-    def __init__(self, add_all_fields=None, add_required_fields=None):
+    def __init__(self, add_all_fields=None, add_all_view_fields=None, add_regional_settings=None,
+                 add_required_fields=None, allow_multiple_value_filter_for_taxonomy_fields=None,
+                 audience_target=None, dates_in_utc=None, expand_groups=None, expand_user_field=None,
+                 filter_out_channel_folders_in_default_doc_lib=None):
         """
         :param bool add_all_fields:
+        :param bool add_all_view_fields:
+        :param bool add_regional_settings:
         :param bool add_required_fields: This parameter indicates if we return required fields.
+        :param bool allow_multiple_value_filter_for_taxonomy_fields: This parameter indicates whether multi value
+            filtering is allowed for taxonomy fields.
+        :param bool audience_target:
+        :param bool dates_in_utc: Specifies if the DateTime field is returned in UTC or local time.
+        :param bool expand_groups: Specifies whether to expand the grouping or not.
+        :param bool expand_user_field:
+        :param bool filter_out_channel_folders_in_default_doc_lib:
         """
         self.AddAllFields = add_all_fields
+        self.AddAllViewFields = add_all_view_fields
+        self.AddRegionalSettings = add_regional_settings
         self.AddRequiredFields = add_required_fields
+        self.AllowMultipleValueFilterForTaxonomyFields = allow_multiple_value_filter_for_taxonomy_fields
+        self.AudienceTarget = audience_target
+        self.DatesInUtc = dates_in_utc
+        self.ExpandGroups = expand_groups
+        self.ExpandUserField = expand_user_field
+        self.FilterOutChannelFoldersInDefaultDocLib = filter_out_channel_folders_in_default_doc_lib
 
     @property
     def entity_type_name(self):

office365/sharepoint/navigation/configured_metadata_items.py

@@ -1,6 +1,30 @@
 from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
+
+
+class ConfiguredMetadataNavigationItem(ClientValue):
+    """Represents a configured metadata navigation item."""
+
+    def __init__(self, field_display_name=None, field_title=None, field_type_as_string=None,
+                 is_content_type_field=None, is_folder_hierarchy=None, is_hierarchy=None):
+        """
+        :param str field_display_name: The display name of the field that this item refers to.
+        :param str field_title: The internal name of the field that this item refers to.
+        :param str field_type_as_string: The type of the field that this item refers to.
+        :param bool is_content_type_field: Indicates whether the type of this field is a content type.
+        :param bool is_folder_hierarchy: Indicates whether this item is a folder hierarchy.
+        :param bool is_hierarchy: Indicates whether this item is hierarchical.
+        """
+        self.FieldDisplayName = field_display_name
+        self.FieldTitle = field_title
+        self.FieldTypeAsString = field_type_as_string
+        self.IsContentTypeField = is_content_type_field
+        self.IsFolderHierarchy = is_folder_hierarchy
+        self.IsHierarchy = is_hierarchy
 
 
 class ConfiguredMetadataNavigationItemCollection(ClientValue):
     """A collection of configured metadata navigation items."""
-    pass
+
+    def __init__(self, items=None):
+        self.Items = ClientValueCollection(ConfiguredMetadataNavigationItem, items)

office365/sharepoint/navigation/metadata_settings.py

@@ -5,23 +5,25 @@ from office365.sharepoint.navigation.configured_metadata_items import Configured
 
 
 class MetadataNavigationSettings(BaseEntity):
-
+    """Described and allows changes to the meta-data navigation and filtering settings on an SPList."""
 
     @staticmethod
-    def get_configured_settings(context, url):
+    def get_configured_settings(context, url, return_type=None):
         """
         Retrieves the configured metadata navigation settings for the list with the specified url.
 
 
         :param office365.sharepoint.client_context.ClientContext context: SharePoint context
         :param str url: Specifies list url
+        :param ClientResult return_type: Return type
         """
 
-        return_type = ClientResult(context, ConfiguredMetadataNavigationItemCollection())
+        if return_type is None:
+            return_type = ClientResult(context, ConfiguredMetadataNavigationItemCollection())
         payload = {
             "DecodedUrl": url
         }
-        qry = ServiceOperationQuery(MetadataNavigationSettings(context), "GetConfiguredSettings", None, payload,
+        qry = ServiceOperationQuery(MetadataNavigationSettings(context), "GetConfiguredSettings", payload, None,
                                     None, return_type, True)
         context.add_query(qry)
         return return_type

office365/sharepoint/permissions/irm/file_settings.py

@@ -10,3 +10,46 @@ class InformationRightsManagementFileSettings(BaseEntity):
         qry = ServiceOperationQuery(self, "Reset")
         self.context.add_query(qry)
         return self
+
+    @property
+    def allow_print(self):
+        """
+        Gets a value indicating whether or not the user can print the downloaded document.
+        True if print is allowed; otherwise, it is false. The default value is false.
+        :rtype: bool
+        """
+        return self.properties.get("AllowPrint", None)
+
+    @allow_print.setter
+    def allow_print(self, value):
+        """
+         Sets a value indicating whether or not the user can print the downloaded document.
+        :param bool value:
+        """
+        self.set_property("AllowPrint", value)
+
+    @property
+    def allow_script(self):
+        """
+        Gets a value indicating whether or not the user can run a script on the downloaded document.
+        True if the script is allowed to run; otherwise, it is false. The default value is false.
+        :rtype: bool
+        """
+        return self.properties.get("AllowScript", None)
+
+    @allow_script.setter
+    def allow_script(self, value):
+        """
+        Sets a value indicating whether or not the user can run a script on the downloaded document.
+        :param bool value:
+        """
+        self.set_property("AllowPrint", value)
+
+    @property
+    def allow_write_copy(self):
+        """
+        Getsa value indicating whether or not the user can write on a copy of the downloaded document.
+        True if write on a copy is allowed; otherwise, it is false. The default value is false.
+        :rtype: bool
+        """
+        return self.properties.get("AllowWriteCopy", None)