Versions Compared

Old Version 1

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The createFlow operation creates a survey, an e-mail connector and an e-mail message based on a template or existing survey. 

Code Block
languagexml
titlecreateFlow 
<surveymonkey.createFlow>
    <templateId>{$ctx:templateId}</templateId>
    <surveyTitle>{$ctx:surveyTitle}</surveyTitle>
    <fromSurveyId>{$ctx:fromSurveyId}</fromSurveyId>
    <collectorType>{$ctx:collectorType}</collectorType>
    <collectorName>{$ctx:collectorName}</collectorName>
    <recipients>{$ctx:recipients}</recipients>
    <collectorSend>{$ctx:collectorSend}</collectorSend>
    <replyEmail>{$ctx:replyEmail}</replyEmail>
    <messageSubject>{$ctx:messageSubject}</messageSubject>
	<messageBody>{$ctx:messageBody}</messageBody>
</surveymonkey.createFlow>
Properties
  • templateId: The template ID to be used for creating the survey.
  • surveyTitle: Required - The title of the survey.
  • fromSurveyId: The ID of an existing survey to be used for creating the survey.
  • collectorType: The type of the collector.
  • collectorName: The name of the collector.
  • recipients: The array of recipients.
  • collectorSend: If "true", sends an email message to recipients.
  • replyEmail: The reply email of the email message to be sent to recipients.
  • messageSubject: The subject of the email message to be sent to recipients.
  • messageBody: The plain text body of the email message to be sent to recipients.
Anchor
request
request
Sample request

Following is a sample REST/JSON request that can be handled by the createFlow operation.

Code Block
titleSample Request for createFlow
{
	"apiUrl":"https://api.surveymonkey.net",
	"accessToken":"paTBz61kMlD0mPWrsaHR3921EuYbHlBvqU0GDZQ.5nahBvB1GbdZpbh2WnOzXY4SpgPezvIfjiLKg1h6dpRI5VJpOBjV3RTscaxNGlgM2w8=",
	"apiKey":"v9wjtvutfpvz5x82t5dqtt8v",
	"surveyTitle":"Test 1",
	"fromSurveyId":"58745768",
	"collectorType":"email",
	"collectorName":"Test",
	"recipients":[ 
			{  
				"email":"dvirajith@virtusa.com",
				"first_name":"Stannis",
				"last_name":"Baratheon",
				"custom_id":"94301"
			}
		],
	"collectorSend":true,
	"replyEmail":"apptest.virajith@gmail.com",
	"messageSubject":"How's it happening",
	"messageBody":"You have successfully joined the happening group of WSO2 ESB Connector Development. Please complete the survey to find out how it's going on.  [SurveyLink]  If you are not a developer of this community, Please unsubscribe  [RemoveLink]"
}
Related SurveyMonkey documentation

https://developer.surveymonkey.com/mashery/create_flow

Anchor
#sample
#sample

Sample configuration 

Following is a sample proxy service that illustrates how to connect to SurveyMonkey with the init operation and use the createFlow operation. The sample request for this proxy can be found in the createFlow sample request.  

Code Block
languagehtml/xml
titleSample Proxy
<?xml version="1.0" encoding="UTF-8"?>
<proxy xmlns="http://ws.apache.org/ns/synapse"
       name="surveymonkey_createFlow"
       transports="https,http"
       statistics="disable"
       trace="disable"
       startOnLoad="true">
   <target>
      <inSequence onError="faultHandlerSeq">
         <property name="apiUrl" expression="json-eval($.apiUrl)"/>
         <property name="accessToken" expression="json-eval($.accessToken)"/>
         <property name="apiKey" expression="json-eval($.apiKey)"/>
         <property name="templateId" expression="json-eval($.templateId)"/>
         <property name="surveyTitle" expression="json-eval($.surveyTitle)"/>
         <property name="fromSurveyId" expression="json-eval($.fromSurveyId)"/>
         <property name="collectorType" expression="json-eval($.collectorType)"/>
         <property name="collectorName" expression="json-eval($.collectorName)"/>
         <property name="recipients" expression="json-eval($.recipients)"/>
         <property name="collectorSend" expression="json-eval($.collectorSend)"/>
         <property name="replyEmail" expression="json-eval($.replyEmail)"/>
         <property name="messageSubject" expression="json-eval($.messageSubject)"/>
         <property name="messageBody" expression="json-eval($.messageBody)"/>
         <surveymonkey.init>
            <accessToken>{$ctx:accessToken}</accessToken>
            <apiKey>{$ctx:apiKey}</apiKey>
            <apiUrl>{$ctx:apiUrl}</apiUrl>
         </surveymonkey.init>
         <surveymonkey.createFlow>
            <templateId>{$ctx:templateId}</templateId>
            <surveyTitle>{$ctx:surveyTitle}</surveyTitle>
            <fromSurveyId>{$ctx:fromSurveyId}</fromSurveyId>
            <collectorType>{$ctx:collectorType}</collectorType>
            <collectorName>{$ctx:collectorName}</collectorName>
            <recipients>{$ctx:recipients}</recipients>
            <collectorSend>{$ctx:collectorSend}</collectorSend>
            <replyEmail>{$ctx:replyEmail}</replyEmail>
            <messageSubject>{$ctx:messageSubject}</messageSubject>
            <messageBody>{$ctx:messageBody}</messageBody>
         </surveymonkey.createFlow>
         <property name="responseStatus" expression="json-eval($.status)"/>
         <filter source="$axis2:HTTP_SC" regex="^[^2][0-9][0-9]">
            <then>
               <switch source="$axis2:HTTP_SC">
                  <case regex="401">
                     <property name="ERROR_CODE" value="600401"/>
                     <property name="ERROR_MESSAGE" value="Unauthorized"/>
                  </case>
                  <case regex="404">
                     <property name="ERROR_CODE" value="600404"/>
                     <property name="ERROR_MESSAGE" value="Not Found"/>
                  </case>
                  <case regex="400">
                     <property name="ERROR_CODE" value="600400"/>
                     <property name="ERROR_MESSAGE" value="Bad Request"/>
                  </case>
				  <case regex="403">
                     <property name="ERROR_CODE" value="600403"/>
                     <property name="ERROR_MESSAGE" value="Forbidden."/>
                  </case>
                  <case regex="500">
                     <property name="ERROR_CODE" value="600500"/>
                     <property name="ERROR_MESSAGE" value="Internal Server Error"/>
                  </case>
               </switch>
			   <property name="messageType" value="application/json" scope="axis2"/>
               <sequence key="faultHandlerSeq"/>
            </then>
            <else>
               <filter xpath="get-property('responseStatus') != 0">
                  <then>
					 <switch source="get-property('responseStatus')">
						<case regex="1">
							<property name="HTTP_SC" value="401" scope="axis2"></property>
							<property name="ERROR_CODE" value="600401"/>
							<property name="ERROR_MESSAGE" value="Unauthorized"/>
						</case>
						<case regex="2">
							<property name="HTTP_SC" value="403" scope="axis2"></property>
							<property name="ERROR_CODE" value="600403"/>
							<property name="ERROR_MESSAGE" value="Forbidden."/>
						</case>
						<case regex="3">
							<property name="HTTP_SC" value="400" scope="axis2"></property>
							<property name="ERROR_CODE" value="600400"/>
							<property name="ERROR_MESSAGE" value="Bad Request"/>
						</case>
						<case regex="4">
							<property name="HTTP_SC" value="403" scope="axis2"></property>
							<property name="ERROR_CODE" value="600403"/>
							<property name="ERROR_MESSAGE" value="Unknown User"/>
						</case>
						<case regex="5">
							<property name="HTTP_SC" value="500" scope="axis2"></property>
							<property name="ERROR_CODE" value="600500"/>
							<property name="ERROR_MESSAGE" value="Internal Server Error"/>
						</case>
					 </switch>
					 <property name="error_description" expression="json-eval($.errmsg)"/>
					 <property name="messageType" value="application/json" scope="axis2"/>
					 <sequence key="faultHandlerSeq"/>
                  </then>
               </filter>
            </else>
         </filter>
         <respond/>
      </inSequence>
      <outSequence>
         <send/>
      </outSequence>
      <faultSequence>
		 <property name="ERROR_CODE" value="600500"/>
		 <property name="ERROR_MESSAGE" value="Internal Server Error"/>
		 <property name="messageType" value="application/json" scope="axis2"/>
         <sequence key="faultHandlerSeq"/>
      </faultSequence>
   </target>
   <description/>
</proxy>

...