Feature/bcss 22023 surveillanceregressiontests scenario 10 (#163)

<!-- markdownlint-disable-next-line first-line-heading -->
## Description

<!-- Describe your changes in detail. -->
Migrating scenario 10 from SurveillanceRegressionTests into playwright,
along with any relevant methods.

## Context

<!-- Why is this change required? What problem does it solve? -->
Migrating scenario 10 from SurveillanceRegressionTests into playwright,
along with any relevant methods.

## Type of changes

<!-- What types of changes does your code introduce? Put an `x` in all
the boxes that apply. -->

- [x] Refactoring (non-breaking change)
- [x] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would change existing
functionality)
- [ ] Bug fix (non-breaking change which fixes an issue)

## Checklist

<!-- Go over all the following points, and put an `x` in all the boxes
that apply. -->

- [x] I am familiar with the [contributing
guidelines](https://github.com/nhs-england-tools/playwright-python-blueprint/blob/main/CONTRIBUTING.md)
- [x] I have followed the code style of the project
- [x] I have added tests to cover my changes (where appropriate)
- [x] I have updated the documentation accordingly
- [ ] This PR is a result of pair or mob programming

---

## Sensitive Information Declaration

To ensure the utmost confidentiality and protect your and others
privacy, we kindly ask you to NOT including [PII (Personal Identifiable
Information) / PID (Personal Identifiable
Data)](https://digital.nhs.uk/data-and-information/keeping-data-safe-and-benefitting-the-public)
or any other sensitive data in this PR (Pull Request) and the codebase
changes. We will remove any PR that do contain any sensitive
information. We really appreciate your cooperation in this matter.

- [x] I confirm that neither PII/PID nor sensitive data are included in
this PR and the codebase changes.

Author: adrianoaru-nhs

investigation_dataset_ui_app/dataset_fields.json

@@ -352,7 +352,7 @@
       },
       {
         "key": "polyp appears fully resected endoscopically",
-        "type": "YesNoOptions",
+        "type": "YesNoUncertainOptions",
         "description": "Whether the polyp appears fully resected endoscopically",
         "optional": true
       }

pages/datasets/investigation_dataset_page.py

@@ -93,12 +93,22 @@ def __init__(self, page: Page):
         self.visible_search_text_input = self.page.locator(
             'input[id^="UI_SEARCH_"]:visible'
         )
+        self.diagnostic_test_result = self.page.locator(
+            "#datasetContent > div:nth-child(1) > div:nth-child(7) > span.userInput"
+        )
 
         # Repeat strings:
         self.bowel_preparation_administered_string = "Bowel Preparation Administered"
         self.antibiotics_administered_string = "Antibiotics Administered"
         self.other_drugs_administered_string = "Other Drugs Administered"
 
+        # Other:
+        self.list_of_multi_line_fields = [
+            "failure reasons",
+            "early complications",
+            "late complications",
+        ]
+
     def select_site_lookup_option(self, option: str) -> None:
         """
         This method is designed to select a site from the site lookup options.
@@ -628,7 +638,7 @@ def get_dataset_section(self, dataset_section_name: str) -> Optional[Locator]:
         Args:
             dataset_section_name (str): The name of the dataset section to locate.
         Returns:
-            Optioanl[Locator]: A Playwright Locator for the matching section if visible, or None if not found or not visible.
+            Optional[Locator]: A Playwright Locator for the matching section if visible, or None if not found or not visible.
         """
         logging.info(f"START: Looking for section '{dataset_section_name}'")
 
@@ -1172,6 +1182,17 @@ def get_drug_dosage_text_locator(self, drug_type: str, drug_number: int) -> Loca
             locator_prefix = "#HILITE_spanAntibioticDosageUnit"
         return self.page.locator(f"{locator_prefix}{drug_number}")
 
+    def assert_test_result(self, expected_text: str) -> None:
+        """
+        Asserts that the text in the test result matches the expected text.
+        Args:
+            expected_text (str): The text expected to be found in the element.
+        """
+        actual_text = self.diagnostic_test_result.inner_text().strip()
+        assert (
+            actual_text.lower() == expected_text.lower()
+        ), f"Expected '{expected_text}', but found '{actual_text}'"
+
 
 def normalize_label(text: str) -> str:
     """

pages/screening_subject_search/advance_episode_page.py

@@ -147,6 +147,9 @@ def __init__(self, page: Page):
         self.date_of_symptomatic_procedure_input = self.page.get_by_role(
             "textbox", name="Date of Symptomatic Procedure"
         )
+        self.initiate_close_button = self.page.get_by_role(
+            "button", name="Initiate Close"
+        )
 
         # Contact recording locators
         self.contact_direction_dropdown = self.page.get_by_label("Contact Direction")
@@ -209,6 +212,10 @@ def click_other_post_investigation_button(self) -> None:
         """Click the 'Other Post-investigation' button."""
         self.safe_accept_dialog(self.other_post_investigation_button)
 
+    def click_initiate_close_button(self) -> None:
+        """Click the 'Initiate Close' button."""
+        self.safe_accept_dialog(self.initiate_close_button)
+
     def get_latest_event_status_cell(self, latest_event_status: str) -> Locator:
         """Get the cell containing the latest event status."""
         return self.page.get_by_role("cell", name=latest_event_status, exact=True)

pages/screening_subject_search/diagnostic_test_outcome_page.py

@@ -1,8 +1,7 @@
-import logging
-from click import option
 from playwright.sync_api import Page, expect, Locator
 from pages.base_page import BasePage
 from enum import StrEnum
+from typing import List
 
 
 class ReferralProcedureType(StrEnum):
@@ -69,6 +68,22 @@ def select_test_outcome_option(self, option: str) -> None:
         """
         self.test_outcome_dropdown.select_option(option)
 
+    def test_outcome_dropdown_contains_options(self, options: List[str]) -> None:
+        """
+        Asserts that all provided options are present in the Outcome of Diagnostic Test dropdown.
+
+        Args:
+            options (List[str]): List of option strings to check.
+        """
+        dropdown_options = [
+            opt.inner_text()
+            for opt in self.test_outcome_dropdown.locator("option").all()
+        ]
+        for item in options:
+            assert (
+                item in dropdown_options
+            ), f"Dropdown is missing expected option: '{item}'"
+
     def verify_reason_for_symptomatic_referral(self, symptomatic_reason: str) -> None:
         """
         Verify reason for symptomatic referral is visible.

pages/screening_subject_search/handover_into_symptomatic_care_page.py

@@ -15,13 +15,18 @@ def __init__(self, page: Page):
         self.calendar_button = self.page.get_by_role("button", name="Calendar")
         self.consultant_link = self.page.locator("#UI_NS_CONSULTANT_PIO_SELECT_LINK")
         self.practitioner_dropdown = self.page.locator("#UI_SCREENING_PRACTITIONER")
+        self.non_screening_practitioner_link = self.page.locator(
+            "#UI_NS_PRACTITIONER_PIO_SELECT_LINK"
+        )
         self.notes_textbox = self.page.get_by_role("textbox", name="Notes")
         self.save_button = self.page.get_by_role("button", name="Save")
         self.cease_from_program_dropdown = self.page.locator(
             "#UI_CEASE_FROM_PROGRAM_ID"
         )
         self.mdt_date_field = self.page.locator("#UI_MDT_DATE")
         self.site_dropdown = self.page.locator("#UI_NS_SITE_SELECT_LINK")
+        self.date_responsibility_accepted_field = self.page.locator("#UI_OTHER_DATE")
+        self.select_locator = self.page.locator('select[id^="UI_RESULTS_"]:visible')
 
     def select_referral_dropdown_option(self, value: str) -> None:
         """
@@ -34,12 +39,26 @@ def select_referral_dropdown_option(self, value: str) -> None:
 
     def select_practitioner_from_index(self, practitioner_index: int) -> None:
         """
-        Select the first option from the Practitioner dropdown.
+        Select the an option from the Practitioner dropdown via index.
         Args:
             practitioner_index (int): The index of the practitioner to select.
         """
         self.practitioner_dropdown.select_option(index=practitioner_index)
 
+    def select_non_screening_practitioner_link(self, practitioner_index: int) -> None:
+        """
+        Select the a non screening practitioner from the non screening practitioner dropdown.
+        Args:
+            practitioner_index (int): The index of the non screening practitioner to select.
+        """
+        self.non_screening_practitioner_link.click()
+        self.select_locator.first.wait_for(state="visible")
+
+        # Find all option elements inside the select and click the one at the given index
+        option_elements = self.select_locator.first.locator("option")
+        option_elements.nth(practitioner_index).wait_for(state="visible")
+        self.click(option_elements.nth(practitioner_index))
+
     def click_calendar_button(self) -> None:
         """Click the calendar button to open the calendar picker."""
         self.click(self.calendar_button)
@@ -56,6 +75,20 @@ def select_consultant(self, value: str) -> None:
         option_locator.wait_for(state="visible")
         self.click(option_locator)
 
+    def select_consultant_from_index(self, consultant_index: int) -> None:
+        """
+        Select the a consultant from the consultant dropdown.
+        Args:
+            consultant_index (int): The index of the consultant to select.
+        """
+        self.click(self.consultant_link)
+        self.select_locator.first.wait_for(state="visible")
+
+        # Find all option elements inside the select and click the one at the given index
+        option_elements = self.select_locator.first.locator("option")
+        option_elements.nth(consultant_index).wait_for(state="visible")
+        self.click(option_elements.nth(consultant_index))
+
     def fill_notes(self, notes: str) -> None:
         """
         Fill the 'Notes' textbox with the provided text.
@@ -88,6 +121,16 @@ def enter_mdt_date(self, date: datetime) -> None:
         """
         CalendarPicker(self.page).calendar_picker_ddmmyyyy(date, self.mdt_date_field)
 
+    def enter_date_responsibility_accepted_field(self, date: datetime) -> None:
+        """
+        Enters a date into the 'Date Responsibility Accepted' field
+        Args:
+            date (datetime): The date to enter.
+        """
+        CalendarPicker(self.page).calendar_picker_ddmmyyyy(
+            date, self.date_responsibility_accepted_field
+        )
+
     def select_site_dropdown_option_index(self, index: int) -> None:
         """
         Select a given option from the site dropdown.
@@ -96,11 +139,10 @@ def select_site_dropdown_option_index(self, index: int) -> None:
             value (str): The value of the option you want to select
         """
         self.click(self.site_dropdown)
-        select_locator = self.page.locator('select[id^="UI_RESULTS_"]:visible')
-        select_locator.first.wait_for(state="visible")
+        self.select_locator.first.wait_for(state="visible")
 
         # Find all option elements inside the select and click the one at the given index
-        option_elements = select_locator.first.locator("option")
+        option_elements = self.select_locator.first.locator("option")
         option_elements.nth(index).wait_for(state="visible")
         self.click(option_elements.nth(index))
 
@@ -118,3 +160,20 @@ def fill_with_cancer_details(self) -> None:
         self.fill_notes("Handover notes for Cancer scenario")
         self.click_save_button()
         self.page.wait_for_timeout(500)  # Timeout to allow subject to update in the DB.
+
+    def perform_referral_to_specific_clinician_scenario(self) -> None:
+        """
+        Complete the Handover into Symptomatic Care form with the Referral to Specific Clinician scenario:
+            Referral: Referral to Specific Clinician
+            Date Responsibility Accepted: Today
+            Non Screening Consultant: Last option
+            Non Screening Practitioner: Last option
+            Note: Handover notes - referral to Specific Clinician
+        """
+        self.select_referral_dropdown_option("Referral to Specific Clinician")
+        self.enter_date_responsibility_accepted_field(datetime.today())
+        self.select_consultant_from_index(-1)
+        self.select_non_screening_practitioner_link(-1)
+        self.fill_notes("Handover notes - referral to Specific Clinician")
+        self.click_save_button()
+        self.page.wait_for_timeout(500)  # Timeout to allow subject to update in the DB.