STANDARD DATA DICTIONARY #231.7 -- TRACKING STAFF FILE                                                            3/24/25    PAGE 1
STORED IN ^EDPB(231.7,  *** NO DATA STORED YET ***   SITE: WWW.BMIRWIN.COM   UCI: VISTA,VISTA                      (VERSION 2.0)   

DATA          NAME                  GLOBAL        DATA
ELEMENT       TITLE                 LOCATION      TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file contains staff assigned to a particular area (e.g., the emergency department).  It allows for concise selection lists
when updating the tracking log.  It also allows for particular colors to be associated with staff.  When that person is shown on
the display board, the colors may be used to more easily tell who is assigned to which patient.  


              DD ACCESS: @
              RD ACCESS: @
              WR ACCESS: @
             DEL ACCESS: @
           LAYGO ACCESS: @
           AUDIT ACCESS: @

CROSS
REFERENCED BY: PERSON(B)

INDEXED BY:    INSTITUTION & AREA & ROLE & INACTIVE (AC), INSTITUTION & AREA & PERSON (AD)




231.7,.01     PERSON                 0;1 POINTER TO NEW PERSON FILE (#200) (Required)

              LAST EDITED:      MAR 05, 2008 
              HELP-PROMPT:      Select a provider, resident, or nurse. 
              DESCRIPTION:
                                This is a person who is assigned to work as staff in the emergency department.  

              CROSS-REFERENCE:  231.7^B 
                                1)= S ^EDPB(231.7,"B",$E(X,1,30),DA)=""
                                2)= K ^EDPB(231.7,"B",$E(X,1,30),DA)

              RECORD INDEXES:   AD (#872)

231.7,.02     INSTITUTION            0;2 POINTER TO INSTITUTION FILE (#4) (Required)

              LAST EDITED:      OCT 08, 2008 
              HELP-PROMPT:      Select the institution for this staff list. 
              DESCRIPTION:
                                This allows each station to have its own set of staff assignments.  

              RECORD INDEXES:   AC (#871), AD (#872)

231.7,.03     AREA                   0;3 POINTER TO TRACKING AREA FILE (#231.9)

              LAST EDITED:      MAR 05, 2008 
              HELP-PROMPT:      Select an area for this person. 
              DESCRIPTION:
                                This is the area to which the person is assigned as staff.  

              TECHNICAL DESCR:  The only area currently supported is the emergency department, but expansion into other areas is
                                anticipated.  

              RECORD INDEXES:   AC (#871), AD (#872)

231.7,.04     INACTIVE               0;4 SET

                                '0' FOR ACTIVE; 
                                '1' FOR INACTIVE; 
              LAST EDITED:      NOV 24, 2007 
              HELP-PROMPT:      Enter 'active' or 'inactive'. 
              DESCRIPTION:      This flag is set to 'inactive' when the person is no longer an active member of the staff for this
                                area.  

              RECORD INDEXES:   AC (#871)

231.7,.05     LOCAL ID*              0;5 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>12!($L(X)<1) X
              LAST EDITED:      MAR 05, 2008 
              HELP-PROMPT:      Answer must be 1-12 characters in length. 

231.7,.06     ROLE                   0;6 POINTER TO CPE ROLE FILE (#232.5)

              LAST EDITED:      MAR 13, 2012 
              HELP-PROMPT:      Select the role for this entry. 
              DESCRIPTION:
                                This is the role for this person.  

              RECORD INDEXES:   AC (#871)

231.7,.07     INITIALS*              0;7 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>7!($L(X)<1) X
              LAST EDITED:      MAR 05, 2008 
              HELP-PROMPT:      Answer must be 1-7 characters in length. 

231.7,.08     COLOR                  0;8 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>20!($L(X)<1) X
              LAST EDITED:      NOV 24, 2007 
              HELP-PROMPT:      Answer must be 1-20 characters in length. 
              DESCRIPTION:      This contains the RGB values for the foreground and background colors used to highlight this person
                                on the display board.  

              TECHNICAL DESCR:  The format of the color map for a person is: 
                                 
                                  ,, 
                                 
                                All colors are represented in hexadecimal.  For example, 
                                 
                                  1,0xff0000,0xffffff 
                                 
                                means to use color, foreground color is red, background color is white.  



      FILES POINTED TO                      FIELDS

CPE ROLE (#232.5)                 ROLE (#.06)

INSTITUTION (#4)                  INSTITUTION (#.02)

NEW PERSON (#200)                 PERSON (#.01)

TRACKING AREA (#231.9)            AREA (#.03)


File #231.7

  Record Indexes:

  AC (#871)    RECORD    REGULAR    IR    SORTING ONLY
      Short Descr:  SITE,AREA,ROLE,IEN if the entry is active
      Description:  This cross reference supports constructing a list of currently active staff for a particular role.  
                     
                    For this record level cross reference, the kill logic should always be executed when any value changes.  The
                    set logic is then executed conditionally, allowing the cross reference to hold only active values.  
        Set Logic:  S ^EDPB(231.7,"AC",X(1),X(2),X(3),DA)=""
         Set Cond:  S X='X2(4)
       Kill Logic:  K ^EDPB(231.7,"AC",X(1),X(2),X(3),DA)
       Whole Kill:  K ^EDPB(231.7,"AC")
             X(1):  INSTITUTION  (231.7,.02)  (Subscr 1)  (forwards)
             X(2):  AREA  (231.7,.03)  (Subscr 2)  (forwards)
             X(3):  ROLE  (231.7,.06)  (Subscr 3)  (forwards)
             X(4):  INACTIVE  (231.7,.04)  (forwards)

  AD (#872)    RECORD    REGULAR    IR    SORTING ONLY
      Short Descr:  SITE,AREA,DUZ,IEN
      Description:  This cross reference allows searching the file for an entry matching a particular DUZ (say, to look up a color
                    map).  Since a person may work as staff in multiple areas, this cross reference allows finding the staff record
                    that applies to the person's activity in a specific area.  
        Set Logic:  S ^EDPB(231.7,"AD",X(1),X(2),X(3),DA)=""
       Kill Logic:  K ^EDPB(231.7,"AD",X(1),X(2),X(3),DA)
       Whole Kill:  K ^EDPB(231.7,"AD")
             X(1):  INSTITUTION  (231.7,.02)  (Subscr 1)  (forwards)
             X(2):  AREA  (231.7,.03)  (Subscr 2)  (forwards)
             X(3):  PERSON  (231.7,.01)  (Subscr 3)  (forwards)


INPUT TEMPLATE(S):

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):