Specifying multiple XAPI calls with the web UI framework

About this task

With the Web UI Framework, you can specify more than one XAPI call under one transaction, using the mashup layer. When you do this, you create mashups within other mashups. IBM® recommends that you use multiple XAPI mashup configurations only for fetch operations, and not for save operations.

Procedure

  1. Open the Designer Workbench.
  2. Click the Mashups button to create or open a mashup.xml file.
  3. For each XAPI, create mashups within the main mashup. Each of these mashups has an id as an attribute to uniquely identify the mashup definition in the XML file. Each mashup also has a resourceId as an optional attribute which is used for authorization and takes precedence over individual resource permission defined under the main mashup element.

    Also, these mashups contain one or more mashupRef elements, which are used to reference other mashups. The mashup id referenced in the mashupRef element must be defined in the mashup.xml file before the reference.

    The mashupRef element can also have an endpoint as an attribute that will take precedence over endpoint attribute in the mashup element. The endpoint attribute in the mashup element will in turn take precedence over the one defined in the XAPI layer.

  4. In each mashupRef tag within each XAPI mashup, use the APINamespace element to define the input namespace and the output namespace for each API in the mashup. If this element is not given, the input namespace defaults to the element name that serves as the input XML and the output namespace defaults to the element name in the output XML.

    If there are two mashups with the same id values and same namespaces, the calls are merged to only one XAPI under the multiple XAPI call. If the namespaces are different, they are treated as separate XAPIs under the multiple XAPI call.