Print Page as PDF
YTAPI4 ICR (3982)

YTAPI4    ICR (3982)

Name Value
NUMBER 3982
IA # 3982
DATE CREATED 2005/01/26
CUSTODIAL PACKAGE MENTAL HEALTH
CUSTODIAL ISC Dallas
USAGE Private
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE YTAPI4
NAME YTAPI4
STATUS Active
DURATION Till Otherwise Agreed
ID YTAPI4
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
PREVIEW(YSDATA,YS)
This API allows scoring of patient responses to a
test or interview without making changes in the M database. The patient ien,
the test code, and administration date is required along with the responses.
All responses are checked for validity. Scoring is returned in the output
documented in the SCOREIT^YTAPI2(.YSDATA,.YS).
VARIABLES TYPE VARIABLES DESCRIPTION
YS Input

Input array .YS
---------------
DFN: Patient internal identifier

CODE: Test code from file 601 or "ASI" e.g. "CAGE", "BDI"

ADATE: Inclusive administration date in %DT acceptable format (11/11/2011)

Staff: DUZ of professional ordering the test

R1: String of patient responses 1-200

R2: String of patient responses 201-400 [as needed]

R3: String of patient responses 401-600 [as needed]

Example:
--------
YS("DFN")=6
YS("ADATE")="T"
YS("CODE")="ZUNG"
YS("STAFF")=67
YS("R1")="12121212121212121212"
YSDATA Output
Output:
-------
Array(1)=[Data]  ;indicates a successful call
Array(2)= Patient Name^Test Code^Test Title^Internal Admin date^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:
--------
Output
------
YSDATA(1)=[DATA]
YSDATA(2)=CAPP,ANDY W^MMPI2^--- ZUNG ---^2940509^05/09/1994^CAULFIELD,MARY A
YSDATA(3)="12121212121212121212"
YSDATA(4)=R2^
YSDATA(5)=R3^
YSDATA(6)=S1^Total^12^
YSDATA("ON")= A mood disorder screening test (ZUNG) was in the low range
(score = 12).
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE SUBSCRIBING DETAILS
ORDER ENTRY/RESULTS REPORTING
Added 9/4/24 to clarify that PREVIEW^YTAPI4 is
deprecated and is not actually called by OE/RR (it is just checking if that
API exists). In the future, OE/RR will remove the reference to this API.