Kontakty
Książka adresowa, do której pisze ta skrzynka.
Narzędzia kontaktów
| Narzędzie | Co robi |
|---|---|
| listContacts | Osoby, do których pisze ta skrzynka, od najnowszej korespondencji. Szukaj po nazwie albo adresie, zawęź do jednej grupy odbiorców albo oddziel te dodane przez kogoś od tych zapisanych automatycznie. |
| getContact | Jeden kontakt po adresie e-mail, z pełnymi notatkami i każdą grupą odbiorców, w której się znajduje. |
| createContact | Dodaj kontakt ręcznie. Jeden kontakt na adres, więc adres już tu obecny zostaje odrzucony, a nie zapisany dwa razy. Nowy kontakt trafia do domyślnej grupy odbiorców. |
| updateContact | Zmień nazwę kontaktu albo notatki prowadzone przy nim. Przekazanie null czyści pole, a pominięcie go zostawia je bez zmian. |
| deleteContact | Usuń kontakt na stałe. Razem z nim znikają notatki oraz każda grupa odbiorców, w której był. |
Kontakty należą do SKRZYNKI, a nie do tego, kto je zapisał, więc kolega z tą samą rolą czyta i zapisuje tę samą książkę. Kontakt zapisywany jest automatycznie przy pierwszej wiadomości wychodzącej na dany adres z edytora wiadomości w aplikacji; poczta przychodząca z jakiegoś adresu nie zapisuje niczego.
Tożsamością jest adres i nie ma żadnego id. Dlatego updateContact nie może go zmienić, a przeniesienie kogoś na nowy adres to createContact i deleteContact. createContact nie przyjmuje pola source: wszystko utworzone tutaj jest manual, a wysyłka nigdy nie obniża tego z powrotem do auto.
Nic z tego niczego nie wysyła ani nikogo do niczego nie zapisuje, a deleteContact nikogo nie wypisuje, bo ta skrzynka w ogóle nie trzyma stanu subskrypcji. Adres, do którego skrzynka nadal pisze, zostanie zapisany ponownie przy kolejnej wysyłce — bez notatek i bez grup odbiorców.