# Podręcznik WebIssues

## Wersja 1.1

Spis treści » Przygotowanie systemu
« Wysyłanie e-maili
Praca ze sprawami »

## Skrzynka odbiorcza

System WebIssues może również odbierać e-maile używając wybranego konta pocztowego i tworzyć sprawy na podstawie tych e-maili, a także tworzyć komentarze i załączniki do istniejących spraw. W połączeniu z subskrypcjami mailowymi, pozwala to skonfigurować dwustronną komunikację mailową z systemem WebIssues. Jest nawet możliwość, by zewnętrzny użytkownicy, nieposiadający konta w systemie WebIssues, komunikowali się w ten sposób z systemem, co jest bardzo użyteczne w przypadku różnego rodzaju usług wsparcia.

Choć skrzynka odbiorcza może być używana bez wysyłania e-maili, w takim wypadku nie będziesz mógł skorzystać z automatycznych odpowiedzi i subskrypcji. Poza tym, jeśli wysyłanie e-maili nie jest skonfigurowane, to użytkownicy systemu WebIssues nie posiadają przypisanego adresu mailowego, a więc wszystkie e-maile są traktowane, jakby były wysłane przez zewnętrznych użytkowników. Więcej informacji o konfigurowaniu wysyłania poczty znajdziesz w sekcji „Ustawienia e-maili”. Musisz również upewnić się, że zadanie cykliczne jest prawidłowo skonfigurowane. Więcej informacji na ten temat znajdziesz w sekcji „Zadania cykliczne”.

### Ustawienia skrzynki odbiorczej

Jeśli chcesz, by system WebIssues odbierał wiadomości e-mail, przejdź do Panelu Administracyjnego i kliknij Ustawienia skrzynki odbiorczej.

Rysunek 2.12. Ustawienia skrzynki odbiorczej

Wybierz protokół komunikacji z serwerem poczty. Zalecane jest wybranie opcji Serwer IMAP, jeśli jest to możliwe, jednak Serwer POP3 również jest wspierany. Podaj również adres e-mail skrzynki odbiorczej. W sekcji Serwer skrzynki odbiorczej podaj adres serwera poczty i numer portu. Wybierz odpowiedni tryb szyfrowania, jeśli twój serwer go obsługuje. Podaj również nazwę użytkownika i hasło używane do uwierzytelnienia połączenia. Możesz podać nazwę skrzynki pocztowej, z której będą pobierane wiadomości do przetworzenia. Jeśli zostawisz to pole puste, zostanie użyta osobista skrzynka odbiorcza bieżącego użytkownika.

### Notatka

Choć ten sam adres e-mail może być użyty do wysyłania poczty i dla skrzynki odbiorczej, zalecane jest użycie dwóch osobnych adresów. Ograniczy to ryzyko powstawania pętli, gdy e-mail powiadomienia zostanie odbity przez serwer poczty odbiorcy, a odbita wiadomość zostanie przetworzona przez skrzynkę odbiorczą.

Zaznacz opcję Nie sprawdzaj certyfikatu serwera, jeśli używasz szyfrowanego połączenia z lokalnym serwerem, który używa samopodpisanego certyfikatu. Używając serwera IMAP, możesz również zaznaczyć opcję Pozostaw przetworzone wiadomości na serwerze. Domyślnie system WebIssues automatycznie usunie przetworzone wiadomości z serwera. Po włączeniu tej opcji, wiadomości będą jedynie oznaczane jako przeczytane i zostaną pozostawione na serwerze. W takim wypadku upewnij się, że zasady przechowywania wiadomości na serwerze usuwają stare e-maile, aby uniknąć zapełnienia skrzynki odbiorczej. Ta opcja nie jest dostępna, jeśli używasz serwera POP3.

Naciśnij przycisk Testuj połączenie by potwierdzić, że system WebIssues może połączyć się z podanym serwerem. Nie spowoduje to przetworzenia żadnych wiadomości, a jedynie wyświetlenie komunikatu o powodzeniu lub błędzie.

Gdy do skrzynki odbiorczej systemu WebIssues jest wysłana wiadomość e-mail, zostaje ona zarejestrowana jako nowa sprawa w wybranym folderze. Temat wiadomości staje się nazwą sprawy. Wszystkie atrybuty są ustawiona na domyślne, początkowe wartości. Tekstowa treść e-maila jest automatycznie dodana jako opis sprawy, wraz z najważniejszymi nagłówkami, takimi jak adres nadawcy i odbiorców wiadomości. Jeśli e-mail posiada treść w formacie HTML, zostaje ona dodana jako załącznik, który można łatwo otworzyć i wyświetlić w przeglądarce. Wszystkie pliki załączone do e-maila są również dodawane jako załączniki sprawy.

Jeśli temat e-maila zawiera identyfikator w nawiasach kwadratowych, na przykład `[#123]`, treść e-maila jest dodawana jako nowy komentarz do sprawy o podanym identyfikatorze. Treść w formacie HTML i załączone pliki są również dodawane jego załączniki tej sprawy. Najłatwiej dodasz komentarz do istniejącej sprawy, odpowiadając na wiadomość potwierdzającą jej utworzenie, albo na powiadomienie subskrypcji, ponieważ zawierają one już identyfikator sprawy w temacie. Pamiętaj, by zamieścić swój komentarz na początku e-maila. Treść cytowanego powiadomienia nie zostanie zamieszczone w twoim komentarzu, ponieważ jest ona automatycznie odcinana na pierwszej linii zawierającej kreski.

### Zewnętrzni użytkownicy

Domyślnie akceptowane są tylko wiadomości wysłane przez użytkowników systemu WebIssues. Adres nadawcy jest porównywany z adresami e-mail skonfigurowanymi w preferencjach użytkowników. E-maile wysłane z adresów, które nie mają odpowiadających użytkowników w systemie WebIssues, są ignorowane. Pamiętaj, że sprawy są tworzone i modyfikowane w imieniu użytkownika skojarzonego z adresem nadawcy, a więc użytkownik ten musi mieć dostęp do projektu i folderu zawierającego sprawę. W przeciwnym wypadku wiadomość jest ignorowana, a do Dziennika zdarzeń jest dodawane ostrzeżenie.

Jeśli włączysz opcję Akceptuj wiadomości od zewnętrznych użytkowników, wiadomości wysłane z adresów niemających odpowiadającego użytkownika w systemie WebIssues będą również akceptowane. W tym wypadku musisz również wybrać Konto użytkownika robota, w którego imieniu będą tworzone i modyfikowane takie sprawy. Konto użytkownika robota również musi mieć dostęp do projektu zawierającego sprawę, a zatem zmieniając uprawnienia tego konta użytkownika, możesz kontrolować, jakie obszary systemu mają być dostępne dla zewnętrznych użytkowników. Choć sprawa jest tworzona i modyfikowana przez użytkownika robota, rzeczywisty nadawca wiadomości jest widoczny w nagłówkach na początku opisu lub komentarza.

Rysunek 2.13. Zewnętrzni użytkownicy

### Wskazówka

Jeśli wiadomości od zewnętrznych użytkowników są akceptowane, serwer WebIssues w żaden sposób nie filtruje otrzymywanych wiadomości. Jeśli chcesz określić akceptowane lub blokowane adresy albo filtrować spam i inne niechciane wiadomości, powinieneś skonfigurować filtrowanie na serwerze poczty.

Możesz na przykład utworzyć odrębną skrzynkę pocztową, z której serwer WebIssues będzie pobierał wiadomości, a następnie skonfigurować regułę, która przenosi jedynie wiadomości spełniające określone kryteria do tej skrzynki. Więcej informacji znajdziesz w dokumentacji swojego serwera poczty.

### Mapowanie folderów

W najprostszym scenariuszu, wszystkie sprawy są tworzone w jednym folderze, który możesz wybrać za pomocą opcji Domyślny folder. Możesz jednak również włączyć opcję Mapuj rozszerzenia adresu do projektu i folderu, która umożliwia określanie projektu i folderu, w którym sprawy są tworzone, na podstawie adresu, na który jest wysłana wiadomość do skrzynki odbiorczej systemu WebIssues.

Rysunek 2.14. Mapowanie folderów

Istnieją dwa sposoby skonfigurowania mapowania adresu e-mail do projektu i folderu. Po pierwsze, możesz włączyć rozszerzenia adresu na serwerze poczty. Na przykład, jeśli adres skrzynki odbiorczej to `service@example.com`, wiadomość wysłana na adres `service+myproject-bugs@example.com` zostanie zarejestrowana jako sprawa w projekcie „My project”, w folderze „Bugs”. Drugie rozwiązanie polega na skonfigurowaniu aliasu, na przykład `service-myproject-bugs@example.com`, dla adresu `service@example.com`. Więcej informacji na temat rozszerzeń adresu i aliasów znajdziesz w dokumentacji serwera poczty.

### Notatka

Aby mapowanie folderu działało, adres e-mail musi zawierać nazwę konta, taką samą jak w adresie skrzynki odbiorczej, następnie znak `+` lub `-`, część nazwy projektu, znak `-` oraz część nazwy folderu. Również nazwa domeny musi odpowiadać adresowi skrzynki odbiorczej. Adres musi jawnie występować w nagłówku Do lub DW e-maila. Odstępy i inne znaki niebędące literami lub cyframi, występujące w nazwie projektu i folderu, są ignorowane przy porównywaniu. Tylko część nazwy projektu i folderu musi pasować, ale mapowanie musi być jednoznaczne.

Na przykład, jeśli projekt ma nazwę „My first project”, zarówno `service+first-bugs@example.com`, jak i `service+firstproject-bugs@example.com` będą pasować. Jeśli jednak więcej niż jeden projekt zawiera słowo „first” w nazwie, pierwszy przykład nie zostanie pomyślnie zmapowany, ponieważ będzie niejednoznaczny.

Zwróć uwagę na polskie litery i inne akcentowane i niełacińskie litery występujące w nazwach projektów i folderów, ponieważ nie wszystkie serwery poczty obsługują adresy e-mail zawierające takie znaki. W takim wypadku możesz dodać słowa zawierające tylko łacińskie znaki do nazw projektów i folderów, aby mogły one być użyte do mapowania adresów e-mail.

Jeśli folder nie może zostać automatycznie określony na podstawie adresu e-mail, sprawa jest tworzona w wybranym domyślnym folderze. Jednak gdy opcja mapowania folderów jest aktywna, możesz nie podawać żadnego domyślnego folderu. W tym wypadku każdy e-mail, który nie może zostać zmapowany, zostanie zignorowany, a do Dziennika zdarzeń zostanie dodane ostrzeżenie. Pamiętaj również, że rzeczywisty użytkownik lub użytkownik robot musi mieć dostęp do danego folderu, niezależnie od tego, czy jest to folder zmapowany, czy domyślny.

### Odpowiedzi i subskrypcje

Jeśli włączysz opcję Wysyłaj odpowiedź gdy sprawa jest utworzona, wiadomość z potwierdzeniem jest wysyłana do nadawcy, jeśli została utworzona nowa sprawa przez skrzynkę odbiorczą. Automatyczna odpowiedź zawiera identyfikator i nazwę sprawy. Odpowiadając na tą wiadomość, można utworzyć dodatkowe komentarze i załączniki, na przykład aby dostarczyć więcej informacji lub zapytać o status sprawy.

Jeśli włączysz opcję Subskrybuj nadawcę do utworzonych spraw, nadawca wiadomości automatycznie subskrybuje sprawę utworzoną przez skrzynkę odbiorczą. W tym wypadku wszystkie zmiany dokonane przez innych użytkowników, w tym edycja atrybutów, zmiany opisu oraz dodawanie komentarzy i załączników, są automatycznie wysyłane jako powiadomienia mailowe. Przeczytaj sekcję „Subskrypcje”, aby uzyskać więcej informacji.

Rysunek 2.15. Wysyłanie e-maili

Odpowiadając na powiadomienie subskrypcji, jeśli skrzynka odbiorcza jest włączona, możesz dodawać komentarze i załączniki do sprawy. W ten sposób możesz śledzić stan spraw i dodawać komentarze używając tylko poczty, bez konieczności logowania się do systemu WebIssues.

Automatyczne subskrypcje działają również dla zewnętrznych użytkowników. Umożliwia to osobom nieposiadającym konta w systemie WebIssues otrzymywać powiadomienia i odpowiadać na sprawy, które utworzyli. W typowym scenariuszu systemu wsparcia, kiedy ktoś wysyła wiadomość do skrzynki odbiorczej, tworzona jest sprawa, a nadawca automatycznie ją subskrybuje. Gdy osoba udzielająca wsparcia zmienia sprawę lub dodaje komentarz za pośrednictwem systemu WebIssues, powiadomienie subskrypcji jest automatycznie wysyłane do twórcy sprawy. Może on wtedy odpowiedzieć na powiadomienie, aby dostarczyć więcej informacji. W ten sposób zewnętrzni użytkownicy mogą komunikować się z systemem WebIssues przy pomocy e-maili, a cała komunikacja zostaje zapisana w historii sprawy.

Możesz również włączyć dostęp anonimowy, aby umożliwić zewnętrznym użytkownikom przeglądanie wszystkich spraw z publicznych projektów za pomocą programu Web Client, bez konieczności logowania się. Pamiętaj jednak, że w tym wypadku wszyscy będą mieli dostęp do wszystkich spraw, nie tylko do tych, które sami utworzyli. Więcej informacji o konfigurowaniu dostępu anonimowego znajdziesz w sekcji „Ustawienia zaawansowane”.

Pamiętaj, że nadawca wiadomości nie subskrybuje istniejących spraw przy dodawaniu komentarza. W tym wypadku nie jest również wysyłana automatyczna odpowiedź. Pozostali odbiorcy wiadomości nie subskrybują automatycznie dodanej sprawy.

« Wysyłanie e-maili
Praca ze sprawami »