DML functions: Sentinel

getTrackedObjectName

getTrackedObjectId

getTrackedObjectUserId

sendCycleLink

The following Sentinel functions are available:

getTrackedObjectName

getTrackedObjectName Comment

Description

getTrackedObjectName returns the name of the Sentinel Tracked Object associated with the currently handled message.

Syntax

getTrackedObjectName()

Returns

Name of the Sentinel Tracked Object associated with the message. (string)

Parameters

none

Example

getTrackedObjectName()

getTrackedObjectId

getTrackedObjectId Comment

Description

getTrackedObjectId returns the ID of the Sentinel Tracked Object associated with the currently handled message.

Syntax

getTrackedObjectId()

Returns

Identity of the Sentinel Tracked Object associated with the message. (string)

Parameters

none

Example

getTrackedObjectId()

getTrackedObjectUserId

getTrackedObjectUserId Comment

Description

getTrackedObjectUserId returns the identity of the event within the Tracked Object cycle.

Syntax

getTrackedObjectUserId()

Returns

The identity of the event within the Tracked Object cycle. (string)

Parameters

none

Example

getTrackedObjectUserId()

The generation of cycle links is a Sentinel-related functionality that creates a sequential relationship between two Tracked Events. These events may occur on two different applications. Either or both events may occur as part of integration processing.

sendCycleLink Comment

Description

sendCycleLink creates a relationship between two Sentinel Tracked Events. For use in the DML Block.

Syntax

sendCycleLinkParentObjectName, ParentCycleId, (ChildObjectName, ChildCycleId)

Return

Does not return a value.

Parameters

(mandatory)

ParentObjectName:

The parent Sentinel Tracked Object name.

ParentCycleId:

The Sentinel Tracked Event cycle ID of the parent event.

ChildObjectName:

The child Sentinel Tracked Object name.

ChildCycleId:

The Tracked Event cycle ID of the child event.

Example

See example

The following graphic illustrates a scenario in which the Map Engine uses the SendCycleLink function.

  1. Integration 1, occurring on an Map Engine server, sends a Tracked Event message describing a business-related event to Sentinel:
  • ObjectName = TO-A
  • CycleId = CI-A
  1. Integration 1, occurring on an Mapping Services Server, uses the function sendCycleLink("TO-A","CI-A","TO-B","CI-B") to create the CycleLink: (TO-A ; CI-A) / (TO-B ; CI-B)
  2. Mapping Services Integration 1 generates a file for Application B.
  3. Application B reads the file generated by the Map Engine 1.
  4. Application B sends a Tracked Event message describing a business-related event to Sentinel (ObjectName = TO-B & CycleId = CI-B):
  • ObjectName = TO-B
  • CycleId = CI-B
  1. Sentinel stores the related Tracked Event and Cycle link records.

Related Links