The configured fields for the specified expense form.
1.1
https://www.concursolutions.com/api/expense/expensereport/v1.1/report/Form/_{FormId}_/Fields
Retrieves the details of the configured form fields for the specified form.
NOTE: When sending in requests using these fields, be sure to include the required fields from the form and any additional required fields specified in the request documentation.
Parameter | Required/Optional | Description |
---|---|---|
{FormId}/Fields | required | The unique identifier for the desired form and the Fields keyword. |
Example: https://www.concursolutions.com/api/expense/expensereport/v1.1/report/Form/{FormId}/Fields
URI Source: The FormId is returned in the FormId element by the Get Form Data function.
Authorization header with OAuth token for valid SAP Concur user. Required.
application/xml
This request will return a FormFieldsList parent element with a FormField parent element for each configured form field.
Element | Description |
---|---|
Id | The form field ID. |
Label | The form field label. |
ControlType | The type of field. |
DataType | The type of data accepted by the field. |
MaxLength | The maximum length of the field value. |
Required | Whether the field is required. |
Cols | The number of columns the field contains. |
Access | The access level the specified user has to the field. |
Width | The width of the field. |
Custom | Whether the field is custom. |
Sequence | The field order on the form. |
GET https://www.concursolutions.com/api/expense/expensereport/v1.1/report/Form/nAaT8$puKKO2$pEVlsXfSruLpDfZL0wVM$s7/Fields HTTP/1.1
Authorization: OAuth {access token}
...
HTTP/1.1 200 OK
Content-Type: application/xml
<FormFieldsList xmlns="https://www.concursolutions.com/api/expense/expensereport/2011/03" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<FormField>
<Id>Name</Id>
<Label>ReportName</Label>
<ControlType>edit</ControlType>
<DataType>VARCHAR</DataType>
<MaxLength>32</MaxLength>
<Required>Y</Required>
<Cols>32</Cols>
<Access>RW</Access>
<Width>32</Width>
<Custom>N</Custom>
<Sequence>1</Sequence>
</FormField>
<FormField>
<Id>ReportId</Id>
<Label>ReportID</Label>
<ControlType>static</ControlType>
<DataType>VARCHAR</DataType>
<MaxLength>32</MaxLength>
<Required>Y</Required>
<Cols />
<Access>RO</Access>
<Width />
<Custom>N</Custom>
<Sequence>2</Sequence>
</FormField>
<FormField>
<Id>PolKey</Id>
<Label>Policy</Label>
<ControlType>picklist</ControlType>
<DataType>INTEGER</DataType>
<MaxLength />
<Required>Y</Required>
<Cols />
<Access>RW</Access>
<Width />
<Custom>N</Custom>
<Sequence>3</Sequence>
</FormField>
<FormField>
<Id>EmpName</Id>
<Label>EmployeeName</Label>
<ControlType>static</ControlType>
<DataType>VARCHAR</DataType>
<MaxLength>32</MaxLength>
<Required>Y</Required>
<Cols />
<Access>HD</Access>
<Width />
<Custom>N</Custom>
<Sequence>4</Sequence>
</FormField>
<FormField>
<Id>UserDefinedDate</Id>
<Label>ReportDate</Label>
<ControlType>edit</ControlType>
<DataType>TIMESTAMP</DataType>
<MaxLength />
<Required>N</Required>
<Cols />
<Access>RW</Access>
<Width />
<Custom>N</Custom>
<Sequence>5</Sequence>
</FormField>
<FormField>
<Id>Purpose</Id>
<Label>BusinessPurpose</Label>
<ControlType>textarea</ControlType>
<DataType>VARCHAR</DataType>
<MaxLength>500</MaxLength>
<Required>Y</Required>
<Cols>32</Cols>
<Access>RW</Access>
<Width>32</Width>
<Custom>N</Custom>
<Sequence>6</Sequence>
</FormField>
</FormFieldsList>