XFA Specification
Chapter 15, Template Specification
Template Reference
518
The execute element
An element that causes an event to invoke a WSDL-based web service.
<execute
Properties:
connection="cdata"
executeType="import
|
remerge"
id="xml-id"
runAt="client
|
server
|
both"
use="cdata"
usehref="cdata"
>
</execute>
The execute element is used within the following other elements:
event proto
Events can cause transactions to occur with web services. This element associates its parent event with a
particular connection to a web service as defined in the connectionSet packet of the XDP. The connection
definition supplies the particulars of the transaction such as the URIs to be used and the operation to
request. The fields and exclusion groups which exchange data with the web service are nominated by their
connect
properties.
The event can be processed by the client, by the server, or both. When an event is processed by both, the
client does its part of the processing first, then sends the resulting data to the server for completion.
The connection property
The
name
of the associated
connection
element in the connection set.
Connections are defined outside the template in a separate packet with its own schema. See
Connection
Set Grammar
This property identifies the connection to the server. It is an error if this property is not supplied or is
empty.
If the value of the
runAt
property is
client
and the XFA processor is acting as server this property is
ignored. Likewise if the property is
server
and the XFA processor is acting as client. Otherwise it is an
error for there to not be any connection with the given name.
Not all connections point to a web service. Some point to a data description or a schema. The connection
named by this property must point to a web service.
The executeType property
Specifies how the XFA processor should process imported data, assuming the following conditions exist:
(1) the name of the
connection
attribute matches the name of the currently executing connection; and
(2) the
usage
attribute has a value of
importOnly
or
exportAndImport
.
import
The XFA processor updates the values of containers that are already bound to the output of the
connection.