xml.DomDocument.getElementById

Returns the element that has an attribute of type ID with the given value

Syntax

getElementById(
   id STRING )
  RETURNING object xml.DomNode

id is the Id value.

Usage

Returns the xml.DomNode element that has an attribute of type ID with the given value, or NULL if there is none.

Attributes with the name "ID" or "id" are not of type ID unless so defined with setIdAttribute or setIdAttributeNS. However, there is a specific attribute called xml:id and belonging to the namespace http://www.w3.org/XML/1998/namespace that is always of type ID even if not set with setIdAttributeNS.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).