TIU DOCUMENTS BY CONTEXT (103)    REMOTE PROCEDURE (8994)

Name Value
NAME TIU DOCUMENTS BY CONTEXT
TAG CONTEXT
ROUTINE TIUSRVLO
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY SUBSCRIPTION
WORD WRAP ON TRUE
APP PROXY ALLOWED Yes
DESCRIPTION
Returns lists of TIU Documents that satisfy the following search criteria:
 
1 - signed documents (all)   
2 - unsigned documents  
3 - uncosigned documents
4 - signed documents/author
5 - signed documents/date range
INPUT PARAMETER
  • CLASS
    PARAMETER TYPE:   LITERAL
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    This is a pointer to the Class of TIU DOCUMENTS which the user is
    interested in (e.g., 3 for PROGRESS NOTES, 244 for DISCHARGE SUMMARIES,
    etc.).
    
  • INCUND
    PARAMETER TYPE:   LITERAL
    REQUIRED:   NO
    SEQUENCE NUMBER:   10
    DESCRIPTION:   
    Optional Boolean parameter determines whether Undictated and 
    Untranscribed documents should be returned along with Unsigned
    documents, when the CONTEXT is passed as 2.
    
  • SHOW
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   1
    REQUIRED:   NO
    SEQUENCE NUMBER:   11
    DESCRIPTION:   
    Boolean: Return "0^SHOW MORE" in return array when additional notes are 
    available for context of 1 or 5 when occurrence limit prevents all notes 
    from displaying.
    
  • TIUIEN
    PARAMETER TYPE:   LITERAL
    REQUIRED:   NO
    SEQUENCE NUMBER:   12
    DESCRIPTION:   
    Starting TIU IEN for additional return when "SHOW MORE" was received in 
    previous return array (LATE date/time will be set to Reference date of 
    this TIU document).
    
  • CONTEXT
    PARAMETER TYPE:   LITERAL
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    This is an integer number which maps the context in which the user wishes
    the notes to be returned.  The mapping is as follows:
     
    1 - signed documents (all)
    2 - unsigned documents  
    3 - uncosigned documents
    4 - signed documents/author
    5 - signed documents/date range
    
  • DFN
    PARAMETER TYPE:   LITERAL
    REQUIRED:   YES
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    Pointer to Patient File (#2).
    
  • EARLY
    PARAMETER TYPE:   LITERAL
    REQUIRED:   NO
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    EARLY DATE/TIME in regular FileMan format for the inclusive lower bound on
    the search.
    
  • LATE
    PARAMETER TYPE:   LITERAL
    REQUIRED:   NO
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    LATE DATE/TIME in regular FileMan format for the inclusive upper bound on
    the search.
    
  • PERSON
    PARAMETER TYPE:   LITERAL
    REQUIRED:   NO
    SEQUENCE NUMBER:   6
    DESCRIPTION:   
    This is a pointer to the NEW PERSON FILE (#200) for the author of the
    documents to be retrieved.
    
  • OCCLIM
    PARAMETER TYPE:   LITERAL
    REQUIRED:   NO
    SEQUENCE NUMBER:   7
    DESCRIPTION:   
    This is the maximum number of documents to be retrieved in the current
    query.
    
  • SEQUENCE
    PARAMETER TYPE:   LITERAL
    REQUIRED:   NO
    SEQUENCE NUMBER:   8
    DESCRIPTION:   
    This is the sequence by reference date/time (A=ascending (OLDEST FIRST),
    D=descending (NEWEST FIRST)) in which the user would like the list
    returned.
    
  • SHOWADD
    PARAMETER TYPE:   LITERAL
    REQUIRED:   NO
    SEQUENCE NUMBER:   9
    DESCRIPTION:   
    This BOOLEAN parameter determines whether addenda will be included in the
    return array, when their parent documents are identified by the search
    criteria, and vice versa. Also if SHOWADD is TRUE (1), the "+" at the
    beginning of the return text will be omitted (since it offers only
    redundant information).
    
RETURN PARAMETER DESCRIPTION
The return array has elements with the following positional values:
date range)), then a final data element will be added indicating more are 
available with the following positional values:
  
   IEN^"SHOW MORE"^^^^^^^^^^^^^
 
IEN^TITLE^REFERENCE DATE/TIME (INT)^PATIENT NAME (LAST I/LAST 4)^AUTHOR
   (INT;EXT)^HOSPITAL LOCATION^SIGNATURE STATUS^Visit Date/Time^
   Discharge Date/time^Variable Pointer to Request (e.g., Consult)^# of
   Associated Images^Subject^Has Children^IEN of Parent Document
 
If SHOW parameter received and additional documents are available for 
return when context is 1 (All Signed (by PT)) or 5 (Signed notes (by PT &