wip & added some methods and locators to subject_screening_summary_page

Author: Andyg79

pages/screening_subject_search/subject_screening_summary_page.py

@@ -1,3 +1,4 @@
+import re
 from playwright.sync_api import Page, expect, Locator
 from pages.base_page import BasePage
 from enum import Enum
@@ -32,7 +33,9 @@ def __init__(self, page: Page):
         self.individual_letters = self.page.get_by_role(
             "link", name="Individual Letters"
         )
-        self.retrieve_data_link = self.page.get_by_role("link", name="Retrieve Data from Spine")
+        self.retrieve_data_link = self.page.get_by_role(
+            "link", name="Retrieve Data from Spine"
+        )
         self.patient_contacts = self.page.get_by_role("link", name="Patient Contacts")
         self.more = self.page.get_by_role("link", name="more")
         self.change_screening_status = self.page.get_by_label("Change Screening Status")
@@ -69,6 +72,16 @@ def __init__(self, page: Page):
         self.book_practitioner_clinic_button = self.page.get_by_role(
             "button", name="Book Practitioner Clinic"
         )
+        self.subject_age_cell = self.page.locator(
+            "table#subjectSummaryTable tr:nth-of-type(1) td:nth-of-type(2)"
+        )
+
+        self.screening_status_cell = self.page.locator(
+            "td.epihdr_label:text('Screening Status') + td.epihdr_data"
+        )
+        self.latest_event_status_cell = self.page.locator(
+            "table#subjectSummaryTable tr:has(td:text('Latest Event Status')) td.epihdr_data"
+        ).nth(0)
 
     def wait_for_page_title(self) -> None:
         """Waits for the page to be the Subject Screening Summary"""
@@ -322,6 +335,58 @@ def navigate_to_spine_search(self) -> None:
         self.click(self.retrieve_data_link)
         self.page.goto(self.spine_url)
 
+    def assert_subject_age(self, expected_age: int) -> None:
+        """
+        Asserts that the subject's age displayed in the demographics cell matches the expected value.
+
+        Args:
+            expected_age (int): The age to verify against the UI.
+
+        Raises:
+            AssertionError: If the age in the UI does not match the expected value.
+        """
+        age_text = self.subject_age_cell.inner_text().strip()
+        match = re.search(r"\(age\s+(\d+)\)", age_text)
+        if not match:
+            raise AssertionError(
+                f"[AGE PARSE ERROR] Could not find age in text: '{age_text}'"
+            )
+
+        actual_age = int(match.group(1))
+        assert (
+            actual_age == expected_age
+        ), f"[AGE MISMATCH] Expected age {expected_age}, but found {actual_age} in UI."
+
+    def assert_screening_status(self, expected_status: str) -> None:
+        """
+        Asserts that the screening status displayed in the summary matches the expected value.
+
+        Args:
+            expected_status (str): The expected screening status (e.g., 'Inactive').
+
+        Raises:
+            AssertionError: If the status in the UI does not match the expected value.
+        """
+        actual_status = self.screening_status_cell.inner_text().strip()
+        assert (
+            actual_status.lower() == expected_status.lower()
+        ), f"[SCREENING STATUS MISMATCH] Expected '{expected_status}', but found '{actual_status}' in UI."
+
+    def assert_latest_event_status(self, expected_status: str) -> None:
+        """
+        Asserts that the latest event status displayed in the summary table matches the expected value.
+
+        Args:
+            expected_status (str): The expected event status (e.g., 'S9 Pre-invitation Sent').
+
+        Raises:
+            AssertionError: If the status in the UI does not match the expected value.
+        """
+        actual_status = self.latest_event_status_cell.inner_text().strip()
+        assert actual_status == expected_status, (
+            f"[LATEST EVENT STATUS MISMATCH] Expected '{expected_status}', but found '{actual_status}' in UI."
+        )
+
 class ChangeScreeningStatusOptions(Enum):
     """Enum for Change Screening Status options."""
 

tests/regression/regression_tests/fobt_regression_tests/test_scenario_2.py

@@ -5,7 +5,13 @@
 from utils.oracle.subject_creation_util import CreateSubjectSteps
 from utils.user_tools import UserTools
 from utils.subject_assertion import subject_assertion
+from utils.call_and_recall_utils import CallAndRecallUtils
+from utils import screening_subject_page_searcher
 from pages.base_page import BasePage
+from pages.screening_subject_search.subject_screening_summary_page import (
+    SubjectScreeningSummaryPage,
+)
+
 
 @pytest.mark.wip
 @pytest.mark.fobt_regression_tests
@@ -31,6 +37,7 @@ def test_scenario_2(page: Page) -> None:
     > Process S158 letter batch > S159 (1.3) > C203 (1.13)
     > Check recall [SSCL4a]
     """
+    summary_page = SubjectScreeningSummaryPage(page)
     logging.info("[TEST START] Regression - fobt normal kit reading")
 
     # Given I log in to BCSS "England" as user role "Hub Manager"
@@ -53,7 +60,7 @@ def test_scenario_2(page: Page) -> None:
         pytest.fail("Failed to create subject: NHS number not returned.")
 
     # Then Comment: NHS number
-    logging.info(f"Created subject's NHS number: {nhs_no}")
+    logging.info(f"[SUBJECT CREATED] Created subject's NHS number: {nhs_no}")
 
     # And my subject has been updated as follows:
     # Subject age         	66
@@ -67,10 +74,20 @@ def test_scenario_2(page: Page) -> None:
             "screening status": "Inactive",
         },
     )
-    logging.info("Updated subject details checked in the DB")
+    logging.info("[DB ASSERTIONS COMPLETE]Updated subject details checked in the DB")
+
+    # Navigate to subject profile in UI
+    screening_subject_page_searcher.search_subject_by_nhs_number(page, nhs_no)
+    logging.info("[SUBJECT VIEW] Subject loaded in UI")
 
+    # Assert subject details in the UI
+    summary_page.assert_subject_age(66)
+    summary_page.assert_screening_status("Inactive")
+    logging.info("[UI ASSERTIONS COMPLETE]Updated subject details checked in the UI")
 
     # When I run the FOBT failsafe trawl for my subject
+    CallAndRecallUtils().run_failsafe(nhs_no)
+    logging.info("[FAILSAFE TRAWL RUN]FOBT failsafe trawl run for subject")
 
     # Then my subject has been updated as follows:
     # Subject has episodes             	No
@@ -94,6 +111,15 @@ def test_scenario_2(page: Page) -> None:
             "Screening Status Reason": "Failsafe Trawl",
         },
     )
+    logging.info("[DB ASSERTIONS COMPLETE]Updated subject details checked in the DB")
+
+    # Navigate to subject profile in UI
+    screening_subject_page_searcher.search_subject_by_nhs_number(page, nhs_no)
+    logging.info("[SUBJECT VIEW] Subject loaded in UI")
+
+    # Assert subject details in the UI
+    summary_page.assert_screening_status("Call")
+    logging.info("[UI ASSERTIONS COMPLETE]Updated subject details checked in the UI")
 
     # When I invite my subject for FOBT screening
 
@@ -110,6 +136,9 @@ def test_scenario_2(page: Page) -> None:
         },
     )
     # Then there is a "S1" letter batch for my subject with the exact title "Pre-invitation (FIT)"
+    logging.info(
+        "[DB ASSERTIONS COMPLETE]Updated subject details checked in the DB & letter batch exists"
+    )
 
     # When I process the open "S1" letter batch for my subject
 
@@ -121,6 +150,15 @@ def test_scenario_2(page: Page) -> None:
             "latest event status": "S9 Pre-invitation Sent",
         },
     )
+    logging.info("[ASSERTIONS COMPLETE]Updated subject status checked in the DB")
+
+    # Navigate to subject profile in UI
+    screening_subject_page_searcher.search_subject_by_nhs_number(page, nhs_no)
+    logging.info("[SUBJECT VIEW] Subject loaded in UI")
+
+    # Assert subject details in the UI
+    summary_page.assert_latest_event_status("S9 Pre-invitation Sent")
+    logging.info("[UI ASSERTIONS COMPLETE]Updated subject details checked in the UI")
 
     # When I run Timed Events for my subject
     # Then there is a "S9" letter batch for my subject with the exact title "Invitation & Test Kit (FIT)"
@@ -145,6 +183,15 @@ def test_scenario_2(page: Page) -> None:
             "latest event status": "S43 Kit Returned and Logged (Initial Test)",
         },
     )
+    # Navigate to subject profile in UI
+    screening_subject_page_searcher.search_subject_by_nhs_number(page, nhs_no)
+    logging.info("[SUBJECT VIEW] Subject loaded in UI")
+
+    # Assert subject details in the UI
+    summary_page.assert_latest_event_status(
+        "S43 Kit Returned and Logged (Initial Test)"
+    )
+    logging.info("[UI ASSERTIONS COMPLETE]Updated subject details checked in the UI")
 
     # When I read my subject's latest logged FIT kit as "NORMAL"
 
@@ -156,6 +203,15 @@ def test_scenario_2(page: Page) -> None:
             "latest event status": "S2 Normal",
         },
     )
+    logging.info("[DB ASSERTIONS COMPLETE]Updated subject details checked in the DB")
+
+    # Navigate to subject profile in UI
+    screening_subject_page_searcher.search_subject_by_nhs_number(page, nhs_no)
+    logging.info("[SUBJECT VIEW] Subject loaded in UI")
+
+    # Assert subject details in the UI
+    summary_page.assert_latest_event_status("S2 Normal")
+    logging.info("[UI ASSERTIONS COMPLETE]Updated subject details checked in the UI")
     # And there is a "S2" letter batch for my subject with the exact title "Subject Result (Normal)"
 
     # When I process the open "S2" letter batch for my subject
@@ -168,6 +224,15 @@ def test_scenario_2(page: Page) -> None:
             "latest event status": "S158 Subject Discharge Sent (Normal)",
         },
     )
+    logging.info("[DB ASSERTIONS COMPLETE]Updated subject details checked in the DB")
+
+    # Navigate to subject profile in UI
+    screening_subject_page_searcher.search_subject_by_nhs_number(page, nhs_no)
+    logging.info("[SUBJECT VIEW] Subject loaded in UI")
+
+    # Assert subject details in the UI
+    summary_page.assert_latest_event_status("S158 Subject Discharge Sent (Normal)")
+    logging.info("[UI ASSERTIONS COMPLETE]Updated subject details checked in the UI")
     # And there is a "S158" letter batch for my subject with the exact title "GP Result (Normal)"
 
     # When I process the open "S158" letter batch for my subject
@@ -231,3 +296,12 @@ def test_scenario_2(page: Page) -> None:
             "surveillance due date reason": "Unchanged",
         },
     )
+    logging.info("[DB ASSERTIONS COMPLETE]Updated subject details checked in the DB")
+
+    # Navigate to subject profile in UI
+    screening_subject_page_searcher.search_subject_by_nhs_number(page, nhs_no)
+    logging.info("[SUBJECT VIEW] Subject loaded in UI")
+
+    # Assert subject details in the UI
+    summary_page.assert_latest_event_status("S159 GP Discharge Sent (Normal)")
+    logging.info("[UI ASSERTIONS COMPLETE]Updated subject details checked in the UI")

utils/call_and_recall_utils.py

@@ -0,0 +1,51 @@
+import logging
+import oracledb
+from utils.oracle.oracle import OracleDB
+
+
+class CallAndRecallUtils:
+    """
+    This contains utility methods to do with Call and Recall
+    """
+
+    def __init__(self):
+        self.oracledb = OracleDB()
+
+    def run_failsafe(self, nhs_no: str) -> None:
+        """
+        Run the failsafe trawl for the given NHS number.
+        Args:
+            nhs_no: The NHS number of the subject
+        """
+        subject_id = int(self.oracledb.get_subject_id_from_nhs_number(nhs_no))
+        conn = self.oracledb.connect_to_db()
+        conn.callTimeout = 30000  # Setting call timeout to 30 seconds
+        cur = conn.cursor()
+
+        pi = cur.var(oracledb.NUMBER)
+        pi.setvalue(0, subject_id)
+
+        out_cursor = cur.var(oracledb.CURSOR)
+
+        cur.execute(
+            """
+            BEGIN
+                pkg_fobt_call.p_failsafe_trawl(
+                    pi_subject_id => :pi,
+                    po_cur_error  => :po
+                );
+            END;""",
+            {"pi": str(subject_id), "po": out_cursor},
+        )
+
+        result_cursor = out_cursor.getvalue()
+        row = result_cursor.fetchone()
+        assert (
+            "The action was performed successfully" in row
+        ), f"Error when executing failsafe for {nhs_no}: {row}"
+
+        # Clean up
+        result_cursor.close()
+        cur.close()
+        conn.close()
+        logging.info(f"END: failsafe stored proc executed for {nhs_no}")