Add Word Press Gf Meta Fields
Zuletzt geändert: 14.03.2026 05:56

Add-WordPressGfMetaFields #

ÜBERSICHT #

Erzeugt aus einer reduzierten WordPress-Order eine einheitliche Feldliste und ergänzt optional systemseitige Meta-Felder.

SYNTAX #

Add-WordPressGfMetaFields [-Order] <pscustomobject> [-IncludeEntryId] [-IncludeApproved]
    [-IncludeCreatedBy] [-IncludeDateCreated] [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion wandelt eine bereits reduzierte WordPress-Order (z.B. aus Add-WordPressGfMetaFields) in eine lineare Feldliste um.

Die Ausgabe besteht aus Objekten mit den Eigenschaften:

  • FieldId
  • FieldLabel
  • Value

Neben den eigentlichen Formularfeldern, aus Order.Data und Order.Meta.Fields, können zusätzliche systemseitige Felder als sogenannte “virtuelle Felder” ergänzt werden. Dies sidn i.d.R. Meta-Daten aus WordPress. Diese erhalten feste, negative FieldIds und werden immer vor den Formularfeldern der Order ausgegeben.

Typische Anwendungsfälle sind:

  • Vereinheitlichte Weiterverarbeitung (CSV, XML, Mapping)
  • Ergänzung technischer Informationen (EntryId, Approval-Status)
  • Vorbereitung für EULANDA-Importe oder Zwischenformate

PARAMETER #

-Order #

Type: pscustomobject

Reduzierte WordPress-Order mit den Eigenschaften:

  • EntryId
  • Data (Hashtable mit FieldId => Value)
  • Meta.Fields (Hashtable mit FieldId => Metadaten, z.B. FieldLabel)

Die Order stammt in der Regel aus Add-WordPressGfMetaFields, welche im Haupt-Ablaufskript verwendet wird.

-IncludeEntryId #

Type: switch

Fügt die EntryId der Order als virtuelles Feld hinzu. Das Feld erhält:

  • FieldId = 0
  • FieldLabel = ‘EntryId’

-IncludeApproved #

Type: switch

Fügt den Approval-Status der Order als virtuelles Feld hinzu. Das Feld wird nur befüllt, wenn die Eigenschaft ‘Approved’ vorhanden ist.

  • FieldId = -1
  • FieldLabel = ‘Approved’

-IncludeCreatedBy #

Type: switch

Fügt den Ersteller (CreatedBy) der Order als virtuelles Feld hinzu. Das Feld wird nur befüllt, wenn die Eigenschaft ‘CreatedBy’ vorhanden ist.

  • FieldId = -2
  • FieldLabel = ‘CreatedBy’

-IncludeDateCreated #

Type: switch

Fügt das Erstellungsdatum der Order als virtuelles Feld hinzu. Das Feld wird nur befüllt, wenn die Eigenschaft ‘DateCreated’ vorhanden ist.

  • FieldId = -3
  • FieldLabel = ‘DateCreated’

.OUTPUTTYPE [pscustomobject[]]

Jedes Objekt enthält:

  • FieldId
  • FieldLabel
  • Value

BEISPIELE #

# Erzeugt eine Feldliste nur aus den Formularfeldern
$fields = Add-WordPressGfMetaFields -Order $order

# Ergänzt die EntryId als technisches Feld
$fields = Add-WordPressGfMetaFields `
  -Order $order `
  -IncludeEntryId

# Ergänzt mehrere systemseitige Meta-Felder
$fields = Add-WordPressGfMetaFields `
  -Order $order `
  -IncludeEntryId `
  -IncludeApproved `
  -IncludeCreatedBy `
  -IncludeDateCreated

# Typischer Workflow: Order reduzieren, dann Feldliste erzeugen
$order = Select-WordPressGfOrderFields -Order $rawOrder
$fields = Add-WordPressGfMetaFields -Order $order -IncludeEntryId

HINWEISE #

Eine Order bezeichnet einen einzelnen Entry aus einem Gravity-Forms- Formular in WordPress.

Gravity Forms speichert jede Formularübermittlung als Entry. Diese Entries werden im EULANDA-Kontext als Orders interpretiert und weiterverarbeitet.