Add the REST Adapter as a Trigger Connection
When you drag the REST Adapter into the integration canvas as a trigger connection, the Adapter Endpoint Configuration Wizard is invoked. Based on your selections in the wizard, the following pages can be displayed.
REST Adapter Trigger Basic Information Page
Enter the REST Adapter user name and description. You can also select to configure multiple resources or verbs.
Element | Description |
---|---|
What do you want to call your endpoint? |
Provide a meaningful name so that others can understand the connection. For example, if you are creating a source Oracle REST connection, you may want to name it
ExposeFlowAsRESTResource . You can include English alphabetic characters, numbers, underscores, and dashes in the name. You cannot include the following:
|
What does this endpoint do? |
Enter an optional description of the endpoint's responsibilities (for example, |
Select to configure multiple resources or verbs (maximum 11) |
Select to configure multiple operation entry points with different resource URIs and HTTP actions/verbs, as necessary. Each operation represents a different pick action branch in a single integration. The maximum number of operations (branches) you can create in one integration is eleven. This feature eliminates the need to create multiple integrations (each with a separate resource URI and verb) to perform different operations. |
REST Adapter Trigger Resource Configuration Page
Enter the REST Adapter operation name, relative resource URI, and endpoint action. You can also select to add query and template parameters or configure a request and/or response for the endpoint.
Element | Description |
---|---|
Provide an operation name |
Enter an operation name. |
What does this operation do? |
Enter an optional description of the operation's responsibilities. |
What is the endpoint’s relative resource URI? |
Specify the relative path associated with the resource. The path can contain
template parameters specified with curly braces (for example,
{order-id} ). A resource is any source of specific
information that can be addressed. The resource path follows a fixed,
prefixed URL appended with the specified relative path. By default, the
URL is prefixed with the following
path:
For example, if the integration name is
You can override the URL, except for the fixed part at the beginning:
|
What action do you want to perform on the endpoint? |
Select a single HTTP action (method) for the endpoint to perform:
|
Select any options that you want to configure |
Select the options that you want to configure:
|
Configure Request Headers? |
Select the type of request header to configure:
|
Configure Response Headers? |
Select the type of response header to configure:
|
Configure CORS (Cross Origin Resource Sharing) (available only in the trigger (inbound) direction) |
Select to configure CORS parameters for a trigger. CORS enables restricted resources (for example,. custom HTTP headers that introduce cross-site Java scripting security issues) on a web page to be requested from another domain outside of the domain from which the resource originated. |
REST Adapter Trigger Request Parameters Page
Enter the REST Adapter request parameters for this endpoint.
Element | Description |
---|---|
Resource URI |
Displays the endpoint relative resource URI entered on the Basic Info page. |
Specify Query Parameters |
Specify query parameters for the REST endpoint. Click the Add icon to display a row for entering the parameter name and selecting its data type. For example, specify Click the Delete icon to delete a selected row. |
Template Parameters |
Displays the template parameters in the relative resource URI. Template parameters are based on details you specified on the Basic Info page and cannot be edited. Template parameters must be defined as part of a path with curly braces around them. For example, the URL Note:
|
REST Adapter Trigger Request Page
Enter the REST Adapter request payload details for the endpoint.
Element | Description |
---|---|
Select the multipart attachment processing options |
Configure the following options based on whether the request is inbound or outbound. For inbound (trigger) requests, select the multipart attachment type to include. This option is only available if you selected the POST action on the Basic Info page.
|
Select the request payload format |
Note:
Select the request payload format to use. The request payload body must be defined by the XSD element that defines the structure of this representation.
|
Schema Location |
Specify the schema file in either of the following ways:
|
Element |
Select the element that defines the payload structure. This field is not displayed until you import the request payload file. Once you browse for and select the schema or JSON sample file, the schema is displayed automatically. It also displays a combination box that selects the root element by default. |
What is the media-type of the Request Body? (Content-Type Header) |
Select the multipart attachment type for the endpoint to receive. This field is
displayed if you selected the Request is multipart with
payload option in the Select the multipart attachment
processing options field.
|
REST Adapter Trigger Request Header Page
Enter the REST Adapter request header properties for this endpoint.
Note:
If you specify a custom header name that is the same as a standard header name, an error occurs. Ensure that you specify unique names for your custom headers.Specify the standard HTTP request headers to use.
Element | Description |
---|---|
Add Standard Request Headers |
Select the standard HTTP request header to use from the default dropdown list.
|
HTTP Header Name |
Perform the following tasks:
|
Specify the custom HTTP request headers to use.
Element | Description |
---|---|
Add Custom Request Headers |
Perform the following custom request header tasks:
|
Custom Header Name |
Enter the custom header name. |
Custom Header Description |
Enter an optional description. |
REST Adapter Trigger CORS Configuration Page
Enter the REST Adapter CORS configuration properties for this endpoint.
Element | Description |
---|---|
Allowed Origins |
Specify the allowable domains from which to make CORS requests. Requests coming from these domains are accepted. Enter an asterisk ( |
Allowed Methods |
The allowed method displayed is based on your selection in the What action does the endpoint perform? list on the Basic Info page. Requests are only accepted from the allowable domains that perform the allowable actions (methods). You cannot configure the method name listed in the CORS configuration. |
REST Adapter Trigger Response Page
Enter the REST Adapter response payload details for the endpoint.
Element | Description |
---|---|
Select the multipart attachment processing options |
Configure the following options based on whether the request is inbound or outbound. For inbound (trigger) responses, select the multipart attachment type to include.
|
Select the response payload format |
Note:
Select the response payload format to use. The response payload body must be defined by the XSD element that defines the structure of this representation.
|
Schema Location |
Specify the schema file in either of the following ways:
|
Element |
Select the element that defines the payload structure. This field is not displayed until you import the response payload file. Once you browse for and select the schema file, it displays a combination box that selects the root element by default. |
What is the media-type of Response Body (Accept Header) |
Select the payload type with which you want the endpoint to reply.
Select the multipart attachment type for the endpoint to receive. This field is
displayed if you selected the Response is multipart with
payload option in the Select the multipart
attachment processing options field.
|
REST Adapter Trigger Response Header Page
Enter the REST Adapter response header properties for this endpoint.
Note:
If you specify a custom header name that is the same as a standard header name, an error occurs. Ensure that you specify unique names for your custom headers.Specify the standard HTTP response headers to use.
Element | Description |
---|---|
Add Standard Response Headers |
Select the standard HTTP response header to use from the default dropdown list.
|
HTTP Header Name |
Perform the following tasks:
|
Specify the custom HTTP response headers to use.
Element | Description |
---|---|
Add Custom Response Headers |
Perform the following custom response header tasks:
|
Custom Header Name |
Enter the custom header name. |
Custom Header Description |
Enter an optional description. |
REST Adapter Trigger Operations Page
Review or edit existing operations or add a new operation. Each operation represents a different pick action branch in a single integration. The maximum number of operations (branches) you can create in one integration is six. Each entry point can be configured with a different resource URI and HTTP action/verb, as necessary. This feature eliminates the need to create multiple integrations (each with a separate resource URI and verb) to perform different operations. You can expose multiple entry points to a single integration with a pick action that uses the REST Adapter as the trigger connection.
See Receive Requests for Multiple Resources in a Single REST Adapter Trigger Connection of Using Integrations in Oracle Integration 3.
Element | Description |
---|---|
Operation | Displays the operation name entered on the Resource Configuration page. |
Resource | Displays the endpoint relative resource URL selected on the Resource Configuration page. |
HTTP Method | Displays the action selected on the Resource Configuration page. |
Edit/Delete | Select to edit or delete an operation and its endpoint relative resource URL and action. |
Add another operation | Select to return to the Resource Configuration page to add another operation name, endpoint relative resource URL, and action. |
REST Adapter Trigger Operation Selection Page
Enter the REST Adapter invoke operation selection parameters for this endpoint.
Element | Description |
---|---|
Business Object |
Select the business object (resource) to use in this connection. |
Operations |
Select the operation (method) to perform on the business object in this connection. |
Summary Page
You can review the specified adapter configuration values on the Summary page.
Element | Description |
---|---|
Summary |
Displays a summary of the configuration values you defined on previous pages of the wizard. The information that is displayed can vary by adapter. For some adapters, the selected business objects and operation name are displayed. For adapters for which a generated XSD file is provided, click the XSD link to view a read-only version of the file. To return to a previous page to update any values, click the appropriate tab in the left panel or click Go back. To cancel your configuration details, click Cancel. Click
generate a sample cURL to
generate sample |