Install and Configure the Recipe

On your Oracle Integration instance, install the recipe package to deploy and configure the integration and associated resources.

1. On the Oracle Integration Home page, scroll to the Accelerators & Recipes section.
2. Click Search All.
   The list of available recipes appears.
3. Select the recipe you want to install, and click Install .
   A confirmation message informing that the recipe was successfully installed appears, and the recipe now displays the Installed tag.
4. Click Configure on the recipe card to configure the following resources using the Configuration Editor.
   • Configure the Oracle ServiceNow Connection
   • Configure the Oracle Box Connection
   • Update Integration Properties

Configure the Oracle ServiceNow Connection

You must configure connection properties and log in credentials for your ServiceNow instance.

1. On the Configuration Editor page, select Oracle ServiceNow Connection.
2. Click Edit .
   The ServiceNow Connection window appears.
3. In the Connection Properties section, enter your ServiceNow instance URL in the ServiceNow Instance Name field. For example, https://<instance_name>.service-now.com/.
4. In the Security section, enter your ServiceNow username in the Username field, and your ServiceNow password in the Password field.
5. Click Save.
6. Click Test to ensure that your connection is successfully configured. In the dialog that displays, click Test again. You get a confirmation message if your test is successful.
7. Click Back to return to the Configuration Editor page.

Configure the Oracle Box Connection

You must specify security details such as credentials, permissions, and signature keys to access your Box instance endpoint.

1. On the Configuration Editor page, select Oracle Box Connection.
2. Click Edit .
   The Box Connection window appears.
3. In the Client ID and Client Secret field, enter the client ID and secret you obtained earlier while creating and configuring a Box App.
   See Create and Configure a Box App.
4. Enter the following authorization permissions in the Scope field.
   • root_readwrite
   • manage_webhook

   The root_readwrite permission lets you perform file/folder operations. The manage_webhook permission lets you use webhook operations. For more information on these scopes see the documentation on the Box.com website.

5. In the Primary Signature Key and the Secondary Signature Key fields, enter the primary and secondary signature keys that you obtained earlier while creating and configuring a Box app.
   See Create and Configure a Box App.
6. Click Provide Consent.
7. In the resulting Sign in dialog, enter your Oracle Integration username and password in the Username and Password fields, and click Sign in.
   A browser window to grant access to Box appears.
8. Enter your Box account credentials, and click Authorize.
9. In the next page, click Grant access to Box.
   You're informed that access to Box is allowed. You can now switch back to the Box Connection window in Oracle Integration to save and test your connection.
10. On the Box Connection window, click Save.
11. Click Test to ensure that your connection is successfully configured. In the dialog that displays, click Test again. You get a confirmation message if your test is successful.
12. Click Back to return to the Configuration Editor page.

Update Integration Properties

You must update the properties for the integration so that new folders for ServiceNow incidents are created under the right parent folder in Box, and runtime exception emails are sent to the right email ID.

1. On the Configuration Editor page, select the Oracle ServiceNow Box Incidents BoxFolder Create integration.
2. Click Actions , and then click Update Property Values.
3. In the Update Property Values dialog, note the two properties that have been configured - NotificationMail and ParentFolderID.
4. Click NotificationMail and in the New Value field, enter the email ID where you want to notify in case a run time exception/error occurs while running the integration.
5. Click ParentFolderID and in the New Value field, enter the parent folder ID you obtained earlier.
   See Get the Parent Folder ID.
6. Click Submit.
   You get a confirmation message that the integration properties have been updated successfully.