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 |
---|---|---|
| Text |
|
| Zahl |
|
| Zahl |
|
| Ja oder Nein |
|
| Datum |
|
Ä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 |
---|---|
| Wenn |
| Wenn |
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