Get-WordPressGfOrder

ÜBERSICHT

Liest einen einzelnen Gravity-Forms-Entry (Bestellung) über WordPress und gibt die Formular-Metadaten sowie die zugehörigen Feldwerte strukturiert zurück.

SYNTAX

Get-WordPressGfOrder [-BaseUrl] <string> [-FormId] <int> [-ConsumerKey] <string> [-ConsumerSecret]
    <string> [-EntryId] <int> [[-TimeoutSec] <int>] [<CommonParameters>]

BESCHREIBUNG

Diese Funktion ruft über die Gravity Forms REST API v2:

• die Formular-Definition (Form Meta) anhand der FormId
• einen konkreten Entry anhand der EntryId

Dabei wird:

• für jedes Formularfeld (inkl. Sub-Inputs wie 1.3, 1.6 bei Name/Adresse) eine Metadaten-Struktur mit FieldId und FieldLabel aufgebaut
• aus dem Entry nur genau diese Feld-IDs extrahiert
• ein konsistentes Objekt erzeugt, unabhängig davon, ob Felder im Entry leer sind

Die Authentifizierung erfolgt per HTTP Basic Auth mit ConsumerKey und ConsumerSecret, den Gravity Forms REST API Keys.

Das Ergebnis ist bewusst so aufgebaut, dass es sich gut für:

• Mapping z.B. EULANDA-ERP
• Weiterverarbeitung
• Debugging und Logging eignet.

PARAMETER

-BaseUrl

Type: string

Basis-URL der WordPress-Installation, z.B. https://example.com. Ein eventuell vorhandener Slash am Ende wird automatisch entfernt.

-FormId

Type: int

Die ID des Gravity-Forms-Formulars, zu dem der Entry gehören muss.

-ConsumerKey

Type: string

Gravity Forms REST API Consumer Key.

-ConsumerSecret

Type: string

Gravity Forms REST API Consumer Secret.

-EntryId

Type: int

Die ID des Gravity-Forms-Entries, wobei ein Eintrag gleich eine Bestellung ist, der geladen werden soll.

-TimeoutSec

Type: int
Default: 60

Timeout für die REST-Aufrufe in Sekunden. Standard ist 60, erlaubt sind Werte von 1 bis 300.

AUSGABEN

[pscustomobject]

Das zurückgegebene Objekt hat folgende Struktur: - EntryId : ID des Entries - FormId : Formular-ID - DateCreated : Erstellungsdatum des Entries - Status : Status des Entries (z.B. active) - Meta.Fields : Hashtable mit Feld-Metadaten (FieldId, FieldLabel) - Data : Hashtable mit den tatsächlichen Feldwerten (Key = FieldId)

BEISPIELE

# Einzelnen Gravity-Forms-Entry laden
$order = Get-WordPressGfOrder `
  -BaseUrl 'https://shop.example.de' `
  -FormId 1 `
  -EntryId 46 `
  -ConsumerKey 'ck_xxxxxxxxxxxxxxxxx' `
  -ConsumerSecret 'cs_xxxxxxxxxxxxxxxxx'

# Zugriff auf ein bestimmtes Feld über die FieldId
$order = Get-WordPressGfOrder `
  -BaseUrl 'https://shop.example.de' `
  -FormId 1 `
  -EntryId 46 `
  -ConsumerKey 'ck_xxxxxxxxxxxxxxxxx' `
  -ConsumerSecret 'cs_xxxxxxxxxxxxxxxxx'

# Beispiel: Feld 11 (z.B. Name oder E-Mail)
$order.Data['11']

# Alle Feld-Labels mit Werten ausgeben
$order = Get-WordPressGfOrder `
  -BaseUrl 'https://shop.example.de' `
  -FormId 1 `
  -EntryId 46 `
  -ConsumerKey 'ck_xxxxxxxxxxxxxxxxx' `
  -ConsumerSecret 'cs_xxxxxxxxxxxxxxxxx'

foreach ($id in $order.Meta.Fields.Keys) {
  [pscustomobject]@{
    FieldId    = $id
    FieldLabel = $order.Meta.Fields[$id].FieldLabel
    Value      = $order.Data[$id]
  }
}

HINWEISE

• Die Funktion prüft, ob der Entry tatsächlich zum angegebenen Formular gehört.
• Leere oder nicht gesetzte Felder werden explizit mit $null zurückgegeben.
• PowerShell 5.1 wird unterstützt; TLS 1.2 wird bei Bedarf erzwungen.