Survey
It is possible to present a short survey to the user when a fault is not detected and repaired by the user. Questions must be defined using the question tag. Each question has an id attribute as well as text attribute to specify its contents.
<question id="q01" text="Do you like chocolate?"/>
One question can have the special id heading, and can be used to specify the leading text in the survey window when the problem was not correctly diagnosed:
<question id="heading" text="Custom text for the heading part (not diagnosed)"/>
One question can have the special id headingOk, and can be used to specify the leading text in the survey window when the error has been correctly diagnosed (see surveyOk):
<question id="headingOk" text="Custom text for the heading part (correctly diagnosed)"/>
In an error element, it is possible to reference questions using the survey attribute (if the problem was not diagnosed) or the surveyOk attribute (if the survey is to be shown when the error was correctly diagnosed):
<error start="2" typ="mixer_block" diagnostics="true" clear="5" surveyOk="q06,01" survey="q01,q05,q03"/>
Questions are referenced using their id: multiple questions are comma separated.
Using the surveyDelay attribute it is possible to delay showing the dialog (default: 1s):
<error start="2" typ="mixer_block" diagnostics="true" clear="5" surveyDelay="15" surveyOk="q06,01" survey="q01,q05,q03"/>
will show the survey dialog 15s after a valid repair / clear
Example
<?xml version="1.0" encoding="UTF-8"?> <script> <duration seconds="2300"/> <assitance typ="user" start="0"/> <!-- Here we define the available questions. Each question must have a unique id. We can insert a line break with <br> --> <!-- The special id 'heading' is used to change the default heading text in the dialog window when the error is not diagnosed --> <question id="heading" text="Custom text for the heading part, problem not diagnosed"/> <!-- The special id 'headingOk' is used to change the default heading text in the dialog window when the error is not diagnosed --> <question id="headingOk" text="Custom text for the heading part, problem correctly diagnosed"/> <question id="q01" text="Do you like chocolate?"/> <question id="q02" text="Do you like chips?"/> <question id="q03" text="Do you like this very very very very very very very very <br> very very very very very long question?"/> <question id="q04" text="Do you like your computer?"/> <question id="q05" text="Do you like apples?"/> <question id="q06" text="Was it difficult?"/> <question id="q07" text="Really?"/> <!-- To specify that a survey must be shown when the error is automatically cleared use the survey attribute --> <!-- To specify that a survey must be shown when the error is correctly diagnosed use the surveyOk attribute --> <!-- As value, a comma separated list of the ids of the selected questions is used --> <error start="2" typ="mixer_block" diagnostics="true" clear="15" surveyOk="q06,q07" survey="q01,q05,q03" allowLateRepair="true"/> </script>