Expresso Provider

The Expresso Provider shared resource collects events from the ExpressoNotify activity and sends them to the Expresso server.

General

The General tab has the following fields.

Field Description
Package Displays the name of the process package that contains the package. This field is not editable.
Name The name of the Expresso Provider shared resource. The name is dispalyed as Domain Name on the mobile application UI.
Description A short description of the Expresso Provider shared resource.

Provider Configuration

Specify appropriate values in the following fields.

Field Literal Value/Module Property Description
Provider Description Yes A short description of the provider. The description is displayed as Domain Description on the mobile application UI.
Provider Color Select the pod color for the providers on the mobile application UI.

Expresso Server Details

Specify appropriate values in the following fields.

Field Literal Value/Module Property Description
Expresso Host Yes The host name or IP address of the Expresso Server. Default host is localhost.
Expresso Port Yes The port of the Expresso server. The default value is 36136.

Test Connection

The Test Connection button tests the connection to the specified Expresso server. You can use this button to ensure that the server client is configured correctly.

Provider Server Configuration

HTTP Connector

The HTTP Connector shared resource holds the HTTP service configuration. The Expresso Provider uses the shared resource to deploy its REST services on (listening to subscribe or unsubscribe requests). For details about the HTTP Connector, refer to TIBCO ActiveMatrix BusinessWorks Bindings and Palettes Reference.

Click the icon, and select the existing HTTPConnectorResource or create a new HTTPConnectorResource from the Select HttpConnResource Resource Template window.

Event Configuration

To reach the internal providers on servers deployed inside the firewall, specify the public host and public port properties. Provider end point URL's are generated using the public host and port properties.

To override the host and port values use the following system properties:

  • bw.plugin.mi.expresso.public.host
  • bw.plugin.mi.expresso.public.port
Note: One Expresso event is equivalent to one ExpressoNotify activity.

Specify appropriate values in the following fields.

Column Name Description
Event Name The name of the Expresso Event. This name is dispalyed as the name of the pod on the mobile application UI.
Note: The Event Name must be unique in the provider and must not contain spaces.
Implementing Process The qualified name of the event.
Opens the Select an Event from Process dialog box. All the available events are displayed. Select the required event.

To create a new event, click the Create New Event Process button. For more details, refer to the section onCreate New Expresso Event Wizard.

Deletes the selected event from the event table.
Opens the process implementation for the selected event.
Validates events and ensures that all the events are available in the module.
Reselectes event implementation.

If you rename the ExpressoNotify activity in an event or in a process containing the event, use this button to reselect the event implementation. After the reselection, validate the event using by clicking the validate button.

Description The description of the selected event. The description is displayed as the decription of the pod on the mobile application UI.
Usage Event Usage - sample usage of the selected event. The Usage is displayed as the pod sample usage on the mobile application UI.

Event Data- displays the tree structure of the event data for the selected event. You can drag and drop data from the Event Data tree to Event Usage.

Schema JSON Draft 4 schema for the selected event. This field is not editable.

Create New Expresso Event Wizard

Selecting the Create New Event Process button opens the Create New Expresso Event wizard. Create a new process with the Timer and ExpressoNotify Activity, using this wizard.
Field Description
Process Folder Specify a folder for the process.
Package Specify a process package.
Process Name Specify the process name.
Modifiers Specify the modifiers.

Configure Event Wizard

Configure granular event details using the Configure Event wizard. These configurations can be modified later using the Description, Usage, and Schema tabs.

Field Name Description
Event Name The name of the Expresso Event. The name of the event is displayed as the name of the pod on the mobile application UI.
Note: The Event Name must be unique in the provider.
Process The qualified name of the event. This field is not editable.
Event Subscription URL The subscription url to be used by the Expresso server, to subscribe and unsubscribe to the events. This field is not editable.
Description The description of the the selected event. The description is displayed as the decription of the pod on the mobile application UI.
Event Usage The sample of the selected event on the mobile application UI.

Registering the Providers

After configuring the ExpressoNotify activity and the Expresso Provider shared resource, run the ActiveMatrix BusinessWorks application. The providers are now registered with the configured Expresso sever.

Note: Currently, persistent storage of subscribers is not supported.

The OSGI command rproviders lists all the registered providers.

For example: 

<>@BWEclipseAppNode rproviders
Provider 1
Provider Name Workday
Expresso Server IP http://localhost:36136
Registered At 2014/11/07 12:16:06 IST
No of Events 2