Metadaten

Über diese Dokumentfunktion können Dokumenteigenschaften ("Core Properties") und erweiterte Dokumenteigenschaften ("Custom Document Properties") für Microsoft Word-, Excel- und PowerPoint-Vorlagen hinzugefügt werden.

Eigenschaften

Die Standardeigenschaften entsprechend den "OpenXML-PackageProperties" und können so konfiguriert werden:

  <Metadata>
    <Core>
      <Category>Kategorie</Category>
      <ContentStatus>Status</ContentStatus>
      <ContentType>Typ</ContentType>
      <Creator>Testuser</Creator>
      <Description>Beschreibung</Description>
      <Identifier>Identifier</Identifier>
      <Keywords>Schlagwörter</Keywords>
      <Language>DE</Language>
      <LastModifiedBy>TestUser</LastModifiedBy>
      <Subject>Thema</Subject>
      <Title> Titel</Title>
      <Version>Version</Version>
      <LastPrinted>2022-04-02</LastPrinted>
      <Modified>2022-06-02</Modified>
      <Created>2022-06-26</Created>
    </Core>
  </Metadata>

Jedes dieser Elemente kann über das XPath-Attribut auf bestehende Daten, z. B. aus dem Dokument-Parameter zugreifen.

<Metadata>
  <Core>
    <Subject XPath="//Text[@id='DocParam.Subject']">Thema</Subject>
  </Core>
</Metadata>

Note

LastPrinted, Modified und Created sind Datumswerte.

Erweiterte Eigenschaften

In Word können die erweiterten Dokumenteigenschaften wie folgt aufgerufen werden:

Aufruf Word Erweiterte Eigenschaften

Unter "Anpassen" können sie angezeigt und bearbeitet werden:

Word Dialog: Dokumenteigenschaften

Unterstützte Typen

Typ	Typ gem. deutschem Word	Beispielwerte
`String`	Text	`Beispieltext`, `Hello World`
`Int`	Zahl	`1`, `7635`
`Double`	Zahl	`42.66`, `1.725`, `4`
`Bool`	Ja oder Nein	`true`, `false`
`Date`	Datum	`2023-01-23`

Ähnlich wie in den "Core-Properties", können bestehende Daten über das XPath-Attribut ausgelesen werden.

OneOffixx Dokumenteigenschaften

Es gibt einige spezielle erweiterte Dokumenteigenschaften, die in OneOffixx eine Auswirkung haben. Es handelt sich dabei um erweiterte Dokumenteigenschaften vom Typ Bool.

Name der erweiterten Dokumenteigenschaft	Auswirkung
`OORefreshFieldsOnOpen`	Wenn `true`: Das OneOffixx-Add-In aktualisiert die nachfolgenden Word-Felder bei jedem Öffnen.
`OORefreshFieldsOnSave`	Wenn `true`: Das OneOffixx-Add-In aktualisiert die nachfolgenden Word-Felder vor jedem Speichern.

Word-Felder:

WdFieldType.wdFieldEditTime
WdFieldType.wdFieldFileName
WdFieldType.wdFieldFileSize
WdFieldType.wdFieldGlossary
WdFieldType.wdFieldLastSavedBy
WdFieldType.wdFieldNumChars
WdFieldType.wdFieldNumPages
WdFieldType.wdFieldNumWords
WdFieldType.wdFieldPage
WdFieldType.wdFieldPageRef
WdFieldType.wdFieldPrint
WdFieldType.wdFieldPrintDate
WdFieldType.wdFieldSaveDate
WdFieldType.wdFieldSection
WdFieldType.wdFieldSectionPages
WdFieldType.wdFieldTOA
WdFieldType.wdFieldTOAEntry
WdFieldType.wdFieldTOC
WdFieldType.wdFieldTOCEntry
WdFieldType.wdFieldFootnoteRef
WdFieldType.wdFieldDocProperty

Weitere Informationen zu den Feldtypen finden Sie hier.

Aktualisierungen im offenen Dokument

Aktualisiert man das Dokument z. B. indem man die Dokument-Parameter ändert, so werden auch die Eigenschaften und erweiterten Eigenschaften basierend auf der Konfiguration aktualisiert. Bei den Eigenschaften gibt es allerdings Einschränkungen, da in Word nicht alle "OpenXML-PackageProperties" nutzbar sind.

Folgende Eigenschaften können auch in einem offenen Dokument über OneOffixx aktualisiert werden:

Category
Creator
Description
Keywords
LastModifiedBy
Subject
Title
Sowie alle "Erweiterten Eigenschaften"

Beispiele

Fixwerte:

<Metadata>
  <Core>
	<Category>Test Category</Category>
  </Core>
  <Meta Name="CustomDocumentPropertyStringExample" Type="String">some text</Meta>
  <Meta Name="CustomDocumentPropertyIntExample" Type="Int">264</Meta>
  <Meta Name="CustomDocumentPropertyDoubleExample" Type="Double">15.723</Meta>
  <Meta Name="CustomDocumentPropertyBoolExample" Type="Bool">true</Meta>
  <Meta Name="CustomDocumentPropertyDateExample" Type="Date">2023-12-31</Meta>
</Metadata>

OneOffixx-Texte mit Fallback:

<Metadata>
  <Core>
    <Category XPath="//Text[@id='DocParam.Category']">Test Category</Category>
  </Core> 
  <Meta Name="DocumentParameterSubject" Type="String" XPath="//Text[@id='DocParam.Subject']">some text</Meta>
</Metadata>

→ Der Wert wird hier vom Dokument-Parameter DocParam.Subject bzw. DocParam.Category übernommen. Falls kein Wert gefunden wird, greift der definierte Wert ("Test Category" bzw. "some text").

Spezielle OneOffixx-Dokumenteigenschaften aktivieren:

<Metadata>
  <Meta Name="OORefreshFieldsOnOpen" Type="Bool">true</Meta>
  <Meta Name="OORefreshFieldsOnSave" Type="Bool">true</Meta>
</Metadata>

→ Hier ist konfiguriert, dass das Word-AddIn alle Word-Felder bei jedem Öffnen und vor jedem Speichern aktualisiert (siehe "Spezielle OneOffixx-Dokumenteigenschaften" weiter oben).

Weiteres Beispiel:

<Metadata>
  <Core>
    <Subject>Individueller Betreff</Subject>
    <Status>Individueller Status</Status>
    <Category>Individuelle Kategorie</Category>
    <Title XPath="//Text[@id='Forms.Title']">Fallback, falls kein Titel kommt</Title>
  </Core>
</Metadata>

Word: Eigenschaften