Remove-WordPressGfUnwantedFields

ÜBERSICHT

Reduziert eine Gravity-Forms-Order auf eine definierte Menge von Formularfeldern.

SYNTAX

Remove-WordPressGfUnwantedFields [-Order] <pscustomobject> [-FieldLabels] <string[]>
    [<CommonParameters>]

BESCHREIBUNG

Diese Funktion filtert eine bestehende Gravity-Forms-Order aus WordPress, sodass nur noch die gewünschten Formularfelder enthalten sind.

Die Reduktion erfolgt anhand der Feldbezeichnungen (FieldLabel). Alle Formularfelder, deren FieldLabel nicht in der angegebenen Liste enthalten ist, werden sowohl aus Meta.Fields als auch aus Data entfernt.

Die Struktur der Order bleibt vollständig erhalten:

• Technische Eigenschaften wie EntryId, FormId, DateCreated, Status, Approved und CreatedBy bleiben unverändert
• Es findet keine Umstrukturierung statt, sondern ausschließlich eine Feldreduktion
• Meta.Fields und Data bleiben konsistent zueinander

Die Funktion eignet sich als vorbereitender Schritt für:

• CSV- oder XML-Exporte
• Mapping auf EULANDA-Strukturen
• weitere fachliche Anreicherung oder Validierung

PARAMETER

-Order

Type: pscustomobject

Die zu verarbeitende Gravity-Forms-Order im internen Objektformat.

Erwartet wird ein Objekt mit mindestens folgenden Eigenschaften:

• EntryId
• FormId
• DateCreated
• Status
• Meta.Fields (Hashtable mit Felddefinitionen)
• Data (Hashtable mit Feldwerten)

Die Order wird nicht verändert, sondern als neues, reduziertes Objekt zurückgegeben.

-FieldLabels

Type: string[]

Liste der Formularfeld-Bezeichnungen (FieldLabel), die in der Order erhalten bleiben sollen.

Alle Formularfelder, deren FieldLabel nicht in dieser Liste enthalten ist, werden aus Meta.Fields und Data entfernt.

.OUTPUTTYPE pscustomobject

BEISPIELE

# Gewünschte Formularfelder definieren, hier beispielhaft und fallspezifisch
$wantedFields = @(
  'OrderDate',
  'OrderNumber',
  'CustomerName',
  'CustomerEmail',
  'ItemNumber',
  'Quantity'
)

# Order auf die gewünschten Felder reduzieren
Write-Verbose "Original-Felder: $($orderRaw.Meta.Fields.Count)"

$order = Remove-WordPressGfUnwantedFields `
  -Order $orderRaw `
  -FieldLabels $wantedFields

Write-Verbose "Felder nach Reduktion: $($order.Meta.Fields.Count)"