# XML Poke

### XMLPoke <a href="#xmlpoke" id="xmlpoke"></a>

The **XMLPoke** function writes to one or more XML nodes in an XML Document.

### Properties <a href="#properties" id="properties"></a>

#### XML source <a href="#xml-source" id="xml-source"></a>

XML source controls where the function reads the input XML from, and can be one of the following values:

1. File\
   Reads from the XML file defined in the [XML file](#xml-file) property
2. String\
   Reads from an XML formatted string defined in the [XML string](#xml-string) property.

#### XML file <a href="#xml-file" id="xml-file"></a>

The path to an XML file which will be read by the function.\
This property is only displayed if [XML source](#xml-source) is set to 'File'.

#### XML string <a href="#xml-string" id="xml-string"></a>

The XML formatted string to read.

This property is only displayed if [XML source](#xml-source) is set to 'String'.

#### XPath <a href="#xpath" id="xpath"></a>

XPath is a string conforming to the XML path language format.

It is used to select which nodes are read by the function.

#### Namespaces <a href="#namespaces" id="namespaces"></a>

An optional string defining any XML namespaces for prefixes used in the [XPath](#xpath) property.

Namespaces should be defined in the format \[prefix]="\[URI]".

Multiple definitions should be separated by a space.

#### Replace with <a href="#replace-with" id="replace-with"></a>

Value to replace contents of matching nodes.

#### Return XML <a href="#return-xml" id="return-xml"></a>

If selected, the updated XML string will be provided as the function's output results.

#### Update File <a href="#update-file" id="update-file"></a>

If selected, the changes made by this function will be written back into the [XML file](#xml-file).

This option is only displayed when [XML source](#xml-source) is set to 'File'.

### Links <a href="#links" id="links"></a>

[Wikipedia: XML](http://en.wikipedia.org/wiki/XML)

[Wikipedia: XML Path Language](http://en.wikipedia.org/wiki/XPath)

[Wikipedia: XML Namespaces](http://en.wikipedia.org/wiki/XML_Namespace)