STANDARD DATA DICTIONARY #748 -- SURVEY FILE                                                                      6/27/25    PAGE 1
STORED IN ^QA(748,  *** NO DATA STORED YET ***   SITE: WWW.BMIRWIN.COM   UCI: VISTA,VISTA                          (VERSION 2.0)   

DATA          NAME                  GLOBAL        DATA
ELEMENT       TITLE                 LOCATION      TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This is the QA survey generator file.  


IDENTIFIED BY: DEVELOPER (#.055)[R]

POINTED TO BY: SURVEY field (#.01) of the NURQ QI SUMMARY File (#217) 
               SURVEY field (#.01) of the SURVEY QUESTIONS File (#748.25) 
               SURVEY field (#.01) of the SURVEY RESPONSE DATA File (#748.3) 
               

CROSS
REFERENCED BY: AUTHORIZED EDITORS(AB), NAME(B)



748,.01       NAME                   0;1 FREE TEXT (Required)

              INPUT TRANSFORM:  K:X[""""!($A(X)=45) X I $D(X) S X=$TR(X,"abcdefghijklmnopqrstuvwxyz","ABCDEFGHIJKLMNOPQRSTUVWXYZ") 
                                K:$L(X)>45!($L(X)<3)!'(X'?1P.E) X
              LAST EDITED:      FEB 03, 1995 
              HELP-PROMPT:      Answer must be 3-45 characters in length. 
              DESCRIPTION:
                                This is the name of the survey, as the survey author will refer to it.  

              DELETE TEST:      1,0)= I 1 W !,*7,"ENTRIES CANNOT BE DELETED!"

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

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


748,.015      TITLE                  0;6 FREE TEXT (Required)

              INPUT TRANSFORM:  K:$L(X)>50!($L(X)<5) X
              LAST EDITED:      MAY 31, 1995 
              HELP-PROMPT:      Answer must be 5-50 characters in length. 
              DESCRIPTION:
                                This is title for the survey, which will be displayed on all outputs such as printouts and screens. 


748,.02       STATION OF SURVEY DEVELOPER 0;2 FREE TEXT (Required)

              INPUT TRANSFORM:  K:$L(X)>3!($L(X)<3)!'(X?3N) X
              LAST EDITED:      NOV 04, 1994 
              HELP-PROMPT:      This is the station number of the developer. [3 numbers] 
              DESCRIPTION:      This is the station of the person who developed the survey.  It is a free text field to allow for
                                survey exportation and importation.  


748,.03       LAST DATE FOR USAGE    0;3 DATE

              INPUT TRANSFORM:  S %DT(0)="T+.5" S %DT="EX" D ^%DT S X=Y K:Y<1 X K %DT(0)
              LAST EDITED:      NOV 09, 1994 
              HELP-PROMPT:      Enter the last date the survey may be filled out.  If not filled in the survey will be active 
                                indefinitely. 
              DESCRIPTION:
                                This is the last date a survey may be participated in by anyone.  

              EXECUTABLE HELP:  W !,?5,"The date must be in the future.",!!
              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER


748,.04       PASSWORD               0;7 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>40!($L(X)<1) X
              OUTPUT TRANSFORM: NOT EXECUTABLE!!  -- SPECIFIER NEEDS AN "O"!
              LAST EDITED:      JAN 18, 1995 
              HELP-PROMPT:      Answer must be 1-40 characters in length. 
              DESCRIPTION:      A password attached to a survey will limit the participation to those who know it.  It is used to
                                segregate participation to a group of people.  

              EXECUTABLE HELP:  D HELP4^QAPUTIL2
              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER


748,.05       STATUS                 0;4 SET (Required)

                                'r' FOR READY FOR USE; 
                                'd' FOR UNDER MAINTENANCE/DEVELOPMENT; 
                                'e' FOR ACTIVE LIFE EXPIRED; 
              LAST EDITED:      MAY 25, 1995 
              HELP-PROMPT:      Select a code from the list.  Use ?? for help. 
              DESCRIPTION:      This is the current state of the survey: 
                                 
                                   r - Ready for use 
                                   d - Under development/maintenance 
                                   e - Active life expired (the date for last usage has passed) 

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


748,.055      DEVELOPER              0;5 POINTER TO NEW PERSON FILE (#200) (Required)

              LAST EDITED:      NOV 04, 1994 
              HELP-PROMPT:      The name of the person who developed this survey. 
              DESCRIPTION:      This is the name of the person who developed the survey.  It is a pointer to file 200 and is not
                                exportable.  


748,.08       INSTRUCTIONS FOR USE   4;0   WORD-PROCESSING #748.12

              LAST EDITED:      OCT 25, 1994 
              DESCRIPTION:      The instructions for use field should contain anything that the survey participants need to know in
                                order to take the survey.  It is up to the survey creator to assure that the instructions are
                                adequate, and that the essential things are present.  


                LAST EDITED:      OCT 25, 1994 
                HELP-PROMPT:      Enter the specific instructions as they are to appear on the survey. 
                DESCRIPTION:
                                  The specific instructions as they pertain to the survey.  




748,.1        ARE ALL DEMOGRAPHICS REQUIRED? 0;8 SET

                                'y' FOR YES; 
                                'n' FOR NO; 
              LAST EDITED:      MAR 04, 1995 
              HELP-PROMPT:      Enter Y if all demographics will be required or N if not. 
              DESCRIPTION:      This field is used as a "master switch" to indicate that the participants must always complete all
                                demographics.  This field is overridden by the individual demographic field which indicates whether
                                or not a demographic is required.  For example this field may be set to NO but an individual
                                demographic field may be set to YES to force an answer perhaps just for one item.  

              EXECUTABLE HELP:  W !,"If this field is set to 'y' for YES, it will override the individual field which sets up demog
                                raphics for each question.",!

748,1         DESCRIPTION            2;0   WORD-PROCESSING #748.01

              LAST EDITED:      OCT 25, 1994 

                LAST EDITED:      OCT 25, 1994 



748,2         AUTHORIZED EDITORS     5;0 POINTER Multiple #748.02

              DESCRIPTION:      This field will allow any person whose name is entered to perform any actions on a survey that
                                would normally be done by the survey creator.  


748.02,.01      AUTHORIZED EDITORS     0;1 POINTER TO NEW PERSON FILE (#200) (Multiply asked)

                LAST EDITED:      NOV 10, 1994 
                HELP-PROMPT:      Enter the name(s) of the person(s) you are authorizing to edit this survey. 
                CROSS-REFERENCE:  748.02^B 
                                  1)= S ^QA(748,DA(1),5,"B",$E(X,1,30),DA)=""
                                  2)= K ^QA(748,DA(1),5,"B",$E(X,1,30),DA)

                CROSS-REFERENCE:  748^AB 
                                  1)= S ^QA(748,"AB",$E(X,1,30),DA(1),DA)=""
                                  2)= K ^QA(748,"AB",$E(X,1,30),DA(1),DA)
                                  This allows quick look up of authorized editors.  





748,3         DEMOGRAPHIC DATA ITEM  1;0 Multiple #748.03 (Add New Entry without Asking)

              LAST EDITED:      NOV 26, 1994 
              DESCRIPTION:      This field will contain any items which the survey creator will want to know about for
                                demographical purposes.  Examples would be race, age, date of birth, job type, etc.  For
                                consistency purposes any item entered here which will be used for reporting must be marked as a
                                required answer.  


748.03,.01      DEMOGRAPHIC DATA ITEM  0;1 FREE TEXT

                INPUT TRANSFORM:  K:$L(X)>40!($L(X)<3) X
                LAST EDITED:      NOV 26, 1994 
                HELP-PROMPT:      Answer must be 3-40 characters in length. 
                EXECUTABLE HELP:  D HELP3^QAPUTIL2
                CROSS-REFERENCE:  748.03^B 
                                  1)= S ^QA(748,DA(1),1,"B",$E(X,1,30),DA)=""
                                  2)= K ^QA(748,DA(1),1,"B",$E(X,1,30),DA)


748.03,1        TYPE                   0;2 SET (Required)

                                  'd' FOR DATE; 
                                  'p' FOR POINTER; 
                                  's' FOR SET OF CODES; 
                                  'f' FOR FREE TEXT; 
                LAST EDITED:      NOV 28, 1994 
                HELP-PROMPT:      Enter the type of answer selection this question will have.  Use ?? for help. 
                TECHNICAL DESCR:
                                  This is the kind of demographic item it is, date, pointer to a file, set of codes or free text.  


748.03,2        FILE                   0;3 POINTER TO DEMOGRAPHIC REFERENCE FILE (#748.2) (Required)

                INPUT TRANSFORM:  S DIC("S")="D SCREEN^QAPFILE" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
                LAST EDITED:      MAY 30, 1995 
                HELP-PROMPT:      Enter the name of the file you wish to reference for demographics..  This is a mandatory field. 
                DESCRIPTION:      If the demographic is a pointer, this field will hold a pointer to the DEMOGRAPHIC REFERENCE
                                  file, which in turn points to file 1.  Care should be taken to use only non-sensitive files.  

                SCREEN:           S DIC("S")="D SCREEN^QAPFILE"
                EXPLANATION:    You may only use files for which you have VA FileMan access.  If you cannot use the file you select
                                ed, this entry should be deleted.

748.03,3        CODE                 1;0 Multiple #748.33 (Add New Entry without Asking)

                DESCRIPTION:
                                If the type is a code, this field has the actual code as it will be presented to the participant.  


748.33,.01        CODE                 0;1 FREE TEXT (Required) (Multiply asked)

                  INPUT TRANSFORM:K:$L(X)>5!($L(X)<1) X
                  LAST EDITED:    NOV 14, 1994 
                  HELP-PROMPT:    Answer must be 1-5 characters in length. 
                  CROSS-REFERENCE:748.33^B 
                                  1)= S ^QA(748,DA(2),1,DA(1),1,"B",$E(X,1,30),DA)=""
                                  2)= K ^QA(748,DA(2),1,DA(1),1,"B",$E(X,1,30),DA)


748.33,1          CODE MEANING         0;2 FREE TEXT

                  INPUT TRANSFORM:K:$L(X)>35!($L(X)<1) X
                  LAST EDITED:    NOV 12, 1994 
                  HELP-PROMPT:    Enter the code's meaning.  [1-35 characters] 
                  DESCRIPTION:    This field has the code interpretation.  Example:  if the actual code is O, it may mean something
                                  like OTHER.  




748.03,4        IS THIS A REQUIRED ANSWER? 0;4 SET

                                  'y' FOR YES; 
                                  'n' FOR NO; 
                  LAST EDITED:    MAR 04, 1995 
                  HELP-PROMPT:    Enter 'y' for YES if answering this item will be required, or 'n' if it will not be required. 
                  DESCRIPTION:    If the demographic entry will be required by the user, this field should be set to YES.  If not
                                  required, it may be left blank or contain NO.  This field overrides the field ARE ALL
                                  DEMOGRAPHICS REQUIRED if it indicates that all demographics are required and the creator wishes
                                  to make only one demographic of many required.  

                  EXECUTABLE HELP:W !,"This field may be overridden by answering the 'demographic required' question on the survey 
                                basic data to YES.",!



748,4         MULTI-ENTRY PASSWORD   0;9 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>40!($L(X)<1) X
              OUTPUT TRANSFORM: NOT EXECUTABLE!!  -- SPECIFIER NEEDS AN "O"!
              LAST EDITED:      JAN 18, 1995 
              HELP-PROMPT:      Answer must be 1-40 characters in length. 
              DESCRIPTION:      The participant must know this password to enter more than one survey response.  This field is used
                                to allow certain groups to use surveys frequently as in Nursing patient care surveys, yet keep
                                others from accessing them.  

              EXECUTABLE HELP:  W !!,"This is the password which will allow users to participate",!,"in a survey more than one time
                                .",!
              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER


748,5         STATISTICS VIEW STATUS 0;10 SET (Required)

                                'c' FOR CREATOR/EDITORS ONLY; 
                                'n' FOR NO RESTRICTIONS; 
              LAST EDITED:      JAN 13, 1995 
              HELP-PROMPT:      Enter c to allow viewing by only the creator or editors or n to have no restrictions at all. 
              DESCRIPTION:      This field is used to limit who may see the statistics which may be produced for a given survey. 
                                Normally only the creator or an authorized editor would have access but there may be instances
                                where the creator wishes the public to view the statistics as well.  



      FILES POINTED TO                      FIELDS

DEMOGRAPHIC REFERENCE (#748.2)    DEMOGRAPHIC DATA ITEM:FILE (#2)

NEW PERSON (#200)                 DEVELOPER (#.055)
                                  AUTHORIZED EDITORS:AUTHORIZED EDITORS (#.01)



INPUT TEMPLATE(S):

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):