Get-WordPressGfEntryNotes #
ÜBERSICHT #
Liest die Notizen (Notes) eines Gravity-Forms-Entries über die REST API v2.
SYNTAX #
Get-WordPressGfEntryNotes [-BaseUrl] <string> [-ConsumerKey] <string> [-ConsumerSecret] <string>
[-EntryId] <int> [[-NoteType] <string>] [[-TimeoutSec] <int>] [<CommonParameters>]
BESCHREIBUNG #
Ruft den Endpoint /wp-json/gf/v2/entries/{EntryId}/notes ab und liefert alle Notizen als strukturierte Objekte zurück. Optional kann nach NoteType gefiltert werden, z.B. ‘gravityview’ für Genehmigungsnotizen.
GravityView protokolliert jede Genehmigungsänderung als Entry-Note mit note_type ‘gravityview’. Diese Notizen enthalten user_id, user_name und user_email des ausführenden Benutzers sowie einen Zeitstempel.
Die Authentifizierung erfolgt per HTTP Basic Auth mit ConsumerKey und ConsumerSecret (Gravity Forms REST API Keys).
PARAMETER #
-BaseUrl #
Type: string
Basis-URL der WordPress-Installation, z.B. https://bestellung.example.de. Ein eventuell vorhandener Slash am Ende wird automatisch entfernt.
-ConsumerKey #
Type: string
Gravity Forms REST API Consumer Key (ck_…).
-ConsumerSecret #
Type: string
Gravity Forms REST API Consumer Secret (cs_…).
-EntryId #
Type: int
Die ID des Gravity-Forms-Entries, dessen Notizen geladen werden sollen.
-NoteType #
Type: string
Optionaler Filter auf note_type. Typische Werte:
- ‘gravityview’ : Genehmigungs-/Ablehnungsnotizen
- ’notification’ : E-Mail-Benachrichtigungen Ohne Angabe werden alle Notizen zurückgegeben.
-TimeoutSec #
Type: int
Default: 60
Timeout für den REST-Aufruf in Sekunden. Standard ist 60, erlaubt sind Werte von 1 bis 300.
AUSGABEN #
[pscustomobject[]]
Jedes Objekt hat folgende Eigenschaften: - Id : Note-ID - EntryId : Entry-ID - UserId : WordPress User-ID (0 bei Systemnotizen) - UserName : Benutzername oder Benachrichtigungsname - UserEmail : E-Mail-Adresse des Benutzers (kann $null sein) - Value : Notiztext (z.B. ‘Den Eintrag für GravityView genehmigt’) - NoteType : Typ der Notiz (z.B. ‘gravityview’, ’notification’) - SubType : Untertyp (z.B. ‘success’, ’error’) - DateCreated : Erstellungszeitpunkt als [datetime]
BEISPIELE #
# Alle Notizen eines Entries lesen
$notes = Get-WordPressGfEntryNotes `
-BaseUrl 'https://bestellung.example.de' `
-EntryId 176 `
-ConsumerKey 'ck_xxxxxxxxxxxxxxxxx' `
-ConsumerSecret 'cs_xxxxxxxxxxxxxxxxx'
# Nur GravityView-Genehmigungsnotizen lesen
$notes = Get-WordPressGfEntryNotes `
-BaseUrl 'https://bestellung.example.de' `
-EntryId 176 `
-ConsumerKey 'ck_xxxxxxxxxxxxxxxxx' `
-ConsumerSecret 'cs_xxxxxxxxxxxxxxxxx' `
-NoteType 'gravityview'
# Letzten Genehmiger mit E-Mail ermitteln
$notes = Get-WordPressGfEntryNotes `
-BaseUrl 'https://bestellung.example.de' `
-EntryId 176 `
-ConsumerKey 'ck_xxxxxxxxxxxxxxxxx' `
-ConsumerSecret 'cs_xxxxxxxxxxxxxxxxx' `
-NoteType 'gravityview'
$approver = $notes | Select-Object -Last 1
$approver.UserName # z.B. 'luca.pehl'
$approver.UserEmail # z.B. 'luca.pehl@wulff-med.de'