Configure Lookup for REST > Name/Value
Prerequisites
- AgilePoint NX OnDemand (public cloud), or AgilePoint NX PrivateCloud or AgilePoint NX OnPremises v7.0 Software Update 2 or higher.
Good to Know
- Some information about third-party integrations is outside the scope of the AgilePoint NX Product Documentation, and it is the responsibility of the vendors who create and maintain these technologies to provide this information. This includes specific business uses cases and examples; explanations for third-party concepts; details about the data models and input and output data formats for third-party technologies; and various types of IDs, URL patterns, connection string formats, and other technical information that is specific to the third-party technologies. For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?
How to Start
- On the Application Explorer screen, do one of these:
- Do one of these:
- Add a Single Select Lookup
control:
- On the eForm Builder screen, in the Toolbox, open the Advanced Controls
tab.
- On the Advanced Controls
tab, drag a Single Select Lookup
form control onto your eForm.
- On the eForm Builder screen, in the Toolbox, open the Advanced Controls
- Change a Single Select Lookup
control:
- On your eForm, click the control, and click Edit
.
- On your eForm, click the control, and click Edit
- Add a Single Select Lookup
- On the Single Select Lookup screen, in the Configure tab,
click Add Lookup
.
- On the Select Data Source Type screen,
select
REST Service
.
- Click Next.
- On the Lookup Details screen, select Name/Value.
- Click Next.
Advanced Configuration tab

Fields
Field Name | Definition |
---|---|
Request URL |
|
Action |
|
Content Type |
|
Accept |
|
Protocol |
|
Request Timeout (Seconds) |
|
Read/Write Timeout (Seconds) |
|
Header Information |
|
Add Header |
|
Authentication |
|
Advanced Configuration > Authentication screen > Basic Authentication tab
Creates REST service authentication credentials to connect to a REST service URL with basic authentication.

Fields
Field Name | Definition |
---|---|
User Name |
|
Password |
|
Authorization |
|
Generate |
|
Insert |
|
Reset |
|
Advanced Configuration > Authentication screen > OAuth 2.0 tab
Creates REST service authentication credentials to connect to a REST service URL with the OAuth 2.0 protocol.

Fields
Field Name | Definition |
---|---|
Token Type |
|
Token |
|
Advanced Configuration > Authentication screen > Windows Authentication tab
Creates REST service authentication credentials to connect to a REST service URL with Windows Authentication (NTLM).

Fields
Field Name | Definition |
---|---|
Domain |
|
User Name |
|
Password |
|
Request tab
Configures the request payload for the REST service method call.

Fields
Field Name | Definition |
---|---|
Request Payload |
|
Map Schema |
|
Response tab
Configures to connect response data from the web service call to your process.

Field Name | Definition |
---|---|
Store the Response in Form Field |
|
Enter Sample Response |
|
Header (Optional) |
|
Add New Record |
|
Update |
|
Delete |
|
Edit |
|
Sample JSON/XML |
|
Payload |
|
Simulate |
|
Map Schema |
|
Error Messages tab
Configures the message to show if the lookup does not return any data.

Fields
Field Name | Definition |
---|---|
No Items Available |
|
Failure Messages |
|