XML Set Attribute

This XML tool changes the value of the named attribute. The node must be an element; otherwise the tool will take the ‘Failure’ exit. If the element has no attribute of the given name, the tool returns through the ‘Unknown’ exit.

Inputs

Node

Element node with attributes to change.

Name

Qualified Name of the attribute to retrieve. This field should be left empty if Base Name and Namespace URI are to be used, as both of those fields will be ignored if Name is given a value.

Base Name

Base name of the attribute to retrieve. This field will be ignored if Name has a value specified.

Namespace URI

Namespace of the attribute to retrieve. This field will be ignored if Name as a value specified.

Attribute Value

String to set as new value of the attribute. If a data type is specified for the attribute (e.g. through the Schema, the string must be coercible into that value)

New Data Type

Integer value corresponding to the new data type to be set before setting the value. See the XML Get Node Info tool for the list of valid data types. If a type is not specified, the type will not be changed.

Create if Unknown

This checkbox determines the tool’s behavior when it is directed toward an attribute that does not presently exist. If set to True, a new attribute will be created with the given ‘Name’ value and Data Type, and it will be added to the Element.

If set to False, the tool will exit through the Unknown exit path.

Outputs

Attribute Node

Attribute node that has been modified. NULL if no attribute of the given name.

Exit Paths

Success

This path is taken if the attribute was successfully retrieved.

Unknown

This path is taken if the element has no attribute of the given name.

Failure

This path is taken if the node is not an element.