pyxecm 3.4.2__tar.gz → 3.4.4__tar.gz

{pyxecm-3.4.2 → pyxecm-3.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyxecm
-Version: 3.4.2
+Version: 3.4.4
 Summary: A Python library to interact with Opentext Content Management Rest API
 Project-URL: Homepage, https://github.com/opentext/pyxecm
 Author-email: Kai Gatzweiler <kgatzweiler@opentext.com>, "Dr. Marc Diefenbruch" <mdiefenb@opentext.com>

{pyxecm-3.4.2 → pyxecm-3.4.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pyxecm"
-version = "3.4.2"
+version = "3.4.4"
 description = 'A Python library to interact with Opentext Content Management Rest API'
 keywords = [
   'opentext',

{pyxecm-3.4.2 → pyxecm-3.4.4}/src/pyxecm/otcs.py

@@ -542,6 +542,8 @@ class OTCS:
         otcs_config["businessObjectTypesUrl"] = otcs_rest_url + "/v2/businessobjecttypes"
         otcs_config["businessObjectsSearchUrl"] = otcs_rest_url + "/v2/forms/businessobjects/search"
         otcs_config["businessWorkspaceTypesUrl"] = otcs_rest_url + "/v1/businessworkspacetypes"
+        otcs_config["businessWorkspaceReportsUrl"] = otcs_rest_url + "/v2/businessworkspace"
+        otcs_config["businessWorkspaceMyTeamTodoUrl"] = otcs_rest_url + "/v2/businessworkspace/myteamtodo"
         otcs_config["businessWorkspaceTypesUrlv2"] = otcs_rest_url + "/v2/businessworkspacetypes"
         otcs_config["businessworkspacecreateform"] = otcs_rest_url + "/v2/forms/businessworkspaces/create"
         otcs_config["businessWorkspacesUrl"] = otcs_rest_url + "/v2/businessworkspaces"
@@ -608,6 +610,12 @@ class OTCS:
         self._soap_docman_client: Client | None = None
         self._soap_transport: Transport | None = None
 
+        # Memoized full reminder client/type list (client_id=None). Reminder client
+        # and type configuration is effectively static for the lifetime of an OTCS
+        # object, so caching it avoids repeated 1+N REST round-trips when a single
+        # add/update operation resolves and validates a reminder type multiple times.
+        self._reminder_clients_cache: list[dict] | None = None
+
         # Handle concurrent HTTP requests that may run into 401 errors and
         # re-authentication at the same time:
         self._authentication_lock = threading.Lock()
@@ -2692,6 +2700,55 @@ class OTCS:
 
     # end method definition
 
+    @tracer.start_as_current_span(attributes=OTEL_TRACING_ATTRIBUTES, name="get_system_default_metadata_language")
+    def get_system_default_metadata_language(self) -> str | None:
+        """Get the Content Server system default metadata language as a 2-letter ISO 639-1 code.
+
+        Derives the language from the server's ``metadata_languages`` list by finding
+        the entry with ``'default': True`` (e.g. ``{'default': True, 'language_code': 'en'}`` → ``'en'``).
+
+        This is the language in which ``wksp_type_name`` and other default metadata fields are stored.
+
+        The result is cached because the system language does not change at runtime.
+
+        Returns:
+            str | None:
+                Two-letter language code (e.g. 'en', 'de', 'fr'),
+                or None if the server info cannot be retrieved.
+
+        """
+
+        language = self.__get_system_default_metadata_language_cached()
+        if language is None:
+            self.__get_system_default_metadata_language_cached.cache_clear()
+
+        return language
+
+    @cache
+    def __get_system_default_metadata_language_cached(self) -> str | None:
+        response = self.get_server_info()
+        if not response:
+            return None
+
+        server_info = response.get("server")
+        if not server_info:
+            return None
+
+        # metadata_languages is a list of dicts, e.g.:
+        # [{'default': True, 'display_name': 'English', 'language_code': 'en'}, ...]
+        # The entry with 'default': True defines the system's metadata language.
+        metadata_languages = server_info.get("metadata_languages")
+        if not metadata_languages:
+            return None
+
+        for lang in metadata_languages:
+            if lang.get("default"):
+                return lang.get("language_code")
+
+        return None
+
+    # end method definition
+
     @tracer.start_as_current_span(attributes=OTEL_TRACING_ATTRIBUTES, name="apply_config")
     def apply_config(self, xml_file_path: str) -> dict | None:
         """Apply Content Server administration settings from XML file.
@@ -11167,11 +11224,24 @@ class OTCS:
     # end method definition
 
     @tracer.start_as_current_span(attributes=OTEL_TRACING_ATTRIBUTES, name="get_business_object_types")
-    def get_business_object_types(self) -> dict | None:
+    def get_business_object_types(
+        self,
+        where_is_default_search: bool | None = None,
+        where_workspace_type_id: int | None = None,
+        drop_empty: bool = True,
+    ) -> dict | None:
         """Get information for all configured business object types.
 
         Args:
-            None
+            where_is_default_search (bool | None, optional):
+                If True, only return business object types that are marked as default search.
+            where_workspace_type_id (int | None, optional):
+                If provided, only return business object types that are associated with the given workspace type ID.
+            drop_empty (bool, optional):
+                If True, drop any business object types that have empty properties. Default is True.
+                It seems OTCM is returning some business object types with all properties empty
+                except for the workspace type ID. These are likely the workspace types that
+                don't have any business object types associated with them. We drop them by default.
 
         Returns:
             dict | None:
@@ -11210,15 +11280,28 @@ class OTCS:
 
         """
 
-        request_url = self.config()["businessObjectTypesUrl"]
+        query = {}
+        if where_is_default_search is not None:
+            query["where_is_default_search"] = where_is_default_search
+
+        encoded_query = urllib.parse.urlencode(query=query, doseq=True)
+
+        request_url = self.config()["businessObjectTypesUrl"] + "?{}".format(encoded_query)
         request_header = self.request_form_header()
 
         self.logger.debug(
-            "Get all business object types; calling -> %s",
+            "Get all business object types%s%s%s; calling -> %s",
+            " where is default search = {}".format(where_is_default_search)
+            if where_is_default_search is not None
+            else "",
+            " and" if where_is_default_search is not None and where_workspace_type_id is not None else "",
+            " where workspace type ID = {}".format(where_workspace_type_id)
+            if where_workspace_type_id is not None
+            else "",
             request_url,
         )
 
-        return self.do_request(
+        response = self.do_request(
             url=request_url,
             method="GET",
             headers=request_header,
@@ -11226,6 +11309,26 @@ class OTCS:
             failure_message="Failed to get business object types",
         )
 
+        # Filter for workspace type ID - the REST API above does not provide such option
+        # so we need to do it manually:
+        if where_workspace_type_id is not None and response and "results" in response:
+            response["results"] = [
+                item
+                for item in response["results"]
+                if "data" in item
+                and "properties" in item["data"]
+                and item["data"]["properties"]["workspace_type_id"] == where_workspace_type_id
+            ]
+        # Drop empty business object types if requested:
+        elif drop_empty and response and "results" in response:
+            response["results"] = [
+                item
+                for item in response["results"]
+                if "data" in item and "properties" in item["data"] and item["data"]["properties"]["bo_type"] is not None
+            ]
+
+        return response
+
     # end method definition
 
     @tracer.start_as_current_span(attributes=OTEL_TRACING_ATTRIBUTES, name="get_business_object_types_iterator")
@@ -11663,7 +11766,7 @@ class OTCS:
     @tracer.start_as_current_span(attributes=OTEL_TRACING_ATTRIBUTES, name="get_business_objects_search")
     def get_business_objects_search(
         self,
-        external_system_id: str,
+        external_system_id: str | None = None,
         type_name: str | None = None,
         type_id: int | None = None,
     ) -> dict | None:
@@ -11673,18 +11776,24 @@ class OTCS:
         get_business_objects method.
 
         Args:
-            external_system_id (str):
-                The External system ID (such as "TM6").
+            external_system_id (str | None):
+                The External system ID (such as "TM6"). Optional parameter but
+                needed if type_id is NOT provided ot type_name. If type_id is provided,
+                the external_system_id parameter will be ignored.
             type_name (str | None):
                 Type name of the business object (such as "SAP Customer").
             type_id (int | None):
-                The business object type ID. This is an alternative to the type_name parameter.
-                Either type_name or type_id needs to be provided.
-                If both are provided, type_id will be used and type_name will be ignored.
+                The business object type ID. This is an alternative to the
+                type_name + external_system_id parameters.
+                Either external_system_id + type_name or type_id needs to be provided.
+                If both are provided, type_id will be used and type_name and external_system_id
+                will be ignored.
 
         Returns:
             dict | None:
                 Business Object Search Form or None if the request fails.
+                The first element in results contains the business object type information
+                and the second element contains the search form information.
 
         Example:
         {
@@ -11848,14 +11957,16 @@ class OTCS:
             )
             return None
 
-        if not external_system_id:
-            self.logger.error("External system ID needs to be provided. Cannot get business object search form.")
+        if type_name and not external_system_id:
+            self.logger.error(
+                "External system ID needs to be provided when type name is used. Cannot get business object search form."
+            )
             return None
 
-        query = {
-            "ext_system_id": external_system_id,
-        }
+        query = {}
 
+        if external_system_id:
+            query["ext_system_id"] = external_system_id
         if type_id:
             query["bo_type_id"] = type_id
         else:
@@ -11869,10 +11980,10 @@ class OTCS:
         request_header = self.request_form_header()
 
         self.logger.debug(
-            "Get search form for business object type%s -> '%s' and external system -> %s; calling -> %s",
+            "Get search form for business object type%s -> '%s'%s; calling -> %s",
             " ID" if type_id else "",
             type_id or type_name,
-            external_system_id,
+            " and external system -> {}".format(external_system_id) if external_system_id else "",
             request_url,
         )
 
@@ -11881,10 +11992,10 @@ class OTCS:
             method="GET",
             headers=request_header,
             timeout=None,
-            failure_message="Failed to get search form for business object type{} -> '{}' and external system -> {}".format(
+            failure_message="Failed to get search form for business object type{} -> '{}'{}".format(
                 " ID" if type_id else "",
                 type_id or type_name,
-                external_system_id,
+                " and external system -> {}".format(external_system_id) if external_system_id else "",
             ),
         )
 
@@ -13150,6 +13261,8 @@ class OTCS:
     @tracer.start_as_current_span(attributes=OTEL_TRACING_ATTRIBUTES, name="get_workspace_types")
     def get_workspace_types(
         self,
+        ext_system_id: int | None = None,
+        bo_type: str | None = None,
         expand_workspace_info: bool = True,
         expand_templates: bool = True,
         show_error: bool = True,
@@ -13162,6 +13275,16 @@ class OTCS:
         This endpoint may throw an HTTP 500 error if no workspace types are in OTCS.
 
         Args:
+            ext_system_id (int | None, optional):
+                External system ID to filter workspace types by. Needs to be provided
+                together with bo_type. If ext_system_id is provided but bo_type is not,
+                the REST API will fail.
+            bo_type (str | None, optional):
+                Business Object type name to filter workspace types by. The is the
+                technical name of the business object type - NOT the ID! E.g. "KNA1"
+                for customers in SAP S/4HANA. Needs to be provided together with ext_system_id.
+                If bo_type is provided but ext_system_id is not, the REST API will fail.
+                It is OK to omit both parameters to get all workspace types in OTCS.
             expand_workspace_info (bool, optional):
                 Controls if the workspace info is returned as well
             expand_templates (bool, optional):
@@ -13181,26 +13304,73 @@ class OTCS:
             ```json
             {
                 'links': {
-                    'data': {...}
+                    'data': {
+                        'self': {
+                            'body': '',
+                            'content_type': '',
+                            'href': '/api/v2/businessworkspacetypes?bo_type=KNA1&expand_templates=true&expand_wksp_info=true&ext_system_id=TE1',
+                            'method': 'GET',
+                            'name': ''
+                        }
+                    }
                 },
                 'results': [
                     {
                         'data': {
                             'properties': {
-                                'rm_enabled': False,
-                                'templates': [
-                                    {
-                                        'id': 14471,
-                                        'name': 'Campaign',
-                                        'subtype': 848
-                                    },
-                                    ...
-                                ],
-                                'wksp_type_id': 35,
-                                'wksp_type_name': 'Campaign'
+                                'add_creator_to_lead_role': True,
+                                'aviator_enabled': True,
+                                'classification': {
+                                    'location': 'StaticNodeId',
+                                    'location_value': '30020'
+                                },
+                                'config_node_id': 39309,
+                                'external_document_storage': {
+                                    'rm_classification': {...},
+                                    'sub_location_path': {...}
+                                },
+                                'indexing': {
+                                    'enabled': True,
+                                    'sub_types': [...]
+                                },
+                                'relations': [{...}, {...}, {...}],
+                                'rm_enabled': True,
+                                'search': {
+                                    'follow_related_wksp': 'AlwaysEnabled',
+                                    'max_number_of_followed_wksp': 50
+                                },
+                                'simplify_business_workspace_creation': False,
+                                'templates': [{...}],
+                                'widget_icon': {
+                                    'url': '/appimg/ot_bws/icons/39309.svg?v=162061_17502'
+                                },
+                                'wksp_copy_enabled': True,
+                                'wksp_creation': {
+                                    'create_wksp_with_fast_bulk_method': False,
+                                    'directly_open_created_wksp': True,
+                                    'location': 'StaticNodeId',
+                                    'location_value': '34962',
+                                    'sub_location_path': {...},
+                                    'use_also_for_manual_creation': True
+                                },
+                                'wksp_creation_enabled': True,
+                                'wksp_descriptions': {'ar': '', 'de': '', 'en': '', 'es': '', 'fr': '', 'it': '', 'iw': '', 'ja': '', 'nl': ''},
+                                'wksp_icon': 'otsapxecm/wksp_customer.png',
+                                'wksp_name_generation': {
+                                    'use_also_for_wksp_without_bo': False,
+                                    'wksp_names': {...}
+                                },
+                                'wksp_policies_enabled': False,
+                                'wksp_type_id': 16,
+                                'wksp_type_name': 'Customer',
+                                'wksp_type_names': {'ar': '', 'de': 'Kunde', 'en': 'Customer', 'es': '', 'fr': 'Client', 'it': 'Cliente', 'iw': '', 'ja': 'お客様', 'nl': ''}
                             },
                             'wksp_info': {
-                                'wksp_type_icon': '/appimg/ot_bws/icons/13147%2Esvg?v=161108_84584'
+                                'in_use': True,
+                                'indexing_status': 'UpToDate',
+                                'modified': '2026-06-30T01:32:24',
+                                'perspective_folder_id': 39316,
+                                'wksp_type_icon': '/appimg/ot_bws/icons/39309.svg?v=162061_17502'
                             }
                         }
                     }
@@ -13212,6 +13382,15 @@ class OTCS:
 
         query = {"expand_templates": expand_templates, "expand_wksp_info": expand_workspace_info}
 
+        if (ext_system_id is not None and bo_type is None) or (ext_system_id is None and bo_type is not None):
+            self.logger.error("Both ext_system_id and bo_type must be provided together.")
+            return None
+
+        if ext_system_id is not None:
+            query["ext_system_id"] = ext_system_id
+        if bo_type is not None:
+            query["bo_type"] = bo_type
+
         encoded_query = urllib.parse.urlencode(query=query, doseq=True)
 
         request_url = self.config()["businessWorkspaceTypesUrlv2"] + "?{}".format(encoded_query)
@@ -14564,7 +14743,7 @@ class OTCS:
         self,
         node_id: int,
     ) -> list | None:
-        """Get a workspace references to business objects in external systems.
+        """Get the workspace references to business objects in external systems.
 
         Args:
             node_id (int):
@@ -14572,7 +14751,7 @@ class OTCS:
 
         Returns:
             list | None:
-                A List of references to business objects in external systems.
+                A list of references to business objects in external systems.
 
         Example:
         [
@@ -14760,7 +14939,7 @@ class OTCS:
     def create_workspace(
         self,
         workspace_template_id: int,
-        workspace_name: str,
+        workspace_name: str | None,
         workspace_description: str,
         workspace_type: int,
         category_data: dict | None = None,
@@ -14780,12 +14959,13 @@ class OTCS:
         template and type, with optional category data and business object details.
         It also supports linking to external systems and specifying metadata such as
         creation and modification dates.
+        If the name is not specified it will be derived from workspace metadata.
 
         Args:
             workspace_template_id (int):
                 The ID of the workspace template to be used.
-            workspace_name (str):
-                The name of the new workspace.
+            workspace_name (str | None):
+                The name of the new workspace. If not specified, it will be derived from workspace metadata.
             workspace_description (str):
                 A description of the new workspace.
             workspace_type (int):
@@ -14853,13 +15033,16 @@ class OTCS:
 
         create_workspace_post_data = {
             "template_id": str(workspace_template_id),
-            "name": workspace_name,
             "description": workspace_description,
             "wksp_type_id": str(workspace_type),
             "type": str(self.ITEM_TYPE_BUSINESS_WORKSPACE),
             "roles": {},  # category_data,
         }
 
+        # Yes, workspace name is optional. If not specified, it will be derived from workspace metadata.
+        if workspace_name:
+            create_workspace_post_data["name"] = workspace_name
+
         if category_data:
             create_workspace_post_data["roles"]["categories"] = category_data
         if external_create_date:
@@ -14891,7 +15074,7 @@ class OTCS:
         if parent_id is not None:
             create_workspace_post_data["parent_id"] = parent_id
             self.logger.debug(
-                "Use specified location with node ID -> %d for workspace -> '%s'",
+                "Use specified location with node ID -> %d for creation of workspace -> '%s'",
                 parent_id,
                 workspace_name,
             )
@@ -15040,7 +15223,7 @@ class OTCS:
         self,
         workspace_id: int,
         related_workspace_id: int,
-        relationship_type: str = "child",
+        relationship_type: str | None = "child",
         show_error: bool = True,
     ) -> dict | None:
         """Create a relationship between two workspaces.
@@ -15060,7 +15243,7 @@ class OTCS:
         and the other of type 'child', but this is a less common use case.
 
         Adding a relationship R1: A --> Child --> B makes A to the parent of B _AND_ also
-        B to the child of A. Requesting the childs of A will include edge R1. Requesting the
+        B to the child of A. Requesting the childs of A will include relationship R1. Requesting the
         parents of B will include R1 as well. But it is still possible to add a relationship
         R2: A --> Parent --> B. This will be a separate relationship.
 
@@ -15069,8 +15252,10 @@ class OTCS:
                 The ID of the workspace.
             related_workspace_id (int):
                 The ID of the related workspace.
-            relationship_type (str, optional):
-                Can be "parent" or "child" - "child" is default if not provided.
+            relationship_type (str | None, optional):
+                Can be "parent" or "child" - "child" is the default. If None (or empty)
+                is provided, it falls back to "child" instead of sending an invalid
+                relationship type to the REST API.
             show_error (bool, optional):
                 If True, log an error if relationship cration fails.
                 Otherwise log a warning.
@@ -15081,6 +15266,17 @@ class OTCS:
 
         """
 
+        # Normalize the relationship type so that callers passing None explicitly
+        # (which overrides the default) still get the intended "child" behavior:
+        if not relationship_type:
+            relationship_type = "child"
+        elif relationship_type not in ("parent", "child"):
+            self.logger.error(
+                "Illegal relationship type -> '%s'! Must be either 'parent' or 'child'.",
+                relationship_type,
+            )
+            return None
+
         create_workspace_relationship_post_data = {
             "rel_bw_id": str(related_workspace_id),
             "rel_type": relationship_type,
@@ -25942,6 +26138,14 @@ class OTCS:
 
         # end method definition of _extract_field_mappings()
 
+        # Serve the memoized full client/type list when no specific client filter
+        # is requested (the common case for type resolution and validation). The
+        # local `client_id` is reassigned inside the loop below, so capture the
+        # original intent up front for both the cache read and the cache write:
+        is_full_list = client_id is None
+        if is_full_list and self._reminder_clients_cache is not None:
+            return self._reminder_clients_cache
+
         response = self.get_reminder_types(client_id=client_id)
         if not response:
             return None
@@ -25983,6 +26187,10 @@ class OTCS:
             str(clients),
         )
 
+        # Memoize the full client/type list for subsequent lookups in this session:
+        if is_full_list:
+            self._reminder_clients_cache = clients
+
         return clients
 
     # end method definition
@@ -27330,7 +27538,13 @@ class OTCS:
             dict | None:
                 Response from the server, or None if the request fails.
 
-        Example:
+        Note:
+            On OTCM 26.2 and newer the `results` payload contains the ID of the
+            newly created reminder (extractable via `get_result_value(response, key="id")`).
+            On older releases `results` was empty even on success, so callers that
+            need the reminder ID on those releases must fall back to `get_reminders()`.
+
+        Example (OTCM 26.2 and newer):
         {
             'links': {
                 'data': {
@@ -27343,7 +27557,7 @@ class OTCS:
                     }
                 }
             },
-            'results': {} # seems to be always empty - also on success
+            'results': {'id': 66}  # ID of the newly created reminder (empty {} on releases before 26.2)
         }
 
         """
@@ -27719,3 +27933,170 @@ class OTCS:
         )
 
     # end method definition
+
+    @tracer.start_as_current_span(attributes=OTEL_TRACING_ATTRIBUTES, name="get_workspace_report_detail")
+    def get_workspace_report_detail(
+        self,
+        workspace_id: int,
+        report_type: str,
+    ) -> dict | None:
+        """Get the full document list for a single workspace report type.
+
+        REST operation: GET /v2/businessworkspace/{workspace_id}/reports?type={report_type}
+
+        Args:
+            workspace_id (int):
+                Business workspace node ID.
+            report_type (str):
+                Report type key. One of ``"documentsAdded"``, ``"outdatedDocuments"``,
+                or ``"recentDocuments"``.
+
+        Returns:
+            dict | None:
+                Report detail response containing a ``results.data`` list and
+                ``results.total_count``, or None on error.
+
+        """
+
+        request_url = "{}/{}/reports?type={}".format(
+            self.config()["businessWorkspaceReportsUrl"],
+            workspace_id,
+            report_type,
+        )
+        request_header = self.request_json_header()
+
+        self.logger.debug(
+            "Get workspace report detail for workspace with ID -> %d, type -> %s; calling -> %s",
+            workspace_id,
+            report_type,
+            request_url,
+        )
+
+        return self.do_request(
+            url=request_url,
+            method="GET",
+            headers=request_header,
+            timeout=REQUEST_TIMEOUT,
+            failure_message="Failed to get '{}' report detail for workspace with ID -> {}".format(
+                report_type, workspace_id
+            ),
+        )
+
+    # end method definition
+
+    @tracer.start_as_current_span(attributes=OTEL_TRACING_ATTRIBUTES, name="get_workspace_documents")
+    def get_workspace_documents(
+        self,
+        workspace_id: int,
+        document_type: Literal["missing", "inprocess"] = "missing",
+    ) -> dict | None:
+        """Get the list of missing or in-process documents for a Business Workspace.
+
+        REST operation: GET /v2/businessworkspaces/{workspace_id}/missingdocuments
+        REST operation: GET /v2/businessworkspaces/{workspace_id}/inprocessdocuments
+
+        Missing documents are required document types that are absent from the workspace.
+        In-process documents are currently being processed within the workspace
+        (e.g. pending classification, approval, or ingestion workflows).
+
+        Args:
+            workspace_id (int):
+                Business workspace node ID.
+            document_type (Literal["missing", "inprocess"], optional):
+                Which document category to retrieve:
+                * ``"missing"`` — required documents absent from the workspace
+                  (``/missingdocuments``).
+                * ``"inprocess"`` — documents currently being processed
+                  (``/inprocessdocuments``).
+                Defaults to ``"missing"``.
+
+        Returns:
+            dict | None:
+                Response containing a ``results.data`` list and ``results.total_count``,
+                or None on error.
+
+        """
+
+        endpoint = "inprocessdocuments" if document_type == "inprocess" else "missingdocuments"
+        request_url = "{}/{}/{}".format(
+            self.config()["businessWorkspacesUrl"],
+            workspace_id,
+            endpoint,
+        )
+        request_header = self.request_json_header()
+
+        self.logger.debug(
+            "Get %s for workspace with ID -> %d; calling -> %s",
+            endpoint,
+            workspace_id,
+            request_url,
+        )
+
+        return self.do_request(
+            url=request_url,
+            method="GET",
+            headers=request_header,
+            timeout=REQUEST_TIMEOUT,
+            failure_message="Failed to get {} for workspace with ID -> {}".format(endpoint, workspace_id),
+        )
+
+    # end method definition
+
+    @tracer.start_as_current_span(attributes=OTEL_TRACING_ATTRIBUTES, name="get_workspace_myteamtodo")
+    def get_workspace_myteamtodo(self) -> dict | None:
+        """Get the My Team Todo data for the currently authenticated user.
+
+        Returns the employee-file completeness status (missing and outdated document types)
+        for all direct reports of the currently authenticated user.
+
+        REST operation: GET /v2/businessworkspace/myteamtodo
+
+        Returns:
+            dict | None:
+                Response containing a ``results`` list where each element holds a
+                ``data.members`` list of direct reportees with their completeness status,
+                or None on error.
+
+        Example:
+                {
+                    'results': [
+                        {
+                            'data': {
+                                'members': [
+                                    {
+                                        'id': 1234,
+                                        'display_name': 'Ian Grant',
+                                        'first_name': 'Ian',
+                                        'last_name': 'Grant',
+                                        'business_email': 'ian.grant@example.com',
+                                        'employee_file_todos': {
+                                            'missing': [{'doc_type_name': 'Contract'}],
+                                            'outdated': [{'doc_type_name': 'Accident'}],
+                                        },
+                                    }
+                                ]
+                            },
+                            'properties': None,
+                        }
+                    ]
+                }
+
+        """
+
+        request_url = self.config()["businessWorkspaceMyTeamTodoUrl"]
+        request_header = self.request_json_header()
+
+        self.logger.debug(
+            "Get My Team Todo data for current user; calling -> %s",
+            request_url,
+        )
+
+        return self.do_request(
+            url=request_url,
+            method="GET",
+            headers=request_header,
+            timeout=REQUEST_TIMEOUT,
+            failure_message="Failed to get My Team Todo data.",
+        )
+
+    # end method definition

{pyxecm-3.4.2 → pyxecm-3.4.4}/src/pyxecm_customizer/payload.py

@@ -9010,11 +9010,12 @@ class Payload:
             # that is used for display purposes in the SmartView if given.
             # It can be either a string or a dict with language keys (e.g. "en", "de", ...)
             # and text values for multilingual support.
-            # If it is a string we convert it to the dict format with "en"
-            # as default language key:
+            # If it is a string we convert it to the dict format with the
+            # system default metadata language key:
             description = external_system.get("description")
             if description and isinstance(description, str):
-                description = {"en": description}
+                default_locale = self._otcs.get_system_default_metadata_language() or "en"
+                description = {default_locale: description}
 
             self._log_header_callback(
                 text="Process External System -> '{}' ({})".format(system_name, system_type),
@@ -13447,7 +13448,7 @@ class Payload:
 
         """
 
-        if not self._workspaces:
+        if not self._ontologies:
             self.logger.info(
                 "Payload section -> '%s' is empty. Skipping...",
                 section_name,
@@ -13505,6 +13506,8 @@ class Payload:
                 )
                 continue
 
+            default_locale = ontology.get("locale", self._otcs.get_system_default_metadata_language() or "en")
+
             for entity in entities:
                 workspace_type_name = entity.get("name")
                 if not workspace_type_name:
@@ -13624,12 +13627,13 @@ class Payload:
                         for r in entity_relations
                     ):
                         self.logger.debug(
-                            "Relationship from entity type -> '%s' (%s) to -> '%s' (%s) of relationship type -> '%s' already exists. Skipping duplicate...",
+                            "Relationship from entity type -> '%s' (%s) to -> '%s' (%s) of relationship type -> '%s' already exists (existing relationships -> %s). Skipping duplicate...",
                             workspace_type_name,
                             workspace_type_id,
                             target_wksp_type_name,
                             target_wksp_type_id,
                             rel_type,
+                            str(entity_relations),
                         )
                         continue
 
@@ -13638,7 +13642,7 @@ class Payload:
                             "target_wksp_type_id": int(target_wksp_type_id),
                             "rel_type": rel_type,  # the REST API requires Child and Parent capitalized
                             "predicates": [
-                                predicate if isinstance(predicate, dict) else {"en": predicate}
+                                predicate if isinstance(predicate, dict) else {default_locale: predicate}
                                 for predicate in rel.get("predicates", [])
                             ],  # the REST API supports multi-lingual. If the payload has plain strings as elements we interpret this as english only
                         }