When used inside <presto:type>, this is optionalconfiguration that defines the behavior of the Path Selection list for this property. Bydefault, users can assign any block property dynamically using the Path Selection list.When used inside <presto:type>, this is optionalconfiguration that defines the behavior of the Path Selection list for this property. Bydefault, users can assign any block property dynamically using the Path Selection list.When type="path" in <presto:type>, you may alsouse this metadata element to limit the types of nodes that user can choose inthe Path Selection list. In this case, theblock property is assigned the XPath expression for the selected node ratherthan the actual value of the selected node. See Get the Chosen Path as Textfor details.When used inside <presto:list>, this metadata defines thepath to obtain a dynamic set of valid values for this list. See Dynamic List Values from a Macro Input Parameterfor details.Name | Required | Description |
usage | Wires automatically limits user choices from block results in the Path Selection list based on the datatype of the macro input parameter. For input parameters with simple datatypes, for example, Wires only allows users to select simple nodes, also know as leaf nodes. When <presto:xpath> is a child of <presto:type datatype="path">, automatic detection is not possible. This attribute allows you to control the types of nodes that users may select in that case: array = users may select only repeating nodes, simple (with data) or complex (with children)branch = users may select only complex nodes with children, either a single node or repeating nodesleaf = users may select only a single simple node with data or a repeating simple nodepath = users may select any type of nodeIf omitted = users may select any type of node | |
limitTo | Yes | Limits the choices presented to users in thePath Selection list to nodes in a specific document-type input parameter, and optionally nodes within a specific path in that document. When <presto:xpath> is defined as a child of <presto:list>, this attribute identifies a document-type input parameter, and optional path within that document, that provides the valid values for the list. |