2.1.1724 Part 1 Section 22.3.2.2, property (Custom File Property)
a. The standard does not reserve a unique property name for the property editor’s content type ID.
Office reserves the following unique property names for the following purposes:
|
Name |
Description |
|---|---|
|
ContentTypeId |
A custom property with this name contains the id of the content type associated with the Windows SharePoint Services document library where this document belongs. Its value is the same as the ma:contentTypeID attribute on the Schema for Content Type element (§3.5.2.1.1.1, contentTypeSchema). |
b. The standard does not reserve unique property names for document workspaces.
Office reserves the following unique property names for the following purposes:
|
Name |
Description |
|---|---|
|
_CheckOutSrcUrl |
A custom property with this name specifies the document workspace from which the document was checked out.
The child element of this property shall be a lpwstr specifying the URL of the document workspace where this document belongs. This URL shall not exceed 256 characters. |
|
_LiveCopyIndex |
A custom property with this name provides a time stamp for comparing the current state of a server document to a local copy of that document.
The child element of this property shall be an i4 containing a hashed value of the modified property when the original document was first added to the document workspace. This value is computed by multiplying the high-order part of the modified filetime property by three and adding that to the low-order part of the filetime.
This information can be used to resolve potential conflicts between two different copies of a document stored in a document workspace. If the _LiveCopyIndex value of a particular document matches the modified property value, then that document is considered to be equivalent to the original shared version of the file on the server. If one of the two copies of a document is the original shared version and the two copies of the document differ, then the other document shall be newer. |
|
_SharedFileIndex |
A custom property with this name identifies the workspace that the document belongs to.
The child element of this property shall be an lpwstr comprised of three parts: a version number, followed by a GUID, followed by the URL of the workspace.
The version number shall be 0000020000000000.
The GUID shall uniquely identify the document.
The URL shall define the requested location of the file on the server. If the location is already occupied by a document with a different GUID, then the document might be relocated.
If the value of this property extends beyond 256 characters, it shall be segmented across multiple properties with the root name of _SharedFileIndex. The subsequent properties will be named _SharedFileIndex1, _SharedFileIndex2, _SharedFileIndex3, and so on. The value of each property shall be at most 256 characters; only when those 256 characters have been exceeded shall the next _SharedFileIndex property be created.
[Example: The shared file index of a document with a workspace location of http://www.contoso.com/documentschemas/schemaexamples/ documentworkspaces/documents/shareddocuments/collaboration/ customfileproperties/serverproperties/ DocumentWithAReallyReallyLongNameAndAReallyReally LongServerLocationWhichRequiresSegmentationOfTheShared FileIndexProperty.docx can be defined as follows:
end example] |
c. The standard does not define any custom document properties used to convey input parameters for a SpreadsheetML document.
Office reserves the following unique property names for the following purposes:
|
Name |
Description |
|---|---|
|
PROP_MULTVAL_ParameterName |
A custom property with this name specifies a filter parameter, where ParameterName is a name given by the user. |
|
PROP_ParameterName |
A custom property with this name specifies a parameter, where ParameterName is a name given by the user. |
d. The standard lists 21 variant types as possible child elements.
Office only allows bool, filetime, empty, i4, lpstr, lpwstr and r8 as valid child elements for custom properties where fmtid has a value of {D5CDD505-2E9C-101B-9397-08002B2CF9AE}.
e. The standard states that the values of the pid attribute are defined by the XML Schema int datatype.
-
Office restricts the value of this attribute to be at least 2.
f. The standard does not document any restrictions on the FmtId attribute.
The following GUIDs shall not be used in a custom property.
Summary Information
{f29f85e0-4ff9-1068-ab91-08002b27b3d9}
Document Summary Information
{d5cdd502-2e9c-101b-9397-08002b2cf9ae}
g. The standard specifies that the name attribute is defined by the XML Schema string datatype.
-
Office requires that the name attribute be a case-insensitive unique name.