xml.DomDocument.getElementById

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

Syntax

getElementById(
   id STRING )
  RETURNS xml.DomNode
  1. id defines the Id value.

Usage

Use this method to return 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 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).