Dynamic Reference Task Setting

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. The value is then used by the next item that refers to a 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.

You may need more than one Set Dynamic Reference task along a mediation path in these situations:

  • The target interface is marked as dynamic and there is an Invoke task on the path configured invoke a different dynamic target interface.
  • More than one Invoke tasks are on a path, and each task invokes a different dynamic target interface.
  • You want to Invoke the same operation on a dynamic target interface more than once, and each time you want to set the dynamic reference to a different value.

Some use cases of the Set Dynamic Reference task are given below:

  • One dynamic target interface and one Set Dynamic Reference task.

  • Two dynamic target interfaces and two Set Dynamic Reference task. The first Set Dynamic Reference task sets the reference for the target operation. The second Set Dynamic Reference task sets the reference for the Invoke task.

  • Two Invoke tasks, each executing different operations on the same interface. The first Set Dynamic Reference task sets the reference for the first Invoke task. The second Set Dynamic Reference task sets the reference for the second Invoke task. A different service provider can be invoked by each Invoke task.

A grey hint line appears between the Set Dynamic Reference task and the corresponding dynamic target interface. A yellow hint line appears between a Set Dynamic Reference task and the corresponding Invoke task when you select a Set Dynamic Reference task in the mediation flow. The diagrams have been changed to show all hint lines, even though only the hint lines for the selected task can be viewed in the mediation editor.

The Set Dynamic Reference task is typically used on input mediation paths. It can be used on output or fault paths when an Invoke task that invokes an operation on a dynamic target interface appears on an output or fault path.