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

DATA          NAME                  GLOBAL        DATA
ELEMENT       TITLE                 LOCATION      TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file supports Clinical Flowsheets scheduled tasks and actions functionality.  


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

PRIMARY KEY:        A (#113)
  Uniqueness Index: PK (#964)
       File, Field: 1) ID (704.121,.01)

POINTED TO BY: CARE_ACTION_ID field (#.02) of the CP_KARDEX_EVENTS File (#704.1211) 
               ACTION_ID field (#.01) of the CP_KARDEX_AUDIT File (#704.1212) 
               


INDEXED BY:    STATUS & PATIENT_ID (ASTATUS), ID (PK), PATIENT_ID & STATUS (PTSTATUS), PATIENT_ID & STOP_DATE_TIME &
               START_DATE_TIME (PTSTOP)




704.121,.01   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 action.  
              DESCRIPTION:      This value is the Global Unique IDentifier (GUID) for this entry. This value is maintained
                                nationally and is the same throughout the enterprise.  A sample ID could be
                                "{2E0C516D-3858-4A1F-A2F3-BF0AB9E3A7FC}".  

              FIELD INDEX:      PK (#964)    REGULAR    IR    LOOKUP & SORTING
                   Unique for:  Key A (#113), File #704.121
                  Short Descr:  Uniqueness Index for Key 'A' of File #704.121
                  Description:  This will provide a quick index of unique file entries.  
                    Set Logic:  S ^MDC(704.121,"PK",$E(X,1,38),DA)=""
                   Kill Logic:  K ^MDC(704.121,"PK",$E(X,1,38),DA)
                   Whole Kill:  K ^MDC(704.121,"PK")
                         X(1):  ID  (704.121,.01)  (Subscr 1)  (Len 38)


704.121,.02   TASK_ID                0;2 POINTER TO TERM FILE (#704.101) (Required)

              INPUT TRANSFORM:  S DIC("S")="I $$SCREEN^MDTERM(+Y,9)" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with an identifier for a task. 
              DESCRIPTION:
                                This identifies a task in the TERM File (#704.101).  

              SCREEN:           S DIC("S")="I $$SCREEN^MDTERM(+Y,9)"
              EXPLANATION:      Allow only active terms of type TASK

704.121,.03   SCHEDULE_ID            0;3 POINTER TO CP_SCHEDULE FILE (#704.008) (Required)

              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with a schedule identifier for this task.  
              DESCRIPTION:
                                This identifies the schedule (#704.008) to use with the task (#.02). 

              SCREEN:           S DIC("S")="I $$SCREEN^MDTERM(+Y,10)"
              EXPLANATION:      Only active schedules allowed.

704.121,.04   PATIENT_ID             0;4 POINTER TO PATIENT FILE (#2) (Required)

              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Answer with an identifier for the PATIENT related to this task.  
              DESCRIPTION:
                                This field identifies the patient (file #2) assigned to this task.  

              RECORD INDEXES:   ASTATUS (#963), PTSTATUS (#965), PTSTOP (#966)

704.121,.05   START_DATE_TIME        0;5 DATE (Required)

              INPUT TRANSFORM:  S %DT="ETXR" D ^%DT S X=Y K:Y<1 X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Enter the start date/time for this task. 
              DESCRIPTION:
                                This is the date/time the execution of this task is permitted.  

              RECORD INDEXES:   PTSTOP (#966)

704.121,.06   STOP_DATE_TIME         0;6 DATE (Required)

              INPUT TRANSFORM:  S %DT="ETXR" D ^%DT S X=Y K:Y<1 X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Enter the stop date/time for this task. 
              DESCRIPTION:
                                This is the date/time the execution of this task is no longer permitted.  

              RECORD INDEXES:   PTSTOP (#966)

704.121,.07   SCHEDULE_TYPE          0;7 SET (Required)

                                '0' FOR Continuous; 
                                '1' FOR PRN; 
                                '2' FOR One-Time; 
                                '3' FOR Stat; 
                                '4' FOR Now; 
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Select the type of schedule for this task. 
              DESCRIPTION:
                                This field indicates the type of schedule used for this task.  


704.121,.08   PRN_TYPE               0;8 SET (Required)

                                '0' FOR No PRN; 
                                '1' FOR PRN-And; 
                                '2' FOR PRN-AndNTE; 
                                '3' FOR PRN-Or; 
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Select the PRN option for this task. 
              DESCRIPTION:
                                This field indicates the Pro Re Nata (PRN) option for task.  


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

                                '0' FOR Active; 
                                '1' FOR Expired; 
                                '2' FOR Discontinued; 
                                '3' FOR Held; 
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Select the status of this task. 
              DESCRIPTION:
                                This field indicates the status of the task. 

              RECORD INDEXES:   ASTATUS (#963), PTSTATUS (#965)

704.121,.1    SPECIAL_INSTRUCTIONS   .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 is free-text for instructions for this particular task.  A sample SPECIAL INSTRUCTIONS could
                                be "Turn patient 90 degrees".  


704.121,.21   PRN_NTE_AMOUNT         .2;1 NUMBER

              INPUT TRANSFORM:  K:+X'=X!(X>999)!(X<0)!(X?.E1"."1N.N) X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Type a Number between 0 and 999, 0 Decimal Digits. 
              DESCRIPTION:      This field the maximum number of times this task should executed.  This field is used in the case
                                of tasks with a PRN option.  


704.121,.22   FIRST_SCHEDULED_TIME   .2;2 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>4!($L(X)<4)!'(X?4N) X
              LAST EDITED:      APR 23, 2009 
              HELP-PROMPT:      Enter, in the military time representation, the first time this task should be done. 
              DESCRIPTION:      This is the military time of the first time that this item should be executed once the start
                                date/time has been reached.  A sample FIRST SCHEDULED TIME could be "1330" to represent "01:30 PM"
                                as the first time this task should be executed.   


704.121,.3    CUSTOM_SCHEDULED_TIMES .3;E1,250 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 is a custom schedule.  If the user wished to modify the schedule for this task (#.02),
                                the schedule here in a military times.  A sample CUSTOM SCHEDULED TIMES could be
                                "0400,0800,1200,1600,2000".  



      FILES POINTED TO                      FIELDS

CP_SCHEDULE (#704.008)            SCHEDULE_ID (#.03)

PATIENT (#2)                      PATIENT_ID (#.04)

TERM (#704.101)                   TASK_ID (#.02)


File #704.121

  Record Indexes:

  ASTATUS (#963)    RECORD    REGULAR    IR    SORTING ONLY
      Short Descr:  Index by status and patient
      Description:  This provides a quick reference to actions/tasks for a patient by status.  
        Set Logic:  S ^MDC(704.121,"ASTATUS",$E(X(1),1,2),$E(X(2),1,30),DA)=""
       Kill Logic:  K ^MDC(704.121,"ASTATUS",$E(X(1),1,2),$E(X(2),1,30),DA)
       Whole Kill:  K ^MDC(704.121,"ASTATUS")
             X(1):  STATUS  (704.121,.09)  (Subscr 1)  (Len 2)  (forwards)
             X(2):  PATIENT_ID  (704.121,.04)  (Subscr 2)  (Len 30)  (forwards)

  PTSTATUS (#965)    RECORD    REGULAR    IR    LOOKUP & SORTING
      Short Descr:  Index by patient and status
      Description:  This provides a quick reference to actions/tasks for a status by patient.  
        Set Logic:  S ^MDC(704.121,"PTSTATUS",$E(X(1),1,30),$E(X(2),1,30),DA)=""
       Kill Logic:  K ^MDC(704.121,"PTSTATUS",$E(X(1),1,30),$E(X(2),1,30),DA)
       Whole Kill:  K ^MDC(704.121,"PTSTATUS")
             X(1):  PATIENT_ID  (704.121,.04)  (Subscr 1)  (Len 30)  (forwards)
             X(2):  STATUS  (704.121,.09)  (Subscr 2)  (Len 30)  (forwards)

  PTSTOP (#966)    RECORD    REGULAR    IR    LOOKUP & SORTING
      Short Descr:  Index by patient and stop date
      Description:  This provides a quick way to reference scheduled tasks by patient, stop date and start date.  
        Set Logic:  S ^MDC(704.121,"PTSTOP",$E(X(1),1,30),$E(X(2),1,30),$E(X(3),1,30),DA)=""
       Kill Logic:  K ^MDC(704.121,"PTSTOP",$E(X(1),1,30),$E(X(2),1,30),$E(X(3),1,30),DA)
       Whole Kill:  K ^MDC(704.121,"PTSTOP")
             X(1):  PATIENT_ID  (704.121,.04)  (Subscr 1)  (Len 30)  (forwards)
             X(2):  STOP_DATE_TIME  (704.121,.06)  (Subscr 2)  (Len 30)  (forwards)
             X(3):  START_DATE_TIME  (704.121,.05)  (Subscr 3)  (Len 30)  (forwards)


INPUT TEMPLATE(S):

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):