Treatment Of Author Fields

From Apache OpenOffice Wiki
Jump to: navigation, search

Treatment of ODF Author Fields in OpenOffice.org

The following describes which ODF Author Fields exist in ODF, which fields in OpenOffice.org correspond to them and how they shall be treated in OpenOffice.org.


ODF Author Fields

The following author fields exist in ODF

  • <text:initial-creator>
    • e.g. in Writer inserted into the document by Menu Insert - Fields - Author or by Menu Insert - Fields - DocInformation - Created - Author
  • <text:creator>
    • e.g. in Writer inserted into the document by Menu Insert - Fields - DocInformation - Modified - Author
  • <text:author-name>
    • e.g. in Writer inserted into the document by Menu Insert - Fields – Document – Author – Name
  • <text:author-initials>
    • e.g. in Writer inserted into the document by Menu Insert - Fields – Document – Author – Initials
  • <text:sender-firstname>
    • e.g. in Writer inserted into the document by Menu Insert - Fields – Document – Sender – First Name
  • <text:sender-lastname>
    • e.g. in Writer inserted into the document by Menu Insert - Fields – Document – Sender – Last Name
  • <text:sender-initials>
    • e.g. in Writer inserted into the document by Menu Insert - Fields – Document – Sender – Initials

Treatment

all ODF Author Fields

  • If ODF attribute text:fixed=“true“ for an author field in an opened ODF document instance, the value shall equal the value given in the ODF document instance.
  • If ODF attribute text:fixed=“true“ for an author field in an opened ODF document instance and this ODF attribute is changed to text:fixed=“false“, the value shall be updated.
  • If a new document is created from a template document all these fields shall be updated, even if its ODF attribute text:fixed=“true“.

<text:initial-creator>

  • The ODF specification is clear – value of <meta:intial-creator> is shown.
  • On creation of new document instance (regardless of from template document or not) the value equals the OOo's user data – assuming that the newly created document is a newly created ODF document instance.

<text:creator>

  • The ODF specification is clear – value of <dc:creator> is shown.
  • On creation of new document instance (regardless of from template document or not) the value equals the OOo's user data – assuming that the newly created document is a newly created ODF document instance.
  • If ODF attribute text:fixed=“false“ in an opened document instance, the value shall be equal to <dc:creator> until the document is modified. If the document is modified, it shall be equal to the OOo's user data. (Minor note: If all document modification are undone, the value shall be equal to <dc:creator>, again.)
  • When an opened and unmodified document instance is saved the value shall be unchanged.

<text:author-...>

  • The ODF specification text says: <quote>The <text:author-name/-initials> element represents the full name/initials of the author of a document.</quote> The term „document“ in this definition denotes the certain ODF document instance.
  • These author fields are filled from the OOo's user data on the creation of a new document instance.
  • If ODF attribute text:fixed=“false“ in an opened document instance, the value shall be equal the value given in the ODF document instance until the document is modified. If the document is modified, it shall be equal the OOo's user data. (Minor note: If all document modification are undone, the value shall be equal the value given in the ODF document instance, again.)
  • When an opened and unmodified document is saved the value shall be unchanged.
  • At least the treatment of <text:author-name> regarding opening existing documents is the same as for <text:creator>. Thus, we should think about removing this field from ODF in one of the next versions in favor of <text:creator>.

<text:sender-...>

  • These sender fields, now named subsequent author fields in ODF 1.2, are filled from the OOo's user data on the creation of a new document instance.
  • These fields are updated in an opened document, even if the document has not been modified and/or is read-only.
  • A use case for these fields:
    • A read-only document is opened for printing and the print out has to contain data about the person who printed it.
Personal tools