HDPI-6517: Caseworker - cancel a hearing

[scottstewart-sl]

Jira link

See HDPI-6517

Change description

Adds an option for a caseworker to cancel the next upcoming hearing.

Testing done

Manual testing locally and in preview. Unit tests updated.

Security Vulnerability Assessment

CVE Suppression: Are there any CVEs present in the codebase (either newly introduced or pre-existing) that are being intentionally suppressed or ignored by this commit?

• Yes
• No

Checklist

• commit messages are meaningful and follow good commit message guidelines
• README and other documentation has been updated / added (if needed)
• tests have been updated / new tests has been added (if needed)
• Does this PR introduce a breaking change

[github-actions]

DB breaking change scan

Recommended reading: HMCTS zero-downtime database deployments

No potentially breaking database changes were detected in the changed Flyway migration .sql files.

This check only scans changed .sql files under src/main/resources/db/migration and flags high-risk DDL patterns. It does not replace a full migration review.

Run details: https://github.com/hmcts/pcs-api/actions/runs/29590075203?check_suite_focus=true

[github-actions]

CCD diff summary

👉 Full report: https://github.com/hmcts/pcs-api/actions/runs/29590075199?check_suite_focus=true

CaseField.json

RegularExpression	Max	Searchable	Min	FieldTypeParameter	HintText	Label	ID	FieldType
+	+	+	+	+	+	+${hearingLocation}	+-hearingLocationbody	+Label
+	+	+	+	+	+	+<p class="govuk-body govuk-!-font-weight-bold">Hearing location:</p>	+addHearing-hearingLocationHeading	+Label
+	+	+	+	+	+	+---	+addHearing-separator	+Label
+	+	+	+	+	+	+---	+cancelHearing-separator	+Label
+	+	+N	+	+	+	+	+hearingLocation	+Text
+	+	+	+	+	+	+ <span class="form-label ng-star-inserted">How long will the hearing be?</span> <span class="form-hint ng-star-inserted">Enter duration</span>	+hearing_AddHearing-hearingDurationLabel	+Label
+	+	+	+	+	+This information will be displayed on the hearing notice	+Enter any additional information	+hearing_AdditionalInformation	+TextArea
+	+	+	+	+	+	+${hearing_HearingSummaryMarkdown}	+hearing_CancelHearing-hearingSummary	+Label
+	+	+	+	+	+This will be included in the notice sent to parties, if one is required	+Enter reason for cancellation	+hearing_CancellationReason	+TextArea
+	+	+	+	+	+Enter date and time	+When is the hearing?	+hearing_Date	+DateTime
+	+23	+	+	+	+	+Hour	+hearing_DurationHours	+Number
+	+59	+	+	+	+	+Minute	+hearing_DurationMinutes	+Number
+	+	+	+	+	+	+	+hearing_HearingId	+Number
+	+	+	+	+	+	+	+hearing_HearingSummaryMarkdown	+Text
+	+	+	+	+VerticalYesNo	+	+Is the hearing without notice?	+hearing_IsWithoutNotice	+FixedRadioList
+	+	+	+	+VerticalYesNo	+	+Does a hearing notice need to be issued?	+hearing_IssueNotice	+FixedRadioList
+	+	+	+	+	+	+Hearing notes	+hearing_Notes	+TextArea
+	+	+	+	+HearingNoticeWording	+	+Wording for hearing notice	+hearing_NoticeWording	+FixedList
+	+100	+	+	+	+	+Enter the type of hearing this is	+hearing_OtherHearingType	+Text
+	+	+	+	+HearingType	+	+Which type of hearing is this?	+hearing_Type	+FixedRadioList
+	+	+N	+	+ManageHearingOption	+	+Do you want to add, edit or cancel a hearing?	+manageHearingOption	+FixedRadioList
+	+	+	+	+	+	+---	+manageHearingSeparator	+Label
+	+	+N	+	+	+	+	+partyMultiSelectionList	+DynamicMultiSelectList
+	+	+	+	+	+	+PLACEHOLDER PAGE	+placeholderEditHearing	+Label
+	+	+N	+	+VerticalYesNo	+	+	+showManageHearingPage	+FixedRadioList

AuthorisationCaseEvent/AuthorisationCaseEvent.json

UserRole	CaseEventID	CRUD
+circuit-judge	+manageHearing	+R
+ctsc	+manageHearing	+R
+ctsc-team-leader	+manageHearing	+R
+fee-paid-judge	+manageHearing	+R
+hearing-centre-admin	+manageHearing	+CRUD
+judge	+manageHearing	+R
+leadership-judge	+manageHearing	+R
+wlu-admin	+manageHearing	+R
+wlu-team-leader	+manageHearing	+R

AuthorisationCaseField/wlu-team-leader.json

UserRole	CaseFieldID	CRUD
+wlu-team-leader	+-hearingLocationbody	+CR
+wlu-team-leader	+addHearing-hearingLocationHeading	+CR
+wlu-team-leader	+addHearing-separator	+CR
+wlu-team-leader	+cancelHearing-separator	+CR
+wlu-team-leader	+hearingLocation	+R
+wlu-team-leader	+hearing_AddHearing-hearingDurationLabel	+CR
+wlu-team-leader	+hearing_AdditionalInformation	+R
+wlu-team-leader	+hearing_CancelHearing-hearingSummary	+CR
+wlu-team-leader	+hearing_CancellationReason	+R
+wlu-team-leader	+hearing_Date	+R
+wlu-team-leader	+hearing_DurationHours	+R
+wlu-team-leader	+hearing_DurationMinutes	+R
+wlu-team-leader	+hearing_HearingId	+R
+wlu-team-leader	+hearing_HearingSummaryMarkdown	+R
+wlu-team-leader	+hearing_IsWithoutNotice	+R
+wlu-team-leader	+hearing_IssueNotice	+R
+wlu-team-leader	+hearing_Notes	+R
+wlu-team-leader	+hearing_NoticeWording	+R
+wlu-team-leader	+hearing_OtherHearingType	+R
+wlu-team-leader	+hearing_Type	+R
+wlu-team-leader	+manageHearingOption	+R
+wlu-team-leader	+manageHearingSeparator	+CR
+wlu-team-leader	+partyMultiSelectionList	+R
+wlu-team-leader	+placeholderEditHearing	+CR
+wlu-team-leader	+showManageHearingPage	+R

AuthorisationCaseField/wlu-admin.json

UserRole	CaseFieldID	CRUD
+wlu-admin	+-hearingLocationbody	+CR
+wlu-admin	+addHearing-hearingLocationHeading	+CR
+wlu-admin	+addHearing-separator	+CR
+wlu-admin	+cancelHearing-separator	+CR
+wlu-admin	+hearingLocation	+R
+wlu-admin	+hearing_AddHearing-hearingDurationLabel	+CR
+wlu-admin	+hearing_AdditionalInformation	+R
+wlu-admin	+hearing_CancelHearing-hearingSummary	+CR
+wlu-admin	+hearing_CancellationReason	+R
+wlu-admin	+hearing_Date	+R
+wlu-admin	+hearing_DurationHours	+R
+wlu-admin	+hearing_DurationMinutes	+R
+wlu-admin	+hearing_HearingId	+R
+wlu-admin	+hearing_HearingSummaryMarkdown	+R
+wlu-admin	+hearing_IsWithoutNotice	+R
+wlu-admin	+hearing_IssueNotice	+R
+wlu-admin	+hearing_Notes	+R
+wlu-admin	+hearing_NoticeWording	+R
+wlu-admin	+hearing_OtherHearingType	+R
+wlu-admin	+hearing_Type	+R
+wlu-admin	+manageHearingOption	+R
+wlu-admin	+manageHearingSeparator	+CR
+wlu-admin	+partyMultiSelectionList	+R
+wlu-admin	+placeholderEditHearing	+CR
+wlu-admin	+showManageHearingPage	+R

AuthorisationCaseField/leadership-judge.json

UserRole	CaseFieldID	CRUD
+leadership-judge	+-hearingLocationbody	+CR
+leadership-judge	+addHearing-hearingLocationHeading	+CR
+leadership-judge	+addHearing-separator	+CR
+leadership-judge	+cancelHearing-separator	+CR
+leadership-judge	+hearingLocation	+R
+leadership-judge	+hearing_AddHearing-hearingDurationLabel	+CR
+leadership-judge	+hearing_AdditionalInformation	+R
+leadership-judge	+hearing_CancelHearing-hearingSummary	+CR
+leadership-judge	+hearing_CancellationReason	+R
+leadership-judge	+hearing_Date	+R
+leadership-judge	+hearing_DurationHours	+R
+leadership-judge	+hearing_DurationMinutes	+R
+leadership-judge	+hearing_HearingId	+R
+leadership-judge	+hearing_HearingSummaryMarkdown	+R
+leadership-judge	+hearing_IsWithoutNotice	+R
+leadership-judge	+hearing_IssueNotice	+R
+leadership-judge	+hearing_Notes	+R
+leadership-judge	+hearing_NoticeWording	+R
+leadership-judge	+hearing_OtherHearingType	+R
+leadership-judge	+hearing_Type	+R
+leadership-judge	+manageHearingOption	+R
+leadership-judge	+manageHearingSeparator	+CR
+leadership-judge	+partyMultiSelectionList	+R
+leadership-judge	+placeholderEditHearing	+CR
+leadership-judge	+showManageHearingPage	+R

AuthorisationCaseField/judge.json

UserRole	CaseFieldID	CRUD
+judge	+-hearingLocationbody	+CR
+judge	+addHearing-hearingLocationHeading	+CR
+judge	+addHearing-separator	+CR
+judge	+cancelHearing-separator	+CR
+judge	+hearingLocation	+R
+judge	+hearing_AddHearing-hearingDurationLabel	+CR
+judge	+hearing_AdditionalInformation	+R
+judge	+hearing_CancelHearing-hearingSummary	+CR
+judge	+hearing_CancellationReason	+R
+judge	+hearing_Date	+R
+judge	+hearing_DurationHours	+R
+judge	+hearing_DurationMinutes	+R
+judge	+hearing_HearingId	+R
+judge	+hearing_HearingSummaryMarkdown	+R
+judge	+hearing_IsWithoutNotice	+R
+judge	+hearing_IssueNotice	+R
+judge	+hearing_Notes	+R
+judge	+hearing_NoticeWording	+R
+judge	+hearing_OtherHearingType	+R
+judge	+hearing_Type	+R
+judge	+manageHearingOption	+R
+judge	+manageHearingSeparator	+CR
+judge	+partyMultiSelectionList	+R
+judge	+placeholderEditHearing	+CR
+judge	+showManageHearingPage	+R

AuthorisationCaseField/hearing-centre-admin.json

UserRole	CaseFieldID	CRUD
+hearing-centre-admin	+-hearingLocationbody	+CR
+hearing-centre-admin	+addHearing-hearingLocationHeading	+CR
+hearing-centre-admin	+addHearing-separator	+CR
+hearing-centre-admin	+cancelHearing-separator	+CR
+hearing-centre-admin	+hearingLocation	+CRUD
+hearing-centre-admin	+hearing_AddHearing-hearingDurationLabel	+CR
+hearing-centre-admin	+hearing_AdditionalInformation	+CRUD
+hearing-centre-admin	+hearing_CancelHearing-hearingSummary	+CR
+hearing-centre-admin	+hearing_CancellationReason	+CRUD
+hearing-centre-admin	+hearing_Date	+CRUD
+hearing-centre-admin	+hearing_DurationHours	+CRUD
+hearing-centre-admin	+hearing_DurationMinutes	+CRUD
+hearing-centre-admin	+hearing_HearingId	+CRUD
+hearing-centre-admin	+hearing_HearingSummaryMarkdown	+CRUD
+hearing-centre-admin	+hearing_IsWithoutNotice	+CRUD
+hearing-centre-admin	+hearing_IssueNotice	+CRUD
+hearing-centre-admin	+hearing_Notes	+CRUD
+hearing-centre-admin	+hearing_NoticeWording	+CRUD
+hearing-centre-admin	+hearing_OtherHearingType	+CRUD
+hearing-centre-admin	+hearing_Type	+CRUD
+hearing-centre-admin	+manageHearingOption	+CRUD
+hearing-centre-admin	+manageHearingSeparator	+CR
+hearing-centre-admin	+partyMultiSelectionList	+CRUD
+hearing-centre-admin	+placeholderEditHearing	+CR
+hearing-centre-admin	+showManageHearingPage	+CRUD

AuthorisationCaseField/fee-paid-judge.json

UserRole	CaseFieldID	CRUD
+fee-paid-judge	+-hearingLocationbody	+CR
+fee-paid-judge	+addHearing-hearingLocationHeading	+CR
+fee-paid-judge	+addHearing-separator	+CR
+fee-paid-judge	+cancelHearing-separator	+CR
+fee-paid-judge	+hearingLocation	+R
+fee-paid-judge	+hearing_AddHearing-hearingDurationLabel	+CR
+fee-paid-judge	+hearing_AdditionalInformation	+R
+fee-paid-judge	+hearing_CancelHearing-hearingSummary	+CR
+fee-paid-judge	+hearing_CancellationReason	+R
+fee-paid-judge	+hearing_Date	+R
+fee-paid-judge	+hearing_DurationHours	+R
+fee-paid-judge	+hearing_DurationMinutes	+R
+fee-paid-judge	+hearing_HearingId	+R
+fee-paid-judge	+hearing_HearingSummaryMarkdown	+R
+fee-paid-judge	+hearing_IsWithoutNotice	+R
+fee-paid-judge	+hearing_IssueNotice	+R
+fee-paid-judge	+hearing_Notes	+R
+fee-paid-judge	+hearing_NoticeWording	+R
+fee-paid-judge	+hearing_OtherHearingType	+R
+fee-paid-judge	+hearing_Type	+R
+fee-paid-judge	+manageHearingOption	+R
+fee-paid-judge	+manageHearingSeparator	+CR
+fee-paid-judge	+partyMultiSelectionList	+R
+fee-paid-judge	+placeholderEditHearing	+CR
+fee-paid-judge	+showManageHearingPage	+R

AuthorisationCaseField/ctsc.json

UserRole	CaseFieldID	CRUD
+ctsc	+-hearingLocationbody	+CR
+ctsc	+addHearing-hearingLocationHeading	+CR
+ctsc	+addHearing-separator	+CR
+ctsc	+cancelHearing-separator	+CR
+ctsc	+hearingLocation	+R
+ctsc	+hearing_AddHearing-hearingDurationLabel	+CR
+ctsc	+hearing_AdditionalInformation	+R
+ctsc	+hearing_CancelHearing-hearingSummary	+CR
+ctsc	+hearing_CancellationReason	+R
+ctsc	+hearing_Date	+R
+ctsc	+hearing_DurationHours	+R
+ctsc	+hearing_DurationMinutes	+R
+ctsc	+hearing_HearingId	+R
+ctsc	+hearing_HearingSummaryMarkdown	+R
+ctsc	+hearing_IsWithoutNotice	+R
+ctsc	+hearing_IssueNotice	+R
+ctsc	+hearing_Notes	+R
+ctsc	+hearing_NoticeWording	+R
+ctsc	+hearing_OtherHearingType	+R
+ctsc	+hearing_Type	+R
+ctsc	+manageHearingOption	+R
+ctsc	+manageHearingSeparator	+CR
+ctsc	+partyMultiSelectionList	+R
+ctsc	+placeholderEditHearing	+CR
+ctsc	+showManageHearingPage	+R

AuthorisationCaseField/ctsc-team-leader.json

UserRole	CaseFieldID	CRUD
+ctsc-team-leader	+-hearingLocationbody	+CR
+ctsc-team-leader	+addHearing-hearingLocationHeading	+CR
+ctsc-team-leader	+addHearing-separator	+CR
+ctsc-team-leader	+cancelHearing-separator	+CR
+ctsc-team-leader	+hearingLocation	+R
+ctsc-team-leader	+hearing_AddHearing-hearingDurationLabel	+CR
+ctsc-team-leader	+hearing_AdditionalInformation	+R
+ctsc-team-leader	+hearing_CancelHearing-hearingSummary	+CR
+ctsc-team-leader	+hearing_CancellationReason	+R
+ctsc-team-leader	+hearing_Date	+R
+ctsc-team-leader	+hearing_DurationHours	+R
+ctsc-team-leader	+hearing_DurationMinutes	+R
+ctsc-team-leader	+hearing_HearingId	+R
+ctsc-team-leader	+hearing_HearingSummaryMarkdown	+R
+ctsc-team-leader	+hearing_IsWithoutNotice	+R
+ctsc-team-leader	+hearing_IssueNotice	+R
+ctsc-team-leader	+hearing_Notes	+R
+ctsc-team-leader	+hearing_NoticeWording	+R
+ctsc-team-leader	+hearing_OtherHearingType	+R
+ctsc-team-leader	+hearing_Type	+R
+ctsc-team-leader	+manageHearingOption	+R
+ctsc-team-leader	+manageHearingSeparator	+CR
+ctsc-team-leader	+partyMultiSelectionList	+R
+ctsc-team-leader	+placeholderEditHearing	+CR
+ctsc-team-leader	+showManageHearingPage	+R

AuthorisationCaseField/circuit-judge.json

UserRole	CaseFieldID	CRUD
+circuit-judge	+-hearingLocationbody	+CR
+circuit-judge	+addHearing-hearingLocationHeading	+CR
+circuit-judge	+addHearing-separator	+CR
+circuit-judge	+cancelHearing-separator	+CR
+circuit-judge	+hearingLocation	+R
+circuit-judge	+hearing_AddHearing-hearingDurationLabel	+CR
+circuit-judge	+hearing_AdditionalInformation	+R
+circuit-judge	+hearing_CancelHearing-hearingSummary	+CR
+circuit-judge	+hearing_CancellationReason	+R
+circuit-judge	+hearing_Date	+R
+circuit-judge	+hearing_DurationHours	+R
+circuit-judge	+hearing_DurationMinutes	+R
+circuit-judge	+hearing_HearingId	+R
+circuit-judge	+hearing_HearingSummaryMarkdown	+R
+circuit-judge	+hearing_IsWithoutNotice	+R
+circuit-judge	+hearing_IssueNotice	+R
+circuit-judge	+hearing_Notes	+R
+circuit-judge	+hearing_NoticeWording	+R
+circuit-judge	+hearing_OtherHearingType	+R
+circuit-judge	+hearing_Type	+R
+circuit-judge	+manageHearingOption	+R
+circuit-judge	+manageHearingSeparator	+CR
+circuit-judge	+partyMultiSelectionList	+R
+circuit-judge	+placeholderEditHearing	+CR
+circuit-judge	+showManageHearingPage	+R

CaseEvent/manageHearing.json

CallBackURLAboutToStartEvent	Description	EndButtonLabel	ID	Name	PostConditionState	PreConditionState(s)	Publish	ShowEventNotes	ShowSummary
+http://localhost:3206/callbacks/about-to-start?eventId=manageHearing	+Manage hearing	+Submit	+manageHearing	+Manage hearing	+CASE_ISSUED	+CASE_ISSUED	+N	+N	+Y

CaseEventToFields/manageHearing.json

CaseEventID	CaseFieldID	DisplayContext	PageColumnNumber	PageDisplayOrder	PageFieldDisplayOrder	PageID	PageLabel
+manageHearing	+-hearingLocationbody	+READONLY	+1	+2	+4	+addHearing	+Add a hearing
+manageHearing	+addHearing-hearingLocationHeading	+READONLY	+1	+2	+3	+addHearing	+Add a hearing
+manageHearing	+addHearing-separator	+READONLY	+1	+2	+2	+addHearing	+Add a hearing
+http://localhost:3206/callbacks/mid-event?page=cancelHearing&eventId=manageHearing	+manageHearing	+cancelHearing-separator	+READONLY	+1	+4	+1	+cancelHearing	+Cancel a hearing	+manageHearingOption="CANCEL"
+http://localhost:3206/callbacks/mid-event?page=addHearing&eventId=manageHearing	+manageHearing	+hearingLocation	+READONLY	+[STATE]="NEVER_SHOW"	+1	+2	+1	+addHearing	+Add a hearing	+manageHearingOption="ADD"	+Y
+manageHearing	+hearing_AddHearing-hearingDurationLabel	+READONLY	+1	+2	+9	+addHearing	+Add a hearing
+manageHearing	+hearing_AdditionalInformation	+OPTIONAL	+1	+2	+16	+addHearing	+Add a hearing	+Y
+manageHearing	+hearing_CancelHearing-hearingSummary	+READONLY	+1	+4	+2	+cancelHearing	+Cancel a hearing
+manageHearing	+hearing_CancellationReason	+MANDATORY	+1	+4	+3	+cancelHearing	+Cancel a hearing	+Y
+manageHearing	+hearing_Date	+MANDATORY	+1	+2	+8	+addHearing	+Add a hearing	+Y
+manageHearing	+hearing_DurationHours	+MANDATORY	+1	+2	+10	+addHearing	+Add a hearing	+Y
+manageHearing	+hearing_DurationMinutes	+MANDATORY	+1	+2	+11	+addHearing	+Add a hearing	+Y
+manageHearing	+hearing_HearingId	+READONLY	+[STATE]="NEVER_SHOW"	+1	+1	+4	+manageHearing	+Manage hearing	+Y	+Y
+manageHearing	+hearing_HearingSummaryMarkdown	+READONLY	+[STATE]="NEVER_SHOW"	+1	+1	+5	+manageHearing	+Manage hearing	+Y	+Y
+manageHearing	+hearing_IsWithoutNotice	+MANDATORY	+hearing_IssueNotice="YES"	+1	+2	+14	+addHearing	+Add a hearing	+Y
+manageHearing	+hearing_IssueNotice	+MANDATORY	+1	+2	+13	+addHearing	+Add a hearing	+Y
+manageHearing	+hearing_Notes	+OPTIONAL	+1	+2	+12	+addHearing	+Add a hearing	+Y
+manageHearing	+hearing_NoticeWording	+MANDATORY	+1	+2	+7	+addHearing	+Add a hearing	+Y
+manageHearing	+hearing_OtherHearingType	+MANDATORY	+hearing_Type="OTHER"	+1	+2	+6	+addHearing	+Add a hearing	+Y
+manageHearing	+hearing_Type	+MANDATORY	+1	+2	+5	+addHearing	+Add a hearing	+Y
+manageHearing	+manageHearingOption	+MANDATORY	+1	+1	+3	+manageHearing	+Manage hearing	+Y
+manageHearing	+manageHearingSeparator	+READONLY	+1	+1	+2	+manageHearing	+Manage hearing
+Select all that apply	+Who should receive the hearing notice?	+manageHearing	+partyMultiSelectionList	+MANDATORY	+hearing_IssueNotice="YES" AND hearing_IsWithoutNotice="YES"	+1	+2	+15	+addHearing	+Add a hearing	+Y
+manageHearing	+placeholderEditHearing	+READONLY	+1	+3	+1	+editHearing	+Edit a hearing	+manageHearingOption="EDIT"
+manageHearing	+showManageHearingPage	+READONLY	+[STATE]="NEVER_SHOW"	+1	+1	+1	+manageHearing	+Manage hearing	+showManageHearingPage="YES"	+Y

FixedLists/ManageHearingOption.json

ID	ListElement	ListElementCode
+ManageHearingOption	+Add a hearing	+ADD
+ManageHearingOption	+Cancel a hearing	+CANCEL
+ManageHearingOption	+Edit a hearing	+EDIT

FixedLists/HearingType.json

ID	ListElement	ListElementCode
+HearingType	+Adjourned first hearing	+ADJOURNED
+HearingType	+Application	+APPLICATION
+HearingType	+Other	+OTHER
+HearingType	+Possession first hearing	+POSSESSION

FixedLists/HearingNoticeWording.json

ID	ListElement	ListElementCode
+HearingNoticeWording	+ADJ - has been adjourned until	+ADJ
+HearingNoticeWording	+RES - has been restored to	+RES
+HearingNoticeWording	+TPL - will take place on	+TPL

[hmcts-jenkins-j-to-z]

Plan Result (aat)

No changes. Your infrastructure matches the configuration.