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'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:
  • The sample AML code below can be copied and pasted directly into the Steps Panel of the Task Builder.
  • Parameters containing user credentials, files, file paths, and/or other information specific to the task must be customized before the sample code can run successfully.

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" />