This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Working with Forms in JotForm


Overview

The following operations allow you to work with forms. Click an operation name to see details on how to use it.

For a sample proxy service that illustrates how to work with forms, see Sample configuration

OperationDescription

getForm

Retrieves a specific form.

getFormSubmissions

Retrieves submissions for a specific form.

cloneFormClones an existing form.

Operation details

This section provides further details on the operations related to forms.

Retrieving a specific form

The getForm operation retrieves a specific form.

getForm
<jotform.getForm>
	<formId>{$ctx:formId}</formId>
</jotform.getForm>
Properties
  • formId: The ID of the form.
   Sample request

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

Sample Request for getForm
{
	"apiUrl" : "https://api.jotform.com",
    "apiKey" : "f71e12ef09ef7941b8b19b80e5173d26",
	"formId" : "51661468375463"
}
Related JotForm documentation

http://api.jotform.com/docs/#form-id

Retrieving submissions

The getFormSubmissions operation retrieves submissions for a specific form.

getFormSubmissions
<jotform.getFormSubmissions>
    <limit>{$ctx:limit}</limit>
    <orderBy>{$ctx:orderBy}</orderBy>
    <formId>{$ctx:formId}</formId>
    <offset>{$ctx:offset}</offset>
	<filter>{$ctx:filter}</filter>
</jotform.getFormSubmissions>
Properties
  • limit: The number of results in each result set for submission data.
  • orderBy: The order value in which the results are ordered.
  • formId: The ID of the form which needs to be retrieved.
  • offset: The page value of each result set for submission data.
  • filter: The query results to fetch a specific submissions range.
   Sample request

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

Sample Request for getFormSubmissions
{
 	"apiUrl" : "https://api.jotform.com",			
    "apiKey" : "f71e12ef09ef7941b8b19b80e5173d26",
	"formId" : "51661468375463",
  	"offset" : "0",
    "limit" :  "2",
	"orderBy" : "id"			
}

Note

There are optional parameters available. For more information on the usage of these parameters please check the API document. 

Related JotForm documentation

http://api.jotform.com/docs/#form-id-submissions

Cloning a form

The cloneForm operation clones an existing form.

cloneForm
<jotform.cloneForm>
	<formId>{$ctx:formId}</formId>
</jotform.cloneForm>
Properties
  • formId: The ID of the form that it is cloned from.
   Sample request

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

Sample Request for cloneForm
{
	"apiUrl" : "https://api.jotform.com",
    "apiKey" : "f71e12ef09ef7941b8b19b80e5173d26",
	"formId" : "51651915860458"
}
Related JotForm documentation

http://api.jotform.com/docs/#post-form-id-clone

Sample configuration

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

Sample Proxy
<?xml version="1.0" encoding="UTF-8"?>
<proxy xmlns="http://ws.apache.org/ns/synapse" name="jotform_getForm" transports="https,http" statistics="disable"
   trace="disable" startOnLoad="true">
   <target>
      <inSequence>
         <property name="apiUrl" expression="json-eval($.apiUrl)" />
         <property name="apiKey" expression="json-eval($.apiKey)" />
         <property name="formId" expression="json-eval($.formId)" />
         <jotform.init>
            <apiUrl>{$ctx:apiUrl}</apiUrl>
            <apiKey>{$ctx:apiKey}</apiKey>
         </jotform.init>
         <jotform.getForm>
            <formId>{$ctx:formId}</formId>
         </jotform.getForm>
         <respond />
      </inSequence>
      <outSequence>
         <send />
      </outSequence>
   </target>
   <description />
</proxy>