Feature/bcss 20478 c6 pom handover into symptomatic care page (#65)

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

<!-- Describe your changes in detail. -->
Newly created POM for handover into symptomatic care page.

## Context

<!-- Why is this change required? What problem does it solve? -->
Allows the reusablity of locators across tests.

## 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
- [ ] 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.

---------

Co-authored-by: Adriano Aru <[email protected]>

Author: vidhya-chandra1

pages/screening_subject_search/handover_into_symptomatic_care_page.py

@@ -0,0 +1,54 @@
+from playwright.sync_api import Page
+from pages.base_page import BasePage
+from datetime import datetime
+
+class HandoverIntoSymptomaticCarePage(BasePage):
+    """
+    HandoverIntoSymptomaticCarePage class for interacting with the 'Handover Into Symptomatic Care' page elements.
+    """
+    def __init__(self, page: Page):
+        self.page = page
+        self.referral_dropdown = self.page.get_by_label("Referral")
+        self.calendar_button = self.page.get_by_role("button", name="Calendar")
+        self.consultant_link = self.page.locator("#UI_NS_CONSULTANT_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")
+
+    def select_referral_dropdown_option(self, value: str) -> None:
+        """
+        Select a given option from the Referral dropdown.
+
+        Args:
+            value (str): The value of the option you want to select
+        """
+        self.referral_dropdown.select_option(value)
+
+    def click_calendar_button(self) -> None:
+        """Click the calendar button to open the calendar picker."""
+        self.click(self.calendar_button)
+
+    def select_consultant(self, value: str) -> None:
+        """
+        Select a consultant from the consultant dropdown using the given value.
+
+        Args:
+        value (str): The value attribute of the consultant option to select.
+        """
+        self.consultant_link.click()
+        option_locator = self.page.locator(f'[value="{value}"]:visible')
+        option_locator.wait_for(state="visible")
+        self.click(option_locator)
+
+    def fill_notes(self, notes: str) -> None:
+        """
+        Fill the 'Notes' textbox with the provided text.
+
+        Args:
+        notes (str): The text to enter into the notes textbox.
+        """
+        self.notes_textbox.click()
+        self.notes_textbox.fill(notes)
+
+    def click_save_button(self) -> None:
+        """Click the save button to save the changes."""
+        self.safe_accept_dialog(self.save_button)

tests/smokescreen/test_compartment_6.py

@@ -9,6 +9,9 @@
 from utils.batch_processing import batch_processing
 from pages.logout.log_out_page import LogoutPage
 from pages.datasets.subject_datasets_page import SubjectDatasetsPage
+from pages.screening_subject_search.handover_into_symptomatic_care_page import (
+    HandoverIntoSymptomaticCarePage
+)
 from utils.calendar_picker import CalendarPicker
 from datetime import datetime
 from pages.screening_subject_search.record_diagnosis_date_page import (
@@ -247,19 +250,12 @@ def handover_subject_to_symptomatic_care(page: Page) -> None:
     page.get_by_role("button", name="Handover into Symptomatic Care").click()
 
     # The following code is on the handover into symptomatic care page
-    page.get_by_label("Referral").select_option("20445")
-    page.get_by_role("button", name="Calendar").click()
+    HandoverIntoSymptomaticCarePage(page).select_referral_dropdown_option("20445")
+    HandoverIntoSymptomaticCarePage(page).click_calendar_button()
     CalendarPicker(page).v1_calender_picker(datetime.today())
-    page.locator("#UI_NS_CONSULTANT_PIO_SELECT_LINK").click()
-    option_locator = page.locator(
-        '[value="201"]:visible'
-    )  # Here value '201' is referring to Consultant B, Frame
-    option_locator.wait_for(state="visible")
-    option_locator.click()
-    page.get_by_role("textbox", name="Notes").click()
-    page.get_by_role("textbox", name="Notes").fill("Test Automation")
-    page.once("dialog", lambda dialog: dialog.accept())
-    page.get_by_role("button", name="Save").click()
+    HandoverIntoSymptomaticCarePage(page).select_consultant("201")
+    HandoverIntoSymptomaticCarePage(page).fill_notes("Test Automation")
+    HandoverIntoSymptomaticCarePage(page).click_save_button()
 
     SubjectScreeningSummaryPage(page).wait_for_page_title()
     SubjectScreeningSummaryPage(page).verify_latest_event_status_value(
@@ -285,7 +281,7 @@ def test_compartment_6(page: Page, smokescreen_properties: dict) -> None:
 
     # This needs to be repeated for two subjects, one old and one not - High Risk Result
     # Older patient
-    nhs_no = "9109877185"
+    nhs_no = "9577049095"
     go_to_investigation_datasets_page(page, nhs_no)
 
     # The following code is on the investigation datasets page
@@ -300,7 +296,7 @@ def test_compartment_6(page: Page, smokescreen_properties: dict) -> None:
     handover_subject_to_symptomatic_care(page)
 
     # Younger patient
-    nhs_no = "9624131880"
+    nhs_no = "9567180636"
     go_to_investigation_datasets_page(page, nhs_no)
 
     # The following code is on the investigation datasets page
@@ -330,7 +326,7 @@ def test_compartment_6(page: Page, smokescreen_properties: dict) -> None:
 
     # This needs to be repeated for two subjects, one old and one not - LNPCP Result
     # Older patient
-    nhs_no = "9648064792"
+    nhs_no = "9237051190"
     go_to_investigation_datasets_page(page, nhs_no)
 
     # The following code is on the investigation datasets page
@@ -345,7 +341,7 @@ def test_compartment_6(page: Page, smokescreen_properties: dict) -> None:
     handover_subject_to_symptomatic_care(page)
 
     # Younger patient
-    nhs_no = "9627060208"
+    nhs_no = "9564243211"
     go_to_investigation_datasets_page(page, nhs_no)
 
     # The following code is on the investigation datasets page
@@ -373,7 +369,7 @@ def test_compartment_6(page: Page, smokescreen_properties: dict) -> None:
     )
 
     # This needs to be repeated for 1 subject, age does not matter - Normal Result
-    nhs_no_normal = "9965184321"
+    nhs_no_normal = "9648226105"
     go_to_investigation_datasets_page(page, nhs_no_normal)
 
     # The following code is on the investigation datasets page