Show All

# 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 &quot;Sign&quot; button below, I agree to be bound to the terms of this document. </xsf:message>
     </xsf:signedDataBlock>
    </xsf:documentSignatures>

©2003-2004 Microsoft Corporation. All rights reserved. Permission to copy, display and distribute this document is available at: http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp