Creating a survey in the Feedback WebApp V2
Creating a survey in the Feedback WebApp V2
Surveys are created as
Added fields on the
Feedback table and summarised in a Group. After exporting the survey to the website,either integrate the URL into a website or an email to send directly. Surveys can be linked to records such as
Events or
Accounts, or be completely free of context.
Example: customer surveys on the New Year's Eve ball, staff survey on the Christmas party
- Create new Added fields
Only users with the
User group "Feedback_V2 Bearbeiter" can create a new survey.
Important: Decide on one type of rating for each survey. This is the only way to ensure a meaningful statistical analysis.- Go to the
Configurations tab and select
Added fields >
Feedback. - Click in the "Typ" line and add the name of the new feedback form in the field Suggested values at the bottom right.
Important: If the new survey is not added to the selection list, it will not be offered for selection!
Example: Feedback_NewYearsEve - Click on the „Auswahl Feedback“ line and add the name of the new feedback form in the field Suggested values at the bottom right.
Important: If the new survey is not added to the selection list, it will not be offered for selection!
Example: Feedback_NewYearsEve - Click on

Add to add a new question to this feedback form. - Select a Rating type (thumbs, stars, grades, etc.) from the picklist. The field
Further settings is automatically pre-assigned with the appropriate parameters. - Customise the added field for your feedback form:
- Enter either the question itself or an internal name as the Field label .
Example: "How many stars would you assign our service team?" or "Service rating"
Note: If the label is too long, it may not be displayed fully in the desktop application. Keep the label short and use the parameter Label in the field Further settings (see below) for longer texts.
Important: If you want to use the field label, be sure to delete the "Label" and "Label with HTML formatting" parameters in the
Additional settings ! - Enter the name of the feedback form as Group .
- Select the Data type "Number" to enable statistical evaluation.
- Do not use any special characters in the Field name .
- All important parameters are already entered in the field
Further settings. Adjust the following parameters if necessary:- Name of the survey as the first parameter
- Page number: for multi-page feedback forms
- Index: Sequence for multiple questions
- Label: only if you don't want to use the field label
Important: In this case, be sure to delete the "Label with HTML formatting"! - Label with HTML formatting: only if HTML formatting (links etc.) is to be inserted.
Important: In this case, be sure to delete the "Label" without formatting! - Additional languages, help texts, placeholders, etc. as required
- Enter either the question itself or an internal name as the Field label .
- Insert an additional table detail field for each additional question. To ensure that the questions all appear in the same survey, the name of the survey must be set as the first parameter in each individual question.
Save your input.
- Go to the
- Configure the server query
The server query is configured in an index file. Only users with the "WebFolder" authorisation can create a new index file for the survey.
- Go to the
Home tab and click on
Start job, then select the export job „WebApp_Feedback_V2_Export_00_Start“ to generate the .js files for the new feedback form. - Go to the
Configurations tab and select
Web >
Web Folder Administration, then open the folder
Feedback_V2 >
Templates. The export job has created a new JavaScript file with the name of the new survey in this folder.
Note: All template files must begin with the prefix "Feedback_Template_".
Example: Feedback_Template_Feedback_NewYearsEve.js - In the
Feedback_V2 folder, select the
HTML-file "Demo_Single-Language", click on
Save to hard drive in the toolbar and select a filing location. - Copy the file and Save it under a new name.
Example: Feedback_NewYearsEve.html - Open the new file in an editor.
- Replace the name of the oldJavaScript file with the name of the new JavaScript file in three places in the HTML file. The prefix remains the same, it is sufficient to replace the name of the new feedback.
Example: the old survey is called "Demo_Einsprachig", the new survey is called "Feedback_Silvesterball"- in line 44: document.getElementById("Language").setAttribute("data-bpWebApp-templateDataSrc", "templates/Feedback_Template_Feedback_NewYearsEve.js")
- in Zeile 48: document.getElementById("Sprache").setAttribute("data-bpWebApp-templateDataSrc", "templates/Feedback_Template_Feedback_NewYearsEve_"+lang+".js");
- in line 95: document.getElementById("Sprache").setAttribute("data-bpWebApp-templateDataSrc", "templates/Feedback_Template_Feedback_NewYearsEve_"+lang+".js");
- Replace the number of the logon ticket in three places in the HTML file (Create a web logon ticket):
- in line 45: data-bpWebApp-templateDataSrc="templates/Feedback_NewYearsEve.js" data-bpWebApp-queryString="&logon_ticket=D24CF964983443CC9C07DDF4E48695AB">
- in line 49: data-bpWebApp-templateDataSrc="templates/Feedback_NewYearsEve.js" data-bpWebApp-queryString="&logon_ticket=D24CF964983443CC9C07DDF4E48695AB"+lang)>
- in line 95: data-bpWebApp-templateDataSrc="templates/Feedback_NewYearsEve.js" data-bpWebApp-queryString="&logon_ticket=D24CF964983443CC9C07DDF4E48695AB"+lang)>
Save the new index file locally under the name "Feedback_NewYearsEve.html".- Click on
Add in the
Web Folder and select
Upload files, then select the new HTML file.
Confirm the new file and close the
Web Folder.
- Go to the
- Create additional languages for surveys
Surveys can be offered in multiple languages; in the WebApp, the user then switches to the other language by clicking on an icon (flag). First enter the parameters in the questions (Added fields) accordingly, create individual JavaScript files for each language and integrate these into the index file.
The language codes "en" and "fr" are preset. Other languages can be added via additional transaction steps in the export job.
- Go to the
Configurations tab and click on
Jobs, then select "WebApp_Feedback_V2_Export_00_Start". - Click on Transaction step >
New and add a copy of the job "WebApp_Feedback_V2_Export_01_Template_Types" for each language individually.
Important: Assign only one language per line (transaction step). - Enter a code for each language as Parameter Default setting . The language does not have to be created in the full client beforehand.
Example: JobParameter:Language=pt
Save and close the job.
- Go to the
- Create multi-language surveys
Surveys can be published in multiple languages; in the WebApp, the user then switches to the other language by clicking on an icon (flag). First enter the parameters in the questions (Added fields) accordingly, create individual JavaScript files for each language and integrate these into the index file.
- Go to the
Configurations tab and select Added fields > Feedbackand filter for the Group (= name of the feedback/survey). - Double-click to open each question (Added field) of the survey and maintain the corresponding parameters in the field Further settings .
Important: Replace the placeholder <Sprache> with the language code and enter an appropriate text- Label-<Sprache>:
- LabelHtml-<Sprache>:
- Tooltip-<Sprache>:
- Options-<Sprache>:
Example:
Demo_Mehrsprachig:1
Index:3
CssClass:bp-fb-defaultOptions:1//Value 1;2//Value 2;3//Value 3;4//Value 4;5//Value 5;6//Value 6;7//Value 7;8//Value 8;9//Value 9;10//Value 10
Options-fr:1//Value 1;2//Value 2;3//Value 3;4//Value 4;5//Value 5;6//Value 6;7//Value 7;8//Value 8;9//Value 9;10//Value 10
Options-en:1//Value 1;2//Value 2;3//Value 3;4//Value 4;5//Value 5;6//Value 6;7//Value 7;8//Value 8;9//Value 9;10//Value 10
Tooltip:Die volle Punktzahl (10 von 10) entspricht der besten Leistung.
Tooltip-en:The full score (10 out of 10) corresponds to the best performance.
Tooltip-fr:La note maximale (10 sur 10) correspond à la meilleure performance.
LabelHtml:<strong></strong><p>... die Planung und Organisation Ihrer Veranstaltung?</p>
Hidelabel:
LabelHtml-en:<strong></strong>...<p> the planning and organisation of your event?</p>
LabelHtml-fr:<strong></strong><p>La planification et l'organisation de votre évènement</p> - Go to the
- Configure the query for multi-language surveys
The individual JavaScript files must be correctly integrated into the index file so that the survey can be displayed correctly in the WebApp in all languages created. Additional icons may also need to be integrated for newly created languages.
- Go to the
Home tab and click on
Start job, then select the export job „Feedback_V2_Export_00_Start“ to generate the .js files for the new feedback form. This creates another file with the new language code for each existing JavaScript file.
Example: "Feedback_Template_Feedback_NewYearsEve.js" is supplemented by "Feedback_Template_Feedback_NewYearsEve-pt.js" - Go to the
Configurations tab and select
Web >
Web Folder Administration, then open the folder
Feedback_V2 >
Templates. All existing JS files should be stored in this folder. - In the
Feedback_V2 folder, select the
HTML-file "Demo_Mulit-Lanuage", click on
Save to hard drive in the toolbar and select a filing location. - Copy the file and Save it under a new name.
Example: Feedback_NewYearsEve.html - Open the new file in an editor.
- Replace the name of the old JavaScript file with the name of the new JavaScript file in three places in the HTML file. The prefix remains the same, it is sufficient to replace the name of the new feedback.
Example: the old survey is called "Demo_Mehrsprachig", the new survey is called "Feedback_NewYearsEve"- in line 44: document.getElementById("Language").setAttribute("data-bpWebApp-templateDataSrc", "templates/Feedback_Template_Feedback_Silvesterball.js")
- in Zeile 48: document.getElementById("Sprache").setAttribute("data-bpWebApp-templateDataSrc", "templates/Feedback_Template_Feedback_NewYearsEve_"+lang+".js");
- All settings are included for the standard languages English and French. For newly created languages, some of the buttons, flags, IDs, classes or HTML tags must be added individually.
- button, e.g. <button title="Portuguese" onclick="startBpWebApp('pt');" id="PT"><img src="/images/portugal_24.png" alt=""></button>
Note: Save the new icon to a suitable location and reference it correctly in the HTML or Css file. -
document.getElementById("PT").setAttribute("title", bpWebApp.localeObj[locale].Portuguese)
- button, e.g. <button title="Portuguese" onclick="startBpWebApp('pt');" id="PT"><img src="/images/portugal_24.png" alt=""></button>
- In order NOT to use languages that have already been created in a survey, the corresponding lines in the HTML file MUST be deleted or commented out (<! -->).
Save the new index file locally under the name "Feedback_NewYearsEve.html".- Click on
Add in the
Web Folder and select
Upload files, then select the new HTML file.
Confirm the new file and close the
Web Folder.
- Go to the
- Configure the language of the web interface
The sample file "Demo_Mehrsprachig.html" already contains the configuration in DE, EN and FR. If you require another language, please make the following adjustments:
- In the HTML document, copy the lines 59 and 90 and then adapt them to the desired language:
Example:
Original: document.getElementById("FR").setAttribute("title", bpWebApp.localeObj[locale].French)
document.getElementById("PT").setAttribute("title", bpWebApp.localeObj[locale].Portuguese)
Original: <button title="Französisch" onclick="startBpWebApp('fr');" id="FR"><img src="/images/france_24.png" alt=""></button>-
New: <button title="Portugiesisch" onclick="startBpWebApp('pt');" id="PT"><img src="/images/Portugal_24.png" alt=""></button>- - Create another "locale" file in the folder Server >Data > Web Folder > Feedback_V2\locale. Select one of the existing files, copy it and adapt the file name with the abbreviation of the desired language.
Example:
Original: bpLocale.fr.json
New: bpLocale.pt.json - Open the new document and only translate the words in the right-hand column.
IMPORTANT:
Pay close attention to the colons (:), double inverted commas (" ") and the comma (,). If this structure is not adhered to, an error will occur when loading the application. Take particular care with the last line: There must be no comma (,) at the end, as opposed to the previous lines!
Example:
{
"Button_Send" : "Send",
"Deutsch" : "German",
"Englisch" : "English",
"Franzoesisch" : "French",
"Msg_Danke" : "Thank you for your feedback.",
"Button_Weiter" : "Forward",
"Msg_Senden" :"The data was sent successfully.",
"Button_Zurueck" : "Back"}
- In the HTML document, copy the lines 59 and 90 and then adapt them to the desired language:
- Export the new survey
Export the new feedback form via the preconfigured job.
- Go to the
Home tab and click on
Start job, then select „WebApp_Feedback_V2_Export_00_Start“. - Enter the URL of the feedback form in the browser. The URL is made up of the port of the service client (from
Administration >
Service Clients > HTTP Port/HTTPs Port), the name of the WebApp (Feedback_V2) and the name of the index file.
Example: <a href="https://<Your server address>/Feedback_V2/Feedback_NewYearsEve.html">
- Go to the
- Send a new survey
To target the new survey to your customers, send emails with an embedded link. The incoming responses can optionally be linked to the customer's account and a specific event. Some suitable text templates are included in the scenario (Feedback_V2 SampleTemplate, Feedback_V2 SampleTemplate_Reservations (for table reservations)).
- Go to the
Templates tab and select
Text templates > Event template "Feedback_V2 Sample template". - Copy the template and
Save under a new name. - Click on
Show 4D expressions in the toolbar.
Important: Not all references are always visible! Be sure to display the references before you make any changes to avoid unknowingly deleting important references! - Customise the link for your survey and your event:
- Enter the corresponding URL of the feedback form.
The URL is made up of the port of the service client (from
Administration >
Service Clients > HTTP Port/HTTPs Port), the name of the WebApp (Feedback_V2) and the name of the index file (HTML file).
Example: <a href="https://<Your server address>/Feedback_V2/Feedback_NewYearsEve.html"> - Enter an Event ID as "VA_DatensatzID=".
- Enter an Account ID as "AdrUUID=", if applicable a Contact person ID as "Asp_UUID=" or a Reservation ID as "Gast_UUI=".
Example: https://<Your server address>/Feedback_V2/Feedback_NewYearsEve.html?VA_DatensatzID=4711&Adr_UUID=1066&Asp_UUID=333&Gast_UUI=7654 contains references to event no. 4711, account no. 1066, contact no. 333 and reservation no. 7654.
- Enter the corresponding URL of the feedback form.
- To send the survey automatically, e.g. after the end of an event, set up a corresponding
Job. (Creating jobs)
- Go to the
- Integrate a new survey into your website
To address the new survey to all customers who come to your website, integrate the link into the website, e.g. via an iFrame. The incoming responses will not be linked to an account (anonymous).
- Go to your website and insert a link to the URL of the feedback form.
The URL is made up of the port of the service client (from
Administration >
Service Clients > HTTP Port/HTTPs Port), the name of the WebApp (Feedback_V2) and the name of the index file (HTML file).
Example: <a href="https://<Your server address>/Feedback_V2/Feedback_NewYearsEve.html"> - Add an Event ID to the URL to obtain feedback on this specific event.
Example: <a href="https://<Your server adress>/Feedback_V2/Feedback_NewYearsEve.html?VA_DatensatzID=4711">
- Go to your website and insert a link to the URL of the feedback form.