1 Zweck und Einsatz
2 Grundaufbau
3 Konfiguration
- 3.1 Core Properties
- 3.2 Custom Properties
- 3.3 Globale Properties
- 3.4 Zugriff auf dynamische Felder

Zweck und Einsatz

Die OfficeProperties-Dokumentfunktion ermöglicht das automatische Setzen von OpenXML Core Properties und Custom Properties in Office-Dokumenten (Word, Excel, PowerPoint).
Dies umfasst sowohl statische Werte als auch dynamisch berechnete Inhalte über field-Value.

Typische Einsatzszenarien:

Automatische Dokumentklassifikation
Unternehmensweite Corporate‑Metadata
Abbildung von Workflow‑Informationen
Ergänzung technischer Metadaten (z. B. IDs, Timestamps)

Grundaufbau

<OfficePropertiesConfiguration>

    <!-- Core Properties -->
    <Title Value="Beispieltitel" />
    <Subject field-Value="Project.Subject" />
    <Keywords Value="primedocs; metadata" />
    <Description Value="Automatisch generiertes Office-Dokument" />
    <Category Value="Reports" />
    <ContentStatus Value="Final" />

    <!-- Custom Properties -->
    <CustomProperty Name="CustomerId" Type="Text" field-Value="Customer.Id" />
    <CustomProperty Name="IsConfidential" Type="YesNo" Value="true" />

    <!-- Globale Property-Referenzen -->
    <GlobalCoreProperty Key="DocumentTitle" />
    <GlobalCustomProperty Key="BusinessUnit" />

</OfficePropertiesConfiguration>

Konfiguration

Der Root‑Container für alle Core‑ und Custom Properties heisst OfficePropertiesConfiguration.
Alle Elemente sind optional und beliebig kombinierbar.

Core Properties

Core Properties entsprechen den standardisierten Metadaten eines Office-Dokuments (sichtbar unter Datei → Informationen).

Unterstützte Core‑Property‑Elemente

Eigenschaft	Beschreibung

Eigenschaft	Beschreibung
Title	Dokumenttitel
Subject	Betreff / Thema
Keywords	Schlüsselwörter
Description	Beschreibung
Category	Kategorie
ContentStatus	Bearbeitungsstatus

Attribute (CorePropertyType)

Attribut	Beschreibung

Attribut	Beschreibung
Value	Statischer Wert
field-Value	Dynamischer Wert über `Fields`

Hinweis: Es sollte nur Value oder field-Value gesetzt werden. Es wird ein Fehler zurückgegeben, wenn ein field-Value auf ein unbekanntes Feld zeigt.

Custom Properties

Custom Properties erlauben frei definierbare Metadaten bestehend aus einem Name, Type und Value bzw. field-Value.

<CustomProperty Name="CustomerId" Type="Text" field-Value="Customer.Id" />

Attribute

Attribut	Beschreibung

Attribut	Beschreibung
Name	Name der Property
Type	`Text`, `Number`, `Date`, `YesNo`
Value	Statischer Wert
field-Value	Dynamischer Wert über Fields

Globale Properties

Globale Properties erlauben die Verwendung zentral verwalteter Metadaten im Zusammenhang mit der Globale Konfigurationen.

Es können mehrere “Globale”-Verweise genutzt werden, allerdings darf ein Element nur einmalig definiert sein - ein doppelter Title oder ein doppeltes CustomProperty führt zu einem Fehler.

GlobalCoreProperty

<GlobalCoreProperty Key="DefaultCoreProperties" />

GlobalCustomProperty

<GlobalCustomProperty Key="CustomerRelatedProperties" />

Zugriff auf dynamische Felder

Die Properties werden vor der finalen Dokumentausgabe in die Word/Excel/PowerPoint-Datei geschrieben.
Über field-Value kann auf Forms, Fields, Profile und Data-Felder zugegriffen werden.