« Zurück zu Produkt

Dokumentation

SetReceiveDataFilter

Benötigt: IP-Symcon >= 4.1

 boolean SetReceiveDataFilter (string $ErforderlicheRegexRegel) 

Parameterliste

ErforderlicheRegexRegel

Regexregel welche als Filter angewendet werden soll

Rückgabewert

Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis TRUE, andernfalls FALSE.

Beschreibung

Setzt den Filter mit der Regular Expression ErforderlicheRegexRegel. RecieveData() wird nur aufgerufen wenn der gesetzte Filter zutrifft.

Warning

Zum Testen für den RegEx-Ausdruck kann die Seite www.regex101.com genutzt werden.

Warning

Bei bestimmten Sonderfällen kann es zu einer Änderung von Groß- zu Kleinschreibung beim PHP json_encode() kommen. So wird z.B. aus dem Sonderzeichen kodierten JSON_String ""\u001D"" nach einem json_decode und erneutem json_encode ""\u001d"".

Beispiel

// Filter für ReceiveData hinzufügen
public function ApplyChanges(): void {

    [...]
    $this->SetReceiveDataFilter(".*Hallo.*");
    [...]

}

// Wird nur aufgerufen, wenn "Hallo" im $JSONString gefunden wird
public function ReceiveData(string $JSONString): string {

    return "";

}
Haben Sie noch Fragen?