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

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

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

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

→ 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

→ 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

 

PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland