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