SetReceiveDataFilter

Benötigt: IP-Symcon >= 4.1

 boolean SetReceiveDataFilter (string $ErforderlicheRegexRegel) 

Parameterliste

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.

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

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 "";

}