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
- Open the Designer Workbench.
- Click the Mashups button to create
or open a mashup.xml file.
- 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.
- 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.