Print Page as PDF
DBIA5792 - $$FIND call in SDAM2 ICR (5792)

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
ID SDAM2
COMPONENT/ENTRY POINT
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 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