Print Page as PDF
TIU GET DOCUMENT COUNT ICR (2812)

TIU GET DOCUMENT COUNT    ICR (2812)

Name Value
NUMBER 2812
IA # 2812
DATE CREATED 1999/04/30
CUSTODIAL PACKAGE TEXT INTEGRATION UTILITIES
CUSTODIAL ISC Salt Lake City
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE TIUSRVLV
NAME TIU GET DOCUMENT COUNT
GENERAL DESCRIPTION
This DBIA documents calls to routine TIUSRVLV

^TMP("TIULIST",$J) may be killed before and after use.

Revision History
4/10/24: A new parameter (CNTSCND) was added to control if the API should
count documents that reference the Visit via the Secondary Visit field.
When the parameter is not passed in, it will behave as it did previously
(it will not include those document counts).
STATUS Active
DURATION Till Otherwise Agreed
ID TIUSRVLV
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
DOCCNT(TIUY,DFN,VSTR,VSIT,CNTSCND)
This entry point returns the number of TIU documents
for a visit.  The Visit may be identified by DFN and visit string or visit
IEN.
VARIABLES TYPE VARIABLES DESCRIPTION
TIUY Output
The number of TIU documents, this value is returned
to the calling routine.
DFN Input
Internal number of the patient as stored in ^DPT(DFN
VSTR Input
A Visit string representing an encounter in the form
of "Location";"date/tame";"service category" where "location", "date/time" and
"service category" would be replaced with the actual values.
VSIT Input
Optional value containing the Visit IEN.
CNTSCND Input
Controls if API should count documents that reference
the Visit via the SECONDARY VISIT field. (Possible values: 1/0; Optional;
Defaults to 0).
NOTES(.ARRAY,VISIT,STATUS)
Returns a list of notes
VARIABLES TYPE VARIABLES DESCRIPTION
.ARRAY Both
Passed by reference as name of array to receive
output.  Receives list of notes for visit (and optionally only a certain
status of notes).  Return array is in the following format: Return array is in
the following format:

^TMP("TIULIST",$J,9999999-VERIFICATION DATE/TIME,COUNTER)=record

data from record is as follows

Piece:       Data
1          IEN of TIU DOCUMENT file (#8925)
2          Display name of document class
3          Reference date (internal format)
4          Patient Name in format (LAST, FIRST MI) followed by space
followed by last 4
5          Signature name of author/dictator
6          Name of Hospital Location associated with note
7          Name of TIU STATUS in lower case
8          'Adm: ' if type of location is a ward or 'Visit: ' otherwise
appended with EPISODE BEGIN DATE/TIME in format MM/DD/YY
9          If EPISODE END DATE/TIME exists, returns 'Dis: " appended to
the date in MM/DD/YY format.
VISIT Input
Pointer to the VISIT file (#9000010).
STATUS Input
Optional:  Internal value of the TIU STATUS file
denoting the status of notes you want returned.  If not passed, all notes for
visit are returned.
SUMMARY(.ARRAY,VISIT,STATUS)
Returns list of summaries
VARIABLES TYPE VARIABLES DESCRIPTION
.ARRAY Both
Passed by reference as name of array to receive
output.  Receives list of summaries for visit (and optionally only a certain
status of summaries).  Return array is in the following format:

^TMP("TIULIST",$J,9999999-VERIFICATION DATE/TIME,COUNTER)=record

data from record is as follows

Piece:       Data
1          IEN of TIU DOCUMENT file (#8925)
2          Display name of document class
3          Reference date (internal format)
4          Patient Name in format (LAST, FIRST MI) followed by space
followed by last 4
5          Signature name of author/dictator
6          Name of Hospital Location associated with note
7          Name of TIU STATUS in lower case
8          'Adm: ' if type of location is a ward or 'Visit: ' otherwise
appended with EPISODE BEGIN DATE/TIME in format MM/DD/YY
9          If EPISODE END DATE/TIME exists, returns 'Dis: " appended to
the date in MM/DD/YY format.
VISIT Input
Pointer to the VISIT file (#9000010).
STATUS Input
Optional:  Internal value of the TIU STATUS file
denoting the status of summaries you want returned.  If not passed, all
summaries for visit are returned.
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE ISC
ORDER ENTRY/RESULTS REPORTING Salt Lake City
SCHEDULING
DATE ACTIVATED 2024/04/10