pyxecm 2.0.0__py3-none-any.whl → 2.0.2__py3-none-any.whl

pyxecm/customizer/guidewire.py

@@ -10,34 +10,56 @@ __maintainer__ = "Dr. Marc Diefenbruch"
 __email__ = "mdiefenb@opentext.com"
 
 import logging
+import platform
+import sys
+import urllib.parse
+from importlib.metadata import version
 
 import requests
+from requests.auth import HTTPBasicAuth
 
-default_logger = logging.getLogger("pyxecm.customizer.guidewire")
+APP_NAME = "pyxecm"
+APP_VERSION = version("pyxecm")
+MODULE_NAME = APP_NAME + ".customizer.guidewire"
+
+PYTHON_VERSION = f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}"
+OS_INFO = f"{platform.system()} {platform.release()}"
+ARCH_INFO = platform.machine()
+REQUESTS_VERSION = requests.__version__
+
+USER_AGENT = (
+    f"{APP_NAME}/{APP_VERSION} ({MODULE_NAME}/{APP_VERSION}; "
+    f"Python/{PYTHON_VERSION}; {OS_INFO}; {ARCH_INFO}; Requests/{REQUESTS_VERSION})"
+)
+
+default_logger = logging.getLogger(MODULE_NAME)
 
 
 class Guidewire:
     """Class Guidewire is used to retrieve and automate stettings and objects in Guidewire."""
 
-    logger: logging.Logger = default_logger
     _config: dict
     _scope = None
-    _token = None
+    _access_token = None
 
     def __init__(
         self,
         base_url: str,
+        auth_type: str,
         client_id: str = "",
         client_secret: str = "",
         username: str = "",
         password: str = "",
         scope: str = "",
+        logger: logging.Logger = default_logger,
     ) -> None:
         """Initialize the Guidewire API client.
 
         Args:
             base_url (str):
                 The base URL of the Guidewire Cloud API.
+            auth_type (str):
+                The authorization type, either "oauth" or "basic".
             client_id (str):
                 The Client ID for authentication (optional, required for client credential flow).
             client_secret (str):
@@ -48,24 +70,37 @@ class Guidewire:
                 The password for authentication (optional, required for password-based authentication).
             scope (str):
                 The OAuth2 scope (optional).
+            logger:
+                The logging object used for all log messages. Default is default_logger.
 
         """
 
+        if logger != default_logger:
+            self.logger = logger.getChild("guidewire")
+            for logfilter in logger.filters:
+                self.logger.addFilter(logfilter)
+
         self._scope = scope
-        self._token = None
 
         guidewire_config = {}
         # Store the credentials and parameters in a config dictionary:
+        guidewire_config["baseUrl"] = base_url.rstrip("/")
+        guidewire_config["authType"] = auth_type
         guidewire_config["clientId"] = client_id
         guidewire_config["clientSecret"] = client_secret
         guidewire_config["username"] = username
         guidewire_config["password"] = password
-        guidewire_config["baseUrl"] = base_url.rstrip("/")
-        guidewire_config["cloudAPIUrl"] = guidewire_config["baseUrl"] + "/api/v1"
-        guidewire_config["tokenUrl"] = guidewire_config["cloudAPIUrl"] + "/oauth2/token"
+        guidewire_config["restUrl"] = guidewire_config["baseUrl"] + "/rest"  # "/api/v1"
+        guidewire_config["tokenUrl"] = guidewire_config["restUrl"] + "/oauth2/token"
+
+        guidewire_config["adminUrl"] = guidewire_config["restUrl"] + "/admin/v1"
+        guidewire_config["claimUrl"] = guidewire_config["restUrl"] + "/claim/v1"
+        guidewire_config["accountUrl"] = guidewire_config["restUrl"] + "/account/v1"
 
         self._config = guidewire_config
 
+        self._session = requests.Session()
+
     # end method definition
 
     def config(self) -> dict:
@@ -81,15 +116,29 @@ class Guidewire:
 
     # end method definition
 
-    def authenticate(self) -> bool:
+    def authenticate(self, auth_type: str) -> HTTPBasicAuth | str | None:
         """Authenticate with the Guidewire API using either client credentials or username/password.
 
+        Args:
+            auth_type (str):
+                The Authorization type. This can be "basic" or "oauth".
+
         Returns:
             bool:
                 True if authentication is successful, False otherwise.
 
         """
 
+        self._session.headers.update(self.request_header())
+
+        if auth_type == "basic":
+            username = self.config()["username"]
+            password = self.config()["password"]
+            if not self._session:
+                self._session = requests.Session()
+            self._session.auth = HTTPBasicAuth(username, password)
+            return self._session.auth
+
         request_url = self.config()["tokenUrl"]
 
         if self.config()["clientId"] and self.config()["clientSecret"]:
@@ -122,33 +171,42 @@ class Guidewire:
 
     # end method definition
 
-    def request_headers(self) -> dict:
+    def request_header(self, content_type: str = "application/json") -> dict:
         """Generate request headers including authentication token.
 
+        Args:
+            content_type (str, optional):
+                Custom content type for the request.
+                Typical value for Guidewire is application/json.
+
         Returns:
             dict:
                 A dictionary containing authorization headers.
 
         """
 
-        if not self._token:
-            self.logger.error("Authentication required. Call authenticate() first.")
-            return None
-
-        return {
-            "Authorization": "Bearer {}".format(self._token),
-            "Content-Type": "application/json",
+        request_header = {
+            "User-Agent": USER_AGENT,
+            "Content-Type": content_type,
         }
 
+        if self.config()["authType"] == "oauth":
+            if not self._access_token:
+                self.logger.error("Authentication required. Call authenticate() first.")
+                return None
+            request_header["Authorization"] = ("Bearer {}".format(self._access_token),)
+
+        return request_header
+
     # end method definition
 
-    def do_request(self, method: str, endpoint: str, data: dict | None = None, params: dict | None = None) -> dict:
+    def do_request(self, method: str, url: str, data: dict | None = None, params: dict | None = None) -> dict:
         """Send a request to the Guidewire REST API.
 
         Args:
             method (str):
                 The HTTP method to use (GET, POST, PUT, DELETE).
-            endpoint (str):
+            url (str):
                 The API endpoint to call.
             data (dict):
                 The request payload (if applicable).
@@ -161,22 +219,706 @@ class Guidewire:
 
         """
 
-        request_url = "{}{}".format(self.base_url, endpoint)
-        response = requests.request(method, request_url, headers=self._headers(), json=data, params=params)
+        response = self._session.request(
+            method=method, url=url, headers=self.request_header(), data=data, params=params
+        )
 
         return response.json() if response.content else {}
 
     # end method definition
 
-    def get_accounts(self) -> dict:
+    def process_parameters(
+        self, fields: list | None = None, filters: list | None = None, page_size: int | None = 25
+    ) -> str | None:
+        """Determine the request parameters (filters, fields).
+
+        Args:
+            fields (list | None, optional):
+                List of filter values. Defaults to None.
+            filters (list | None, optional):
+                List of filter values. Defaults to None.
+            page_size (int, optional):
+                The maximum number of groups to return.
+
+        Returns:
+            str | None:
+                Encoded URL parameters for the request URL.
+
+        """
+
+        query = {}
+
+        if fields:
+            fields = ",".join(fields)
+            query["fields"] = fields
+
+        for filter_dict in filters or []:
+            if "op" not in filter_dict:
+                filter_dict["op"] = "eq"
+            if "attribute" not in filter_dict:
+                self.logger.error("Missing attribute in filter condition!")
+                return None
+            if "value" not in filter_dict:
+                self.logger.error("Missing value(s) in filter condition!")
+                return None
+            elif isinstance(filter_dict["value"], list):
+                filter_dict["value"] = ",".join(filter_dict["value"])
+            query["filter"] = (
+                filter_dict.get("attribute") + ":" + filter_dict.get("op") + ":" + filter_dict.get("value")
+            )
+
+        if page_size:
+            query["pageSize"] = page_size
+
+        encoded_query = urllib.parse.urlencode(query=query, doseq=True)
+
+        return encoded_query
+
+    # end method definition
+
+    def get_groups(
+        self,
+        fields: list | None = None,
+        filters: list | None = None,
+        page_size: int = 25,
+        next_page_url: str | None = None,
+    ) -> dict:
+        """Retrieve a list of Guidewire groups.
+
+        Args:
+            fields (list):
+                The list of fields in the results. If None, all default
+                fields are returned.
+                Fields for Guidewire accounts:
+                - *all = return all fields
+                - *default = return just the default list of fields
+                - *summary = return the fields defined for giving a summary
+                - *detail = details
+                - displayName
+                - groupType
+                - id
+                - loadFactor
+                - name
+                - organization
+                - parent
+                - securityZone
+                - supervisor
+            filters (list):
+                List of dictionaries with three keys each:
+                - "attribute" - name of the attribute to use for the filter (available attributes see above)
+                - "op" - operator:
+                    * eq - equal
+                    * ne - not equal
+                    * lt - less than - also usable for dates (before)
+                    * gt - greater than - also usable for dates (after)
+                    * le - less or equal
+                    * ge - greater or equal
+                    * in - is in list
+                    * ni - is NOT in list
+                    * sw - starts with
+                    * cn - contains
+                - "value": the value to filter for. Either literal or list of values
+            page_size (int, optional):
+                The maximum number of groups to return.
+            next_page_url (str, optional):
+                The Guidewire URL to retrieve the next page of Guidewire groups (pagination).
+                This is used for the iterator get_groups_iterator() below.
+
+        Returns:
+            dict:
+                JSON response containing account data. None in case of an error.
+
+        Example reponse:
+        {
+            'count': 25,
+            'data': [
+                {
+                    'attributes': {
+                        'displayName': 'Actuary Unit',
+                        'groupType': {...},
+                        'id': 'pc:S_I-NOU3hb3FU0qTfu8fd',
+                        'loadFactor': 100,
+                        'name': 'Actuary Unit',
+                        'organization': {...},
+                        'parent': {...},
+                        'securityZone': {...},
+                        'supervisor': {...}
+                    },
+                    'checksum': '0',
+                    'links': {
+                        'self': {...}
+                    }
+                },
+                ...
+            ],
+            'links': {
+                'first': {
+                    'href': '/admin/v1/groups?fields=%2Adefault',
+                    'methods': ['get']
+                },
+                'next': {
+                    'href': '/admin/v1/groups?fields=%2Adefault&pageOffset=25',
+                    'methods': ['get']
+                },
+                'self': {...}
+            }
+        }
+
+        """
+
+        if not next_page_url:
+            request_url = self.config()["adminUrl"] + "/groups"
+
+            encoded_query = self.process_parameters(fields=fields, filters=filters, page_size=page_size)
+            if encoded_query:
+                request_url += "?" + encoded_query
+        else:
+            request_url = self.config()["restUrl"] + next_page_url
+
+        return self.do_request(method="GET", url=request_url)
+
+    # end method definition
+
+    def get_groups_iterator(self, fields: list | None = None, filters: list | None = None, page_size: int = 25) -> iter:
+        """Get an iterator object that can be used to traverse all Guidewire groups.
+
+        Returning a generator avoids loading a large number of nodes into memory at once. Instead you
+        can iterate over the potential large list of groups.
+
+        Example usage:
+            groups = guidewire_object.get_groups_iterator()
+            for group in groups:
+                logger.info("Traversing Guidewire group -> '%s'...", group.get("attributes", {}).get("displayName"))
+
+        Returns:
+            iter:
+                A generator yielding one Guidewire group per iteration.
+                If the REST API fails, returns no value.
+
+        """
+
+        next_page_url = None
+
+        while True:
+            response = self.get_groups(fields=fields, filters=filters, page_size=page_size, next_page_url=next_page_url)
+            if not response or "data" not in response:
+                # Don't return None! Plain return is what we need for iterators.
+                # Natural Termination: If the generator does not yield, it behaves
+                # like an empty iterable when used in a loop or converted to a list:
+                return
+
+            # Yield users one at a time:
+            yield from response["data"]
+
+            # See if we have an additional result page.
+            # If not terminate the iterator and return
+            # no value.
+            next_page_url = response.get("links", {}).get("next", {}).get("href")
+            if not next_page_url:
+                # Don't return None! Plain return is what we need for iterators.
+                # Natural Termination: If the generator does not yield, it behaves
+                # like an empty iterable when used in a loop or converted to a list:
+                return
+
+    # end method definition
+
+    def get_group(self, group_id: str) -> dict:
+        """Retrieve details of a specific group.
+
+        Args:
+            group_id: The unique identifier of the group.
+
+        Returns:
+            dict: JSON response containing group details.
+
+        Example response;
+        {
+            'data': {
+                'attributes': {
+                    'displayName': 'Actuary Unit',
+                    'groupType': {
+                        'code': 'actuary',
+                        'name': 'Actuary unit'
+                    },
+                    'id': 'pc:S_I-NOU3hb3FU0qTfu8fd',
+                    'loadFactor': 100,
+                    'name': 'Actuary Unit',
+                    'organization': {
+                        'displayName': 'Enigma Fire & Casualty',
+                        'id': 'systemTables:1',
+                        'type': 'Organization',
+                        'uri': '/admin/v1/organizations/systemTables:1'
+                    },
+                    'parent': {
+                        'displayName': 'Enigma Fire & Casualty',
+                        'id': 'systemTables:1',
+                        'type': 'Group',
+                        'uri': '/admin/v1/groups/systemTables:1'
+                    },
+                    'securityZone': {
+                        'displayName': 'HO UW',
+                        'id': 'pc:So-lJXKuecOco_hGZ_8iR'
+                    },
+                    'supervisor': {
+                        'displayName': 'Super Visor',
+                        'id': 'pc:S1cZ06yduoQadHVOcVCyv',
+                        'type': 'User',
+                        'uri': '/admin/v1/users/pc:S1cZ06yduoQadHVOcVCyv'
+                    }
+                },
+                'checksum': '0',
+                'links': {...}
+            }
+        }
+
+        """
+
+        request_url = self.config()["adminUrl"] + "/groups/" + str(group_id)
+
+        return self.do_request(method="GET", url=request_url)
+
+    # end method definition
+
+    def get_users(
+        self,
+        fields: list | None = None,
+        filters: list | None = None,
+        page_size: int = 25,
+        next_page_url: str | None = None,
+    ) -> dict:
+        """Retrieve a list of Guidewire users.
+
+        Args:
+            fields (list):
+                The list of fields in the results. If None, all default
+                fields are returned.
+                Fields for Guidewire accounts:
+                - *all = return all fields
+                - *default = return just the default list of fields
+                - *summary = return the fields defined for giving a summary
+                - *detail = details
+                - displayName
+                - groupType
+                - id
+                - loadFactor
+                - name
+                - organization
+                - parent
+                - securityZone
+                - supervisor
+            filters (list):
+                List of dictionaries with three keys each:
+                - "attribute" - name of the attribute to use for the filter (available attributes see above)
+                - "op" - operator:
+                    * eq - equal
+                    * ne - not equal
+                    * lt - less than - also usable for dates (before)
+                    * gt - greater than - also usable for dates (after)
+                    * le - less or equal
+                    * ge - greater or equal
+                    * in - is in list
+                    * ni - is NOT in list
+                    * sw - starts with
+                    * cn - contains
+                - "value": the value to filter for. Either literal or list of values
+            page_size (int, optional):
+                The maximum number of groups to return.
+            next_page_url (str, optional):
+                The Guidewire URL to retrieve the next page of Guidewire groups (pagination).
+                This is used for the iterator get_groups_iterator() below.
+
+        Returns:
+            dict:
+                JSON response containing account data.
+
+        Example reponse:
+        {
+            'count': 10,
+            'data': [
+                {
+                    'attributes': {
+                        'active': True,
+                        'displayName': 'Alice Applegate',
+                        'externalUser': False,
+                        'firstName': 'Alice',
+                        'groups': [
+                            {
+                                'displayName': 'Eastern Region Underwriting',
+                                'id': 'pc:SDrypgK62o6oS1TxOGcvF',
+                                'type': 'Group',
+                                'uri': '/admin/v1/groups/pc:SDrypgK62o6oS1TxOGcvF'
+                            },
+                            {
+                                'displayName': 'Los Angeles Branch UW',
+                                'id': 'pc:SJxAbEha2jYpG9Mb5_KAo',
+                                'type': 'Group',
+                                'uri': '/admin/v1/groups/pc:SJxAbEha2jYpG9Mb5_KAo'
+                            }
+                        ],
+                        'id': 'pc:Si6MBM-35EAhneDubeFsl',
+                        'lastName': 'Applegate',
+                        'organization': {
+                            'displayName': 'Enigma Fire & Casualty',
+                            'id': 'systemTables:1',
+                            'type': 'Organization',
+                            'uri': '/admin/v1/organizations/systemTables:1'
+                        },
+                        'roles': [
+                            {
+                                'displayName': 'Reinsurance Manager',
+                                'id': 'reinsurance_manager',
+                                'type': 'Role',
+                                'uri': '/admin/v1/roles/reinsurance_manager'
+                            },
+                            {
+                                'displayName': 'Underwriter',
+                                'id': 'underwriter',
+                                'type': 'Role',
+                                'uri': '/admin/v1/roles/underwriter'
+                            }
+                        ],
+                        'useOrgAddress': True,
+                        'useProducerCodeSecurity': False,
+                        'userType': {
+                            'code': 'underwriter',
+                            'name': 'Underwriter'
+                        },
+                        'username': 'aapplegate',
+                        'uwAuthorityProfiles': [
+                            {
+                                'displayName': 'Underwriter 1',
+                                'id': 'pc:underwriter1',
+                                'type': 'UWAuthorityProfile',
+                                'uri': '/admin/v1/uw-authority-profiles/pc:underwriter1'
+                            }
+                        ],
+                        'vacationStatus': {
+                            'code': 'atwork',
+                            'name': 'At work'
+                        },
+                        'workPhone': {
+                            'displayName': '213-555-8164',
+                            'number': '2135558164'
+                        }
+                    },
+                    'checksum': 'ec4710cd2af59bdc1cd7e15a18707d84',
+                    'links': {
+                        'self': {'href': '/admin/v1/users/pc:Si6MBM-35EAhneDubeFsl', 'methods': ['delete', 'get', 'patch']}
+                    }
+                },
+                ...
+            ],
+            'links': {
+                'first': {'href': '/admin/v1/users?fields=%2Adefault&pageSize=20', 'methods': ['get']},
+                'next': {'href': '/admin/v1/users?fields=%2Adefault&pageSize=20&pageOffset=20', 'methods': ['get']},
+                'self': {'href': '/admin/v1/users?fields=%2Adefault&pageSize=20', 'methods': ['get']}
+            }
+        }
+
+        """
+
+        if not next_page_url:
+            request_url = self.config()["adminUrl"] + "/users"
+
+            encoded_query = self.process_parameters(fields=fields, filters=filters, page_size=page_size)
+            if encoded_query:
+                request_url += "?" + encoded_query
+        else:
+            request_url = self.config()["restUrl"] + next_page_url
+
+        return self.do_request(method="GET", url=request_url)
+
+    # end method definition
+
+    def get_users_iterator(self, fields: list | None = None, filters: list | None = None, page_size: int = 25) -> iter:
+        """Get an iterator object that can be used to traverse all Guidewire users.
+
+        Returning a generator avoids loading a large number of nodes into memory at once. Instead you
+        can iterate over the potential large list of users.
+
+        Example usage:
+            users = guidewire_object.get_users_iterator()
+            for user in users:
+                logger.info("Traversing Guidewire user -> '%s'...", user.get("attributes", {}).get("displayName"))
+
+        Args:
+            fields (list):
+                The list of fields in the results. If None, all default
+                fields are returned.
+                Fields for Guidewire accounts:
+                - *all = return all fields
+                - *default = return just the default list of fields
+                - *summary = return the fields defined for giving a summary
+                - *detail = details
+                - active
+                - displayName
+                - externalUser
+                - firstName
+                - id
+                - lastName
+                - organization
+                - useOrgAddress
+                - useProducerCodeSecurity
+                - username
+            filters (list):
+                List of dictionaries with three keys each:
+                - "attribute" - name of the attribute to use for the filter (available attributes see above)
+                - "op" - operator:
+                    * eq - equal
+                    * ne - not equal
+                    * lt - less than - also usable for dates (before)
+                    * gt - greater than - also usable for dates (after)
+                    * le - less or equal
+                    * ge - greater or equal
+                    * in - is in list
+                    * ni - is NOT in list
+                    * sw - starts with
+                    * cn - contains
+                - "value": the value to filter for. Either literal or list of values
+            page_size (int, optional):
+                The maximum number of groups to return.
+            next_page_url (str, optional):
+                The Guidewire URL to retrieve the next page of Guidewire groups (pagination).
+                This is used for the iterator get_groups_iterator() below.
+
+        Returns:
+            iter:
+                A generator yielding one Guidewire user per iteration.
+                If the REST API fails, returns no value.
+
+        """
+
+        next_page_url = None
+
+        while True:
+            response = self.get_users(fields=fields, filters=filters, page_size=page_size, next_page_url=next_page_url)
+            if not response or "data" not in response:
+                # Don't return None! Plain return is what we need for iterators.
+                # Natural Termination: If the generator does not yield, it behaves
+                # like an empty iterable when used in a loop or converted to a list:
+                return
+
+            # Yield users one at a time:
+            yield from response["data"]
+
+            # See if we have an additional result page.
+            # If not terminate the iterator and return
+            # no value.
+            next_page_url = response.get("links", {}).get("next", {}).get("href")
+            if not next_page_url:
+                # Don't return None! Plain return is what we need for iterators.
+                # Natural Termination: If the generator does not yield, it behaves
+                # like an empty iterable when used in a loop or converted to a list:
+                return
+
+    # end method definition
+
+    def get_user(self, user_id: str) -> dict:
+        """Retrieve details of a specific user.
+
+        Args:
+            user_id:
+                The unique identifier of the group.
+
+        Returns:
+            dict:
+                JSON response containing group details.
+
+        Example response;
+        {
+            'data': {
+                'attributes': {
+                    'active': True,
+                    'displayName': 'Alice Applegate',
+                    'externalUser': False,
+                    'firstName': 'Alice',
+                    'groups': [{...}, {...}],
+                    'id': 'pc:Si6MBM-35EAhneDubeFsl',
+                    'lastName': 'Applegate',
+                    'organization': {
+                        'displayName': 'Enigma Fire & Casualty',
+                        'id': 'systemTables:1',
+                        'type': 'Organization',
+                        'uri': '/admin/v1/organizations/systemTables:1'
+                    },
+                    'roles': [{...}, {...}],
+                    'useOrgAddress': True,
+                    'useProducerCodeSecurity': False,
+                    'userType': {
+                        'code': 'underwriter',
+                        'name': 'Underwriter'
+                    },
+                    'username': 'aapplegate',
+                    'uwAuthorityProfiles': [{...}],
+                    'vacationStatus': {
+                        'code': 'atwork',
+                        'name': 'At work'
+                    },
+                    'workPhone': {
+                        'displayName': '213-555-8164',
+                        'number': '2135558164'
+                    }
+                },
+                'checksum': 'ec4710cd2af59bdc1cd7e15a18707d84',
+                'links': {
+                    'producer-codes': {
+                        'href': '/admin/v1/users/pc:Si6MBM-35EAhneDubeFsl/producer-codes',
+                        'methods': [...]
+                    },
+                    'self': {
+                        'href': '/admin/v1/users/pc:Si6MBM-35EAhneDubeFsl',
+                        'methods': [...]
+                    }
+                }
+            }
+        }
+
+        """
+
+        request_url = self.config()["adminUrl"] + "/users/" + str(user_id)
+
+        return self.do_request(method="GET", url=request_url)
+
+    # end method definition
+
+    def update_user(self, user_id: str, user_data: dict) -> dict:
+        """Update an existing user.
+
+        Args:
+            user_id:
+                The unique identifier of the user.
+            user_data:
+                Dictionary containing updated user information.
+
+        Returns:
+            dict:
+                Response with updated user details.
+
+        """
+
+        request_url = self.config()["adminUrl"] + "/users/" + str(user_id)
+
+        return self.do_request(method="PUT", url=request_url, data=user_data)
+
+    # end method definition
+
+    def get_accounts(
+        self,
+        fields: list | None = None,
+        filters: list | None = None,
+        page_size: int = 25,
+        next_page_url: str | None = None,
+    ) -> dict | None:
         """Retrieve a list of accounts.
 
+        Args:
+            fields (list):
+                The list of fields in the results. If None, all default
+                fields are returned.
+                Fields for Guidewire accounts:
+                - *all = return all fields
+                - *default = return just the default list of fields
+                - *summary = return the fields defined for giving a summary
+                - *detail = details
+                - accountNumber
+                - accountHolder
+                - accountStatus
+                - businessOperationsDescription
+                - createdDate
+                - frozen
+                - id
+                - industryCode
+                - organizationType
+                - preferredCoverageCurrency
+                - preferredSettlementCurrency
+                - primaryLanguage
+                - primaryLocale
+                - primaryLocation
+                - producerCodes
+            filters (list):
+                List of dictionaries with three keys each:
+                - "attribute" - name of the attribute to use for the filter (available attributes see above)
+                - "op" - operator:
+                    * eq - equal
+                    * ne - not equal
+                    * lt - less than - also usable for dates (before)
+                    * gt - greater than - also usable for dates (after)
+                    * le - less or equal
+                    * ge - greater or equal
+                    * in - is in list
+                    * ni - is NOT in list
+                    * sw - starts with
+                    * cn - contains
+                - "value": the filue to filter for. Either literal or list of values
+            page_size (int, optional):
+                The maximum number of groups to return.
+            next_page_url (str, optional):
+                The Guidewire URL to retrieve the next page of Guidewire groups (pagination).
+                This is used for the iterator get_groups_iterator() below.
+
         Returns:
-            dict: JSON response containing account data.
+            dict:
+                JSON response containing account data. None in case of an error.
+
+        """
+
+        if not next_page_url:
+            request_url = self.config()["accountUrl"] + "/accounts"
+
+            encoded_query = self.process_parameters(fields=fields, filters=filters, page_size=page_size)
+            if encoded_query:
+                request_url += "?" + encoded_query
+        else:
+            request_url = self.config()["restUrl"] + next_page_url
+
+        return self.do_request(method="GET", url=request_url)
+
+    # end method definition
+
+    def get_accounts_iterator(
+        self, fields: list | None = None, filters: list | None = None, page_size: int = 25
+    ) -> iter:
+        """Get an iterator object that can be used to traverse all Guidewire accounts.
+
+        Returning a generator avoids loading a large number of nodes into memory at once. Instead you
+        can iterate over the potential large list of groups.
+
+        Example usage:
+            accounts = guidewire_object.get_accounts_iterator()
+            for account in accounts:
+                logger.info("Traversing Guidewire account -> '%s'...", account.get("attributes", {}).get("displayName"))
+
+        Returns:
+            iter:
+                A generator yielding one Guidewire account per iteration.
+                If the REST API fails, returns no value.
 
         """
 
-        return self.do_request("GET", "/accounts")
+        next_page_url = None
+
+        while True:
+            response = self.get_accounts(
+                fields=fields, filters=filters, page_size=page_size, next_page_url=next_page_url
+            )
+            if not response or "data" not in response:
+                # Don't return None! Plain return is what we need for iterators.
+                # Natural Termination: If the generator does not yield, it behaves
+                # like an empty iterable when used in a loop or converted to a list:
+                return
+
+            # Yield users one at a time:
+            yield from response["data"]
+
+            # See if we have an additional result page.
+            # If not terminate the iterator and return
+            # no value.
+            next_page_url = response.get("links", {}).get("next", {}).get("href")
+            if not next_page_url:
+                # Don't return None! Plain return is what we need for iterators.
+                # Natural Termination: If the generator does not yield, it behaves
+                # like an empty iterable when used in a loop or converted to a list:
+                return
 
     # end method definition
 
@@ -184,14 +926,18 @@ class Guidewire:
         """Retrieve details of a specific account.
 
         Args:
-            account_id: The unique identifier of the account.
+            account_id:
+                The unique identifier of the account.
 
         Returns:
-            dict: JSON response containing account details.
+            dict:
+                JSON response containing account details.
 
         """
 
-        return self.do_request("GET", "/accounts/{}".format(account_id))
+        request_url = self.config()["accountUrl"] + "/accounts/" + str(account_id)
+
+        return self.do_request(method="GET", url=request_url)
 
     # end method definition
 
@@ -199,14 +945,18 @@ class Guidewire:
         """Create a new account.
 
         Args:
-            account_data: Dictionary containing account information.
+            account_data:
+                Dictionary containing account information.
 
         Returns:
-            dict: JSON response with created account details.
+            dict:
+                JSON response with created account details.
 
         """
 
-        return self.do_request("POST", "/accounts", data=account_data)
+        request_url = self.config()["accountUrl"] + "/accounts"
+
+        return self.do_request(method="POST", url=request_url, data=account_data)
 
     # end method definition
 
@@ -214,15 +964,20 @@ class Guidewire:
         """Update an existing account.
 
         Args:
-            account_id: The unique identifier of the account.
-            account_data: Dictionary containing updated account information.
+            account_id:
+                The unique identifier of the account.
+            account_data:
+                Dictionary containing updated account information.
 
         Returns:
-            dict: JSON response with updated account details.
+            dict:
+                JSON response with updated account details.
 
         """
 
-        return self.do_request("PUT", "/accounts/{}".format(account_id), data=account_data)
+        request_url = self.config()["accountUrl"] + "/accounts/" + str(account_id)
+
+        return self.do_request(method="PUT", url=request_url, data=account_data)
 
     # end method definition
 
@@ -237,19 +992,118 @@ class Guidewire:
 
         """
 
-        return self.do_request("DELETE", "/accounts/{}".format(account_id))
+        request_url = self.config()["accountUrl"] + "/accounts/" + str(account_id)
+
+        return self.do_request(method="DELETE", url=request_url)
 
     # end method definition
 
-    def get_claims(self) -> dict:
+    def get_claims(
+        self,
+        fields: list | None = None,
+        filters: list | None = None,
+        page_size: int = 25,
+        next_page_url: str | None = None,
+    ) -> dict | None:
         """Retrieve a list of claims.
 
+            fields (list):
+                The list of fields in the results. If None, all default
+                fields are returned.
+                Fields for Guidewire accounts:
+                - *all = return all fields
+                - *default = return just the default list of fields
+                - *summary = return the fields defined for giving a summary
+                - *detail = details
+                - displayName
+                - groupType
+                - id
+                - loadFactor
+                - name
+                - organization
+                - parent
+                - securityZone
+                - supervisor
+            filters (list):
+                List of dictionaries with three keys each:
+                - "attribute" - name of the attribute to use for the filter (available attributes see above)
+                - "op" - operator:
+                    * eq - equal
+                    * ne - not equal
+                    * lt - less than - also usable for dates (before)
+                    * gt - greater than - also usable for dates (after)
+                    * le - less or equal
+                    * ge - greater or equal
+                    * in - is in list
+                    * ni - is NOT in list
+                    * sw - starts with
+                    * cn - contains
+                - "value": the value to filter for. Either literal or list of values
+            page_size (int, optional):
+                The maximum number of groups to return.
+            next_page_url (str, optional):
+                The Guidewire URL to retrieve the next page of Guidewire groups (pagination).
+                This is used for the iterator get_groups_iterator() below.
+
         Returns:
-            dict: JSON response containing claim data.
+            dict | None:
+                JSON response containing claim data.
 
         """
 
-        return self.do_request("GET", "/claims")
+        if not next_page_url:
+            request_url = self.config()["claimUrl"] + "/claim-infos"
+
+            encoded_query = self.process_parameters(fields=fields, filters=filters, page_size=page_size)
+            if encoded_query:
+                request_url += "?" + encoded_query
+        else:
+            request_url = self.config()["restUrl"] + next_page_url
+
+        return self.do_request(method="GET", url=request_url)
+
+    # end method definition
+
+    def get_claims_iterator(self, fields: list | None = None, filters: list | None = None, page_size: int = 25) -> iter:
+        """Get an iterator object that can be used to traverse all Guidewire claims.
+
+        Returning a generator avoids loading a large number of nodes into memory at once. Instead you
+        can iterate over the potential large list of groups.
+
+        Example usage:
+            claims = guidewire_object.get_claims_iterator()
+            for claim in claims:
+                logger.info("Traversing Guidewire claim -> '%s'...", claim.get("attributes", {}).get("displayName"))
+
+        Returns:
+            iter:
+                A generator yielding one Guidewire claim per iteration.
+                If the REST API fails, returns no value.
+
+        """
+
+        next_page_url = None
+
+        while True:
+            response = self.get_claims(fields=fields, filters=filters, page_size=page_size, next_page_url=next_page_url)
+            if not response or "data" not in response:
+                # Don't return None! Plain return is what we need for iterators.
+                # Natural Termination: If the generator does not yield, it behaves
+                # like an empty iterable when used in a loop or converted to a list:
+                return
+
+            # Yield users one at a time:
+            yield from response["data"]
+
+            # See if we have an additional result page.
+            # If not terminate the iterator and return
+            # no value.
+            next_page_url = response.get("links", {}).get("next", {}).get("href")
+            if not next_page_url:
+                # Don't return None! Plain return is what we need for iterators.
+                # Natural Termination: If the generator does not yield, it behaves
+                # like an empty iterable when used in a loop or converted to a list:
+                return
 
     # end method definition
 
@@ -257,14 +1111,18 @@ class Guidewire:
         """Retrieve details of a specific claim.
 
         Args:
-            claim_id: The unique identifier of the claim.
+            claim_id:
+                The unique identifier of the claim.
 
         Returns:
-            dict: JSON response containing claim details.
+            dict:
+                JSON response containing claim details.
 
         """
 
-        return self.do_request("GET", "/claims/{}".format(claim_id))
+        request_url = self.config()["claimUrl"] + "/claims/" + str(claim_id)
+
+        return self.do_request(method="GET", url=request_url)
 
     # end method definition
 
@@ -281,7 +1139,9 @@ class Guidewire:
 
         """
 
-        return self.do_request("POST", "/claims", data=claim_data)
+        request_url = self.config()["claimUrl"] + "/claims"
+
+        return self.do_request(method="POST", url=request_url, data=claim_data)
 
     # end method definition
 
@@ -300,7 +1160,9 @@ class Guidewire:
 
         """
 
-        return self.do_request("PUT", "/claims/{}".format(claim_id), data=claim_data)
+        request_url = self.config()["claimUrl"] + "/claims/" + str(claim_id)
+
+        return self.do_request(method="PUT", url=request_url, data=claim_data)
 
     # end method definition
 
@@ -317,6 +1179,8 @@ class Guidewire:
 
         """
 
-        return self.do_request("DELETE", "/claims/{}".format(claim_id))
+        request_url = self.config()["claimUrl"] + "/claims/" + str(claim_id)
+
+        return self.do_request(method="DELETE", url=request_url)
 
     # end method definition