xml.Signature.createReference

Creates a new reference that will be signed with the compute() method

Syntax

createReference(
   uri STRING,
   digest STRING )
  RETURNING ind INTEGER

The returned value represents the index for any further manipulation of this reference.

The uri can be:

An absolute url such as http://, https://, tcp://, tcps://, file:/// and alias:// (see FGLPROFILE Configuration for more details about URL mapping with aliases), and where the data can be a XML document or any kind of data such as images or html pages.
NULL to sign the whole document, but only one NULL is allowed in the entire signature.
A fragment like #tobesigned. Note that a DOM node fragment is identified via the value of an attribute of type ID such as xml:id or any attribute whose type was changed to ID with setIdAttribute() or setIdAttributeNS().

In case of error, the method throws an exception and sets the STATUS variable with the appropriate error number.