[Spike] Document empty/error state logic for community care appointment

[outerpress]

Background/Request

Product and UX wants to know how VAOS is currently displaying missing data on details pages. We'll use the information to add and update those patterns in the details page redesign.

We also want to understand the field names and data calls for each data point so we can map these and align with other teams who display appointment data.

Goal

Document the situations where VAOS doesn't display data, or displays an error state when data is missing from VA in-person appointment details pages. (This does not apply to the list view). Also, capture technical information about the data calls.

Requirements to Consider

For each data field that can show on the details page of a community care appointment please provide:

• The services or endpoints that are being called to retrieve the data.
  • The technical name of the field in the data call.
• The logic or error (if any) that triggers missing data states.
• Screenshots of the missing data states.

---

Tasks

• Answer the following questions for each data point (noted in the table that follows):
  • What (if any) logic is in place to handle situations where the data point can’t be displayed to the user?
    • Note if logic is for an error state or other situation.
    • Please provide screenshots of the details page in each state where data is missing.
    • Please the services or endpoints that are being called to retrieve the data.
    • Please provide the field name used in the data call.

Data points to review for VA In-person booked appointments:

• Appointment Date and Time
• Type of Care
• Provider Name
• Treatment Specialty
• Provider Address
• Provider Phone Number
• Veteran Reason For Appointment

Time Box

8 hours

Definition of Done

• Tasks are complete
• Research and recommendations are documented in this ticket

---

[JunTaoLuo]

We retrieve the appointment information using one of the following calls:

• From appointment list: /vaos/v2/appointments?_include=facilities,clinics&start={today-120}&end={today+1}&statuses[]=proposed&statuses[]=cancelled and /vaos/v2/appointments?_include=facilities,clinics&start={today-30}&end={today+395}&statuses[]=booked&statuses[]=arrived&statuses[]=fulfilled&statuses[]=cancelled
• From appointment details page: /vaos/v2/appointments/${id}?_include=facilities,clinics,avs

Data points:

Role	Section name	Source field name	Empty state logic
Appointment date and time	When	appt.localStartTime	Start time always populated
Type of Care	What	appt.serviceType	Do not display if not available.
Provider Name	Provider	appt.practitioners[0].name	Display "Provider information not available" if not available.
Treatment Specialty	Provider	appt.extension.ccTreatingSpecialty	Display "Treatment specialty not available" if not available.
Provider Address	Provider	appt.extension.ccLocation.address	Display "Address not available" if not available.
Provider Phone	Provider	appt.extension.ccLocation.telecom	Do not display if not available.
Veteran Reason For Appointment	Details you shared with your provider	appt.patientComments	Display "Not available" if not available.

Screenshots

Upcoming	Past	Cancelled	Empty state

[JunTaoLuo]

@outerpress this is ready for validation.

[outerpress]

Documented here and closing, thank you!