Defining An Event Message Map

Note: Currently, Message Maps support Connectors that can send Messages to TIBCO Scribe® Online, such as Salesforce or HTTP, Connectors created by other vendors, or Custom Connectors. For more information, see the Help for the specific Connector or the third-party Application Help.

Use this feature only if you understand how outbound messaging works in the source Application.

In this example, we used a TIBCO Scribe® Online Message-Based Map to process outbound messages from Salesforce and integrate the records within the messages into a target datastore.

If your site has Salesforce Outbound Messaging set up for a specific object, a message may be created whenever a change is made to the records in that Salesforce object or entity.

Note: TIBCO Scribe® Online throttles the number of inbound messages processed by the Agents to 20 messages per batch for both the Cloud Agent and the On-Premise Agent. When the batch is complete, the Agent requests another batch of messages until the Message Queue is empty.

As illustrated in this image, the outbound message pings the TIBCO Scribe® Online cloud endpoint, which uses a URL that is unique for each Message Map to relay the message to TIBCO Scribe® Online.

Message-based Event map overview

In TIBCO Scribe® Online, use the Create Map dialog to create visual Maps by pulling the elements, or Blocks, from the Connections panel to the mapping workspace. For Message Maps, each Map can process a single type of entity from Salesforce.

Creating Maps

When you open a Map the Connections panel and workspace display. The Connections panel contains all of the Blocks required to easily create Maps used to integrate your source data into one or more target datastores. To build your Map, move the Blocks into the workspace.

Each time you save your Map a separate revision of the Map is stored. Before saving, enter a comment in the Comment field at the bottom of the workspace to associate a comment with the new revision. You can revert to a prior revision from the Revisions dialog. See Map Revisions for additional information.

Selecting Connections

Each Connection in a Map can be used for both Source and Target operations based on what the Connector and the associated datastore support. For example, if you have a Salesforce Connection and you use a Query Block for that Connection in the Map, the Query is a Source operation, therefore, Salesforce is the Source for that Block. If you use a Create Block for the Salesforce Connection in the Map, Create is a Target operation, and Salesforce is the Target for that Block.

Connections are sorted based on the order in which they were added to the Map. The color of the Blocks associated with a Connection is determined by the order of the Connections. Control Blocks are always light blue, the first Connection Blocks are always orange, and Blocks for the second Connection are yellow, Blocks for the third Connection are green, and so on up to eleven Connections.

TIBCO Scribe® Online supports multiple target datastores in Integration Maps. You can integrate data from one source into multiple targets. For example, while integrating your Microsoft Dynamics GP data into Salesforce, you can also send data from the same run to a CSV Text file for reporting purposes. Add Connections to a Map to connect to one or more target datastores.

The first step is to select or create up Connections in the Connections panel on the left side of the Map. From the Connections panel, you can either:

As soon as a valid Connection is selected, all of the Blocks supported by the Connection display in the Connection panel.

Starting A Map

After you select your Connections, you can begin to create a Map. A Map is a visual representation of the instructions needed to integrate your data. For Message Maps, the Map must start with a Wait For Message Block.

Add Wait For Message Block

  1. From the Connections panel, select theWait For Message Block associated with the Connection you want to use as a data source and drag it to the workspace.

    Tip: As you drag and drop Blocks, the top border always changes color. If the color of the Block is transparent, you have not attached it correctly to the previous Block and the Map does not run.

    When you first drag Blocks over, they often display an error in the corner. This is expected because the Block is missing important configuration information, such as the entity you want to use.

  2. Select the Wait For Message Block.
  3. Select the General link in the Properties panel to open the Wait For Message Block Properties.
  4. Select your source entity. At this point, you can continue to build your Map, or you can close the Properties dialog and save the Map.
  5. Select the next Block for your Map. Unlike a regular Map, the For Each Result block is not required or available.

    As you build your Map, keep in mind that you only define the processing for one record at a time. If a message contains multiple records, your Map runs once for each record.

  6. When you are done, select OK to save and close your Map. Then, configure the Outbound Message in Salesforce.

    Note: After saving the Map the first time, TIBCO Scribe® Online generates a unique Endpoint URL which displays on the Block Properties — General tab. This may take a few minutes.

    You must copy and paste the URL into the source Application. See the Administrator for the Application or the associated Help.

Note: Using the Apply button to save an Event Message Map does not update Properties tab for the Wait For Message Block with the Endpoint URL. Use the OK button to save and close the Map.

Set Security Rules

From the Security dialog under More > Security, specify the security rules for the Event Solutions in this Organization.

Important: When an Event Solution runs, TIBCO Scribe® Online sends a response to Messages or Requests for data from any one of three static IP addresses. Configure your Proxy Server, Firewall, or other network security devices to allow responses from these IP addresses to access your network. Static IP Addresses include: 

Example: Creating The Outbound Message In Salesforce

To use a Message Map, you need to create a Workflow and an Outbound Message in Salesforce. The message you configure uses the Endpoint URL displayed in the Wait for Message Block.

  1. Create a new Workflow Rule
  2. Add a new Outbound Message as a Workflow Action
  3. For the new Outbound Message, copy the Endpoint URL from the Wait for Message Block for this entity.

    Note: Every Message Map has a unique URL. Make sure that you configure your messages for the correct Maps.

  4. When you are done, be sure to activate the Workflow Rule.

Note: Once created and activated, you can monitor the Outbound Messages in Salesforce.

For detailed information about configuring and monitoring Workflows and Outbound Messages, see the Salesforce Help.

Related Topics

Integration Maps

Working With Blocks

Control Blocks

Debugging Maps

Block Properties General Tab

Wait For Message Block

Map Revisions