15.2.12.2 Custom File Properties Part

Content Type:

application/vnd.openxmlformats-officedocument.custom-properties+xml

Root Namespace:

http://purl.oclc.org/ooxml/officeDocument/customProperties

Source Relationship:

http://purl.oclc.org/ooxml/officeDocument/relationships/customProperties

An instance of this part contains the names of custom file properties that apply to the package, their values, and the types of those values. A custom file property might be the name of the client for whom the document was prepared, a date/time on which some event happened, a document number, or some Boolean status flag.

A package shall contain at most one Custom File Properties part, and that part shall be the target of a relationship in the package-relationship item for the document.

[Example: The following PresentationML’s package-relationship item contains a relationship to a Custom File Properties part, stored in the ZIP item docProps/custom.xml:

<Relationships xmlns="…">
  <Relationship Id="rId4"
  Type="http://…/custom-properties" Target="docProps/custom.xml"/>
</Relationships>

end example]

The root element for a part of this content type shall be Properties.

[Example: Here’s some content markup from a WordprocessingML document, which contains four custom properties: Client, having a text value of “ACME Corp.”; Document number, having a numeric value of 1543; Recorded date, having a date/time value of 2005-12-01; and Special processing needed, having a Boolean value of false:

<Properties … xmlns:vt="…">
  <property fmtid="{D5C…9AE}" pid="2" name="Client">
    <vt:lpwstr>ACME Corp.</vt:lpwstr>
  </property>
  <property fmtid="{D5C…9AE}" pid="3" name="Document number">
    <vt:i4>1543</vt:i4>
  </property>
  <property fmtid="{D5C…9AE}" pid="4" name="Recorded date">
    <vt:filetime>2005-12-01T05:00:00Z</vt:filetime>
  </property>
  <property fmtid="{D5C…9AE}" pid="5" name="Special processing needed">
    <vt:bool>false</vt:bool>
  </property>
</Properties>

end example]

A Custom File Properties part shall be located within the package containing the relationships part (expressed syntactically, the TargetMode attribute of the Relationship element shall be Internal).

A Custom File Properties part shall not have implicit or explicit relationships to other parts defined by ISO/IEC 29500.