webleads-tracker

Home> List of values from the registration from

List of values from the registration from


Introduction

This API provides the data to create the default TraceParts registration form.

API Key

This web service requires an API Key. Please refer to this chapter to request your API Key.

Description

The API returns all fields, rules and list of values for the TraceParts registration. These lists can also be used to know the values, in the related language, for some fields of the TraceParts Analytics reports.

Building a URL

The FormsData API request takes the following form:

http://ws.tracepartsonline.net/tpowebservices/FormsData?parameters

 

Parameters

Certain parameters are required while others are optional. As is standard in URLs, all parameters are separated using the ampersand (&) character. The list of parameters and their possible values are enumerated below.

Required parameters

Parameter Name

Data type

Default value

Description

ApiKey

string

none

Code calling an API to track and control how the API is used

Format

string

none

Answer file type (xml, json or csv)

Language

string

en

LanguageID given by the LanguagesList API

FormId

string

none

Please always use the value “userRegistration_AllFields”

 

Optional parameters

Parameter Name

Data type

Default value

Description

ActiveJsonLight

boolean

0

Enables the light version when json is the answer file type

 

Example of FormsData API

The request below returns all data to used for a TraceParts registration and matches it to the IDs of each field from the TraceParts Analytics reports.

http://ws.tracepartsonline.net/tpowebservices/FormsData?Language=en&FormId=userRegistration_AllFields&format=json&ApiKey={ApiKey}

FormsData responses

FormsData responses are returned in the format indicated by the Format parameter within the URL request’s path.

JSON Output

A sample HTTP request is shown below, displaying a registration field in the English language.

{"formsDataList":[{
"fieldId":"f_Service",
"label":"Your department",
"type":"CMB",
"defaultValue":"",
"mandatory":"True",
"lengthMin":"1",
"lengtMax":"50",
"regex":"",
"values":[
{"id":"SERV02","label":"AFTER-SALES"},
{"id":"SERV03","label":"ASSEMBLY & PRODUCTION"},
{"id":"SERV04","label":"ENGINEERING"},
{"id":"SERV06","label":"GENERAL MANAGEMENT"},
{"id":"SERV07","label":"IT DEPARTMENT"},
{"id":"SERV08","label":"LOGISTICS"},
{"id":"SERV09","label":"MAINTENANCE & REPAIR OPERATIONS"},
{"id":"SERV11","label":"METHODS"},
,"noMatchRegex":""}
}]}

 

XML Output

Same example as above.

<WsFormsDataList>
<FormsDataList>
<WsFormsData>
<FieldId>f_Service</FieldId>
<Label>Your department</Label>
<Type>CMB</Type>
<DefaultValue/>
<Mandatory>True</Mandatory>
<LengthMin>1</LengthMin>
<LengtMax>50</LengtMax>
<Regex/>
<Values>
<WsFormsData_Value>
<Id>SERV02</Id>
<Label>AFTER-SALES</Label>
</WsFormsData_Value>
<WsFormsData_Value>
<Id>SERV03</Id>
<Label>ASSEMBLY & PRODUCTION</Label>
</WsFormsData_Value>
<WsFormsData_Value>
<Id>SERV04</Id>
<Label>ENGINEERING</Label>
</WsFormsData_Value>
<WsFormsData_Value>
<Id>SERV06</Id>
<Label>GENERAL MANAGEMENT</Label>
</WsFormsData_Value>
<WsFormsData_Value>
<Id>SERV07</Id>
<Label>IT DEPARTMENT</Label>
</WsFormsData_Value>
<WsFormsData_Value>
<Id>SERV08</Id>
<Label>LOGISTICS</Label>
</WsFormsData_Value>
<WsFormsData_Value>
<Id>SERV09</Id>
<Label>MAINTENANCE & REPAIR OPERATIONS</Label>
</WsFormsData_Value>
<WsFormsData_Value>
<Id>SERV11</Id>
<Label>METHODS</Label>
</WsFormsData_Value>
</Values>
<NoMatchRegex/>
</WsFormsData>
</FormsDataList>
</WsFormsDataList>

FormsData response elements

FormsData responses contain ten elements:

  • “FieldId”: TraceParts ID of the field.
  • “Label”: label of the field, depending on the language.
  • “Type”: Type of the field (Text box, drop list, check box…).
  • “DefaultValue”: default value.
  • “Mandatory”: boolean (True/False) if the field is mandatory or not.
  • “LengthMin”: minimum length.
  • “LengtMax”: maximum length.
  • “Regex”: regular expression to validate the value of the text field.
  • “Values”: list of values for a list control.
  • “NoMatchRegex”: N/A.

Developer support

Please contact us for any problems, questions or comments related to this web service.

Last updated July 29, 2016