Set Dynamic Reference

The Set Dynamic Reference task provides the values needed for resolving a service provider in a dynamic target interface.

Each Set Dynamic Reference task sets the value of the service provider for the specified dynamic target interface—either the end of the mediation path points to a dynamic target interface, or an Invoke task invokes an operation on a dynamic target interface.

General Tab

Use the General tab to specify a name and description of the Set Dynamic Reference task, and to set the target interface and endpoint reference mechanism.

Field Description
Name Assign a name to the task, to identify the task in the mediation flow. This name appears in the tooltip that opens when you hover the cursor over the task icon in the mediation flow.
Description Describe the task briefly. This description appears in the tooltip that opens when you hover the cursor over the task icon in the mediation flow.
Dynamic Target Interface

The name of the dynamic target interface for which this task is supplying the service name and namespace.

By default, this field is automatically set to the dynamic target interface at the other end of the path. If an Invoke task is on the path, this field may be set by default to the first dynamic target interface in the target interface list. You might need to set this field when the default choice does not match the dynamic target interface that you want to set.

The name of the dynamic target interface for which this task is supplying the application and service name. By default, this field is set to the dynamic target interface at the other end of the path. If there is an Invoke task on the path, this field can be set by default to the first dynamic target interface in the target interface list. You might need to set this field when the default choice does not match the dynamic target interface that you want to set.

Endpoint Reference Mechanism Select an option for the mechanism to use for setting the application and service name:
  • Application & Service Name: Select to supply the application name and service name. This option requires two inputs for mapping on the Input tab—ApplicationName and ServiceName.
  • Application & Service URI: Select to supply the exact URI of the endpoint. This is useful if, for example, someone sends you the URI—you simply copy and paste it into the ApplicationServiceURI parameter on the Input tab.
  • URI: Select this option to specify a URI.
  • Pattern Variables: Select to use pattern variables from the dynamic target interface. This is useful if several operations in a dynamic target interface use a similar pattern for the application name and service name. You can specify the mapping once on the dynamic target interface and use variables to supply the variable portion. The variables you create on the dynamic target interface appear in the Input tab when this option is selected.

By default, the Endpoint Mechanism field is set to Application & Service Name when the dynamic target interface has no pattern variables.

If the dynamic target interface has pattern variables, the Endpoint Mechanism field is set to Pattern Variables by default.

Input Tab

When the Endpoint Reference Mechanism field on the General tab is set to Service & Namespace, the input elements for this task are serviceName and serviceNamespace. Any value you specify for these input elements overrides the value specified on the Pattern Map tab of the specified dynamic target interface.

When the Endpoint Reference Mechanism field on the General tab is set to Pattern Variables, then the pattern variables defined on the specified dynamic target interface are the input elements. This enables you to specify simple mappings of data from the mediation exchange to the variable values. The variable values are then passed to the mapping supplied on the Pattern Map tab of the dynamic target interface.

Use any data available in the mediation exchange on the left side of the mapper panel to provide data to the input values.

The content of the Input tab depends on which Endpoint Reference Mechanism you select on the General tab — Application & Service Name, Application & Service URI, or Pattern Variables:

Application & Service Name
When the Endpoint Reference Mechanism field on the General tab is set to Application & Service Name, the input elements for the Set Dynamic Reference task are ApplicationName and ServiceName:
  • ApplicationName refers to the application name provided during deployment of a composite, to uniquely identify an instance of an application template.
  • ServiceName is the name of the composite service that is contained in the target composite.
Application & Service URI

When the Endpoint Reference Mechanism field on the General tab is set to Application & Service URI, the input element for the Set Dynamic Reference task is ApplicationServiceURI.

The data type of the ApplicationServiceURI input field is a URI of the format

urn:amx:EnvironmentName/ApplicationName#service(ServiceName)

The variables EnvironmentName, ApplicationName, and ServiceName refer to the environment and service that are being invoked:
  • EnvironmentName is the name of the ActiveMatrix environment that contains the target service.
  • ApplicationName refers to the application name that is provided during deployment of a composite, to uniquely identify an instance of an application template.
  • ServiceName is the name of the composite service that is contained in the target composite.
URI
When the Endpoint Reference Mechanism field on the General tab is set to URI, the input elements for the Set Dynamic Reference task are URI.:

  • SOAP over HTTP

    http://<HostName>:<PortNumber>/<Path>

    <PortNumber> and <Path> are optional elements.

  • SOAP over JMS: Specify the queue as jms:queue:<QueueName>

  • ActiveMatrix Service Virtualization

    urn:amx:<EnvironmentName>/<ApplicationName>#service(<PromotedServiceName>)

Pattern Variables

When the Endpoint Reference Mechanism field on the General tab is set to Pattern Variables, the pattern variables that are defined on the specified dynamic target interface are the input elements.

This enables you to specify simple mappings of data from the mediation exchange to the variable values. The variable values are then passed to the mapping supplied on the Pattern Map tab of the dynamic target interface. You can use any data available in the mediation exchange on the left side of the mapper panel to provide data to the input values.