Skip to content

Latest commit

 

History

History
 
 

QualtricsIntegration

Qualtrics Survey Operators

The custom operators provided in this sample are designed to extract responses from Qualtrics.

Coding was done on Python 3.6.x and was tested with Data Hub version 2.7.

Author: Cassio Binkowski - github - SAP profile

Requirements

Before you start using the example, please make sure that:

Content

1. Dockerfile 'qualtrics' (Source code)

2. Custom operator 'ExportResponses' (Source code)

  • continuous mode: the operator will continuously fetch responses if recurrence is set to anything above 0. The first run will fetch all responses until present moment, and then only the delta
  • single-run mode: the operator will fetch all responses until present moment and terminate graph (recurrence set to 0)
  • derived from 'Python3Operator'
  • Uses image tag qualtrics
  • need to configure API token, data center and survey ID for operator to work. For more info on that, please consult Qualtrics API info
  • output port responses of Type string: returns a batch of responses in CSV format
  • output port terminate of Type string: returns a signal to terminate graph (only used in single-run mode)

3. Custom operator 'GetResponse' (Source code)

  • derived from 'Python3Operator'
  • Uses image tag qualtrics
  • need to configure API token, data center and survey ID for operator to work. For more info on that, please consult Qualtrics API info
  • input port responseID of Type string: should be the body of an API call received from a Qualtrics action
  • output port response of Type string: returns the full Qualtrics survey response in CSV format

4. Sample graphs

  • Extract Responses (Source code): extract responses in batch mode, continuously or single-run Graph Extract Responses
  • Receive Response (Source code): start an API inside Data Hub to receive responses from Qualtrics as soon as they are finished. NB: You need to configure an Action inside Qualtrics survey to send the response ID via POST service call. Graph Receive Responses

The API endpoint will be: https://{Data Hub URL}/app/pipeline-modeler/openapi/service/poc/qualtrics/survey

Configure Basic authentication with Data Hub user in this format:

  • username: {tenant}\{username}
  • pwd: {user's password}

Qualtrics Action

How to run

  • Import solution/qualtrics-1.0.0.zip via SAP Data Hub System Management -> Files -> Import Solution
  • Make sure you have your Qualtrics API information (API token, data center and Survey ID)
  • Open graphs Extract Responses and Receive Response and configure the respective Qualtrics operators with API information
  • Start the graphs and check the wiretaps for the outputs