Contacts
Le carnet d'adresses auquel cette boîte aux lettres écrit.
Outils Contacts
| Outil | Ce qu'il fait |
|---|---|
| listContacts | Les personnes auxquelles cette boîte aux lettres écrit, correspondance la plus récente en premier. Cherchez par nom ou par adresse, restreignez à une seule audience, ou séparez ceux que quelqu'un a ajoutés de ceux qui ont été enregistrés automatiquement. |
| getContact | Un contact par adresse e-mail, avec ses notes en entier et chaque audience dont il fait partie. |
| createContact | Ajouter un contact à la main. Un seul contact par adresse : une adresse déjà présente est donc refusée plutôt qu'écrite deux fois. Le nouveau contact rejoint l'audience par défaut. |
| updateContact | Modifier le nom d'un contact ou les notes conservées à son sujet. Passer null vide un champ, l'omettre le laisse inchangé. |
| deleteContact | Supprimer définitivement un contact. Les notes partent avec lui, ainsi que chaque audience dont il faisait partie. |
Les contacts appartiennent à la BOÎTE AUX LETTRES plutôt qu'à celui qui les a enregistrés : un collègue détenant le même rôle lit et écrit donc le même carnet. Un contact est enregistré automatiquement la première fois qu'un message part vers une adresse depuis la fenêtre de rédaction de l'application ; le courrier arrivant d'une adresse n'écrit rien.
L'adresse est l'identité et il n'y a pas d'id. updateContact ne peut donc pas la changer, et faire passer quelqu'un à une nouvelle adresse, c'est un createContact et un deleteContact. createContact ne prend pas de source : tout ce qui est créé ici est manual, et un envoi ne rétrograde jamais cette valeur en auto.
Rien de tout cela n'envoie quoi que ce soit ni n'abonne qui que ce soit à quoi que ce soit, et deleteContact ne désabonne personne, parce que cette boîte aux lettres ne conserve aucun état d'abonnement. Une adresse à laquelle la boîte aux lettres continue d'écrire est réenregistrée au prochain envoi, sans notes et sans audiences.