Règles
Ce qui arrive au courrier à sa réception.
Outils Règles
| Outil | Ce qu'il fait |
|---|---|
| listRules | Toutes les règles de la connexion active, dans l'ordre où elles sont évaluées, avec ce que chacune fait et le nombre de fois qu'elle s'est déclenchée. |
| getRule | Une règle en détail : ses conditions, ses actions et si elle est active. |
| createRule | Écrire une règle : des conditions portant sur un message entrant, et ce qui doit arriver à tout ce qui les satisfait. La règle est créée DÉSACTIVÉE. |
| testRule | Quels messages des trente derniers jours une règle aurait attrapés, et ce qu'elle leur aurait fait. Ne change rien. |
| setRuleEnabled | Activer ou désactiver une règle, une fois qu'une personne l'a relue. |
createRule écrit la règle DÉSACTIVÉE, et c'est le seul endroit où ce serveur diffère délibérément de l'API REST. POST /rules crée une règle activée par défaut. Une règle qui archive, met à la corbeille ou fait suivre du courrier ne devrait pas se mettre à le faire sur la foi d'un message de conversation : écrivez-la, appelez testRule pour montrer à la personne pour qui vous travaillez lesquels de ses propres messages elle aurait attrapés, et demandez seulement ensuite setRuleEnabled.
Il n'y a ni updateRule, ni deleteRule, ni réordonnancement, pour la même raison qu'il n'y a pas de suppression de modèle : ce sont les opérations qui cassent la configuration de quelqu'un d'autre depuis une fenêtre de conversation. Une règle supprimée ne peut pas être restaurée, et un réordonnancement change silencieusement ce que fera chaque message futur. Les trois se trouvent dans Paramètres → Règles et sur l'API REST, là où c'est une personne qui clique.
Les règles appartiennent à la CONNEXION : celles-ci agissent donc sur la boîte aux lettres nommée en dernier par setActiveConnection, et une règle écrite par un collègue en fait partie. Une boîte aux lettres contient 100 règles, chacune avec au plus 20 conditions et 10 actions.
Rien ici n'est rétroactif. Une règle décide de ce qui arrive au courrier reçu après son activation ; elle ne balaie pas une boîte aux lettres déjà constituée, et testRule rapporte plutôt qu'il ne classe.