SharePoint API: homesites, apps and tenant namespaces enhancements

Author: vgrem

office365/sharepoint/appprincipal/identity_provider.py

@@ -3,4 +3,8 @@
 
 class AppPrincipalIdentityProvider(BaseEntity):
     """Represents an identity provider for app principals."""
-    pass
+
+    @staticmethod
+    def external(context):
+        pass
+

office365/sharepoint/apps/license_manager.py

@@ -0,0 +1,5 @@
+from office365.sharepoint.base_entity import BaseEntity
+
+
+class SPAppLicenseManager(BaseEntity):
+    pass

office365/sharepoint/apps/solution_exporter.py

@@ -0,0 +1,5 @@
+from office365.sharepoint.base_entity import BaseEntity
+
+
+class SolutionExporter(BaseEntity):
+    pass

office365/sharepoint/apps/user_solution.py

@@ -0,0 +1,5 @@
+from office365.sharepoint.base_entity import BaseEntity
+
+
+class UserSolution(BaseEntity):
+    pass

office365/sharepoint/businessdata/app_bdc_catalog.py

@@ -1,5 +1,24 @@
+from office365.runtime.client_result import ClientResult
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+from office365.runtime.types.collections import StringCollection
 from office365.sharepoint.base_entity import BaseEntity
 
 
 class AppBdcCatalog(BaseEntity):
-    pass
+    """
+    Represents the Business Data Connectivity (BDC) MetadataCatalog for an application that contains external content
+    types provisioned by the application.
+    """
+
+    def get_permissible_connections(self):
+        """
+        Gets the list of external connections that the application has permissions to use.
+        """
+        return_type = ClientResult(self.context, StringCollection())
+        qry = ServiceOperationQuery(self, "GetPermissibleConnections", None, None, None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    @property
+    def entity_type_name(self):
+        return "SP.BusinessData.AppBdcCatalog"

office365/sharepoint/client_context.py

@@ -338,6 +338,12 @@ def ee(self):
         from office365.sharepoint.viva.employee_engagement import EmployeeEngagement
         return EmployeeEngagement(self)
 
+    @property
+    def employee_experience(self):
+        """Alias to EmployeeExperience"""
+        from office365.sharepoint.viva.employee_experience_controller import EmployeeExperienceController
+        return EmployeeExperienceController(self)
+
     @property
     def micro_service_manager(self):
         """Alias to MicroServiceManager"""

office365/sharepoint/clientsidecomponent/component_context_info.py

@@ -0,0 +1,9 @@
+from office365.sharepoint.base_entity import BaseEntity
+
+
+class ComponentContextInfo(BaseEntity):
+    """This class functions as a wrapper of the ContextInfo object. Reserved for internal use only."""
+
+    @property
+    def entity_type_name(self):
+        return "Microsoft.SharePoint.Internal.ClientSideComponent.ComponentContextInfo"

office365/sharepoint/fileservices/__init__.py

@@ -1,4 +1,5 @@
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.base_entity import BaseEntity
 
 
@@ -8,6 +9,15 @@ def __init__(self, context):
         stat_path = ResourcePath("Microsoft.Online.SharePoint.TenantAdministration.Internal.SPOWebAppServicePrincipal")
         super(SPOWebAppServicePrincipal, self).__init__(context, stat_path)
 
+
+    def update_spfx_client_secret(self, secret_value):
+        """
+        :param str secret_value:
+        """
+        payload = {"secretValue": secret_value}
+        qry = ServiceOperationQuery(self, "UpdateSpfxClientSecret", None, payload)
+        self.context.add_query(qry)
+
     @property
     def entity_type_name(self):
         return "Microsoft.Online.SharePoint.TenantAdministration.Internal.SPOWebAppServicePrincipal"

office365/sharepoint/largeoperation/__init__.py

@@ -114,13 +114,17 @@ def get_home_sites_details(self):
         self.context.add_query(qry)
         return return_type
 
-    def remove_home_site(self):
+    def remove_home_site(self, home_site_url):
         """
+        Remove home site
+
+        :param str home_site_url:
         """
-        return_type = ClientResult(self.context, str())
-        qry = ServiceOperationQuery(self, "RemoveSPHSite", None, None, None, return_type)
+        payload = {"homeSiteUrl": home_site_url}
+        qry = ServiceOperationQuery(self, "RemoveHomeSite", None, payload)
         self.context.add_query(qry)
-        return return_type
+        return self
+
 
     def has_valid_education_license(self):
         """"""

office365/sharepoint/tenant/administration/internal/web_appservice_principal.py

@@ -0,0 +1,5 @@
+from office365.sharepoint.base_entity import BaseEntity
+
+
+class TenantAppUtility(BaseEntity):
+    pass

office365/sharepoint/tenant/administration/tenant.py

@@ -0,0 +1,5 @@
+from office365.sharepoint.base_entity import BaseEntity
+
+
+class EmployeeExperienceController(BaseEntity):
+    pass

office365/sharepoint/tenant/app_utility.py

@@ -0,0 +1,14 @@
+from unittest import TestCase
+
+from office365.sharepoint.client_context import ClientContext
+from tests import test_admin_site_url, test_admin_credentials
+
+
+class TestBdc(TestCase):
+
+    def test_1_get_corporate_catalog_url(self):
+        client = ClientContext(test_admin_site_url).with_credentials(test_admin_credentials)
+        return_type = client.tenant_settings.get().execute_query()
+        self.assertIsNotNone(return_type.corporate_catalog_url)
+
+

office365/sharepoint/viva/employee_experience_controller.py

@@ -1,28 +1,25 @@
-from random import randint
 from unittest import TestCase
 
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.sharepoint.client_context import ClientContext
 from office365.sharepoint.publishing.portal_health_status import PortalHealthStatus
 from office365.sharepoint.tenant.administration.settings_service import TenantAdminSettingsService
 from office365.sharepoint.tenant.administration.sharing_capabilities import SharingCapabilities
-from office365.sharepoint.tenant.cdn_api import TenantCdnApi
-from office365.sharepoint.tenant.management.office365_tenant import Office365Tenant
 from office365.sharepoint.tenant.administration.site_properties import SiteProperties
 from office365.sharepoint.tenant.administration.site_properties_collection import SitePropertiesCollection
 from office365.sharepoint.tenant.administration.tenant import Tenant
+from office365.sharepoint.tenant.cdn_api import TenantCdnApi
+from office365.sharepoint.tenant.management.office365_tenant import Office365Tenant
 from office365.sharepoint.tenant.settings import TenantSettings
-from tests import test_site_url, test_admin_site_url, test_user_credentials, test_team_site_url
+from tests import test_site_url, test_admin_site_url, test_team_site_url, test_admin_credentials
 
 
 class TestTenant(TestCase):
     target_site_props = None  # type: SiteProperties
-    target_site_url = "{base_url}sites/{site_name}".format(base_url=test_site_url,
-                                                           site_name="Site_" + str(randint(0, 10000)))
 
     @classmethod
     def setUpClass(cls):
-        client = ClientContext(test_admin_site_url).with_credentials(test_user_credentials)
+        client = ClientContext(test_admin_site_url).with_credentials(test_admin_credentials)
         cls.tenant = Tenant(client)
         cls.client = client
 
@@ -140,3 +137,7 @@ def test_20_get_tenant_cdn_api(self):
     #def test_21_get_onedrive_site_sharing_insights(self):
     #    result = self.tenant.get_onedrive_site_sharing_insights(1).execute_query()
     #    self.assertIsNotNone(result.value)
+
+    def test_22_get_home_site_url(self):
+        result = self.tenant.get_home_site_url().execute_query()
+        self.assertIsNotNone(result.value)