1 Eigenschaften
2 Erweiterte Eigenschaften
- 2.1 Unterstützte Typen
3 primedocs Dokumenteigenschaften
4 Aktualisierungen im offenen Dokument
5 Beispiele
- 5.1 Fixwerte
- 5.2 primedocs-Texte mit Fallback
- 5.3 Spezielle primedocs-Dokumenteigenschaften aktivieren
- 5.4 Weiteres Beispiel

Ü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).

primedocs: technische Dokumentation

Metadaten