XForms actions

Introduction
The actions in this page are called "XForms actions" because they closely match actions found in the XForms specification.
xf:setvalue
[SINCE Orbeon Forms 4.7]
Set a value in the form data.
parameters
ref: required XPath expression, relative to the root element of the form data, points to the nodes to set.
value: optional XPath expression, relative to the node to set, specifies the value to set.
all: [SINCE Orbeon Forms 2018.1] optional boolean
If "false" (the default) the First-item rule is applied: if the ref XPath expression returns a sequence of size greater than 1, the first item in the sequence is used.
If "true", all the items in the sequence are used.
If value is omitted, the value selected is the empty string.
Examples:
xf:setvalue(ref = "//first-name")                            // clear the value of the `first-name` element, if found
xf:setvalue(ref = "//submit-date", value = "current-date()") // set the value of the `submit-date` element, if found, to the current date
xf:dispatch
[SINCE Orbeon Forms 4.3]
Dispatch an XForms event by name to an XForms target.
parameters
name (default parameter): specifies the name of the event to dispatch
targetid: specifies the event's target id, fr-form-model by default. [SINCE Orbeon Forms 4.4]
xf:send
[SINCE Orbeon Forms 4.3]
Send an XForms submission.
parameters
submission: specifies the id of the submission to send
xf:show
[SINCE Orbeon Forms 4.3]
Open an XForms dialog by id.
parameters
dialog: specifies the id of the dialog to open
xf:hide
[SINCE Orbeon Forms 4.10]
Close an XForms dialog by id.
parameters
dialog: specifies the id of the dialog to close
xf:insert
[SINCE Orbeon Forms 2021.1]
Insert data in an XML document.
parameters
origin: required XPath expression, relative to the root element of the form data, points to the nodes to insert.
before: optional XPath expression, relative to the root element of the form data, points to a node to insert before.
after: optional XPath expression, relative to the root element of the form data, points to a node to insert after.
into: optional XPath expression, relative to the root element of the form data, points to a node to insert into.
Only one of into, before, or after is used, as follows:
If before is specified and contains at least one node, then insertion occurs before that node.
Or else, if after is specified and contains at least one node, then insertion occurs after that node.
Or else, if into is specified and contains at least one node, then insertion occurs into that node.
xxx
Examples:
xf:insert(
    into  = "xxxx",
    origin = "xxxx"
)
xf:delete
[SINCE Orbeon Forms 2021.1]
Delete data from an XML document.
parameters
ref: required XPath expression, relative to the root element of the form data, points to the nodes to delete.
Examples:
xf:delete(
    ref = "xxxx"
)
Email action
Predefined buttons, processes and dialogs
Last modified 3mo ago