6 - Share events for discovery by others

Note: To follow the step-by-step instructions in this tutorial, you can watch the video or read the instructions on the page.

Scenario: Sharing results of analysis and processing

The EMEA operations team wants to share their new topic of EMEA orders for use by other teams in their enterprise.

Instructions

Step 1 : Create a flow

This tutorial begins with the flow that is created in Triggering actions.

If you haven’t completed that tutorial yet, you should do it now.

Step 2 : Add the topic to the catalog

The next step is to provide the topic details to create an entry in the catalog.

  1. Go to the Event Streams page for the new ORDERS.EMEA topic created in the previous tutorial.

    screenshot

    If you need a reminder of how to access Event Streams, you can review Accessing the tutorial environment.

  2. Click Share for reuse.

    screenshot

  3. Click Next.

  4. Paste your access token from Event Endpoint Management cluster.

    screenshot

    You can generate access tokens from the profile page in Event Endpoint Management.

  5. Give the event source the name EMEA orders.

    screenshot

    Verify the sample message selected.

  6. Click Share for reuse.

Step 3 : Document the topic

The next step is to document the topic to describe the events that your processing flow is producing.

  1. Go to the Event Endpoint Management Topics page.

    screenshot

    If you need a reminder of how to access Event Endpoint Management, you can review Accessing the tutorial environment.

  2. Click the new EMEA orders topic.

    screenshot

  3. Use Edit information to provide documentation for the topic.

    screenshot

  4. Add a description of the events generated by your processing flow.

    screenshot

    Suggested description:

    “Events from the EMEA region recorded by the order management system”

  5. Click Save.

Step 4 : Publish the topic

The final step is to publish the new topic in the catalog so that it can be discovered by other teams in your enterprise.

  1. Click the Create option button in the Options tab.

    screenshot

  2. Create a name for the access option that you are creating.

    screenshot

    Calling the option “Self service” is a good way to describe a topic being published without any approval requirements.

  3. Create a topic alias for the option.

    As this is the only option, ORDERS.EMEA is a reasonable alias.

  4. As we are not adding any additional controls, click Save.

    screenshot

  5. Click Publish.

    screenshot

  6. Confirm the gateway group and click Publish.

    screenshot

  7. Confirm that the topic is published by switching to the catalog.

    screenshot

  8. Confirm that your sample message and description are displayed in the topic details page.

    screenshot

Recap

You published the results of your event processing flow to a catalog.

The documentation you provided will enable other people in your enterprise to make use of the events your flow is producing, and the catalog will allow them to create their own credentials for using the topic.

Next step

You have completed the guided tutorial. You used all three capabilities in IBM Event Automation: creating topics in Event Streams, discovering and publishing topics in Event Endpoint Management, and processing events in Event Processing.

If you would like more ideas of things to try in Event Processing, we have more Tutorials for Event Processing, which are there to show you other things that you can do, and inspire you with ideas for your own projects.