Regles
Què passa amb el correu quan arriba.
Eines de regles
| Eina | Què fa |
|---|---|
| listRules | Totes les regles de la connexió activa, en l'ordre en què s'avaluen, amb què fa cadascuna i quantes vegades s'ha disparat. |
| getRule | Una regla sencera: les seves condicions, les seves accions i si està activada. |
| createRule | Escriu una regla: condicions sobre un missatge que arriba, i què ha de passar amb tot el que hi coincideixi. La regla es crea DESACTIVADA. |
| testRule | Quins missatges dels darrers trenta dies hauria capturat una regla, i què n'hauria fet. No canvia res. |
| setRuleEnabled | Activa o desactiva una regla, un cop una persona l'ha llegida. |
createRule escriu la regla DESACTIVADA, que és l'únic punt on aquest servidor difereix deliberadament de l'API REST. POST /rules per defecte la deixa activada. Una regla que arxiva, llença a la paperera o reenvia correu no hauria de començar a fer-ho per la força d'un missatge de xat: escriu-la, crida testRule per mostrar a la persona per a qui treballes quins dels seus propis missatges hauria capturat, i només llavors demana setRuleEnabled.
No hi ha updateRule, ni deleteRule, ni reordenació, pel mateix motiu que no hi ha eliminació de plantilles: són les operacions que trenquen la configuració d'una altra persona des d'una finestra de xat. Una regla eliminada no es pot restaurar, i una reordenació canvia en silenci què passa amb tots els missatges futurs. Les tres són a Configuració → Regles i a l'API REST, on qui fa clic és una persona.
Les regles pertanyen a la CONNEXIÓ, de manera que aquestes actuen sobre la bústia que setActiveConnection hagi indicat per última vegada, i una regla que ha escrit un company n'és una. Una bústia admet 100 regles, cadascuna amb un màxim de 20 condicions i 10 accions.
Res d'aquí no és retroactiu. Una regla decideix què passa amb el correu que arriba després d'activar-la; no escombra una bústia que ja existeix, i testRule informa en lloc d'arxivar.