mbu-dev-shared-components 0.0.51.post3__tar.gz → 0.0.52__tar.gz

{mbu_dev_shared_components-0.0.51.post3 → mbu_dev_shared_components-0.0.52}/.pylintrc

@@ -5,4 +5,6 @@ disable =
   R0913, # Too many arguments
   R0914, # Too many local variables
   W0718, # Catching too general exception Exception (broad-exception-caught)
-  R0903, # Too few public methods
+  R0903, # Too few public methods
+  R0916, # Too many boolean expressions in if statement
+  R0917 # Too many positional arguments

{mbu_dev_shared_components-0.0.51.post3 → mbu_dev_shared_components-0.0.52}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mbu_dev_shared_components
-Version: 0.0.51.post3
+Version: 0.0.52
 Summary: Shared components to use in RPA projects
 Author-email: MBU <rpa@mbu.aarhus.dk>
 Classifier: Programming Language :: Python :: 3
@@ -15,6 +15,7 @@ Requires-Dist: requests_ntlm>=1.2.0
 Requires-Dist: python-dateutil==2.9.*
 Requires-Dist: cryptography>=43.0.0
 Requires-Dist: office365-rest-python-client
+Requires-Dist: uiautomation
 
 # mbu-dev-shared-components
 

mbu_dev_shared_components-0.0.52/mbu_dev_shared_components/solteqtand/app_handler.py

@@ -0,0 +1,336 @@
+"""
+This module contains the `SolteqTandApp` class, which automates interactions with the SolteqTand application using the UIAutomation library.
+"""
+import os
+import time
+import uiautomation as auto
+
+
+class SolteqTandApp:
+    """
+    A class to automate interactions with the SolteqTand application.
+    """
+    def __init__(self, app_path, username, password, ssn):
+        """
+        Initializes the SolteqTandApp object.
+
+        Args:
+            app_path (str): Path to the application.
+            username (str): Username for login.
+            password (str): Password for login.
+            ssn (str): SSN for lookup.
+        """
+        self.app_path = app_path
+        self.username = username
+        self.password = password
+        self.ssn = ssn
+        self.app_window = None
+
+    def find_element_by_property(self, control, control_type=None, automation_id=None, name=None, class_name=None) -> auto.Control:
+        """
+        Uses GetChildren to traverse through controls and find an element based on the specified properties.
+
+        Args:
+            control (Control): The root control to search from (e.g., main window or pane).
+            control_type (ControlType, optional): ControlType to search for.
+            automation_id (str, optional): AutomationId of the target element.
+            name (str, optional): Name of the target element.
+            class_name (str, optional): ClassName of the target element.
+
+        Returns:
+            Control: The found element or None if no match is found.
+        """
+        children = control.GetChildren()
+
+        for child in children:
+            if (control_type is None or child.ControlType == control_type) and \
+               (automation_id is None or child.AutomationId == automation_id) and \
+               (name is None or child.Name == name) and \
+               (class_name is None or child.ClassName == class_name):
+                return child
+
+            found = self.find_element_by_property(child, control_type, automation_id, name, class_name)
+            if found:
+                return found
+
+        return None
+
+    def wait_for_control(self, control_type, search_params, search_depth=1, timeout=30):
+        """
+        Waits for a given control type to become available with the specified search parameters.
+
+        Args:
+            control_type: The type of control, e.g., auto.WindowControl, auto.ButtonControl, etc.
+            search_params (dict): Search parameters used to identify the control.
+                                  The keys must match the properties used in the control type, e.g., 'AutomationId', 'Name'.
+            search_depth (int): How deep to search in the user interface.
+            timeout (int): How long to wait, in seconds.
+
+        Returns:
+            Control: The control object if found, otherwise None.
+        """
+        end_time = time.time() + timeout
+        while time.time() < end_time:
+            control = control_type(searchDepth=search_depth, **search_params)
+            if control.Exists(0, 0):
+                return control
+            time.sleep(0.5)
+        raise TimeoutError(f"Control with parameters {search_params} was not found within the timeout period.")
+
+    def start_application(self):
+        """
+        Starts the application using the specified path.
+        """
+        os.startfile(self.app_path)
+
+    def login(self):
+        """
+        Logs into the application by entering the username and password.
+        Checks if the login window is open and ready.
+        Checks if the main window is opened and ready.
+        """
+        self.app_window = self.wait_for_control(
+            auto.WindowControl,
+            {'AutomationId': 'FormLogin'},
+            search_depth=3,
+            timeout=60
+        )
+        self.app_window.SetFocus()
+
+        username_box = self.app_window.EditControl(AutomationId="TextLogin")
+        username_box.SendKeys(text=self.username)
+
+        password_box = self.app_window.EditControl(AutomationId="TextPwd")
+        password_box.SendKeys(text=self.password)
+
+        login_button = self.app_window.PaneControl(AutomationId="ButtonLogin")
+        login_button.SetFocus()
+        login_button.SendKeys('{ENTER}')
+
+        self.app_window = self.wait_for_control(
+            auto.WindowControl,
+            {'AutomationId': 'FormFront'},
+            search_depth=2,
+            timeout=60
+        )
+
+    def open_patient(self):
+        """
+        When the main window is open, presses Ctrl + O to open the 'Open Patient' window,
+        searches for the SSN, and opens the patient.
+        """
+        self.app_window.SetFocus()
+        self.app_window.SendKeys('{Ctrl}o', waitTime=0)
+
+        open_patient_window = self.wait_for_control(
+            auto.WindowControl,
+            {'AutomationId': 'FormOpenPatient'},
+            search_depth=2
+        )
+        open_patient_window.SetFocus()
+
+        ssn_input = open_patient_window.EditControl(AutomationId="TextBoxCpr")
+        search_button = open_patient_window.PaneControl(AutomationId="ButtonOk")
+
+        ssn_input.SendKeys(text=self.ssn)
+        search_button.SetFocus()
+        search_button.SendKeys('{ENTER}')
+
+        self.app_window = self.wait_for_control(
+            auto.WindowControl,
+            {'AutomationId': 'FormPatient'}
+        )
+        self.app_window.Maximize()
+
+    def open_sub_tab(self, sub_tab_name: str):
+        """
+        Opens a specific sub-tab in the patient's main card.
+
+        Args:
+            sub_tab_name (str): The name of the sub-tab to open (e.g., "Dokumenter").
+        """
+        sub_tab_button = self.app_window.TabItemControl(Name=sub_tab_name)
+        is_sub_tab_selected = sub_tab_button.GetPattern(10010).IsSelected
+
+        if not is_sub_tab_selected:
+            sub_tab_button.SetFocus()
+            sub_tab_button.SendKeys('{ENTER}')
+
+    def open_tab(self, tab_name: str):
+        """
+        Opens a specific tab in the patient's main card.
+
+        Args:
+            tab_name (str): The name of the tab to open (e.g., "Frit valg").
+        """
+        match tab_name:
+            case "Stamkort":
+                tab_name_modified = "S&tamkort"
+            case "Fritvalg":
+                tab_name_modified = "F&ritvalg"
+            case "Journal":
+                tab_name_modified = "&Journal"
+
+        tab_button = self.find_element_by_property(
+            control=self.app_window,
+            control_type=auto.ControlType.TabItemControl,
+            name=tab_name_modified
+        )
+        is_tab_selected = tab_button.GetPattern(10010).IsSelected
+
+        if not is_tab_selected:
+            tab_button.SetFocus()
+            tab_button.SendKeys('{ENTER}')
+
+    def create_document(self, document_full_path: str = None, document_type: str = None):
+        """
+        Creates a new document under the 'Dokumenter' tab.
+
+        Args:
+            document_full_path (str, optional): The full path of the document to upload.
+            document_type (str, optional): The type of document to select from the dropdown.
+        """
+        self.open_tab("Stamkort")
+        self.open_sub_tab("Dokumenter")
+
+        document_list = self.find_element_by_property(
+            control=self.app_window,
+            control_type=auto.ControlType.ListControl,
+            automation_id="cleverListView1"
+        )
+
+        list_items = self.find_element_by_property(
+            control=document_list,
+            control_type=auto.ControlType.ListItemControl
+        )
+        list_items.RightClick(simulateMove=False, waitTime=0)
+
+        document_list_menu = self.wait_for_control(
+            auto.MenuControl,
+            {'Name': 'Kontekst'},
+            search_depth=2
+        )
+
+        menu_create_document = self.find_element_by_property(
+            control=document_list_menu,
+            control_type=auto.ControlType.MenuItemControl,
+            name="Opret"
+        )
+        menu_create_document.Click(simulateMove=False, waitTime=0)
+
+        create_document_window = self.wait_for_control(
+            auto.WindowControl,
+            {'AutomationId': 'UploadFile'},
+            search_depth=2
+        )
+        file_path_textbox = self.find_element_by_property(
+            control=create_document_window,
+            control_type=auto.ControlType.EditControl,
+            automation_id="textBoxLocalFilePath"
+        )
+        legacy_pattern = file_path_textbox.GetLegacyIAccessiblePattern()
+        legacy_pattern.SetValue(document_full_path)
+
+        if document_type:
+            document_type_drop_down = self.find_element_by_property(
+                control=create_document_window,
+                control_type=auto.ControlType.ButtonControl,
+                name="Åbn"
+            )
+            document_type_drop_down.Click(simulateMove=False, waitTime=0)
+
+            document_type_button = self.find_element_by_property(
+                control=create_document_window,
+                control_type=auto.ControlType.ListItemControl,
+                name=document_type
+            )
+            document_type_button.Click(simulateMove=False, waitTime=0)
+
+        button_create_document = self.find_element_by_property(
+            control=create_document_window,
+            control_type=auto.ControlType.PaneControl,
+            automation_id="buttonOpen"
+        )
+        button_create_document.Click(simulateMove=False, waitTime=0)
+
+    def create_event(self, event_message: str, patient_clinic: str):
+        """
+        Creates an event for the given patient.
+
+        Args:
+            event_title (str): The title of the event to create.
+            patient_clinic (str): The clinic associated with the patient.
+        """
+        self.open_tab("Stamkort")
+
+        menu_funktioner = self.app_window.MenuItemControl(Name="Funktioner")
+        menu_funktioner.Click(simulateMove=False, waitTime=0)
+
+        henvis_patient = self.app_window.Control(
+            Name="Henvis patient",
+            ControlType=auto.ControlType.MenuItemControl
+        )
+        henvis_patient.Click(simulateMove=False, waitTime=0)
+
+        clinic_list = self.wait_for_control(
+            auto.WindowControl,
+            {"AutomationId": "FormFindClinics"},
+            search_depth=2
+        )
+
+        clinic_list_items = clinic_list.ListControl(AutomationId="ListClinics")
+        clinic_list_item = clinic_list_items.Control(
+            Name=patient_clinic,
+            ControlType=auto.ControlType.ListItemControl
+        )
+        clinic_list_item.GetPattern(10017).ScrollIntoView()
+        clinic_list_item.SetFocus()
+        clinic_list_item.DoubleClick(simulateMove=False, waitTime=0)
+
+        message_window = self.wait_for_control(
+            auto.WindowControl,
+            {"AutomationId": "VBInputBox"},
+            search_depth=2
+        )
+        message_textbox = message_window.EditControl(AutmationId="TextBox")
+        message_textbox_legacy_pattern = message_textbox.GetLegacyIAccessiblePattern()
+        message_textbox_legacy_pattern.SetValue(event_message)
+        message_textbox.SendKeys('{ENTER}')
+
+        self.wait_for_control(
+            self.app_window.TextControl,
+            {'RegexName': '^Henvisning.*$'},
+            search_depth=2
+        )
+
+        message_button = self.app_window.ButtonControl(Name="OK")
+        message_button.Click(simulateMove=False, waitTime=0)
+
+    def create_journal_note(self, note_message: str, checkmark_in_complete: bool):
+        """
+        Creates a journal note for the given patient.
+
+        Args:
+            note_message (str): The note message.
+            checkmark_in_complete (bool): Checks the checkmark in 'Afslut'.
+        """
+        self.open_tab("Journal")
+
+        self.wait_for_control(
+            auto.DocumentControl,
+            {"AutomationId": "RichTextBoxInput"},
+            search_depth=19
+            )
+
+        input_box = self.app_window.DocumentControl(AutomationId="RichTextBoxInput")
+        input_box_value_pattern = input_box.GetValuePattern()
+        input_box_value_pattern.SetValue(value=note_message, waitTime=0)
+
+        if checkmark_in_complete:
+            checkbox = self.app_window.CheckBoxControl(AutomationId="CheckBoxAssignCompletionStatus")
+            checkbox.SetFocus()
+            checkbox.Click(simulateMove=False, waitTime=0)
+
+        save_button = self.app_window.PaneControl(AutomationId="buttonSave")
+        save_button.SetFocus()
+        save_button.Click(simulateMove=False, waitTime=0)

mbu_dev_shared_components-0.0.52/mbu_dev_shared_components/solteqtand/db_handler.py

@@ -0,0 +1,187 @@
+"""
+This module defines the SolteqTandDatabase class, which provides
+an interface to interact with the Solteq Tand database.
+"""
+import pyodbc
+
+
+class SolteqTandDatabase:
+    """Handles database operations related to the Solteq Tand system."""
+
+    def __init__(self, conn_str: str, ssn: str):
+        """
+        Initializes the SolteqTandDatabase instance.
+
+        Args:
+            conn_str (str): Connection string to the Solteq Tand database.
+            ssn (str): Social Security Number (CPR) for identifying the patient.
+        """
+        self.connection_string = conn_str
+        self.ssn = ssn
+
+    def _execute_query(self, query: str, params: tuple):
+        """
+        Executes a query with the provided parameters and returns the result.
+
+        Args:
+            query (str): SQL query to execute.
+            params (tuple): Parameters to include in the SQL query.
+
+        Returns:
+            list: A list of rows returned by the query, where each row is a dictionary.
+        """
+        conn = pyodbc.connect(self.connection_string)
+        cursor = conn.cursor()
+        cursor.execute(query, params)
+        rows = cursor.fetchall()
+        columns = [column[0] for column in cursor.description]
+        result = [dict(zip(columns, row)) for row in rows]
+        return result
+
+    def check_if_document_exists(self, filename: str):
+        """
+        Checks if a document with the given filename exists for the specified patient.
+
+        Args:
+            filename (str): Name of the file to search for.
+
+        Returns:
+            list: A list of matching document records.
+        """
+        query = """
+            WITH LatestActiveDocuments AS (
+                SELECT
+                    ds.DocumentId,
+                    ds.entityId,
+                    ds.OriginalFilename,
+                    ds.UniqueFilename,
+                    ds.DocumentType,
+                    ds.DocumentDescription,
+                    ds.Priviledged,
+                    ds.ContentType,
+                    dss.Document_HistoryId,
+                    dss.DocumentStoreStatusId,
+                    dss.SentToNemSMS,
+                    dss.Documented AS [DocumentCreatedDate],
+                    dss.Decided AS [DocumentLastEditedDate],
+                    ROW_NUMBER() OVER (
+                        PARTITION BY ds.DocumentId
+                        ORDER BY dss.Document_HistoryId DESC
+                    ) AS rn
+                FROM [tmtdata_prod].[dbo].[DocumentStore] ds
+                JOIN DocumentStoreStatus dss ON ds.DocumentId = dss.DocumentId
+            )
+            SELECT  ds.DocumentId,
+                    ds.entityId,
+                    ds.OriginalFilename,
+                    ds.UniqueFilename,
+                    ds.DocumentCreatedDate,
+                    ds.DocumentLastEditedDate,
+                    ds.SentToNemSMS,
+                    p.cpr
+            FROM [tmtdata_prod].[dbo].[PATIENT] p
+            JOIN LatestActiveDocuments ds ON ds.entityId = p.patientId
+            WHERE ds.rn = 1
+            AND ds.DocumentStoreStatusId = 1
+            AND p.cpr = ?
+            AND ds.OriginalFilename = ?
+        """
+        return self._execute_query(query, (self.ssn, filename))
+
+    def check_extern_dentist(self):
+        """
+        Checks if the patient is associated with an external dentist.
+        (This method is a placeholder and needs to be implemented based on specific requirements.)
+        """
+        query = """
+            SELECT	[patientId]
+                    ,[cpr]
+                    ,[privateClinicId]
+                    ,[c.contractorId]
+                    ,[c.isPrimary]
+                    ,[c.name]
+                    ,[c.streetAddress]
+                    ,[c.zip]
+                    ,[c.phoneNumber]
+            FROM	[tmtdata_prod].[dbo].[PATIENT] p
+            JOIN	[CLINIC] c on c.clinicId = p.privateClinicId
+            WHERE	cpr = ?
+        """
+        return self._execute_query(query, (self.ssn))
+
+    def check_if_booking_exists(self):
+        """
+        Checks if any booking exists for the specified patient.
+
+        Returns:
+            list: A list of booking records for the patient.
+        """
+        query = """
+            SELECT  b.StartTime,
+                    b.EndTime,
+                    b.PatientNotified,
+                    b.PatientNotifiedVia,
+                    b.BookingText,
+                    b.Warnings,
+                    b.CreatedDateTime,
+                    b.LastModifiedDateTime,
+                    bt.Description,
+                    bt.PrinterFriendlyText
+            FROM [tmtdata_prod].[dbo].[BOOKING] b
+            JOIN PATIENT p on p.patientId = b.patientId
+            JOIN BOOKINGTYPE bt on bt.BookingTypeID = b.BookingTypeID
+            WHERE p.cpr = ?
+        """
+        return self._execute_query(query, (self.ssn))
+
+    def check_if_event_exists(self, event_name: str, event_message: str):
+        """
+        Checks if a specific event exists for the patient based on the event name and message.
+
+        Args:
+            event_name (str): The name of the event (clinic name).
+            event_message (str): The event message or state.
+
+        Returns:
+            list: A list of matching event records for the patient.
+        """
+        query = """
+            SELECT  e.[eventId],
+                    e.[type],
+                    e.[currentStateText],
+                    e.[currentStateDate],
+                    e.[timestamp],
+                    e.[clinicId],
+                    c.name,
+                    e.[entityId],
+                    e.[eventTriggerDate],
+                    p.cpr
+            FROM [EVENT] e
+            JOIN [PATIENT] p ON p.patientId = e.entityId
+            JOIN [CLINIC] c ON c.clinicId = e.clinicId
+            WHERE p.cpr = ?
+            AND c.name = ?
+            AND e.currentStateText = ?
+        """
+        return self._execute_query(query, (self.ssn, event_name, event_message))
+
+    def get_primary_dental_clinic(self):
+        """
+        Fetches the primary dental clinic details for the specified patient.
+
+        Returns:
+            dict: A dictionary containing patient and clinic details.
+        """
+        query = """
+            SELECT  p.cpr,
+                    p.patientId,
+                    p.firstName,
+                    p.lastName,
+                    p.preferredDentalClinicId,
+                    p.isPreferredDentalClinicLocked,
+                    c.name AS preferredDentalClinicName
+            FROM [tmtdata_prod].[dbo].[PATIENT] p
+            JOIN [CLINIC] c ON c.clinicId = p.preferredDentalClinicId
+            WHERE p.cpr = ?
+        """
+        return self._execute_query(query, (self.ssn))

mbu_dev_shared_components-0.0.52/mbu_dev_shared_components/utils/file_handler.py

@@ -0,0 +1,33 @@
+"""Module that inculdes helper functions for file handling."""
+import os
+
+
+def rename_file(current_path, new_name):
+    """
+    Renames a file from the given current path to a new name.
+
+    Parameters:
+    current_path (str): The full path of the file that you want to rename.
+    new_name (str): The new name for the file (without the directory path).
+
+    Returns:
+    None
+    """
+    if not os.path.isfile(current_path):
+        print(f"The file '{current_path}' does not exist.")
+        return
+
+    directory = os.path.dirname(current_path)
+
+    new_path = os.path.join(directory, new_name)
+
+    try:
+        os.rename(current_path, new_path)
+        print(f"File renamed to '{new_name}' successfully.")
+
+    except FileNotFoundError:
+        print(f"Error: The file '{current_path}' does not exist.")
+    except PermissionError:
+        print(f"Error: You do not have permission to rename '{current_path}'.")
+    except OSError as e:
+        print(f"OS error occurred: {e}")

{mbu_dev_shared_components-0.0.51.post3 → mbu_dev_shared_components-0.0.52}/mbu_dev_shared_components.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mbu_dev_shared_components
-Version: 0.0.51.post3
+Version: 0.0.52
 Summary: Shared components to use in RPA projects
 Author-email: MBU <rpa@mbu.aarhus.dk>
 Classifier: Programming Language :: Python :: 3
@@ -15,6 +15,7 @@ Requires-Dist: requests_ntlm>=1.2.0
 Requires-Dist: python-dateutil==2.9.*
 Requires-Dist: cryptography>=43.0.0
 Requires-Dist: office365-rest-python-client
+Requires-Dist: uiautomation
 
 # mbu-dev-shared-components
 

{mbu_dev_shared_components-0.0.51.post3 → mbu_dev_shared_components-0.0.52}/mbu_dev_shared_components.egg-info/SOURCES.txt

@@ -30,7 +30,11 @@ mbu_dev_shared_components/os2forms/documents.py
 mbu_dev_shared_components/os2forms/forms.py
 mbu_dev_shared_components/sap/__init__.py
 mbu_dev_shared_components/sap/create_invoice.py
+mbu_dev_shared_components/solteqtand/__init__.py
+mbu_dev_shared_components/solteqtand/app_handler.py
+mbu_dev_shared_components/solteqtand/db_handler.py
 mbu_dev_shared_components/utils/__init__.py
 mbu_dev_shared_components/utils/db_stored_procedure_executor.py
 mbu_dev_shared_components/utils/fernet_encryptor.py
+mbu_dev_shared_components/utils/file_handler.py
 mbu_dev_shared_components/utils/json_handler.py

{mbu_dev_shared_components-0.0.51.post3 → mbu_dev_shared_components-0.0.52}/mbu_dev_shared_components.egg-info/requires.txt

@@ -4,3 +4,4 @@ requests_ntlm>=1.2.0
 python-dateutil==2.9.*
 cryptography>=43.0.0
 office365-rest-python-client
+uiautomation

{mbu_dev_shared_components-0.0.51.post3 → mbu_dev_shared_components-0.0.52}/pyproject.toml

@@ -23,6 +23,7 @@ dependencies = [
   "python-dateutil == 2.9.*",
   "cryptography >= 43.0.0",
   "office365-rest-python-client",
+  "uiautomation",
 ]
 
 [tool.setuptools_scm]