XML - Edit node

Declaration

<AMXML ACTIVITY="edit_node" NEWVALUE="text" EDITNODE="text (options)" SESSION="text" />

Related Topics  

Description

Edits a node value or its attribute in a given file. Select the appropriate node using Xpath expression. Note that the action will edit the first node if Xpath evaluates to more than one node.

IMPORTANT: The use of Automate Desktop's XML activities requires a fundamental understanding of XML schema and general knowledge of XML-related terms, such as Nodes, XPath, DTD and XSLT.  

Practical usage

See Description.

Parameters

Session

Property Type Required Default Markup Description
Session Text Yes XMLSession1 SESSIONNAME="myXMLSession" The name of an existing XML session in which to associate this activity with. As a safety measure, when a session is created, the XML file bound by that session is saved in memory and the original file is locked. Any modifications by subsequent XML steps are performed on a copy of the XML data saved to memory instead of the original. Linking several activities to a single session eliminates redundancy. Additionally, a single task supports simultaneous execution of multiple sessions, improving overall efficiency. Use the XML - Output file or XML - Save activity to output the in-memory representation of the XML session to a file or variable. To end the session, use the XML - End session activity. 

Node

Property Type Required Default Markup Description
XPath Expression Text Yes (Empty) XPATH="/BookStore/Books/Price"  The Xpath expression to the XML node in which to edit.
Attribute (optional) Text No (Empty) XMLATTRIBUTE="Price" Tells the XML node the value of the attribute to edit.
Value Text No (Empty) NEWVALUE="NewValue" The XML node's attribute to edit.
Apply text to nodes only Yes/No No Yes APPLYTOTEXTNODE="NO" If selected, text will be applied to the nodes only.
Edit mode Text (options) No First EDITNODE="All" Specifies whether the first node or all nodes are to be edited. The available options are:
  • First matching node(default) - The first matching node will be edited.
  • All matching nodes -  All matching nodes will be edited.

Description

Error Causes

On Error

Example

NOTE:
  • Copy and paste the sample AML code below directly into the Task Builder Steps Panel.
  • To successfully run the sample code, update parameters containing user credentials, files, file paths, or other information specific to the task to match your environment.

Description

This sample task edits the XML node at XPath location /BookStore/Book.

Copy 
<AMXML FILE="XMLFile" SESSION="XmlSession1" />
<AMXML ACTIVITY="edit_node" XPATH="/BookStore/Book" NEWVALUE="Who moved my Cheese" SESSION="XmlSession1" />
<AMXML ACTIVITY="end_session" SESSION="XmlSession1" />