This documentation supports an earlier version of BMC Helix Operations Management.To view the documentation for the latest version, select 23.3 from the Product version picker.

Example: Enrich event details with the encoded event ID

Scenario

Sarah is an administrator at Apex Global. She wants to access the BMC Helix Operations Management Event Details page securely from an event notification email by using a direct cross-launch URL. It is easier for Sarah to click the cross-launch URL in an email rather than navigate to the Event Details page. To achieve this goal, she can perform the following steps:

  1. Use the ToBase64 function to encode the event ID to a Base64 value. To learn about the ToBase64 function, see Return-functions.
  2. Enrich an event slot by appending the encoded event ID to the cross-launch URL of the desired tenant.
  3. Use the enriched event slot value in the notification email.

To enrich the detailed message event slot, perform the following steps:

  1. Define the event selection criteria.
  2. Build the policy workflow.

Actions used in the example

  • Variable
  • Enrich

For more information about actions, see Actions-for-advanced-and-time-based-enrichment.

To define the event selection criteria

  1. Select Configuration > Event Policies and click Create.
  2. In Event Selection Criteria, define a condition to select events that contain the message base64demo.

The following image illustrates how the event selection criteria will look:

Base 64 event selection criteria.png

To learn how to construct the event selection criteria, see Creating-and-enabling-event-policies.

To build the policy workflow

On the Advanced Enrichment page, perform the following steps:

TipYou can hover over an action to view the complete label for the action as shown:Action_hover.png

  1. Add the Variable action to encode the event ID to a Base64 value. Use the ToBase64 function to convert the event ID and store the function output in the $Base64EventID variable. 
    Base64 variable.png

  2. Add an Enrich action to enrich the detailed message slot with the cross-launch URL of the desired tenant where the event ID is encoded to the Base64 value. Use the Concat function to append the encoded event ID to the desired tenant URL and save the advanced enrichment policy configuration.
    Enrich detailed message base64.png
  3. On the Update Event Policy page, add an email Notification policy configuration and use the enriched value of the detailed message slot in the email body as shown in the following screenshot. Save the notification policy configuration.
    Email notification with encoded cross-launch URL.png
  4. Both policy configurations are listed as shown in the following screenshot. Enable the policy and click Save.
    Save event policy.png

Results

The resulting policy workflow enriches the detailed message with the cross-launch URL of the desired tenant where the event ID is encoded (Base64). The notification email contains the encoded cross-launch URL to the Event Details page.

Without event enrichment

Before enrichment base64.png

With event enrichment

After enrichment base64.png

Notification email.png

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*