STANDARD DATA DICTIONARY #403.5 -- RECALL REMINDERS FILE                                                          3/24/25    PAGE 1
STORED IN ^SD(403.5,  *** NO DATA STORED YET ***   SITE: WWW.BMIRWIN.COM   UCI: VISTA,VISTA                        (VERSION 5.3)   

DATA          NAME                  GLOBAL        DATA
ELEMENT       TITLE                 LOCATION      TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file contains records for all active Recall Reminders. Once a patient has called to make an appointment, the entry is then
moved from this file to RECALL REMINDERS REMOVED file. Patients should not be entered into this file when their future appoitment
is less than 30 days.  The records are maintained by Recall Date and patient name.  


              DD ACCESS: @
              RD ACCESS: 
              WR ACCESS: 
             DEL ACCESS: @
           LAYGO ACCESS: @
           AUDIT ACCESS: @
IDENTIFIED BY: CLINIC (#4.5)[R], RECALL DATE (#5)[R]

POINTED TO BY: APPT REQUEST TYPE field (#.22) of the SDEC APPOINTMENT File (#409.84) 
               SDEC REQUEST POINTER field (#2.3) of the SDEC CONTACT File (#409.86) 
               

CROSS
REFERENCED BY: PATIENT NAME(B), PROVIDER(C), RECALL DATE(D), CLINIC(E)

INDEXED BY:    PATIENT NAME (A66201), DATE/TIME RECALL ADDED & USER WHO ENTERED RECALL (AC)


    LAST MODIFIED: JAN 20,2025@15:57:08

403.5,.01     PATIENT NAME           0;1 POINTER TO PATIENT FILE (#2) (Required)

              LAST EDITED:      NOV 21, 2024 
              HELP-PROMPT:      Enter the name of the Patient you wish to enter a Recall for. 
              DESCRIPTION:
                                Recall Reminder patient name this is a pointer to the patient file #2.  

              CROSS-REFERENCE:  403.5^B 
                                1)= S ^SD(403.5,"B",$E(X,1,30),DA)=""
                                2)= K ^SD(403.5,"B",$E(X,1,30),DA)
                                Used for checking to see if the patient is in the Recall file and display recall information before
                                a new entry is made.  


              FIELD INDEX:      A66201 (#823)    MUMPS    IR    ACTION
                  Short Descr:  Save copy of record before deletion.
                  Description:  Before deleting a record from this file, save a copy of it in file 403.56.  Deletion can be either
                                because a clerk deletes a patient from the recall list, or because a patient has been given an
                                appointment in a clinic requested by the recall list and therefore is deleted by the nightly job. 
                                We save this information so that we can look back at appointments given to patients and see how
                                timely the appointments were.  
                    Set Logic:  Q
                   Kill Logic:  D DELETE^SDRRISRU
                    Kill Cond:  S X=(X1'=""&(X2=""))
                         X(1):  PATIENT NAME  (403.5,.01)  (forwards)


403.5,2       ACCESSION#             0;3 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>25!($L(X)<1) X
              LAST EDITED:      JUL 15, 2008 
              HELP-PROMPT:      Answer must be 1-25 characters in length. 
              DESCRIPTION:
                                This is the lab order number or the lab accession number if known.  


403.5,2.5     COMMENT                0;7 FREE TEXT (audited)

              INPUT TRANSFORM:  K:$L(X)>80!($L(X)<1) X
              LAST EDITED:      NOV 02, 2016 
              HELP-PROMPT:      Answer must be 1-80 characters in length. 
              DESCRIPTION:
                                Comments needed for this recall entry. 

              AUDIT:            YES, ALWAYS

403.5,2.6     FAST/NON-FASTING       0;8 SET (audited)

                                'f' FOR FASTING; 
                                'n' FOR NON-FASTING; 
              LAST EDITED:      NOV 02, 2016 
              HELP-PROMPT:      Are the labs Fasting or Non-Fasting? leave blank if no labs have been ordered. 
              DESCRIPTION:      If the  patient has had lab tests ordered for this recall visit, select either Fasting or
                                Non-Fasting labs. If the patient has no labs orders leave blank.  

              AUDIT:            YES, ALWAYS

403.5,2.7     COMMENT AUDIT          2;0 DATE Multiple #403.57 (Add New Entry without Asking)

              DESCRIPTION:      This multiple will audit the COMMENT (#2.5) field by tracking each update including the additional
                                comment entered, the date/time it was entered, and the user who had entered the comment.  

              TECHNICAL DESCR:  This sub-file should only be updated indirectly using the VSE GUI or ISS applications, and not
                                directly via FileMan.  


403.57,.01      DATE/TIME COMMENT ADDED 0;1 DATE

                INPUT TRANSFORM:  S %DT="ET" D ^%DT S X=Y K:Y<1 X
                LAST EDITED:      NOV 21, 2024 
                HELP-PROMPT:      Please enter the date/time the comment was added. 
                DESCRIPTION:
                                  The date/time the new comment was added to the COMMENT (#2.5) field.  

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


403.57,1        COMMENT ADDED BY       0;2 POINTER TO NEW PERSON FILE (#200)

                LAST EDITED:      NOV 21, 2024 
                HELP-PROMPT:      Please enter the user who had entered the new comment. 
                DESCRIPTION:
                                  The DUZ of the user who had added the new comment to the COMMENT (#2.5) field.  


403.57,2        COMMENT                0;3 FREE TEXT

                INPUT TRANSFORM:  K:$L(X)>80!($L(X)<3) X
                MAXIMUM LENGTH:   80
                LAST EDITED:      NOV 21, 2024 
                HELP-PROMPT:      Answer must be 3-80 characters in length. 
                DESCRIPTION:
                                  The new comment being added to the COMMENT (#2.5) field.  




403.5,3       TEST/APP.              0;4 POINTER TO RECALL REMINDERS APPT TYPE FILE (#403.51) (Required) (audited)

              LAST EDITED:      NOV 02, 2016 
              HELP-PROMPT:      Select the type of Recall visit 
              DESCRIPTION:
                                This is the type of Recall Visit that is assigned for this entry.  

              AUDIT:            YES, ALWAYS

403.5,4       PROVIDER               0;5 POINTER TO RECALL REMINDERS PROVIDERS FILE (#403.54) (Required) (audited)

              LAST EDITED:      NOV 02, 2016 
              HELP-PROMPT:      Select the provider for this Recall entry. 
              DESCRIPTION:
                                The provider who is assigned for this Recall entry.  

              AUDIT:            YES, ALWAYS
              CROSS-REFERENCE:  403.5^C 
                                1)= S ^SD(403.5,"C",$E(X,1,30),DA)=""
                                2)= K ^SD(403.5,"C",$E(X,1,30),DA)
                                Used for printing of the cards/letter and reports by Provider or Recall Team.  



403.5,4.5     CLINIC                 0;2 POINTER TO HOSPITAL LOCATION FILE (#44) (Required) (audited)

              LAST EDITED:      NOV 02, 2016 
              HELP-PROMPT:      Select the clinic that this Recall will be linked to. 
              DESCRIPTION:
                                This is the Hospital Location which this patient will have the Recall entry assigned. 

              AUDIT:            YES, ALWAYS
              CROSS-REFERENCE:  403.5^E 
                                1)= S ^SD(403.5,"E",$E(X,1,30),DA)=""
                                2)= K ^SD(403.5,"E",$E(X,1,30),DA)
                                Used during the display of Recall information and for selecting the printing of cards/letters,
                                Also, used in selecting reports printed by Recall clinic.  



403.5,4.7     LENGTH OF APPT.        0;9 NUMBER (audited)

              INPUT TRANSFORM:  K:+X'=X!(X>120)!(X<10)!(X?.E1"."1N.N) X
              LAST EDITED:      NOV 02, 2016 
              HELP-PROMPT:      Type a Number between 10 and 120, 0 Decimal Digits 
              DESCRIPTION:
                                The length of appointment (in minutes) that will be required once scheduled.  

              AUDIT:            YES, ALWAYS

403.5,5       RECALL DATE            0;6 DATE (Required)

              INPUT TRANSFORM:  S %DT="EFX",%DT(0)=$$FMADD^XLFDT(DT,1) D ^%DT K %DT(0) S X=Y K:Y<1 X
              LAST EDITED:      JAN 14, 2016 
              HELP-PROMPT:      Enter the Recall Date that the provider has requested for this patient. 
              DESCRIPTION:      Recall Date is a date the provider has requested the patient to return. This must be a future exact
                                date.  

                                UNEDITABLE
              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER

              CROSS-REFERENCE:  403.5^D 
                                1)= S ^SD(403.5,"D",$E(X,1,30),DA)=""
                                2)= K ^SD(403.5,"D",$E(X,1,30),DA)
                                Used in selecting a date range for printing Recall cards/letters and in all Recall reports.  


              CROSS-REFERENCE:  ^^TRIGGER^403.5^7 
                                1)= K DIV S DIV=X,D0=DA,DIV(0)=D0 S Y(1)=$S($D(^SD(403.5,D0,0)):^(0),1:"") S X=$P(Y(1),U,11),X=X S 
                                DIU=X K Y S X=DIV S X=DUZ S DIH=$G(^SD(403.5,DIV(0),0)),DIV=X S $P(^(0),U,11)=DIV,DIH=403.5,DIG=7 D
                                 ^DICR

                                2)= Q

                                CREATE VALUE)= S X=DUZ
                                DELETE VALUE)= NO EFFECT
                                FIELD)= #7
                                Used to update USER THAT ENTER RECALL field #7 



403.5,5.5     RECALL DATE (PER PATIENT) 0;12 DATE

              INPUT TRANSFORM:  S %DT="EFX",%DT(0)=$$FMADD^XLFDT(DT,1) D ^%DT K %DT(0) S X=Y K:Y<1 X
              LAST EDITED:      JAN 14, 2016 
              HELP-PROMPT:      Enter the Date that the patient is requesting for their Recall Visit. 
              DESCRIPTION:      This is the Recall Date that the patient is requesting. It can be different from the Recall Date,
                                which is what the Provider has requested. This must be a future exact date.  

                                UNEDITABLE
              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER


403.5,6       DATE REMINDER SENT     0;10 DATE

              INPUT TRANSFORM:  S %DT="E" D ^%DT S X=Y K:Y<1 X
              LAST EDITED:      JUL 15, 2008 
              HELP-PROMPT:      Date letter/card first printed. 
              DESCRIPTION:
                                This is the date that the first letter/card was printed and sent to the Veteran.  


403.5,7       USER WHO ENTERED RECALL 0;11 POINTER TO NEW PERSON FILE (#200)

              LAST EDITED:      APR 03, 2015 
              HELP-PROMPT:      New person who entered or edited Recall entry 
              DESCRIPTION:
                                User who enter or edit a Recall entry.  

              NOTES:            TRIGGERED by the RECALL DATE field of the RECALL REMINDERS File 

              RECORD INDEXES:   AC (#1354)

403.5,7.5     DATE/TIME RECALL ADDED 0;14 DATE

              INPUT TRANSFORM:  S %DT="ET" D ^%DT S X=Y K:(Y<1)!(X>$E($$NOW^XLFDT,1,12)) X
              LAST EDITED:      JAN 14, 2016 
              HELP-PROMPT:      Enter a date and time not in the future 
              DESCRIPTION:
                                Date and Time this recall reminder was added. Cannot be in the future.  

                                UNEDITABLE
              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER

              RECORD INDEXES:   AC (#1354)

403.5,8       SECOND PRINT           0;13 DATE

              INPUT TRANSFORM:  S %DT="E" D ^%DT S X=Y K:Y<1 X
              LAST EDITED:      JUL 15, 2008 
              HELP-PROMPT:      Date for second printing of card or letter 
              DESCRIPTION:
                                This is the date that the second letter/card was printed and sent.  


403.5,100     EAS TRACKING NUMBER    1;1 FREE TEXT (audited)

              INPUT TRANSFORM:  K:$L(X)>40!($L(X)<1) X
              MAXIMUM LENGTH:   40
              LAST EDITED:      DEC 23, 2021 
              HELP-PROMPT:      Answer must be 1-40 characters in length. 
              DESCRIPTION:      The EAS tracking number originates from the Enterprise Appointment Scheduling system. This number
                                allows actions performed by a proxy user to be traceable back to the end user.  

              AUDIT:            YES, ALWAYS


      FILES POINTED TO                      FIELDS

HOSPITAL LOCATION (#44)           CLINIC (#4.5)

NEW PERSON (#200)                 USER WHO ENTERED RECALL (#7)
                                  COMMENT AUDIT:COMMENT ADDED BY (#1)

PATIENT (#2)                      PATIENT NAME (#.01)

RECALL REMINDERS APPT TYPE 
                   (#403.51)      TEST/APP. (#3)

RECALL REMINDERS PROVIDERS 
                   (#403.54)      PROVIDER (#4)


File #403.5

  Record Indexes:

  AC (#1354)    RECORD    REGULAR    IR    SORTING ONLY
      Short Descr:  Index by DATE/TIME RECALL ADDED and USER WHO ENTERED RECALL
      Description:  This cross reference is used to sort by DATE/TIME RECALL ADDED and USER WHO ENTERED RECALL.  
        Set Logic:  S ^SD(403.5,"AC",X(1),X(2),DA)=""
       Kill Logic:  K ^SD(403.5,"AC",X(1),X(2),DA)
       Whole Kill:  K ^SD(403.5,"AC")
             X(1):  DATE/TIME RECALL ADDED  (403.5,7.5)  (Subscr 1)  (forwards)
             X(2):  USER WHO ENTERED RECALL  (403.5,7)  (Subscr 2)  (forwards)


INPUT TEMPLATE(S):
SDRR RECALL CARD ADD          JAN 21, 2016@21:30  USER #0    
SDRREMARKS                    FEB 22, 2008@09:41  USER #0    

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):