transform

POSTALL,CFI/CreateNewFormInstance

IN THIS PAGE

Arguments

formIdCharacter

formId of the form definition for which a new formInstance will be created

formDataJSONCharacter

JSON data for the new formInstance

personCharacter

the userId for the TransForm user to whom the new formInstnce is assigned.

Returns

resultJSON Object

Returns an object with these properties:

errorboolean

true if there was an error

errorTextstring
resultobject
recordsAddednumber of rows added to the forms table
forminstanceid

forminstanceid (i.e. primary key) of the new form instance

Description

Create a new form instance. The form type is specified by the formId. The account is the account associated with the API key.

CURL 

CURL --insecure -H "apikey:Your_api_key" -H "accept: application/json" -d "{"""formId""":value_of_formId,"""formDataJSON""":{},"""person""":value_of_person}" https://transform.alphasoftware.com/transformAPIVersion1.a5svc/CreateNewFormInstance

Node 

var request = require('request')
var path = 'https://transform.alphasoftware.com/transformAPIVersion1.a5svc/CreateNewFormInstance';
var data = {"formId": "value_of_formId","formDataJSON": "{}","person": "value_of_person"};
var dataJSON = JSON.stringify(data)
request.post(
	{
		headers: {apikey: "Your_api_key"},   
		url: path, 
		form: dataJSON}, 
		function(err,httpResponse,body){
			if(err) console.log(err)
			console.log(body)
	}
)

Xbasic 

dim apikey as c = "Your_api_key"
dim postdata as c
postdata = <<%txt%
{
    "formId": "value_of_formId",
    "formDataJSON": "{}",
    "person": "value_of_person"
}

%txt%

dim url as c = "/CreateNewFormInstance"
dim pr as p
pr = a5dialogHelper_transformAPIQuery(url,postdata,apikey)
if pr.error = .f. then
	dim result as c 
	result = pr.result
else
	dim errorText as c 
	errorText = pr.errorText
end if