Skip to main content

Setting up the Feedback WebApp

Setting up the Feedback WebApp

Only a few settings are required when importing the scenario WebApp_Feedback_V2. If an older version of the WebApp was previously installed, individual settings may need to be adjusted.

  • Assign a real user

    A Gruppen User group with the relevant authorisations for editing surveys is included in the scenario. The real user is responsible for creating and analysing surveys via the Feedback WebApp.

    1. Go to the Administration Administration tab and click on Benutzer Users, then select the user who is to be responsible for editing the feedback.
      Example: Events Office, Carolin Fixit
    2. Assign the user group  Gruppen „Feedback_V2_Bearbeiter“ as   or give the user authorisation to write   in the table Feedback Feedback .
    3. Speichern Save your input.
  • Set up two technical users

    Two Gruppen User groups with the relevant authorisations are included in the scenario.

    1. Go to the  Administration Administration tab and click on  Benutzer Users.
    2. The technical user "Feedback_V2_Import" is only required for importing the data. Create this Benutzer User with the following login name, name and first name:
      1. Login name: "Feedback_V2_Import", Name: "Feedback_V2_Import", First name: "WebAppUser"
      2. Do not give any access rights.
      3. Assign the Gruppen User group "Feedback_V2_Import".
    3. The technical user "Feedback_V2_Technik" is required to create the web login ticket. Create this Benutzer User with the following login name, name and first name:
      1. Login name: "Feedback_V2_Technik", Name: "Feedback_V2_Technik", First name: "WebAppUser"
      2. Give  Access  Web Client "via web server"
      3. Assign the Gruppen User group "Feedback_V2_Technik".
    4. Speichern Save your input.
  • Create a web login ticket

    Create a web login ticket for the user who is to be responsible for the Feedback WebApp. The ticket is need when configuring the server query for new surveys (Configure the server query).

    1. Go to the Einrichtung Configurations tab and click on Html Web > Web Logon Ticket Web logon tickets > neu New.
    2. Select the Benutzer User "Feedback_V2_Technik" from the picklist.
    3. Enable multi-use for the ticket and set the Validity to a high value.
    4. Copy the web logon ticket to the clipboard when prompted.
    5. save Save your input.
  • Export the demo feedback forms

    The scenario contains three sample surveys:
    - "Demo_Bewertungsarten": The feedback is only used to illustrate all available types of rating and should NOT be used as a copy template.
    - "Demo_Einsprachig": The feedback serves as a simple example of a survey that is output in one language.
    - "Demo_Mehrsprachig": The feedback serves as a simple example of a survey that is output in several languages.

    1. Go to the  Basis Home tab and click on  abspielen Start job, then select „WebApp_Feedback_V2_Export_00_Start“.
    2. Open a browser.
      a. Find a sample page with all available rating types and text examples at "https://<Your server address/http port>/Feedback_V2/Demo_Rating_Types.html?" 
      b. Find a sample page with several questions on different topics but with the same rating type at "https://<Your server address/http port>/Feedback_V2/Demo_Einsprachig.html?" . The same rating type should always be used within a survey in order to enable a statistical evaluation.
      c. Find a sample page with several questions on different topics but with the same rating type at "https://<Your server address/http port>/Feedback_V2/Demo_Mehrsprachig.html?" . On this page you can also switch between the languages German - English - French.
  • Adjust settings from older versions

    If an older version of the Feedback WebApp was previously installed on the selected server, additional settings may need to be adjusted.

    1. If this has not happened automatically, add the name of the feedback („Demo_Bewertungsarten“) to the lists of suggested values:
      a. in added field Auswahl Feedback
      b. in added field Typ 
    2. Check whether the field Typ > Further settings contains the entry "All types:X" and add it if necessary.
    3. Check the Visibility rule in record for the Table settings and adjust if necessary.
  • 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:

    1. 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>-
    2. 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
    3. 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"

    }