documentSignatures Element
Contains the signedDataBlock element, which defines how digital signatures are applied to a form or section of a form.
Type
xsd:complexType
Structure
| Name | Description |
|---|---|
| signatureLocation | (Optional attribute) Contains an XPath expression that points to the XML DOM node within the form's underlying XML document that is used for storing the digital signature. |
Child Elements
| Element | Description |
|---|---|
| signedDataBlock | Defines a nodeset in the form's underlying XML document to which a digital signature can be applied. |
Definition
<xsd:element name="documentSignatures">
<xsd:complexType>
<xsd:sequence>
<xsd:element ref="xsf:signedDataBlock" minOccurs="0" maxOccurs="unbounded" />
</xsd:sequence>
<xsd:attribute name="signatureLocation" type="xsd:string" use="optional" />
</xsd:complexType>
</xsd:element>
<xsd:element name="signedDataBlock">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="message" type="xsf:xdSignedDataBlockMessage" minOccurs="0" />
</xsd:sequence>
<xsd:attribute name="name" type="xsf:xdSignedDataBlockName" use="required" />
<xsd:attribute name="data" type="xsd:string" use="required" />
<xsd:attribute name="signatureLocation" type="xsd:string" use="required" />
<xsd:attribute name="mode" type="xsf:xdSignatureRelationEnum" use="required" />
</xsd:complexType>
<xsd:unique name="signedDataBlock_name_unique">
<xsd:selector xpath="." />
<xsd:field xpath="@name" />
</xsd:unique>
</xsd:element>
Remarks
The signedDataBlock element is a new XSF element addition in Microsoft Office InfoPath 2003 Service Pack 1. See below for backward compatibility information with 1.0 form solutions.
For backward compatibility, the document signatures element defines the location of the digital signature XML Document Object Model (DOM) node within the form's underlying XML document.
The documentSignatures element is an optional element of the xDocumentClass element.
Example
The following is an example of the documentSignatures element:
<xsf:documentSignatures signatureLocation=”my:myfields/my:subtree1 | my:myfields/my:subtree2”/>
The following is an example of the documentSignatures element used in Microsoft Office InfoPath 2003 Service Pack 1:
<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 "Sign" button below, I agree to be bound to the terms of this document. </xsf:message>
</xsf:signedDataBlock>
</xsf:documentSignatures>