$NewChild¶

Represents the XML element for a new child item that is about to be added to a list.

1

const $NewChild: Xml;

Remarks¶

This variable provides access to the XML structure of the new child item, allowing you to set default values or modify its properties before it is added to the list.

Setting a default value for a field in the new child item¶

1

$NewChild.SetValue('MyField', $Xml.Evaluate('$poolRoot/MyField'));

Capabilities¶

Namespaces¶

• $NewChild.AddNamespace: Adds a namespace to the XML node with the given prefix and URI.
• $NewChild.LookupNamespaceURI: Returns the namespace URI associated with the specified prefix.
• $NewChild.LookupPrefix: Returns the prefix associated with the specified namespace URI.
• $NewChild.RemoveNamespace: Removes the prefix for the specified namespace URI.

Structure Changes¶

• $NewChild.AppendChild: Appends a new child to the specified XPath location and executes the provided callback function on the newly created node before inserting it into the DOM. Returns the appended new node.
• $NewChild.Copy: Copies the current XML node and all its child nodes from the source XPath to the target XPath or target navigator.
• $NewChild.Remove: Removes the current node and returns it in an array.
• $NewChild.Sync: Synchronizes the nodes at the specified XPath with the input nodes, and returns an array of the synchronized nodes.

Validation and Cleanup¶

• $NewChild.Assert: Performs an error check by asserting that the specified XPath evaluates to a boolean true value. If the assertion fails, an error is thrown.
• $NewChild.CommitDeletes: Deletes all child nodes that have the State attribute set to the value 'Deleted'.

Client Events¶

• $NewChild.Bind: Attaches a change event handler to the nodes selected by the specified XPath.
• $NewChild.Live: Attaches a change event handler to the specified XPath.
• $NewChild.Trigger: Triggers event handlers bound to the current node.

Reading and Predicates¶

• $NewChild.Count: Returns the number of nodes at the specified XPath.
• $NewChild.Equals: Returns a boolean value indicating whether the specified XPath has the specified value.
• $NewChild.Evaluate: Returns the string value of the current node.
• $NewChild.EvaluateBoolean: Returns the boolean value of the current node.
• $NewChild.EvaluateDateTime: Returns the date-time offset value of the current node.
• $NewChild.EvaluateNumber: Returns the numeric value of the current node.
• $NewChild.IsEmpty: Returns a boolean value indicating whether the current node has an empty string value.
• $NewChild.Sum: Returns the sum of the numeric values of child elements on the current node, or at the specified XPath.

Creation and Persistence¶

• $NewChild.Create: Creates a new XmlWriter instance.
• $NewChild.Load: Loads XML content into the current node from the $XmlRepository.
• $NewChild.Parse: Parses the specified string as an XML node and returns the document element as an Xml instance.
• $NewChild.Save: Saves the current node's content to the $XmlRepository.

Formatting and Transformation¶

• $NewChild.Format: Applies the specified template to the current node and returns the resulting string.
• $NewChild.InnerXml: Returns the inner XML of the current node.
• $NewChild.OuterXml: Returns the outer XML of the current node.
• $NewChild.Transform: Performs an XSLT transformation on the current node and returns the result as a string.

Attributes¶

• $NewChild.GetAttribute: Gets an attribute value on the current node.
• $NewChild.RemoveAttribute: Removes the attribute with the specified name.
• $NewChild.SetAttribute: Sets an attribute on the current node to the specified value.
• $NewChild.SetAttributeNS: Sets an attribute on the current node to the specified value in the specified namespace URI.

Selection and Navigation¶

• $NewChild.GetParent: Returns the parent node of the current node.
• $NewChild.SelectAll: Selects all matching nodes based on the specified XPath expression.
• $NewChild.SelectSingle: Selects a single node based on the specified XPath expression.

Value Updates¶

• $NewChild.SetDefaultValue: Sets the value of the current node if it is empty.
• $NewChild.SetValue: Sets the value of the current node.