Create a Unique Instance Identifier

Every Integration Insight model must have an identifier defined. This identifier specifies the value that should be extracted at runtime as the unique instance identifier for every instance of the business process defined by the model.

Users with the ServiceAdministrator, ServiceDeveloper, or ServiceDeployer roles can create, edit, and update a model.

To create a unique instance identifier:

  1. In the Oracle Integration navigation pane, click Insight.

  2. In the Insight navigation pane, click Models.

  3. On the Models page, click the draft model for which you want to create an identifier.

  4. Choose one of the following options:

    • Create a Unique Instance Identifier from a Milestone:

      1. In the Model Designer, expand the milestone to which to associate the identifier.

      2. In the Indicators section, click the Create Create icon icon, then select Identifier.


        Create Identifier

        Note:

        You can create only one identifier per model. If one is already created, the Identifier option in this list is not selectable.

    • Create a Unique Instance Identifier from the Unique Instance Identifier Tile:

      • In the Model Designer, click the Unique Instance Identifier tile.


        Unique Instance Identifier
  5. Enter a name that identifies a unique value in the business process.

    Make sure that the value you specify will identify unique instances in the business process. For example, OrderID. You do not want to specify something like salesRepId, because the same sales representative is likely responsible for multiple orders and therefore is not a unique identifier among instances of the business process defined by the model.

  6. Press the Enter key, then enter a description for the identifier.

  7. If API invocations are enabled for the milestone, set the data type for the identifier. In the API Data Type field, click the Click to set the API data type icon, and then select the data type of the identifier.

    The data types available for identifiers are: String, Integer, Float, Decimal, and Date.

An identifier is created for the model.

See Add Additional Unique Instance Identifier Associations if your business process spans multiple integrations.

After all model creation tasks are complete, see Associate a Model to a Business Process Implementation.

Add Additional Unique Instance Identifier Associations

Integration Insight uses the unique instance identifier to correlate events to the same instance of a business process (like an order or a warranty claim). If your business process implementation spans more than one integration, you need to associate it to an additional milestone in your model for each integration (or other disconnection point) to correlate events from all integrations as belonging to the same instance.

Users with the ServiceAdministrator, ServiceDeveloper, or ServiceDeployer roles can define unique instance identifiers.

To add additional unique instance identifier associations:

  1. In the Oracle Integration navigation pane, click Insight.
  2. In the Insight navigation pane, click Models.
  3. On the Models page, click the draft model for which you want to create an additional unique instance identifier.
  4. In the Model Designer, click the Unique Instance Identifier tile.
  5. For each integration in your business process flow:
    1. Click Reinitialize Identifier.
    2. In the new Milestone section that appears, click the Select milestone icon, and then select a milestone.
  6. Click Save.
If the milestone(s) you selected are not yet mapped to an integration, see Map a Milestone to an Integration. If the milestones are already mapped, see Define Identifier Extraction Criteria.