13.3.1 Comment Authors Part

Content Type:

application/vnd.openxmlformats-officedocument.presentationml.commentAuthors+xml

Root Namespace:

http://purl.oclc.org/ooxml/presentationml/main

Source Relationship:

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

An instance of this part type contains information about each author who has added a comment to the document. That information includes the author’s name, initials, a unique author-ID, a last-comment-index-used count, and a display color. (The color can be used when displaying comments to distinguish comments from different authors.)

A package shall contain at most one Comment Authors part. If it exists, that part shall be the target of an implicit relationship from the Presentation (13.3.6) part.

[Example: The following Presentation part relationship item contains a relationship to the Comment Authors part, which is stored in the ZIP item commentAuthors.xml:

<Relationships xmlns="…">
  <Relationship Id="rId8"
    Type="http://…/commentAuthors" Target="commentAuthors.xml"/>
</Relationships>

end example]

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

[Example: Two people have authored comments in this document: Mary Smith and Peter Jones. Her initials are “mas”, her author-ID is 0, and her comments’ display color index is 0. Since Mary’s last-comment-index-used value is 3, the next comment-index to be used for her is 4. His initials are “pjj”, his author-ID is 1, and his comments’ display color index is 1. Since Peter’s last-comment-index-used value is 1, the next comment-index to be used for him is 2:

<p:cmAuthorLst xmlns:p="…" >
  <p:cmAuthor id="0" name="Mary Smith" initials="mas" lastIdx="3"
    clrIdx="0"/>
  <p:cmAuthor id="1" name="Peter Jones" initials="pjj" lastIdx="1"
    clrIdx="1"/>
</p:cmAuthorLst>

end example]

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

A Comment Authors part shall not have implicit or explicit relationships to any other part defined by ISO/IEC 29500.

Last updated on