3 Install and Configure the Recipe

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

  1. On the Oracle Integration Home page, in the Use a recipe/accelerator section, click View all.
  2. Find the recipe you want to install, then click Get.

    A message confirms that the recipe was successfully installed, and the recipe card shows In use.

  3. Click Configure Configure icon on the recipe to configure its resources.

    The project workspace opens, displaying all the resources of the recipe. Configure the following resources before you activate and run the recipe.

Configure the Oracle Cloud Infrastructure Streaming Connection

  1. In the Connections section, click the connection name.
  2. In the Properties section, specify the host and port to use to connect to Oracle Cloud Infrastructure Streaming in the Bootstrap Servers field. For example: streaming.region_location.oci.oraclecloud.com:port.
    Where the region_location is found in the URL when you log in to the Oracle Cloud Infrastructure Console and port is the port value (for example, 9092).

    Note:

    Do not include https:// in the Bootstrap Servers field.
  3. In the Security section, enter the following details:
    Field Information to Enter
    SASL Username

    Enter the user name to access Oracle Cloud Infrastructure Streaming. This is a combination of the tenancy name, stream user name, and stream pool OCID separated by forward slashes (/). For example: xxxtenant/abcuser/yyystreampoolocid

    See Prerequisites for Creating a Connection.

    SASL Password Enter the password.
    TrustStore (Optional) Upload the trust store you generated. This field is optional.
    TrustStore Password (Optional) Enter the trust store password. This field is optional.
  4. Click Save. If prompted, click Save again.
  5. Configure an agent group for accessing the service hosted on your premises behind the fire wall. See Configure an Agent Group.
  6. Test your connection to ensure that it is configured successfully. Click Test in the connection window. In the resulting window, click Test again.

    A message confirms if your test is successful.

  7. To return to the project workspace, click Go back Back icon.

Configure the Integration Flow

To successfully publish messages to Oracle Cloud Infrastructure Streaming, you must edit the PublishTo endpoint in the Oracle Cloud Infrastructure Streaming - Publish integration flow.

  1. In the Integrations section, click the integration flow name.
  2. On the integration canvas, click the Invoke element, and then click Actions Actions icon and select Edit to edit the PublishTo endpoint.
    Specify the stream and partition to which messages are to be sent and be sure to include a sample of the message structure. The integration has the following sample message structure that you'll need to replace. For details, see Stream & Partition Page and Message Structure Page.
    {
       "Id" : “123”,   [ ns2:getFlowId () ]
       "Country":"US",
       "State": "MA" ,
       "County": "Worcester"
     }
  3. To return to the project workspace, click Go back Back icon.