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 https://learn.microsoft.com/de-ch/dotnet/api/system.io.packaging.packageproperties?redirectedfrom=MSDN&view=netframework-4.8 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>

hinweis

HINWEIS LastPrinted, Modified und Created sind Datumswerte.

---

Erweiterte Eigenschaften

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

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

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.

---

primedocs Dokumenteigenschaften

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

Name der erweiterten Dokumenteigenschaft	Auswirkung
OORefreshFieldsOnOpen	Wenn true: Das primedocs-Add-In aktualisiert die nachfolgenden Word-Felder bei jedem Öffnen.
OORefreshFieldsOnSave	Wenn true: Das primedocs-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
• WdFieldType.wdFieldIncludePicture

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 primedocs 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>

primedocs-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 primedocs-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 primedocs-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>