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):