Ensure mandatory entity type for LisiItem, Readme updates

Author: vgrem

README.md

@@ -35,7 +35,7 @@ The list of supported API versions:
 
 The following auth flows are supported:
 
-- app principals flow: `AuthenticationContext.ctx_auth.acquire_token_for_app(client_id, client_secret)`  (refer [Granting access using SharePoint App-Only] (https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/security-apponly-azureacs) for a details) 
+- app principals flow: `AuthenticationContext.ctx_auth.acquire_token_for_app(client_id, client_secret)`  (refer [Granting access using SharePoint App-Only](https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/security-apponly-azureacs) for a details) 
 - user credentials flow:`AuthenticationContext.ctx_auth.acquire_token_for_user(username, password)`
 - certificate credentials flow `ClientContext.connect_with_certificate(site_url, client_id,thumbprint, certificate_path)`
 

examples/sharepoint/ConnectionWithCert.md

@@ -41,7 +41,7 @@ where
 ```
 site_url - SharePoint site url
 client_id - The OAuth client id of the calling application. 
-thumbprint - ex encoded thumbprint of the certificate
+thumbprint - hex encoded thumbprint of the certificate
 certificate_path - path to a PEM encoded certificate private key
 ```
 

examples/sharepoint/data_generator.py

@@ -1,36 +1,52 @@
-import settings
+from settings import settings
 from faker import Faker
-
-from office365.runtime.auth.authentication_context import AuthenticationContext
+from office365.runtime.auth.UserCredential import UserCredential
 from office365.sharepoint.client_context import ClientContext
+from office365.sharepoint.list_creation_information import ListCreationInformation
+from office365.sharepoint.list_template_type import ListTemplateType
 
 
-def generate_tasks(context):
-    tasks_list = ctx.web.lists.get_by_title("Tasks")
-    for idx in range(0, 10):
-        title = "Task{0}".format(idx)
-        task_properties = {'__metadata': {'type': 'SP.Data.TasksListItem'}, 'Title': title}
-        task_item = tasks_list.add_item(task_properties)
-        context.execute_query()
-        print("Task '{0}' has been created".format(task_item.properties["Title"]))
+def ensure_list(web, list_properties):
+    ctx = web.context
+    lists = web.lists.filter("Title eq '{0}'".format(list_properties.Title))
+    ctx.load(lists)
+    ctx.execute_query()
+    if len(lists) == 1:
+        return lists[0]
+    target_list = web.lists.add(list_properties)
+    ctx.execute_query()
+    return target_list
 
 
 def generate_contacts(context):
-    contacts_list = ctx.web.lists.get_by_title("Contacts")
+    contacts_list = ensure_list(context.web,
+                                ListCreationInformation("Contacts_Large",
+                                                        None,
+                                                        ListTemplateType.Contacts)
+                                )
+
     fake = Faker()
-    for idx in range(0, 1):
-        name = fake.name()
-        contact_properties = {'__metadata': {'type': 'SP.Data.ContactsListItem'}, 'Title': name}
+    for idx in range(0, 100):
+        contact_properties = {
+
+                              'Title': fake.name(),
+                              'FullName': fake.name(),
+                              'Email': fake.email(),
+                              'Company': fake.company(),
+                              'WorkPhone': fake.phone_number(),
+                              'WorkAddress': fake.street_address(),
+                              'WorkCity': fake.city(),
+                              'WorkZip': fake.postcode(),
+                              'WorkCountry': fake.country(),
+                              'WebPage': {'Url': fake.url()}
+                              }
         contact_item = contacts_list.add_item(contact_properties)
         context.execute_query()
         print("Contact '{0}' has been created".format(contact_item.properties["Title"]))
 
 
 if __name__ == '__main__':
-    ctx_auth = AuthenticationContext(url=settings['url'])
-    if ctx_auth.acquire_token_for_user(username=settings['username'], password=settings['password']):
-        ctx = ClientContext(settings['url'], ctx_auth)
-        generate_tasks(ctx)
-        # generate_contacts(ctx)
-    else:
-        print(ctx_auth.get_last_error())
+    ctx = ClientContext.connect_with_credentials("https://mediadev8.sharepoint.com/sites/team",
+                                                 UserCredential(settings['user_credentials']['username'],
+                                                                settings['user_credentials']['password']))
+    generate_contacts(ctx)

examples/sharepoint/read_large_list.py

@@ -2,15 +2,16 @@
 from office365.sharepoint.client_context import ClientContext
 from settings import settings
 
-ctx = ClientContext.connect_with_credentials(settings['url'],
+ctx = ClientContext.connect_with_credentials("https://mediadev8.sharepoint.com/sites/team",
                                              ClientCredential(settings['client_credentials']['client_id'],
                                                               settings['client_credentials']['client_secret']))
 
 large_list = ctx.web.lists.get_by_title("Contacts_Large")
-paged_items = large_list.get_items().top(2000)
+paged_items = large_list.get_items().top(100)
 ctx.load(paged_items)
 ctx.execute_query()
 
+#res = paged_items[102]
 print("Items count: {0}".format(len(paged_items)))
-for idx, item in enumerate(paged_items):
-    print("{0}: {1}".format(idx, item.properties['Title']))
+#for idx, item in enumerate(paged_items):
+#    print("{0}: {1}".format(idx, item.properties['Title']))

office365/sharepoint/listitem.py

@@ -89,4 +89,13 @@ def set_property(self, name, value, persist_changes=True):
                     "getItemById", [value], self._parent_collection.resourcePath.parent)
 
     def ensure_type_name(self, target_list):
-        pass
+        if not self._entity_type_name:
+            if not target_list.is_property_available("ListItemEntityTypeFullName"):
+                self.context.load(target_list, "ListItemEntityTypeFullName")
+                self.context.get_pending_request().afterExecute += self._init_item_type
+            else:
+                self._entity_type_name = target_list.properties['ListItemEntityTypeFullName']
+
+    def _init_item_type(self, result):
+        self.context.get_pending_request().afterExecute -= self._init_item_type
+        self._entity_type_name = result.properties['ListItemEntityTypeFullName']