1. Using Integrations in Oracle Integration 3
  2. Create Event Integrations
  3. Share Events Across Projects

Share Events Across Projects

You can select to make events available across projects. This selection allows you to share the event in one project with other projects. This feature also eliminates the need to create separate events in each project.

Guidelines

  • Event sharing is allowed in the following use cases:
    • The publishing integration and shared event are in the same project, while the subscribing integration is in a separate project.
    • The publishing integration, shared event, and subscribing integration are all in separate projects.
    • The publishing integration and subscribing integration are in the same project while the shared event is in a separate project. This use case is described in Share an Event Across Projects.
  • You can export and then import projects into another instance that share events. Any event sharing between the projects is retained.

    Note:

    The order in which you import event sharing projects into another instance matters. For example, assume project A includes publishing and subscribing integrations and project B includes an event being shared (referenced) by project A. You must first import project B with the shared event into the instance before project A can be successfully imported.
  • You cannot delete an event in a project that is shared with integrations in other projects.
  • You cannot delete a project that includes an event that is shared with integrations in other projects.
  • When a shared event is updated, a newer version of the event is created. Any active integrations continue to work with the existing event version. To use the newer event version, you must deactivate the integration and edit the publish event where you can select to use the newer version.

Share an Event Across Projects

This use case provides an overview of how to use event sharing across projects. This use case consists of two projects with the following resources:
Project l2devevt Project l2devflow

Project l2devevt contains the following resources:

  • Event public (shared between projects)
  • Event pvtevt (not shared between projects)

There are no integrations defined in this project.

Project l2devflow contains the following resources:

  • Publishing integration pubflow
  • Subscribing integration sub

There are no events defined in this project.
  1. In the navigation pane, click Projects.
  2. Create a project (for this example, l2devevt is created).
  3. In the Events section, create an event.
  4. Enter a name and an optional description (for this example, public is created).
  5. Click Share with other projects. This option enables you to share the event across projects.
  6. Complete the remaining steps of the wizard to define a JSON-based event. 
    {
    "input1": "value", 

    "input3": false
}
  7. Create a second event, but do not select to share this event with other projects (for this example, pvtevt is created). This event can only be used in the l2devevt project.


    The project is shown. Four vertical tabs are shown. The Integration tab is selected. The Events section is shown. Two events (public and pvtevt) appear in the Events section.

  8. Create a second project (for this example, l2devflow is created).
  9. Create a scheduled integration in this project to publish the shared event (for this example, pubflow is created).
  10. Drag a Publish event integration into the integration canvas.

    The Choose event wizard is displayed.

  11. Click the Shared tab.
  12. Search for and expand the l2devevt project, then select public.


    The Choose event dialog is shown. Tabs for This project and Shared (which is selected) are shown. The Define new event button is shown. The Search field is shown. Below this, the public event is selected.

    Note that the pvtevt is not available for selection because you did not select to share that event with other projects.

  13. Complete the remaining steps of the Choose event wizard.

    When you return to the canvas, note that the word Public appears on the map action. This indicates that this integration is using a shared event.


    The integration canvas shows the schedule, map, and publish actions.

  14. Open the map action, and map the source elements to the target elements.
  15. Create an event integration to subscribe to the event (for this example, sub is created).

    A Subscribe to event trigger is displayed in the integration canvas.

    The Choose event wizard is displayed.

  16. Click the Shared tab.
  17. Select to subscribe to the same event that you published in Step 12 (public).


    The Choose event dialog is shown. Tabs for This project and Shared (which is selected) are shown. The Define new event button is shown. The Search field is shown. Below this, the public event is selected.

  18. Define a business identifier for tracking in the subscribing integration.
  19. Click Deploy.
  20. Create a deployment that includes the publishing and subscribing integrations in l2devevt.


    The deployment page is shown. The integrations included in the deployment are shown, along with the version and Configured label.

  21. Activate the deployment, which activates the integrations.
  22. Run the pubflow integration by selecting Run from the Actions Actions icon menu.
  23. Click Run.

    View the results in the activity stream. The subscribing integration successfully subscribed to the shared event.


    The activity stream shows the key milestones of the integration instance. All are green, indicating that they were successfully processed. The activity stream is expanded to show that the shared published event was successfully processed.

  24. Expand Publish PUBLIC1_REQUEST, then expand the payload to see the shared event type listed.
    Cloud event type: PUBLIC
  25. Click Observe to view additional runtime details. For example, the Subscription tab shows the sub integration that subscribed to the published event.


    The Deploy and Observe tabs (which is selected) are shown. The Integrations, Instances, Subscriptions (which is selected), Future runs, and Audits tabs are shown. Search and filter icons are shown. A table is shown with columns for Subscriber, Event, Retained events, and Subscriber status. The date and a refresh button appear in the upper right.