Additional Resources > Windchill Risk and Reliability Data Engine API > Using the Data Engine API > GetDataDefinitionForFields Functions
GetDataDefinitionForFields Functions
The GetDataDefinitionForFields and GetDataDefinitionForFieldsSession functions return data definitions for specified fields. These two functions differ only in respect to parameters for login. For more information, see Login Parameters.
Syntax
The following is the syntax for an HTTP request:
POST /WindchillRiskandReliability12.0/DataEngine.asmx/GetDataDefinitionForFields HTTP/1.1
Host: vm-test
Content-Type: application/x-www-form-urlencoded
Content-Length: length

UserName=string&Password=string&GroupName=string&ProjectName=string&FieldsList=string
Parameters
In addition to login parameters, both the GetDataDefinitionForFields and GetDataDefinitionForFieldsSession functions use these parameters:
• ProjectName—The name of the Windchill Risk and Reliability project. This value is case-sensitive.
• FieldsList—The name of the table and field for which to return the data definition. The format in which you enter this is {"TableName”:[“FieldName”]}. For example, to return the data definition for the Description field in the System Tree Items table, you would enter {"System Tree Items":["Description"]}. To return data definitions for multiple fields from multiple tables, you would enter something like this:
{"FTA Table":["Description"], "FRACAS Incidents":["Approval"],"FMEA DVPs":["DVP Identifier","Causes"],"FMEA Table":["FMEA Identifier"]}
* 
If a user prompt is specified for a field, you must enter the user prompt in the API. If you enter the default prompt instead, an error is returned, indicating that no field with this prompt is found.
The following is an example of an HTTP POST request:
POST /WindchillRiskandReliability12.0/DataEngine.asmx/GetDataDefinitionForFields HTTP/1.1
Host: vm-test
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserName=Bill&Password=passwd&ProjectName=Tablet PC&FieldsList=
{"FTA Table":["Description"],"FRACAS Incidents":["Approval"],
"FMEA DVPs":["DVP Identifier","Causes"],"FMEA Table":["FMEA Identifier"]}
Returns
If the user is authenticated and the specified parameters are found, data definitions for the given fields are returned.
<?xml version="1.0" encoding="utf-8"?>
<DataEngineResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://www.ptc.com/WindchillRiskandReliability/12.0/">
<Success>true</Success>
<AdditionalData>
{"UserPrompt":"Description","FieldType":"Memo","Precision":0,
"ChoiceListCode":"","ParentChoiceListFieldTable":"",
"ParentChoiceListFieldName":"","ListChoiceText":"DisplayText",
"MemoFieldType":"Memo"},{"UserPrompt":"Approval","FieldType":
"Text","Precision":0,"ChoiceListCode":"","ParentChoiceListFieldTable":"",
"ParentChoiceListFieldName":"","ListChoiceText":"DisplayText",
"MemoFieldType":"Memo"},{"UserPrompt":"DVP Identifier","FieldType":"Text",
"Precision":0,"ChoiceListCode":"","ParentChoiceListFieldTable":"",
"ParentChoiceListFieldName":"","ListChoiceText":"DisplayText",
"MemoFieldType":"Memo"},{"UserPrompt":"Causes","FieldType":"Long",
"Precision":0,"ChoiceListCode":"","ParentChoiceListFieldTable":"",
"ParentChoiceListFieldName":"","ListChoiceText":"DisplayText",
"MemoFieldType":"Memo"},{"UserPrompt":"FMEA Identifier",
"FieldType":"Text","Precision":0,"ChoiceListCode":"",
"ParentChoiceListFieldTable":"","ParentChoiceListFieldName":"",
"ListChoiceText":"DisplayText","MemoFieldType":"Memo"}]
</AdditionalData>
</DataEngineResponse>
If the call fails, the AdditionalData tag provides the reason for the failure.