DBIA5792 - $$FIND call in SDAM2 ICR (5792)

Name

Value

NUMBER

5792

IA #

5792

DATE CREATED

2012/04/30

CUSTODIAL PACKAGE

SCHEDULING

USAGE

Private

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

SDAM2

NAME

DBIA5792 - $$FIND call in SDAM2

GENERAL DESCRIPTION

To support delivery of the VA Point of Service (VPS
Kiosks), access to the API $$FIND^SDAM2() is requested in order to find all
the appointments for a patient on a given date.

STATUS

Active

DURATION

Till Otherwise Agreed

SDAM2

COMPONENT/ENTRY POINT

VARIABLES

$$FIND

VARIABLES	TYPE	VARIABLES DESCRIPTION
VPSDFN	Input	The patient's DFN.
VPSDT	Input	Date/time for appointment in FileMan internal format.
VPSCLIN	Input	IEN of the clinic.
VPSSCIEN	Output	IEN for the patient's appointment (if any).

SUBSCRIBING PACKAGE

SUBSCRIBING DETAILS

VA POINT OF SERVICE (KIOSKS)

The input data will be 3 required data elements as
follows: the patient's DFN, date/time of the appointment (FileMan format), and
the clinic's internal entry number (IEN). The data of the input will be
collected after the patient scans his/her VA card at the Kiosk. This action
will trigger the execution of another RPC (Get Patient Demographics) that
relies on available APIs to get the information.

Example of data input: 3 variables defined as follows:


VPSDFN   = Patient's IEN from file #2
VPSDT    = Date/Time for the appointment
VPSCLIN  = IEN of the clinic


Syntax for API call:

S VPSSCIEN=$$FIND^SDAM2(VPSDFN,VPSDT,VPSCLIN)


Example of data output:

VPSSCIEN = IEN of the patient's appointment.

If VPSSCIEN = 0, no appointment was found and the patient is notified.

If VPSSCIEN > 0, the applicable appointment for that day is
passed back, CHECK-IN is completed, and patient is notified. More than
one appointment can be checked-in if applicable for the date.

DATE ACTIVATED

2012/09/26