Added POM for appointment calendar page (#38)

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

<!-- Describe your changes in detail. -->
Added a new POM for the appointment calendar page and removed hard coded
locators in compartment 5

## Context

<!-- Why is this change required? What problem does it solve? -->
Allows for reuse of the POM across multiple tests and removed hard coded
locators in these 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)
- [ ] 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

pages/screening_practitioner_appointments/appointment_calendar_page.py

@@ -0,0 +1,27 @@
+from playwright.sync_api import Page, expect
+from pages.base_page import BasePage
+
+
+class AppointmentCalendar(BasePage):
+    def __init__(self, page: Page):
+        super().__init__(page)
+        self.page = page
+        # Appointment Calendar - page filters
+        self.appointment_type_drowdown = self.page.locator("#UI_APPOINTMENT_TYPE")
+        self.screening_centre_dropdown = self.page.locator("#UI_SCREENING_CENTRE")
+        self.site_dropdown = self.page.locator("#UI_SITE")
+        self.view_appointments_on_this_day_button = self.page.get_by_role(
+            "button", name="View appointments on this day"
+        )
+
+    def select_appointment_type_dropdown(self, type: str) -> None:
+        self.appointment_type_drowdown.select_option(label=type)
+
+    def select_screening_centre_dropdown(self, screening_centre: str) -> None:
+        self.screening_centre_dropdown.select_option(label=screening_centre)
+
+    def select_site_dropdown(self, site: str) -> None:
+        self.site_dropdown.select_option(label=site)
+
+    def click_view_appointments_on_this_day_button(self) -> None:
+        self.click(self.view_appointments_on_this_day_button)

tests/smokescreen/bcss_smokescreen_tests.properties

@@ -32,6 +32,13 @@
     c4_eng_site_name2=The Royal Hospital (Wolverhampton)
     c4_eng_practitioner_name=Astonish, Ethanol
 
+# ----------------------------------
+#   compartment 5
+# ----------------------------------
+    c5_eng_appointment_type=Colonoscopy Assessment
+    c5_eng_screening_centre=BCS001 - Wolverhampton Bowel Cancer Screening Centre
+    c5_eng_site=(all)
+
 # ----------------------------------
 #   compartment 6
 # ----------------------------------
@@ -78,7 +85,7 @@
 # ----------------------------------
 #   compartment 5
 # ----------------------------------
-#    c5_eng_number_of_screening_appts_to_attend=6
+#    c5_eng_number_of_screening_appts_to_attend=5
 
 # ----------------------------------
 #   compartment 6

tests/smokescreen/test_compartment_5.py

@@ -17,6 +17,9 @@
 from pages.screening_practitioner_appointments.appointment_detail_page import (
     AppointmentDetail,
 )
+from pages.screening_practitioner_appointments.appointment_calendar_page import (
+    AppointmentCalendar,
+)
 from utils.user_tools import UserTools
 from utils.load_properties_file import PropertiesFile
 from utils.screening_subject_page_searcher import verify_subject_event_status_by_nhs_no
@@ -53,13 +56,17 @@ def test_compartment_5(page: Page, smokescreen_properties: dict) -> None:
     ScreeningPractitionerAppointmentsPage(page).go_to_view_appointments_page()
 
     # Select the Appointment Type, Site, Screening Practitioner and required date of the appointment and click 'View appointments on this day' button
-    page.locator("#UI_APPOINTMENT_TYPE").select_option(label="Colonoscopy Assessment")
-    page.locator("#UI_SCREENING_CENTRE").select_option(
-        label="BCS001 - Wolverhampton Bowel Cancer Screening Centre"
+    AppointmentCalendar(page).select_appointment_type_dropdown(
+        smokescreen_properties["c5_eng_appointment_type"]
+    )
+    AppointmentCalendar(page).select_screening_centre_dropdown(
+        smokescreen_properties["c5_eng_screening_centre"]
+    )
+    AppointmentCalendar(page).select_site_dropdown(
+        smokescreen_properties["c5_eng_site"]
     )
-    page.locator("#UI_SITE").select_option(label="The Royal Hospital (Wolverhampton)")
 
-    page.get_by_role("button", name="View appointments on this day").click()
+    AppointmentCalendar(page).click_view_appointments_on_this_day_button()
     ScreeningPractitionerDayView(page).click_calendar_button()
     date_from_util = datetime(2025, 4, 29)
     CalendarPicker(page).v1_calender_picker(date_from_util)