STANDARD DATA DICTIONARY #231.9 -- TRACKING AREA FILE 3/24/25 PAGE 1
STORED IN ^EDPB(231.9, (1 ENTRY) SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 2.0)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file contains the parameters that control the behavior of the tracking software. It also contains XML descriptions that are
used by the client display board software to control column appearance, row content, and cell color.
DD ACCESS: @
RD ACCESS: @
WR ACCESS: @
DEL ACCESS: @
LAYGO ACCESS: @
AUDIT ACCESS: @
POINTED TO BY: AREA field (#.03) of the ED LOG File (#230)
AREA field (#.03) of the TRACKING BOARD File (#231.6)
AREA field (#.03) of the TRACKING STAFF File (#231.7)
AREA field (#.03) of the TRACKING ROOM-BED File (#231.8)
AREA field (#.03) of the EDP WORKSHEET SPECIFICATION File (#232.6)
CROSS
REFERENCED BY: NAME(B), INSTITUTION(C)
LAST MODIFIED: JUL 13,2023@20:12:27
231.9,.01 NAME 0;1 FREE TEXT (Required)
INPUT TRANSFORM: K:$L(X)>30!($L(X)<3)!'(X'?1P.E) X
LAST EDITED: SEP 15, 2008
HELP-PROMPT: Answer must be 3-30 characters in length.
DESCRIPTION: This is the name for an area within the hospital. Emergency Department is the only area currently
supported.
CROSS-REFERENCE: 231.9^B
1)= S ^EDPB(231.9,"B",$E(X,1,30),DA)=""
2)= K ^EDPB(231.9,"B",$E(X,1,30),DA)
231.9,.02 INSTITUTION 0;2 POINTER TO INSTITUTION FILE (#4) (Required)
LAST EDITED: OCT 08, 2008
HELP-PROMPT: Select the instutition for this area.
DESCRIPTION:
This allows each station served by the VistA system to have its own set of areas.
CROSS-REFERENCE: 231.9^C
1)= S ^EDPB(231.9,"C",$E(X,1,30),DA)=""
2)= K ^EDPB(231.9,"C",$E(X,1,30),DA)
This allows finding an area within a specific division.
231.9,.03 LAST UPDATE 0;3 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAY 02, 2008
HELP-PROMPT: Enter the date/time the configuration changed.
DESCRIPTION: This is the date/time that the configuration was last updated. This helps the client or display
board know whether it is necessary to reload the configuration parameters.
231.9,1.1 DIAGNOSIS REQUIRED 1;1 SET
'0' FOR NO;
'1' FOR YES;
LAST EDITED: OCT 15, 2007
HELP-PROMPT: Enter 'YES' if a diagnosis must be entered before removing the patient from the board.
DESCRIPTION:
This is true if a diagnosis must be entered before removing a patient from the display board.
231.9,1.11 AMBULANCE 1;11 POINTER TO TRACKING ROOM-BED FILE (#231.8)
LAST EDITED: MAY 14, 2008
HELP-PROMPT: Select the room/area that represents an arriving ambulance.
DESCRIPTION:
This field identifies which entry in the TRACKING ROOM-BED represents an arriving ambulance.
231.9,1.12 INITIAL ROOM 1;12 POINTER TO TRACKING ROOM-BED FILE (#231.8)
LAST EDITED: MAY 14, 2008
HELP-PROMPT: Enter the room/area that is initially assigned.
DESCRIPTION: This field refers to the entry in the TRACKING ROOM-BED file that should be initially assigned to a
patient when the patient is first added to the board (the default room). Often this is the waiting
room.
231.9,1.2 CODED DIAGNOSIS 1;2 SET
'0' FOR NO;
'1' FOR YES;
LAST EDITED: OCT 15, 2007
HELP-PROMPT: Enter YES if the diagnosis is required to be an ICD9 code.
DESCRIPTION: This is set to YES if the diagnosis is required to be an ICD9 code. Otherwise, the diagnosis may
be free text.
231.9,1.3 DISPOSITION REQUIRED 1;3 SET
'0' FOR NO;
'1' FOR YES;
LAST EDITED: OCT 15, 2007
HELP-PROMPT: Enter 'YES' if a disposition must be entered before removing patient from the board.
DESCRIPTION:
This is true if a disposition must be entered before removing a patient from the display board.
231.9,1.4 DELAY REQUIRED 1;4 SET
'0' FOR NO;
'1' FOR YES;
LAST EDITED: OCT 15, 2007
HELP-PROMPT: Enter 'YES' if a delay reason is required for visits exceeding the pre-set number of minutes
allowed.
DESCRIPTION: This is true if a delay reason must be entered for visits that have lasted longer than the number
of minutes identified in DELAY MINUTES before removing the patient from the board.
231.9,1.5 DELAY MINUTES 1;5 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>1440)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: OCT 10, 2008
HELP-PROMPT: Type a Number between 1 and 1440, 0 Decimal Digits
DESCRIPTION:
This represents the number of minutes a visit may last before a delay reason is required.
231.9,1.6 FIRST SHIFT START 1;6 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>1440)!(X<0)!(X?.E1"."1N.N) X
LAST EDITED: OCT 10, 2008
HELP-PROMPT: Type a Number between 0 and 1440, 0 Decimal Digits
DESCRIPTION: Some of the reports may be generated by shift. This is the time that the first shift of the day
begins. It is currently assumed that the shifts have equal length.
This is the number of minutes past midnight when the first shift begins.
231.9,1.7 SHIFT DURATION 1;7 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>1440)!(X<0)!(X?.E1"."1N.N) X
LAST EDITED: OCT 10, 2008
HELP-PROMPT: Type a Number between 0 and 1440, 0 Decimal Digits
DESCRIPTION: This represents the number of minutes the comprise a shift. If the shift is 8 hours long, this
value would be 480 (8*60).
231.9,1.8 PROMPT RESIDENTS 1;8 SET
'0' FOR NO;
'1' FOR YES;
LAST EDITED: NOV 30, 2007
HELP-PROMPT: Enter 'YES' if residents should be prompted for.
DESCRIPTION: This flag is set to YES if residents should be prompted for in addition to providers (i.e., the
attending provider).
231.9,1.9 PROMPT CLINICS 1;9 SET
'0' FOR NO;
'1' FOR YES;
LAST EDITED: DEC 15, 2008
HELP-PROMPT: Enter 'YES' if clinics should be prompted for.
DESCRIPTION: This flag is set to YES if clinics should be prompted for. This allows the visit to be created
based on an explicitly selected clinic.
231.9,2 WAITING TEXT ONE 232;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>244!($L(X)<1) X
MAXIMUM LENGTH: 244
LAST EDITED: APR 21, 2023
HELP-PROMPT: Enter text to be displayed for the left panel of the Waiting Room Board. Answer must be 1-244
characters in length.
DESCRIPTION: This field stores the text to be displayed on the left hand panel of the Waiting Room Big Board for
the EDIS GUI.
231.9,3 COLOR SPEC 3;0 WORD-PROCESSING #231.93 (NOWRAP)
DESCRIPTION:
This contains an XML document that is a map of the colors to be used for the display board.
LAST EDITED: OCT 27, 2007
HELP-PROMPT: Enter the XML-based color map.
DESCRIPTION:
This contains an XML document that is a map of the colors to be used for the display board.
231.9,4 DISPLAY BOARD CONFIG 4;0 Multiple #231.94 (Add New Entry without Asking)
DESCRIPTION:
This multiple contains the XML descriptions of each display board definition.
231.94,.01 NAME 0;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>30!($L(X)<1) X
LAST EDITED: MAY 14, 2008
HELP-PROMPT: Enter a unique name for this display board configuration.
DESCRIPTION:
This is the name of the specific display board.
CROSS-REFERENCE: 231.94^B
1)= S ^EDPB(231.9,DA(1),4,"B",$E(X,1,30),DA)=""
2)= K ^EDPB(231.9,DA(1),4,"B",$E(X,1,30),DA)
231.94,1 SPEC 1;0 WORD-PROCESSING #231.941 (NOWRAP)
DESCRIPTION:
This is the XML description for a specific display board.
LAST EDITED: MAY 14, 2008
HELP-PROMPT: Enter the XML that represents the board specification.
DESCRIPTION:
This is the XML-based description of a specific display board definition.
231.9,5 WAITING TEXT TWO 233;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>244!($L(X)<1) X
MAXIMUM LENGTH: 244
LAST EDITED: APR 21, 2023
HELP-PROMPT: Enter text to be displayed for the bottom panel of the Waiting Room Board. Answer must be 1-244
characters in length.
DESCRIPTION: This field stores the text to be displayed on the bottom panel of the Waiting Room Big Board for
the EDIS GUI.
231.9,6 WAITING TEXT UPDATES 234;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>244!($L(X)<1) X
MAXIMUM LENGTH: 244
LAST EDITED: APR 21, 2023
HELP-PROMPT: Enter text to be displayed for the "updates" panel of the Waiting Room Board. Answer must be 1-244
characters in length.
DESCRIPTION: This field stores the text to be displayed on the updates panel of the Waiting Room Big Board for
the EDIS GUI.
231.9,230.1 TRACKING UPDATED 230;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>30!($L(X)<1) X
LAST EDITED: OCT 06, 2007
HELP-PROMPT: Answer must be 1-30 characters in length.
DESCRIPTION: This timestamp is set whenever the data that is shown on any display board for an area has been
updated.
TECHNICAL DESCR: The timestamp kept in this field is $H. The $H value is used as a token by the client to know that
tracking data has changed.
231.9,231.1 CHOICES UPDATED 231;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>30!($L(X)<1) X
LAST EDITED: JUL 27, 2008
HELP-PROMPT: Answer must be 1-30 characters in length.
DESCRIPTION: This is a timestamp that is set whenever the definition of any display board for a given area has
been modified.
TECHNICAL DESCR: The timestamp kept in this field is $H. The $H value is used as a token by the client to know that
display choices have been updated.
FILES POINTED TO FIELDS
INSTITUTION (#4) INSTITUTION (#.02)
TRACKING ROOM-BED (#231.8) AMBULANCE (#1.11)
INITIAL ROOM (#1.12)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):