signedDataBlock Element

  • Article

Defines a node set in the form's underlying XML document to which a digital signature can be applied.

Type

  xsd:complexType

Child Elements

Element Description
message The signature confirmation message shown when a digital signature is applied to the form or to a section of the form.

Attributes

Attribute Type Required Description Possible Values
name 
  xdSignedDataBlockName
Yes Contains the name of the signedDataBlock element.

minLength = 1

maxLength = 255

 
  xdSignedDataBlockName
data 
  xsd:string
Yes Contains an XPath match expression that defines the node set to which the signature will be applied. string 
  xsd:string
signatureLocation 
  xsd:string
Yes Contains an XPath expression that points to the XML Document Object Model (DOM) node within the form's underlying XML document that is used for storing the digital signature. string 
  xsd:string
mode 
  xdSignatureRelationEnum
Yes Specifies the signature relationship for the signedDatablock element. The default is "single".
  • countersign
  • cosign
  • single
 
  xdSignatureRelationEnum

Definition

  <xsd:element name="signedDataBlock">
  <xsd:complexType>
    <xsd:sequence>
      <xsd:element name="message" type="xsf:xdSignedDataBlockMessage" minOccurs="0"></xsd:element>
    </xsd:sequence>
    <xsd:attribute name="name" type="xsf:xdSignedDataBlockName" use="required"></xsd:attribute>
    <xsd:attribute name="data" type="xsd:string" use="required"></xsd:attribute>
    <xsd:attribute name="signatureLocation" type="xsd:string" use="required"></xsd:attribute>
    <xsd:attribute name="mode" type="xsf:xdSignatureRelationEnum" use="required"></xsd:attribute>
  </xsd:complexType>
  <xsd:unique name="signedDataBlock_name_unique">
    <xsd:selector xpath="."/>
    <xsd:field xpath="@name"/>
  </xsd:unique>
</xsd:element>

Remarks

The node set must be the union of connected subtrees. If a nonleaf node is included in a signedDataBlock, then all children must be included.

Example

The following is an example of the signedDataBlock element:

  <xsf:documentSignatures>
 <xsf:signedDataBlock name=”main”
  data=”my:myfields/my:subtree1 | my:myfields/my:subtree2”
  signatureLocation=”my:mifields/sig:signatures/main”
  mode=”countersign”>
  <xsf:message>By pressing the &quot;Sign&quot; button below, I agree to be bound
   to the terms of this document.</xsf:message>
 </xsf:signedDataBlock>
</xsf:documentSignatures>