5.4: Survey feedback reader tool
Summary | This article explains how to use the survey feedback tool |
Applies to | AskiaDesign; Supervisor; |
Written for | Scriptwriters and survey authors |
Keywords | survey feedback; 5.4; CAWI; |
Survey feedback has been implemented in 5.4.4. It allows a tester or a respondent to send feedback from AskiaWeb interviews. We have a tool that allows you to read the feedback from selected surveys.
There are two versions of the tool:
One tool for CCA 5.4.4: DemoFeedbackAPI v2.2. Please configure your web.config file for ccaAPI to allow TCP as below.
One tool for CCA 5.4.6 and above: DemoFeebackAPI V3. It uses by default the TCP link (as, starting from 5.4.6, the web.config file is generated with TCP bindings).
Requirements:
- CCA 5.4.X
- CCAAPI 5.4.X
On the Supervisor
First thing to do is to create a new API module, named "dev", on supervisor:
Then associate this module to the supervisor restriction you want to use:
On the server
On the Server where the CCAAPI is installed, you need to enable the TCP connection.
1/ Add the net.tcp binding on the server:
- IIS manager > Click on server > default Web site.
- Click on "Bindings..." on the right side.
- Verify whether there is a net.tcp type listed. If that's not the case, then add it.
.
2/ Add the net.tcp protocol for the website:
- Click on the website on the left side.
- Click on "Advanced Settings…" on the right side.
- Verify if ‘net.tcp' is listed in the "Enabled protocols". If it isn't, add it (list is comma separated).
3/ Add TCP endoints for CCAAPI
A - Make a backup copy and then open the web.config file located in the CCAAPI root directory (something like C:\inetpub\wwwroot\ccaAPI).
B - Look for the <bindings> section, and add this at the end (just before the </bindings>):
<netTcpBinding>
<binding name="TheTcpBinding" sendTimeout="00:01:00">
<security mode="None" />
</binding>
</netTcpBinding>
C - Then, look for the first <service> section inside the parent <services> section, and add this at the end (just before </service>):
<endpoint behaviorConfiguration="" binding="netTcpBinding" bindingConfiguration="TheTcpBinding" name="Service.TCP" contract="CcaAPI.Interfaces.IService">
<identity>
<dns value="localhost" />
</identity>
</endpoint>
<endpoint behaviorConfiguration="" binding="netTcpBinding" bindingConfiguration="TheTcpBinding" name="Objects.TCP" contract="CcaAPI.Interfaces.IDuplexCcaObjects">
<identity>
<dns value="localhost" />
</identity>
</endpoint>
<endpoint behaviorConfiguration="" binding="netTcpBinding" bindingConfiguration="TheTcpBinding" name="Reports.TCP" contract="CcaAPI.Interfaces.ICcaReports">
<identity>
<dns value="localhost" />
</identity>
</endpoint>
<endpoint behaviorConfiguration="" binding="netTcpBinding" bindingConfiguration="TheTcpBinding" name="Quota.TCP" contract="CcaAPI.Interfaces.IDuplexCcaQuota">
<identity>
<dns value="localhost" />
</identity>
</endpoint>
D - Save the file . . .
You can find attached to this article a web.config file, 5.4.4 compatible where you just need to modify the 5th line of the file and enter your external server address:
<add key="ExternalCcaIPAddress" value="XXX" />
On the survey feedback tool:
Start the DemoFeedbackAPI.exe:
- API reference: IP address of your CCAAPI (the IP address muse use the net.tcp protocol (and not the http one. For example, if you start the demofeedback tool on the server where the CCAAPI is installed: net.tcp://localhost/CcaAPI/CcaAPI.Service.svc).
- API Module: dev
- API Username: Supervisor login with dev module available
- API password: Supervisor password
Once filled, click connect and select the appropriate survey into the dropdown menu:
Click the "Find feedback" button. A list of all feedback made appears:
Select the feedback wanted and you will see a screenshot from the screen where the feedback was done and interview information: