Rules
Wat er met mail gebeurt zodra die binnenkomt.
Tools voor rules
| Tool | Wat het doet |
|---|---|
| listRules | Elke regel op de actieve connection, in de volgorde waarin ze worden geëvalueerd, met wat elke regel doet en hoe vaak hij is afgegaan. |
| getRule | Eén regel in zijn geheel: de voorwaarden, de acties en of hij aan staat. |
| createRule | Schrijf een regel: voorwaarden over een binnenkomend bericht, en wat er moet gebeuren met alles wat eraan voldoet. De regel wordt UITGESCHAKELD aangemaakt. |
| testRule | Welke berichten van de afgelopen dertig dagen een regel zou hebben gevangen, en wat hij ermee zou hebben gedaan. Verandert niets. |
| setRuleEnabled | Zet één regel aan of uit, nadat een mens hem heeft teruggelezen. |
createRule schrijft de regel UITGESCHAKELD weg, en dat is de ene plek waar deze server bewust afwijkt van de REST API. POST /rules staat standaard ingeschakeld. Een regel die mail archiveert, weggooit of doorstuurt zou daar niet mee moeten beginnen op gezag van een chatbericht: schrijf hem, roep testRule aan om de persoon voor wie je werkt te laten zien welke van zijn eigen berichten hij zou hebben gevangen, en vraag pas daarna om setRuleEnabled.
Er is geen updateRule, geen deleteRule en geen herordening, om dezelfde reden dat er geen templateverwijdering is: dat zijn de handelingen die vanuit een chatvenster de inrichting van iemand anders kapotmaken. Een verwijderde regel kan niet worden hersteld, en een herordening verandert stilletjes wat er met elk toekomstig bericht gebeurt. Alle drie zitten in Settings → Rules en op de REST API, waar een mens degene is die klikt.
Regels horen bij de CONNECTION, dus deze werken op de mailbox die setActiveConnection het laatst heeft genoemd, en een regel die een collega heeft geschreven is er één van. Een mailbox houdt 100 regels, elk met maximaal 20 voorwaarden en 10 acties.
Niets hiervan werkt met terugwerkende kracht. Een regel bepaalt wat er gebeurt met mail die binnenkomt nadat hij is ingeschakeld; hij veegt geen mailbox door die al bestaat, en testRule rapporteert in plaats van op te bergen.