Regeln
Was mit Mail geschieht, während sie ankommt.
Regel-Tools
| Tool | Was es tut |
|---|---|
| listRules | Jede Regel der aktiven Verbindung, in der Reihenfolge ihrer Auswertung, mit dem, was sie jeweils tut, und wie oft sie ausgelöst hat. |
| getRule | Eine Regel vollständig: ihre Bedingungen, ihre Aktionen und ob sie an ist. |
| createRule | Eine Regel schreiben: Bedingungen über eine ankommende Nachricht und was mit allem geschehen soll, das darauf passt. Die Regel wird DEAKTIVIERT angelegt. |
| testRule | Welche Nachrichten der letzten dreißig Tage eine Regel erwischt hätte und was sie mit ihnen getan hätte. Ändert nichts. |
| setRuleEnabled | Eine Regel an- oder abschalten, sobald ein Mensch sie gegengelesen hat. |
createRule schreibt die Regel DEAKTIVIERT – die eine Stelle, an der dieser Server bewusst von der REST-API abweicht. POST /rules legt sie standardmäßig aktiviert an. Eine Regel, die Mail archiviert, in den Papierkorb legt oder weiterleitet, sollte damit nicht allein auf eine Chatnachricht hin beginnen: Schreiben Sie sie, rufen Sie testRule auf, um der Person, für die Sie arbeiten, zu zeigen, welche ihrer eigenen Nachrichten sie erwischt hätte, und fragen Sie erst dann nach setRuleEnabled.
Es gibt kein updateRule, kein deleteRule und kein Umsortieren, aus demselben Grund, aus dem es kein Löschen von Vorlagen gibt: Das sind die Operationen, die aus einem Chatfenster heraus die Einrichtung anderer zerlegen. Eine gelöschte Regel lässt sich nicht wiederherstellen, und ein Umsortieren ändert stillschweigend, was mit jeder künftigen Nachricht passiert. Alle drei stecken in Settings → Rules und in der REST-API, wo ein Mensch derjenige ist, der klickt.
Regeln gehören zur VERBINDUNG; diese Tools wirken also auf das Postfach, das setActiveConnection zuletzt benannt hat, und eine Regel, die jemand anderes im Team geschrieben hat, ist eine davon. Ein Postfach fasst 100 Regeln mit jeweils höchstens 20 Bedingungen und 10 Aktionen.
Nichts hier wirkt rückwirkend. Eine Regel entscheidet, was mit Mail geschieht, die nach ihrer Aktivierung ankommt; sie räumt kein bereits bestehendes Postfach auf, und testRule berichtet, statt abzulegen.