Print Page as PDF
DBIA4442 ICR (4442)

DBIA4442    ICR (4442)

Name Value
NUMBER 4442
IA # 4442
DATE CREATED 2005/01/26
CUSTODIAL PACKAGE MENTAL HEALTH
CUSTODIAL ISC Dallas
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE YTAPI10
NAME DBIA4442
GENERAL DESCRIPTION
API to return the scoring for a psychological test.
STATUS Active
KEYWORDS
  • MENTAL HEALTH
  • CLINICAL REMINDERS
DURATION Till Otherwise Agreed
ID YTAPI10
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
ENDAS(.YSDATA,DAS)
This API returns the psychological test scoring for a
specified patient and a specified test. The psychological test of interest is
located using the Clinical Reminders Index. The last subscript in the index
entry (DAS) give the location in the global where the results are stored.

Example of the Mental Health Clinical Reminder Index global entry:

^PXRMINDX(601.2,"IP",INSTRUMENT,DFN,COMPLETION DATE,DAS)
^PXRMINDX(601.2,"PI",DFN,INSTRUMENT,COMPLETION DATE,DAS)

^PXRMINDX(601.2,"IP",6,30,3030213,"30;1;6;1;3030213") =
^PXRMINDX(601.2,"PI",30,6,3030213,"30;1;6;1;3030213") =

To call the API use D ENDAS^YTAPI10(.YSDATA,DAS). YSDATA (output) and DAS
(input) are described in detail in the Output and Input variable sections.

VARIABLES TYPE VARIABLES DESCRIPTION
YSDATA Output
The output variable YSDATA is an array in the format:

Array(1)=[DATA]
Array(2)=Patient Name^Test Code^Test Title^Internal Admindate^
External Admin Date ^Ordered by
Array(3)=R1^Responses 1-200 undelimited
Array(4)=R2^ Responses 201-400 undelimited (even if less than 200)
Array(5)=R3^ Responses 401-600 undelimited
Array(6)=S1^Scale Name^Raw Score^Transformed Score
Array(7)=S2^ Scale Name^Raw Score^Transformed Score And onward as needed

Example of the output YSDATA array:

YSDATA(0)=[ERROR]
YSDATA(1)=[DATA]
YSDATA(2)=NOSE,LIMP^ATQ^--- AUTOMATIC THOUGHTS QUESTIONNAIRE
---^3030213^02/13/2003^DIBENEDETTO,PETER
YSDATA(3)=R1^12345X12345X2345X12345X12345X1
YSDATA(4)=R2^
YSDATA(5)=R3^
YSDATA(6)=S1^ATQ-30^75^74
YSDATA(7)=S2^MALADJ^14^46
YSDATA(8)=S3^NEG SC^18^49
YSDATA(9)=S4^LOW SE^1^36
YSDATA(10)=S5^HELPLESS^1^34


DAS Input
This input variable (DAS) is a semicolon separated
string of values stored in the Clinical Reminder Index entry:

^PXRMINDX(601.2,"IP",INSTRUMENT,DFN,COMPLETION DATE,DAS)
^PXRMINDX(601.2,"PI",DFN,INSTRUMENT,COMPLETION DATE,DAS)

It gives the location in the global where the results are stored. The first
piece is the first subscript, then second piece the second subscript, and so
on. For example, if DAS="30;1;6;1;3030213" then the data location would be
^YTD(601.2,30,1,6,1,3030213,1).

SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE ISC
CLINICAL REMINDERS Salt Lake City
ORDER ENTRY/RESULTS REPORTING