˙˙˙˙˙˙˙˙˙˙˙˙ ÜŪŪŪŪŪÜ ÜßßÜ ÜŪŪŪŪŪÜ ŽŪ ŪŪ ŪŪŪŪŪŪÜ ÜŪŪŪŪŪÜ ŪŪ ŪŪ ßÜÜß ŪŪÜÜÜŪŪ ŪŪÜÜŪŪÜ ŪŪ ŪŪ ŪŪÜÜÜŪŪ ŪŪ ßÜŪŪ Üß ßÜß ŪŪßßßŪŪ ßßßßŪŪß ŪŪŪŪŪŪ ŪŪßßßŪŪ ßŪŪŪŪßÜ ßÜ ÜßÜ ŪŪ ŪŪ ŪŪ ŪŪ ßŪŪ ŪŪ ŪŪ ßß ß Revision 11 Questions and Answers for RemoteAccess 2.x °°±±²² QUESTAIR.Q&A ²²±±°° Updated on 02/04/96 By: Eric Staufer The Concession Stand FidoNet 1:374/6568 Topics: Keywords: ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ o What can you do with a Questionnaire? ..... ** WHAT ** o General Parts of a Questionnaire .......... ** PARTS ** o Ask ................................ ** ASK ** o Assign ............................. ** ASSIGN ** o Capitalise ......................... ** CAPITAL ** o Commit ............................. ** COMMIT ** o ChangeColor ........................ ** COLOR ** o ClearScreen ........................ ** CLEAR ** o DefineOutput ....................... ** DEFINE ** o Display ............................ ** DISPLAY ** o DisplayFile ........................ ** DISPLAYFILE ** o EndIf .............................. ** ENDIF ** o Exec ............................... ** EXEC ** o GetChoice .......................... ** GETCHOICE ** o Goto ............................... ** GOTO ** o If ................................. ** IF ** o ListAnswer ......................... ** LISTANSWER ** o MenuCmnd ........................... ** MENUCMND ** o OutputAnswer ....................... ** OUTPUT ** o PostInfo ........................... ** POSTINFO ** o Quit ............................... ** QUIT ** o SetFlag ............................ ** FLAG ** o SetSecurity ........................ ** SECURITY ** o WaitEnter .......................... ** WAITENTER ** o HardCoded Questionnaires .................. ** HARDCODED ** ** WHAT ** What is a Questionnaire? ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ A Questionnaire (Q-A) is a script language file for RemoteAccess. You can ask questions within a questionnaire, and depending on the responce of a certain questionnaire, you can upgrade their security, give them certain flags, execute certain menu commands, and execute programs, or do the opposite of the above. Some people have even been known to create little programs with these questionnaires. Though, most of the SysOps use Questionnaires to obtain information from their users on their BBS, using them as polls and newuser questionnaires. For more information about 'What is a Questionnaire?' check page #236 of the RemoteAccess Documentation. ** PARTS ** General Parts of a Questionnaire ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Listed below in their each section are the different actions of a questionnaire file. I am not going to copy WORD for WORD from the RA.DOC. At the top of the header for each action, I will make a note saying: 'See Page #xxx / RA.DOC " For more information concerning the specific action. ** ASK ** Ask See Page #239 / RA.DOC ÄÄÄÄ ~~~~~~~~~~~~~~~~~~~~~~ Syntax: ASK Desc: Prompts the user to input an answer into the field. The is what to store the inputted information as. Example: Ask 35 1 In the above example, a user would have upto 35 characters to write down the answer to a question. The inputted information would be stored as variable #1. Assign See Page #239 / RA.DOC ÄÄÄÄÄÄÄ ~~~~~~~~~~~~~~~~~~~~~~ Syntax: ASSIGN <"text"> Desc: This stores the <"text"> of what you specified on the command line as a specific variable number. o Notice that the "text" must be in quotation marks. o Control Codes may be used in the place of the "text", but control codes do not need to be in quotation marks. Example: Assign 3 "Hello" This would simply store the word 'Hello' as variable #3. ** CAPITAL ** Capitalise See Page #239 / RA.DOC ÄÄÄÄÄÄÄÄÄÄÄ ~~~~~~~~~~~~~~~~~~~~~~ Syntax: CAPITALISE Desc: Turns on or off auto input capitalization. Default mode in a questionnaire is OFF. Example: Capitalise ON This would force the user's input to be all capitalized. To turn it back to normal mode, just use a Capitalise OFF. ** COMMIT ** See Line #133 / WHATSNEW.250 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Commit ÄÄÄÄÄÄÄ Syntax: COMMIT Desc: Immediately writes the answers to the output (answer) file. Instead of waiting for the questionnaire to be completed before writing all of the answers to the output file, with this new command, it will immediately add the answers to the output file. Example: Commit ** COLOR ** ChangeColor See Page #240 / RA.DOC ÄÄÄÄÄÄÄÄÄÄÄÄ ~~~~~~~~~~~~~~~~~~~~~~ Syntax: CHANGECOLOR Desc: Changes the color of the text, if the user has ANSi capabilities. The Color Codes are on page #181. Example: ChangeColor 10 0 This would change the text color to Bright Green on a Black Background. ** CLEAR ** ClearScreen See Page #240 / RA.DOC ÄÄÄÄÄÄÄÄÄÄÄÄ ~~~~~~~~~~~~~~~~~~~~~~ Syntax: CLEARSCREEN Desc: Clears the Screen if the user has screen clearing codes enabled. Example: ClearScreen Would simply clear the user's screen. ** DEFINE ** See Line #139 / WHATSNEW.250 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DefineOutPut ÄÄÄÄÄÄÄÄÄÄÄÄÄ Syntax: DefineOutPut c:\path\to\output.txt Desc: This command which is optional, will put all of the output from the questionnaire into the specified file and path. Normally, if this command is not specified, RA will automatically generate the output file as the name of the questionnaire with the ASW extension and would be found in RA's system directory. Example: DefineOutPut C:\RA\QA\SAMPLE.ASW This would put all of the output into a file called SAMPLE.ASW in the speficized directory. ** DISPLAY ** Display See Page #240 / RA.DOC ÄÄÄÄÄÄÄÄ ~~~~~~~~~~~~~~~~~~~~~~ Syntax: DISPLAY " [ | ] " Desc: Displays the given "text" to the user online. o That the MUST be in quotes! o The pipe '|' symbol is used as a carriage return. Example: Display "Hello there! |" Displays the line "Hello there! " to the user. And since we used a pipe in the statement, it will automatically goto the next line after the line is displayed. ** DISPLAYFILE ** DisplayFile See Page #241 / RA.DOC ÄÄÄÄÄÄÄÄÄÄÄÄ ~~~~~~~~~~~~~~~~~~~~~~ Syntax: DISPLAYFILE Desc: This displays a textfile to the user. All you need to remember is that after the command "DisplayFile" you must only write down the basefile name of the file .. DO NOT INCLUDE THE EXTENSION. Also, the textfile must reside in your textfiles directory. Example: DisplayFile BBSRULES This would display the file BBSRULES to the user. ** ENDIF ** EndIf See Page #241 / RA.DOC ÄÄÄÄÄ ~~~~~~~~~~~~~~~~~~~~~~ Syntax: ENDIF Desc: Used in conjunction with the "IF" command, it signifies the end to the if statement. Example: Please see the IF section. ** EXEC ** Exec See Page #241 / RA.DOC ÄÄÄÄÄ ~~~~~~~~~~~~~~~~~~~~~~ Syntax: EXEC Desc: Runs an external protocol. Similiar to the Type 7 menu command. All external parameters are allowed (ie *N, *M, etc..) Example: C:\RA\SEARCH.EXE *M Would execute the program SEARCH.EXE from the C:\RA directory. *M is used to swap RemoteAccess out of memory. ** GETCHOICE ** GetChoice See Page #242 / RA.DOC ÄÄÄÄÄÄÄÄÄÄ ~~~~~~~~~~~~~~~~~~~~~~ Syntax: GETCHOICE Desc: Waits for the user to enter one of the valid . And it stores the responce in the . Example: GetChoice YN 3 Waits for the user to enter "Y" or "N", and stores the input into variable #3. ** GOTO ** Goto See Page #242 / RA.DOC ÄÄÄÄÄ ~~~~~~~~~~~~~~~~~~~~~~ Syntax: GOTO