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.