1. Office Well Defined Custom XML Parts. 1

1.1. Cover Page Properties. 2

1.1.1. Cover Page Properties Schema. 2

1.2. Content Type Schemas. 4

1.2.1. Content Type Schemas Schema. 4

1.2.2. Metadata Attributes. 8

1.3. Custom Document Information Panel 14

1.3.1. Custom Document Information Panel Schema. 14

1.4. Custom XSN.. 16

1.4.1. Custom XSN Schema. 16

1.5. Long Properties. 17

1.5.1. Long Properties Schema. 18

 

1. Office Well Defined Custom XML Parts

Office reads and writes a set of well-defined Custom XML Parts.  Custom XML Parts, in general, are described in Custom XML Data Storage Part ("[ECMA-376] Part 1 §15.2.4; Custom XML Data Storage Part") and Custom XML Data Properties ("[ECMA-376] Part 4 §7.5; Custom XML Data Properties"). In addition to implementing the relevant portions of ECMA-376 Office Open XML File Formats [ECMA-376], Office understands a predefined set of schemas when applied to Custom XML Parts.

This clause and its subordinate subclauses describe the structure and content of these well-defined parts. 

[Note: For convenience, information from those subclauses is summarized in the following table:

Part	Root Element	Namespace	Ref
Cover Page Properties	coverPageProperties	http://schemas.microsoft.com/‌office/‌2006/‌coverPageProps	Office 2007 Well Defined Custom Parts
Content Type Schema	contentTypeSchema	http://schemas.microsoft.com/‌office/‌2006/‌metadata/‌contentType	Office 2007 Well Defined Custom Parts
Custom Document Information Panel	customPropertyEditors	http://schemas.microsoft.com/‌office/‌2006/‌customDocumentInformationPanel	Office 2007 Well Defined Custom Parts
Custom XSN	customXsn	http://schemas.microsoft.com/‌office/‌2006/‌metadata/‌customXsn	Office 2007 Well Defined Custom Parts
Long Properties	longProperties	http://schemas.microsoft.com/‌office/‌2006/‌metadata/longProperties	Office 2007 Well Defined Custom Parts

 

end note]

1.1. Cover Page Properties

The Cover Page Properties is comprised of a Custom XML Data Storage Part ("[ECMA-376] Part 1 §15.2.4; Custom XML Data Storage Part") which contains the Cover Page Properties information, and a Custom XML Data Storage Properties Part ("[ECMA-376] Part 1 §15.2.5; Custom XML Data Storage Properties Part") which contains the set of properties for the custom XML data.

 The XML contents of the data storage part conform to the schema defined in Cover Page Properties Schema (Office 2007 Well Defined Custom Parts).

The root element of the Custom XML Data Storage Part shall be CoverPageProperties (Office 2007 Well Defined Custom Parts).

The Associated XML Schema ("[ECMA-376] Part 4 §7.5.2.2; schemaRef") for this Custom XML Data Storage Part shall be “http://schemas.microsoft.com/office/2006/coverPageProps”.

1.1.1. Cover Page Properties Schema

Cover page properties define a set of document properties available for use on a Word cover page.

1.1.1.1. Elements

1.1.1.1.1. Abstract (Document Abstract)

This element specifies an abstract of the document content.

Parent Elements

CoverPageProperties (§1.1.1.1.6)

1.1.1.1.2. CompanyAddress (Company Address)

This element specifies the address of the company to be used in the document.

Parent Elements

CoverPageProperties (§1.1.1.1.6)

1.1.1.1.3. CompanyEmail (Company Email Address)

This element specifies the e-mail address of the company to be used in the document.

Parent Elements

CoverPageProperties (§1.1.1.1.6)

1.1.1.1.4. CompanyFax (Company Fax Number)

This element specifies the fax number of the company to be used in the document.

Parent Elements

CoverPageProperties (§1.1.1.1.6)

1.1.1.1.5. CompanyPhone (Company Phone Number)

This element specifies the phone number of the company to be used in the document.

Parent Elements

CoverPageProperties (§1.1.1.1.6)

1.1.1.1.6. CoverPageProperties (Cover Page Properties)

This element is the parent element of properties that are typically used for a document cover page.

Child Elements	Subclause
Abstract (Document Abstract)	§1.1.1.1.1
CompanyAddress (Company Address)	§1.1.1.1.2
CompanyEmail (Company Email Address)	§1.1.1.1.3
CompanyFax (Company Fax Number)	§1.1.1.1.4
CompanyPhone (Company Phone Number)	§1.1.1.1.5
PublishDate (Document Publish Date)	§1.1.1.1.7

The following XML Schema fragment defines the contents of this element:

1.1.1.1.7. PublishDate (Document Publish Date)

Specifies the date this document was published.

The possible values for this element are defined by the ST_PublishDate simple type (§1.1.1.2.1).

Parent Elements

CoverPageProperties (§1.1.1.1.6)

The following XML Schema fragment defines the contents of this element:

1.1.1.2. Simple Types

This is the complete list of simple types in the http://schemas.microsoft.com/office/2006/coverPageProps namespace.

1.1.1.2.1. ST_PublishDate (Publish Date Value)

The publish date may be specified in either the XML Schema Date format, the XML Schema DateTime format, or simply as a string.

This simple type is a union of the following types:

·         The XML Schema date datatype.

·         The XML Schema dateTime datatype.

·         The XML Schema string datatype.

Referenced By

PublishDate (§1.1.1.1.7)

The following XML Schema fragment defines the contents of this simple type:

1.2. Content Type Schemas

The Content Type Schemas is comprised of a Custom XML Data Storage Part ("[ECMA-376] Part 1 §15.2.4; Custom XML Data Storage Part") which contains the Content Type Schemas information, and a Custom XML Data Storage Properties Part ("[ECMA-376] Part 1 §15.2.5; Custom XML Data Storage Properties Part") which contains the set of properties for the custom XML data.

 The XML contents of the data storage part conform to the schema defined in Content Type Schemas Schema (Office 2007 Well Defined Custom Parts).

The root element of the Custom XML Data Storage Part shall be contentTypeSchema (Office 2007 Well Defined Custom Parts).

The Associated XML Schema ("[ECMA-376] Part 4 §7.5.2.2; schemaRef") for this Custom XML Data Storage Part shall be “http://schemas.microsoft.com/‌office/‌2006/‌metadata/‌contentType”.

1.2.1. Content Type Schemas Schema

Content Type Schemas define the general look and composition of UI elements presented in a Document Information Panel. Information in the content type schema is derived from a content type associated with documents on Windows SharePoint Services. A Content Type Schema is used in conjunction with a CustomXSN element (§1.4.1.1.2) data to fully define the behaviours of the Document Information Panel.

1.2.1.1. Elements

1.2.1.1.1. contentTypeSchema (Schema for Content Type)

The attributes and children of this element collectively specify a schema for the custom XML data part that specifies properties related to the content type associated with the document on Windows SharePoint Services. Each child of this element is an xsd:schema element, possibly decorated with attributes from the http://schemas.microsoft.com/office/2006/metadata/properties/metaAttributes namespace, that describes one or more elements that appear in that custom XML data part.

In the following description, let the term 'content type' refer specifically to the root element of the Content Type Definition Type as described in Collaborative Application Markup Language (CAML) Structure Specification ([MS-WSSCAML] Subclause 2.4.1.1).

The contentTypeSchema element shall contain an xsd:schema child element which has an ma:root attribute (Office 2007 Well Defined Custom Parts) with a value of true. This xsd:schema must have a targetNamespace attribute whose value is set to http://schemas.microsoft.com/office/2006/metadata/properties. The xsd:schema must declare and import any namespaces used by its child elements. It must also have an ma:fieldsID attribute (Office 2007 Well Defined Custom Parts).

Additionally, this xsd:schema element must declare an element with a name attribute whose value is properties  and which uses the following structure. The children of the xsd:all element are not shown, but instead described by the text that follows.

<xsd:element name="properties">

  <xsd:complexType>

    <xsd:sequence>

      <xsd:element name="documentManagement">

        <xsd:complexType>

          <xsd:all>

            ...

          </xsd:all>

        </xsd:complexType>

      </xsd:element>

    </xsd:sequence>

  </xsd:complexType>

</xsd:element>

Let the term "fields" denote the list of all Field elements that are children of the Fields element, which is in turn a child of the ContentType element in the content type. The Field elements are the fields used in the content type, as described in Collaborative Application Markup Language (CAML) Structure Specification ([MS-WSSCAML] Subclause 2.3.2.6). Furthermore, let the term "filtered fields" denote the list of all filtered fields to be those Field elements from the fields that satisfy all of the following conditions:

1.       The value of the Type attribute is not Computed, Calculated, or WorkflowStatus.

2.       The value of the Name attribute is not Modified_x0020_By, Created_x0020_By, Modified, Created or FileLeafRef.

3.       The value of the StaticName attribute is not Title, Subject, _Author, Keywords, _Comments, _Category, or ContentType.

The xsd:all element from the preceding structure must contain an xsd:element element for each Field element in the filtered fields set. This xsd:element must have a ref attribute. The value of the ref attribute must be a qualified reference to a type whose name is the value of the StaticName attribute of the Field element and which resides in the namespace identified by the SourceID attribute of the Field element. Furthermore, if the Required attribute is not present on the Field element; or if the attribute is present but its value is not TRUE; or if the value of the Type attribute is MultiChoice or LookupMulti, then a minOccurs attribute with value of 0 must be present on the xsd:element element.

For each unique string that appears as the value of the SourceID attribute on a Field element in the fields, the contentTypeSchema element must contain an xsd:schema child whose targetNamespace attribute has that same value. Each xsd:schema must contain one xsd:element element for each Field whose SourceID attribute matches the targetNamespace attribute of the xsd:schema.

Each xsd:element element must have a name attribute whose value is the value of the StaticName attribute on the corresponding Field element. Each xsd:element element must have an ma:index attribute (§1.2.2) whose value is the number of Field elements that appear before the corresponding Field element within the Fields element in the content type. If the Required attribute is not present on the corresponding Field element; the Required attribute is present but its value is not TRUE; or the value of the Type attribute is MultiChoice or LookupMulti, then a nullable attribute with value of true must be present on the xsd:element element.

The following attributes can appear on each xsd:element element: ma:displayName (§1.2.2); ma:decimals (§1.2.2); ma:default (§1.2.2); ma:description (§1.2.2); ma:format (§1.2.2); ma:hidden (§1.2.2); ma:LCID (§1.2.2); ma:list (§1.2.2); ma:internalName (§1.2.2); ma:readOnly (§1.2.2); ma:showField (§1.2.2); ma:percentage (§1.2.2); ma:web (§1.2.2); ma:requiredMultiChoice (§1.2.2).

The contentTypeSchema element must have an xsd:schema child whose targetNamespace attribute has the value http://schemas.openxmlformats.org/package/2006/metadata/core-properties.

Attributes	Description
_ (Reserved)	Shall be empty.   The possible values for this attribute are defined by the XML Schema anySimpleType datatype.
_ (Reserved)   Namespace: http://schemas.microsoft.com/office/2006/metadata/properties/metaAttributes	Shall be empty.   The possible values for this attribute are defined by the XML Schema anySimpleType datatype.
contentTypeDescription (Content Type Description)   Namespace: http://schemas.microsoft.com/office/2006/metadata/properties/metaAttributes	Shall be the same value as the Description attribute of the ContentType element (as described in Collaborative Application Markup Language (CAML) Structure Specification ([MS-WSSCAML] Subclause 2.4.1.1) for the content type associated with this document.   The possible values for this attribute are defined by the XML Schema string datatype.
contentTypeID (Content Type ID)   Namespace: http://schemas.microsoft.com/office/2006/metadata/properties/metaAttributes	Identifies the content type associated with this document.   The possible values for this attribute are defined by the ST_ContentTypeId simple type (§1.2.2.2.1).
contentTypeName (Content Type Name)   Namespace: http://schemas.microsoft.com/office/2006/metadata/properties/metaAttributes	Must be the same value as the Name attribute of the ContentType element (as described in Collaborative Application Markup Language (CAML) Structure Specification ([MS-WSSCAML] Subclause 2.4.1.1)) for the content type associated with this document.   The possible values for this attribute are defined by the XML Schema string datatype.
contentTypeScope (Content Type Scope)   Namespace: http://schemas.microsoft.com/office/2006/metadata/properties/metaAttributes	Shall be empty.   The possible values for this attribute are defined by the XML Schema string datatype.
contentTypeVersion (Content Type Version)   Namespace: http://schemas.microsoft.com/office/2006/metadata/properties/metaAttributes	Shall be the same value as the Version attribute of the ContentType element (as described in Collaborative Application Markup Language (CAML) Structure Specification ([MS-WSSCAML] Subclause 2.4.1.1) for the content type associated with this document.   The possible values for this attribute are defined by the ST_IntNonNegative simple type (§1.2.2.2.2).
versionID (Version ID)   Namespace: http://schemas.microsoft.com/office/2006/metadata/properties/metaAttributes	A string hash used to determine if the definition of the content type associated with this document has changed since the last time the content type was applied to the document.   The value is computed as an MD5 hash of the substring that represents the ContentType element (from <ContentType> to </ContentType>, inclusive) within the SOAP result of the GetListContentType Web service request, as described in Lists Web Service Protocol Specification ([MS-LISTSWS] Subclause 3.1.4.17).   The possible values for this attribute are defined by the XML Schema string datatype.

The following XML Schema fragment defines the contents of this element:

1.2.2. Metadata Attributes

Metadata attributes are used to provide additional information for each of the schema children of the Content Type Schemas (Office 2007 Well Defined Custom Parts).

1.2.2.1. Shared Attributes (Content Type Schemas)

The schemas referred to here (including the root schema and core schema) are the child schemas described in Content Type Schemas (§1.2.1, Content Type Schemas Schema).

Attributes	Description
decimals (Decimal Digits)	Specifies the number of fractional digits to display on the property editing surface for the property corresponding to an xsd:element in a schema other than the root schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Currency or {http://schemas.microsoft.com/office/2006/documentManagement/types}Number.   Office handles the integer values 0-9 and auto.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
default (Default Value)	When applied to an xsd:element in a schema other than the root schema or the core schema, specifies the initial value of the property corresponding to the xsd:element.   When applied to an xsd:element in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}DateTime, if set to [today], specifies that the initial value of the property corresponding to the xsd:element should be set to the current date and time.   When applied to an xsd:element in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Boolean, Office interprets 1 as logical true and all other values as logical false in determining the initial value of the property corresponding to this xsd:element.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
description (Description)	When applied to an xsd:element in a schema other than the root schema, specifies information displayed as a part of the tooltip on the property editing surface for the property corresponding to this xsd:element.   Office displays the first 512 characters of the concatenation of the property name, the ": " delimiter, and the description as the tooltip.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
displayName (Display Name)	When applied to an xsd:element in a schema other than the root schema or core schema, specifies the text displayed on the property editing surface and as a part of the tooltip for the property corresponding to the xsd:element.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
fieldsID (Fields ID)	This attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
format (Format)	When applied to an xsd:element in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}DateTime, if set to DateTime, specifies that the property value displayed in the property editing surface for the property corresponding to this xsd:element should include both the date and time, and if not present or set to any other value, specifies that the property value displayed in the property editing surface for the property corresponding to this xsd:element should include only the date.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
hidden (Hidden)	When applied to an xsd:element in a schema other than the root schema or core schema, if set to true, specifies that the property corresponding to this xsd:element should not be presented for editing on the property editing surface.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
index (Ordering Index)	The value of this attribute is used to determine the ordering on a property editing surface of xsd:elements bearing this attribute from schemas other than the root schema. First, the xsd:elements are broken into groups, as follows. The first group is composed of any xsd:element that: ·         is not the description element in the core properties, and ·         is not a simpleType restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Note, and ·         is not a complex content based on any of {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiChoice, {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiChoiceFillIn, or {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiChoiceLookup. The second group is composed of the remaining xsd:elements bearing this attribute from schemas other than the root schema. Within each group the order of the index attribute values is ascending.   If an xsd:element in a schema other than the root schema or core schema does not have this attribute, it will not be presented to the user for editing on the property editing surface.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the ST_IntNonNegative simple type (§1.2.2.2.2).
internalName (Internal Name)	Specifies an internal name.   This attribute shall be present on xsd:elements in a schema other than the root schema or core schema.  If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
LCID (LCID)	When applied to an xsd:element in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Currency, specifies the locale identifier as specified in the Windows Language Code Identifier (LCID) Reference [MS-LCID] to determine the currency symbol used in the display of the property corresponding to this xsd:element in the property editing surface.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema int datatype.
list (List Identifier)	Shall be present on xsd:elements for which neither the hidden nor read-only attributes are set to true in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Lookup or {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiLookup.When present on such an element, specifies the list from which to get data for display of the property corresponding to this xsd:element in the property editing surface.   Office will populate this data when the save location of the document is a site that implements the Lists Web Service Protocol Specification [MS-LISTSWS] and the value of this attribute is a valid GUID enclosed in braces corresponding to the ID of a list on the site.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
percentage (Show as Percentage)	When applied to an xsd:element in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Currency or {http://schemas.microsoft.com/office/2006/documentManagement/types}Number, if set to TRUE, specifies that the property corresponding to this xsd:element should be displayed as a percentage in the property editing surface, and if not present or set to any other value, specifies that the property corresponding to this xsd:element should not be displayed as a percentage in the property editing surface.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
readOnly (Read Only)	When applied to an xsd:element in a schema other than the root schema or core schema, if set to true, specifies that the property corresponding to this xsd:element should not be presented for editing on the property editing surface.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
requiredMultiChoice (Required Multiple Choice)	When applied to an xsd:element in a schema other than the root schema or core schema whose content model is an xsd:restriction based on  {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiChoice, {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiChoiceFillIn, or {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiChoiceLookup, if set to true, specifies that the property editing surface should indicate an error if no choices are selected for the property corresponding to the xsd:element.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
root (Root Schema)	Shall be set to true on the root schema element described in  Content Type Schemas (§1.2.1, Content Type Schemas Schema) for the http://schemas.microsoft.com/office/2006/contentTypeSchema namespace and shall not be applied to any other element.   The possible values for this attribute are defined by the ST_TrueOnly simple type (§1.2.2.2.3).
showField (Displayed Field)	Shall be present on xsd:elements for which neither the hidden nor read-only attributes are set to true in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Lookup or {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiLookup. When applied to such an element, specifies the text displayed for the lookup options in the property editing surface for the property corresponding to the xsd:element.   Office handles values corresponding to the Name attribute of a field as specified in the response from a GetList request as specified in the Lists Web Service Protocol Specification ([MS-LISTSWS] Subclause 3.1.4.14).   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the XML Schema string datatype.
web (Site Identifier)	When applied to an xsd:element for which neither the hidden nor read-only attributes are set to true in a schema other than the root schema or core schema whose content model is an xsd:restriction based on {http://schemas.microsoft.com/office/2006/documentManagement/types}Lookup or {http://schemas.microsoft.com/office/2006/documentManagement/types}MultiLookup, specifies the site of the list from which to get data for display of the property corresponding to this xsd:element in the property editing surface.   If applied to any other element, this attribute should be ignored.   The possible values for this attribute are defined by the ST_UniqueIdentifierWithoutBraces simple type (§1.2.2.2.4).

The following XML Schema fragment defines the contents of this element:

1.2.2.2. Simple Types

This is the complete list of simple types in the http://schemas.microsoft.com/office/2006/metadata/properties/metaAttributes namespace.

1.2.2.2.1. ST_ContentTypeId (Content Type ID)

This simple type's contents are a restriction of the XML Schema string datatype.

This simple type also specifies the following restrictions:

·         This simple type's contents shall match the following regular expression pattern: 0x([0-9A-Fa-f][1-9A-Fa-f]|[1-9A-Fa-f][0-9A-Fa-f]|00[0-9A-Fa-f]{32})*.

·         This simple type's contents have a maximum length of 1026 characters.

·         This simple type's contents have a minimum length of 2 characters.

Referenced By

contentTypeSchema@contentTypeID (§1.2.1.1.1)

The following XML Schema fragment defines the contents of this simple type:

1.2.2.2.2. ST_IntNonNegative (Non-Negative Integer)

This simple type's contents are a restriction of the XML Schema int datatype.

This simple type also specifies the following restrictions:

·         This simple type has a minimum value of greater than or equal to 0.

Referenced By

contentTypeSchema@contentTypeVersion (§1.2.1.1.1); Shared Attributes@index (§1.2.2.1)

The following XML Schema fragment defines the contents of this simple type:

1.2.2.2.3. ST_TrueOnly (True Only)

This simple type's contents are a restriction of the XML Schema string datatype.

The following are possible enumeration values for this type:

Enumeration Value	Description
true ()

 

Referenced By

Shared Attributes@root (§1.2.2.1)

The following XML Schema fragment defines the contents of this simple type:

1.2.2.2.4. ST_UniqueIdentifierWithoutBraces (Unique Identifier without Braces)

This simple type's contents are a restriction of the XML Schema string datatype.

This simple type also specifies the following restrictions:

·         This simple type's contents shall match the following regular expression pattern: [0-9a-fA-F]{8}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{12}.

Referenced By

Shared Attributes@web (§1.2.2.1)

The following XML Schema fragment defines the contents of this simple type:

1.3. Custom Document Information Panel

The Custom Document Information Panel is comprised of a Custom XML Data Storage Part ("[ECMA-376] Part 1 §15.2.4; Custom XML Data Storage Part") which contains the Custom Document Information Panel information, and a Custom XML Data Storage Properties Part ("[ECMA-376] Part 1 §15.2.5; Custom XML Data Storage Properties Part") which contains the set of properties for the custom XML data.

 The XML contents of the data storage part conform to the schema defined in Custom Document Information Panel Schema (Office 2007 Well Defined Custom Parts).

The root element of the Custom XML Data Storage Part shall be customPropertyEditors (Office 2007 Well Defined Custom Parts).

The Associated XML Schema ("[ECMA-376] Part 4 §7.5.2.2; schemaRef") for this Custom XML Data Storage Part shall be “http://schemas.microsoft.com/‌office/‌2006/‌customDocumentInformationPanel”.

1.3.1. Custom Document Information Panel Schema

Custom Document Information Panel information defines the location and behaviors for a customized Document Information Panel based on a standalone XSN file. Unlike a Document Information Panel defined by a Content Type Schema (§1.2.1) and a CustomXSN (§1.4.1), Custom Document Information Panels need not be associated directly with a server.

1.3.1.1. Elements

1.3.1.1.1. customPropertyEditor (Custom Property Editor)

This element associates a namespace with the location of an XSN file (as specified by InfoPath Form Template Format Structure Specification [MS-IPFF]). The specified XSN file can be used to visually edit the information in a custom XML data part in this document. The XMLNamespace child specifies which custom xml data parts are suitable for editing; the XSNLocation child specifies a path to the XSN file.

Parent Elements

customPropertyEditors (§1.3.1.1.2)

 

Child Elements	Subclause
XMLNamespace (Namespace for Property Editor)	§1.3.1.1.5
XSNLocation (Location of XSN File)	§1.3.1.1.6

The following XML Schema fragment defines the contents of this element:

1.3.1.1.2. customPropertyEditors (Custom Property Editors List)

This element specifies the list of (and settings for) any XSN files (as specified by InfoPath Form Template Format Structure Specification[MS-IPFF]) that may be associated with this document to edit information in its custom XML data parts.

Child Elements	Subclause
customPropertyEditor (Custom Property Editor)	§1.3.1.1.1
defaultPropertyEditorNamespace (Default Namespace)	§1.3.1.1.3
showOnOpen (Show On Open)	§1.3.1.1.4

The following XML Schema fragment defines the contents of this element:

1.3.1.1.3. defaultPropertyEditorNamespace (Default Namespace)

This element specifies the XML namespace that identifies which XSN is shown by default if the user chooses to edit properties contained in the custom XML data parts of this document. If this element is not present, or if the value of this element does not equal the namespace specified in the XmlNamespace element (§1.3.1.1.5), the application may choose to display the core properties.

Parent Elements

customPropertyEditors (§1.3.1.1.2)

1.3.1.1.4. showOnOpen (Show On Open)

This element specifies whether the user should be presented with a surface to edit either the core properties or properties in one of the custom xml data parts in this document, as informed by the defaultPropertyEditorNamespace. A value of true indicates that such a surface shall be provided; any other value indicates such a surface shall not be provided. If this element is not present, a surface shall not be provided.

Parent Elements

customPropertyEditors (§1.3.1.1.2)

1.3.1.1.5. XMLNamespace (Namespace for Property Editor)

Specifies the root namespace of custom XML data parts that are appropriate for editing by the XSN specified in XSNLocation.

Parent Elements

customPropertyEditor (§1.3.1.1.1)

1.3.1.1.6. XSNLocation (Location of XSN File)

Specifies the path to the XSN file.

Parent Elements

customPropertyEditor (§1.3.1.1.1)

1.4. Custom XSN

The Custom XSN is comprised of a Custom XML Data Storage Part ("[ECMA-376] Part 1 §15.2.4; Custom XML Data Storage Part") which contains the Custom XSN information, and a Custom XML Data Storage Properties Part ("[ECMA-376] Part 1 §15.2.5; Custom XML Data Storage Properties Part") which contains the set of properties for the custom XML data.

 The XML contents of the data storage part conform to the schema defined in Custom XSN Schema (Office 2007 Well Defined Custom Parts).

The root element of the Custom XML Data Storage Part shall be customXsn (Office 2007 Well Defined Custom Parts).

The Associated XML Schema ("[ECMA-376] Part 4 §7.5.2.2; schemaRef") for this Custom XML Data Storage Part shall be “http://schemas.microsoft.com/‌office/‌2006/‌metadata/‌customXsn”.

1.4.1. Custom XSN Schema

A CustomXSN defines the source location and Document Information Panel behaviors for the document. CustomXSN is used in conjunction with Content Type Schema (Office 2007 Well Defined Custom Parts) to fully define the behaviours of the Document Information Panel.

1.4.1.1. Elements

1.4.1.1.1. cached (Cached View)

This element indicates whether the XSN specified by xsnLocation should be used to edit properties in this document. A value of true indicates that the XSN shall not be used.

Parent Elements

customXsn (§1.4.1.1.2)

1.4.1.1.2. customXsn (Custom XSN)

This element specifies that an XSN file (as specified by InfoPath Form Template Format Structure Specification [MS-IPFF]) should be presented to the user for editing properties of this document.

Child Elements	Subclause
cached (Cached View)	§1.4.1.1.1
openByDefault (Open By Default)	§1.4.1.1.3
xsnLocation (XSN Location)	§1.4.1.1.4
xsnScope (Scope)	§1.4.1.1.5

The following XML Schema fragment defines the contents of this element:

1.4.1.1.3. openByDefault (Open By Default)

This element specifies whether the user should be presented with a surface to edit properties of this document, immediately after opening it. A value of true indicates that such a surface shall be provided; any other value indicates such a surface shall not be provided.  If this element is not present, a surface shall not be provided.

Parent Elements

customXsn (§1.4.1.1.2)

1.4.1.1.4. xsnLocation (XSN Location)

This element specifies the location of an XSN file (as specified by InfoPath Form Template Format Structure Specification[MS-IPFF]) to use for editing properties of this document

Parent Elements

customXsn (§1.4.1.1.2)

1.4.1.1.5. xsnScope (Scope)

Specifies a path to use when resolving any relative paths that appear within the specified XSN.

Parent Elements

customXsn (§1.4.1.1.2)

1.5. Long Properties

The Long Properties is comprised of a Custom XML Data Storage Part ("[ECMA-376] Part 1 §15.2.4; Custom XML Data Storage Part") which contains the Long Properties information, and a Custom XML Data Storage Properties Part ("[ECMA-376] Part 1 §15.2.5; Custom XML Data Storage Properties Part") which contains the set of properties for the custom XML data.

 The XML contents of the data storage part conform to the schema defined in Long Properties Schema (Office 2007 Well Defined Custom Parts).

The root element of the Custom XML Data Storage Part shall be LongProperties (Office 2007 Well Defined Custom Parts).

The Associated XML Schema ("[ECMA-376] Part 4 §7.5.2.2; schemaRef") for this Custom XML Data Storage Part shall be “http://schemas.microsoft.com/‌office/‌2006/‌metadata/longProperties”.

1.5.1. Long Properties Schema

Long properties define a set of properties used to store server property values exceeding 255 characters in length.

1.5.1.1. Elements

1.5.1.1.1. LongProp (Custom XML Server Property - Long Property)

This element specifies the full value of a custom server property that exceeds 255 characters. This property is written out when a document is roundtripped to binary and back, to ensure that the full value of the custom property is not lost. When the first 255 characters of the value of the LongProp agrees with the value of the custom property with the corresponding name, it is assumed that the custom property was not modified when roundtripped; in that case, the LongProp is considered to contain the correct, full property value.  If instead the first 255 characters of the value of the LongProp and the custom property of the same name differ, the custom property is assumed to have the more current (and therefore accurate) value for the property.

Parent Elements

LongProperties (§1.5.1.1.2)

 

Attributes	Description
name (Custom XML Server Property Name)	Specifies the name of the custom property.   The possible values for this attribute are defined by the XML Schema string datatype.

1.5.1.1.2. LongProperties (Custom XML Server Properties - Long Properties)

This element specifies the full content of custom server properties whose values exceed 255 characters.  When a document containing custom server properties is roundtripped to binary and back, any server properties whose values exceed 255 characters can be written out as LongProperties to ensure that no data are lost. These long properties are first written when the document is saved to binary (where the custom property values can be truncated).

Child Elements	Subclause
LongProp (Custom XML Server Property - Long Property)	§1.5.1.1.1

The following XML Schema fragment defines the contents of this element: