STANDARD DATA DICTIONARY #704.117 -- OBS FILE                                                                     3/24/25    PAGE 1
STORED IN ^MDC(704.117,  *** NO DATA STORED YET ***   SITE: WWW.BMIRWIN.COM   UCI: VISTA,VISTA                     (VERSION 1.0)   

DATA          NAME                  GLOBAL        DATA
ELEMENT       TITLE                 LOCATION      TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file maintains observations for use with the Clinical Flowsheets application.  


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

PRIMARY KEY:        A (#110)
  Uniqueness Index: PK (#957)
       File, Field: 1) OBS_ID (704.117,.01)

POINTED TO BY: OBS_ID field (#.02) of the OBS_SET_OBS_PAIR File (#704.1161) 
               PARENT_ID field (#.02) of the OBS File (#704.117) 
               OBS_ID field (#.01) of the OBS_QUALIFIER File (#704.118) 
               AUDIT_OBSERVATION field (#.03) of the OBS_AUDIT File (#704.119) 
               REPLACEMENT_OBSERVATION field (#.08) of the OBS_AUDIT File (#704.119) 
               


INDEXED BY:    OBSERVED_DATE_TIME (ADT), PARENT_ID & CHILD_ORDER (AP), STATUS (APXRM), STATUS & PATIENT_ID & OBSERVED_DATE_TIME
               (AS), STATUS (ASTATUS), STATUS & OBSERVED_DATE_TIME (AUV), OBS_ID (PK), PATIENT_ID & OBSERVED_DATE_TIME (PT)




704.117,.01   OBS_ID                 0;1 FREE TEXT (Required) (Key field)

              INPUT TRANSFORM:  K:$L(X)>38!($L(X)<38)!'(X?1"{"8UN1"-"4UN1"-"4UN1"-"4UN1"-"12UN1"}") X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with the system generated GUID for this observation.  
              DESCRIPTION:      This is a Globally Unique IDentifier (GUID) for this entry. This is maintained nationally so it is
                                the same throughout the enterprise.  A sample OBS ID could be
                                "{69DBD11E-9A8C-4ECE-AFA4-73947218807D}".  

              FIELD INDEX:      PK (#957)    REGULAR    IR    LOOKUP & SORTING
                   Unique for:  Key A (#110), File #704.117
                  Short Descr:  Uniqueness Index for Key 'A' of File #704.117
                  Description:  This provides a quick reference to unique entries.  
                    Set Logic:  S ^MDC(704.117,"PK",$E(X,1,38),DA)=""
                   Kill Logic:  K ^MDC(704.117,"PK",$E(X,1,38),DA)
                   Whole Kill:  K ^MDC(704.117,"PK")
                         X(1):  OBS_ID  (704.117,.01)  (Subscr 1)  (Len 38)


704.117,.02   PARENT_ID              0;2 POINTER TO OBS FILE (#704.117)

              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with an identifier for the parent observation of this observation.  
              DESCRIPTION:
                                This identifies the parent observation in the case of a complex observation.  

              RECORD INDEXES:   AP (#953)

704.117,.03   FACILITY_ID            0;3 POINTER TO DOMAIN FILE (#4.2) (Required)

              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with an identifier for the facility/domain related to this observation.  
              DESCRIPTION:
                                This identifies the domain (file #4.2) relevant to this observation (#.01).  


704.117,.04   HOSPITAL_LOCATION_ID   0;4 POINTER TO HOSPITAL LOCATION FILE (#44)

              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with an identifier for the hospital location related to this observation.  
              DESCRIPTION:
                                This identifies the hospital location (file #44) relevant to this observation (#.01).  


704.117,.05   OBSERVED_DATE_TIME     0;5 DATE (Required)

              INPUT TRANSFORM:  S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with the date/time this observation occurred.  
              DESCRIPTION:
                                This is the date/time this observation (#.01) took place.  

              FIELD INDEX:      ADT (#952)    REGULAR    IR    SORTING ONLY
                  Short Descr:  Whole file by Date/Time Observed
                    Set Logic:  S ^MDC(704.117,"ADT",$E(X,1,20),DA)=""
                   Kill Logic:  K ^MDC(704.117,"ADT",$E(X,1,20),DA)
                   Whole Kill:  K ^MDC(704.117,"ADT")
                         X(1):  OBSERVED_DATE_TIME  (704.117,.05)  (Subscr 1)  (Len 20)  (forwards)

              RECORD INDEXES:   AS (#955), AUV (#956), PT (#958)

704.117,.06   OBSERVED_BY_ID         0;6 POINTER TO NEW PERSON FILE (#200)

              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with an identifier for the observer. 
              DESCRIPTION:
                                This identifies the person (file #200) that made this observation.  


704.117,.07   TERM_ID                0;7 POINTER TO TERM FILE (#704.101) (Required)

              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with an identifier for the type of this observation. 
              DESCRIPTION:      This identifies the type of observation.  This "type" is an entry in the TERM File (#704.101).  A
                                sample TERM ID here could reference the term "SYSTOLIC PRESSURE".  


704.117,.08   PATIENT_ID             0;8 POINTER TO PATIENT FILE (#2) (Required)

              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with an identifier for the PATIENT that correlates to this observation.  
              DESCRIPTION:
                                This identifies the PATIENT (file #2) for whom this observation (#.01) was taken.  

              RECORD INDEXES:   AS (#955), PT (#958)

704.117,.09   STATUS                 0;9 SET (Required)

                                '0' FOR Unverified; 
                                '1' FOR Verified; 
                                '2' FOR Archived; 
                                '3' FOR Purged; 
                                '4' FOR Corrected; 
                                '5' FOR Removed; 
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with the status of this observation.  
              DESCRIPTION:
                                This field indicates the current status of this observation (#.01).  

              FIELD INDEX:      ASTATUS (#1328)    MUMPS        ACTION
                  Short Descr:  Used to trigger MD OBSERVATION UPDATE protocol
                  Description:  This index invokes the MD OBSERVATION UPDATE protocol when the status of OBS data is changed to or
                                from verified.  No actual cross-reference nodes are set or killed.  
                    Set Logic:  D:((X1="1")!(X2="1")) PROT^MDCPROTD Q
                   Kill Logic:  Q
                   Whole Kill:  Q
                         X(1):  STATUS  (704.117,.09)

              RECORD INDEXES:   APXRM (#954), AS (#955), AUV (#956)

704.117,.1    SVALUE                 .1;1 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>250!($L(X)<1) X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer must be 1-250 characters in length. 
              DESCRIPTION:
                                This field represents the value of the observation (#.01).       A sample SVALUE could be "122/55". 


704.117,.21   SOURCE                 .2;1 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>50!($L(X)<1) X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer must be 1-50 characters in length. 
              DESCRIPTION:      This field is the source of the SVALUE (#.1). A sample SOURCE could be "instrument" or "CP
                                Flowsheets".  


704.117,.22   SOURCE_COMMENTS        .2;2 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>50!($L(X)<1) X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer must be 1-50 characters in length. 
              DESCRIPTION:      This is any comment type information generated by the source about this observation (#.01).  A
                                sample SOURCE COMMENTS could be "Routine MDZCLIO Tag BUILD".  


704.117,.23   SOURCE_DATA_ITEM_ID    .2;3 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>50!($L(X)<1) X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer must be 1-50 characters in length. 
              DESCRIPTION:      This field contains source (#.21) generated information for later tagging.  A sample SOURCE DATA
                                ITEM ID could be "CPFLOWSHEETS.EXE:C13A6427".  


704.117,.24   SOURCE_VERSION         .2;4 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>50!($L(X)<1) X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer must be 1-50 characters in length. 
              DESCRIPTION:      This is the version of the source (#.21) that generated this observation (#.01).  A sample SOURCE
                                VERSION could be " 1.0".  


704.117,.25   ENTERED_DATE_TIME      .2;5 DATE (Required)

              INPUT TRANSFORM:  S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Enter the data and time this observation was entered. 
              DESCRIPTION:
                                This is the date and time this entry was placed into this observation file.  


704.117,.26   ENTERED_BY_ID          .2;6 POINTER TO NEW PERSON FILE (#200)

              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with an identifier for the person that submitted the observation to this file. 
              DESCRIPTION:
                                This identifies the person (file #200) who entered the data for this observation (#.01).  


704.117,.27   CHILD_ORDER            .2;7 NUMBER

              INPUT TRANSFORM:  K:+X'=X!(X>999)!(X<1)!(X?.E1"."1N.N) X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Type a Number between 1 and 999, 0 Decimal Digits 
              DESCRIPTION:
                                This is the order that this observation is placed into its parent observation (#.02). 

              RECORD INDEXES:   AP (#953)

704.117,.28   RANGE                  .2;8 SET

                                '0' FOR Unknown; 
                                '1' FOR Normal; 
                                '2' FOR Out Of Bounds Low; 
                                '3' FOR Out Of Bounds High; 
                                '4' FOR Low; 
                                '5' FOR High; 
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with the condition of this observation value.  
              DESCRIPTION:
                                This indicates the condition of the observation value (#.1).  


704.117,.4    COMMENT                .4;1 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>250!($L(X)<1) X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer must be 1-250 characters in length. 
              DESCRIPTION:
                                This is free-text for additional clinical COMMENT.  A sample COMMENT could be "test O2 saturation".  


704.117,.911  AUDIT_EXISTS            ;  COMPUTED

              MUMPS CODE:       S X=($D(^MDC(704.119,"ALOG",D0))>0) S X=$J(X,0,0)
              ALGORITHM:        S X=($D(^MDC(704.119,"ALOG",D0))>0)  (ALWAYS 0 DECIMAL DIGITS)
              LAST EDITED:      APR 23, 2009 
              DESCRIPTION:
                                This indicates whether or not any record exist in the audit log for this observation.  


704.117,.912  CORRECTION_FOR_ID       ;  COMPUTED

              MUMPS CODE:       S X=$P($G(^MDC(704.117,+$O(^MDC(704.119,"APREV",D0,0)),0)),U)
              ALGORITHM:        S X=$P($G(^MDC(704.117,+$O(^MDC(704.119,"APREV",D0,0)),0)),U)
              LAST EDITED:      APR 23, 2009 
              DESCRIPTION:
                                This identifies the record this observation was entered to correct.  



      FILES POINTED TO                      FIELDS

DOMAIN (#4.2)                     FACILITY_ID (#.03)

HOSPITAL LOCATION (#44)           HOSPITAL_LOCATION_ID (#.04)

NEW PERSON (#200)                 OBSERVED_BY_ID (#.06)
                                  ENTERED_BY_ID (#.26)

OBS (#704.117)                    PARENT_ID (#.02)

PATIENT (#2)                      PATIENT_ID (#.08)

TERM (#704.101)                   TERM_ID (#.07)


File #704.117

  Record Indexes:

  AP (#953)    RECORD    REGULAR    IR    SORTING ONLY
      Short Descr:  X-Ref on Parent Observation
      Description:  This provides a quick sorting of parent and child observations.  
        Set Logic:  S ^MDC(704.117,"AP",$E(X(1),1,30),$E(X(2),1,30),DA)=""
       Kill Logic:  K ^MDC(704.117,"AP",$E(X(1),1,30),$E(X(2),1,30),DA)
       Whole Kill:  K ^MDC(704.117,"AP")
             X(1):  PARENT_ID  (704.117,.02)  (Subscr 1)  (Len 30)  (forwards)
             X(2):  CHILD_ORDER  (704.117,.27)  (Subscr 2)  (Len 30)  (forwards)

  APXRM (#954)    RECORD    MUMPS    IR    ACTION
      Short Descr:  Used to maintain the Clinical Reminders Index
      Description:  This index, along with Clinical Flowsheets M routine PXRMONE^MDCLIO1, supports interfacing with the Clinical
                    Reminders application.  PXRMONE^MDCLIO1 maintains the following indexes, with "obs"=observation and
                    "guid"=global unique identifier: 
                     
                     
                    ^PXRMINDX(120.5,"PI",patient ien, vital measurement ien, obs date/time, obs guid)="" 
                     
                    ^PXRMINDX(120.5,"IP",vital measurement ien, patient ien, obs date/time, obs guid)="" 
        Set Logic:  D PXRMONE^MDCLIO1(DA)
       Kill Logic:  Q
             X(1):  STATUS  (704.117,.09)  (Subscr 1)  (Len 30)  (forwards)

  AS (#955)    RECORD    REGULAR    IR    SORTING ONLY
      Short Descr:  By Status, Patient, Observed Date/Time
      Description:  This provides a quick reference for the status of a patient's observations, and the time of that observation.  
        Set Logic:  S ^MDC(704.117,"AS",$E(X(1),1,1),$E(X(2),1,30),$E(X(3),1,20),DA)=""
       Kill Logic:  K ^MDC(704.117,"AS",$E(X(1),1,1),$E(X(2),1,30),$E(X(3),1,20),DA)
       Whole Kill:  K ^MDC(704.117,"AS")
             X(1):  STATUS  (704.117,.09)  (Subscr 1)  (Len 1)  (forwards)
             X(2):  PATIENT_ID  (704.117,.08)  (Subscr 2)  (Len 30)  (forwards)
             X(3):  OBSERVED_DATE_TIME  (704.117,.05)  (Subscr 3)  (Len 20)  (forwards)

  AUV (#956)    RECORD    REGULAR    IR    SORTING ONLY
      Short Descr:  Index of all unverified observations for nightly cleanup
        Set Logic:  S ^MDC(704.117,"AUV",$E(X(1),1,1),$E(X(2),1,20),DA)=""
         Set Cond:  S X=(X(1)=0)
       Kill Logic:  K ^MDC(704.117,"AUV",$E(X(1),1,1),$E(X(2),1,20),DA)
        Kill Cond:  S X=1
       Whole Kill:  K ^MDC(704.117,"AUV")
             X(1):  STATUS  (704.117,.09)  (Subscr 1)  (Len 1)  (forwards)
             X(2):  OBSERVED_DATE_TIME  (704.117,.05)  (Subscr 2)  (Len 20)  (forwards)

  PT (#958)    RECORD    REGULAR    IR    LOOKUP & SORTING
      Short Descr:  Patient, Observed Date/Time
      Description:  This provides a quick sorting of a patient's observations by when they occurred.  
        Set Logic:  S ^MDC(704.117,"PT",$E(X(1),1,30),$E(X(2),1,30),DA)=""
       Kill Logic:  K ^MDC(704.117,"PT",$E(X(1),1,30),$E(X(2),1,30),DA)
       Whole Kill:  K ^MDC(704.117,"PT")
             X(1):  PATIENT_ID  (704.117,.08)  (Subscr 1)  (Len 30)  (forwards)
             X(2):  OBSERVED_DATE_TIME  (704.117,.05)  (Subscr 2)  (Len 30)  (forwards)


INPUT TEMPLATE(S):

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):