IMAP SEARCH

IMAP SEARCH to polecenie tego protokołu umożliwiające przeszukiwanie wiadomości na serwerze według zdefiniowanych kryteriów.

Jak działa wyszukiwanie IMAP SEARCH

IMAP SEARCH jest poleceniem protokołu IMAP służącym do wyszukiwania wiadomości bez konieczności pobierania całej zawartości skrzynki na komputer użytkownika. Po wybraniu folderu pocztowego, na przykład INBOX, klient poczty przekazuje serwerowi zestaw kryteriów. Serwer analizuje wiadomości znajdujące się w tym folderze i zwraca numery wiadomości spełniających podane warunki. Dzięki temu wyszukiwanie może obejmować również pocztę przechowywaną na serwerze, a nie tylko wiadomości zapisane lokalnie w programie pocztowym.

Podstawowa postać polecenia ma składnię SEARCH kryterium, przy czym kryterium może być pojedyncze albo złożone z wielu elementów. Polecenie SEARCH ALL oznacza wyszukanie wszystkich wiadomości w aktualnie wybranym folderze. Wynik zwykłego SEARCH jest zwracany jako numery sekwencyjne wiadomości, czyli numery zależne od bieżącego widoku i stanu folderu. Numery te nie są trwałymi identyfikatorami, dlatego do operacji wymagających stabilnego wskazania wiadomości stosuje się polecenie UID SEARCH, zwracające identyfikatory UID.

Kryteria nadawcy, odbiorcy i treści wiadomości

IMAP SEARCH pozwala filtrować wiadomości według pól nagłówka oraz tekstu. Kryterium FROM wyszukuje wskazany tekst w polu nadawcy, a TO w polu odbiorcy. Do sprawdzania tematu służy SUBJECT. Przykładowe polecenie SEARCH FROM "example.com" może odszukać wiadomości, których pole nadawcy zawiera podany tekst, natomiast SEARCH SUBJECT "raport" wyszukuje temat zawierający słowo „raport”. Dopasowanie nie jest ograniczone wyłącznie do pełnej, identycznej wartości pola.

Do przeszukiwania tekstu wiadomości służą między innymi kryteria BODY i TEXT. BODY odnosi się do treści wiadomości, a TEXT obejmuje tekst nagłówków i treści. Kryterium HEADER pozwala wskazać konkretny nagłówek, na przykład HEADER Message-ID "abc" albo HEADER X-Mailer "program". Można także używać kryteriów stanu, takich jak SEEN, UNSEEN, ANSWERED, FLAGGED, DELETED i DRAFT. Są one związane z flagami IMAP przypisanymi do wiadomości, a nie z nazwą folderu widoczną w programie pocztowym.

Łączenie warunków i ograniczenia dat

Wiele warunków w jednym poleceniu SEARCH jest domyślnie łączonych logicznie operatorem AND. Polecenie SEARCH FROM "firma.pl" UNSEEN zwróci więc wiadomości od wskazanego nadawcy, które nie zostały oznaczone jako przeczytane. Do zaprzeczenia warunku służy NOT, a do alternatywy OR. Możliwe jest także grupowanie kryteriów w nawiasach, co pozwala budować bardziej precyzyjne zapytania, na przykład łączyć kilka nadawców z jednym warunkiem dotyczącym tematu.

Wyszukiwanie może być ograniczone datą wewnętrzną wiadomości przechowywaną przez serwer. SINCE wybiera wiadomości z określonej daty lub późniejsze, BEFORE wiadomości wcześniejsze od wskazanej daty, a ON wiadomości przypisane do konkretnego dnia. Dostępne są także kryteria dotyczące daty wysłania, między innymi SENTSINCE, SENTBEFORE i SENTON, które odnoszą się do daty zapisanej w nagłówku wiadomości. Różnica między datą wewnętrzną a datą z nagłówka może powodować, że wyniki wyszukiwania nie będą odpowiadały dacie widocznej w polu „Wysłano”.

W zapytaniu można wskazywać zakresy numerów sekwencyjnych, na przykład 1:50, oraz wyszukiwać wiadomości większe lub mniejsze od określonego rozmiaru za pomocą LARGER i SMALLER. Składnia tekstowa jest wrażliwa na poprawne cytowanie wartości zawierających spacje. Wynik zależy również od możliwości konkretnego serwera IMAP, jego interpretacji kodowania znaków oraz od tego, czy klient pocztowy korzysta ze standardowego SEARCH, czy z dodatkowych rozszerzeń.

Rola IMAP SEARCH podczas diagnozy poczty

Nieprawidłowe wyniki wyszukiwania nie zawsze oznaczają uszkodzenie wiadomości. Przyczyną może być przeszukiwanie niewłaściwego folderu, użycie numerów sekwencyjnych po zmianie zawartości skrzynki, różnica między datą serwera a datą z nagłówka albo ograniczona obsługa kryteriów przez serwer. Znaczenie ma także sposób indeksowania poczty. Serwer może zwracać wynik z opóźnieniem, a niektóre programy pocztowe mogą prezentować własne, lokalne wyniki zamiast przekazywać zapytanie IMAP do serwera.

Podczas diagnostyki warto sprawdzić, czy konto korzysta z IMAP, jaki folder jest aktualnie wybrany, czy wiadomości mają oczekiwane flagi oraz czy wyszukiwanie działa przez webmail i przez program pocztowy. Pomocne jest porównanie prostego zapytania, takiego jak wyszukiwanie po adresie nadawcy, z bardziej złożonym filtrem obejmującym temat, datę i status przeczytania. Należy również odróżnić brak wyników od błędu składni polecenia. Warszawskie Pogotowie Komputerowe wykonuje profesjonalną naprawę laptopów i komputerów PC, w tym diagnostykę problemów z konfiguracją programów pocztowych oraz działaniem poczty na tych urządzeniach.