Dotyczy wersji: 8.2.x, autor: Martyna Krzyżak
Opis funkcjonalności
Program WEBCON BPS daje możliwość stworzenia HotMailBoxa. Pozwala on na automatyczne startowanie obiegów lub dołączanie plików do obiegu na podstawie wiadomości e-mail przesyłanych na skonfigurowaną w HotMailBoxie skrzynkę odbiorczą. HotMailBox może działać w jednym z czterech trybów:
- „Startuj jeden obieg dla wiadomości e-mail”;
- „Startuj po jednym obiegu dla wybranych załączników”;
- „Dołącz do elementów na podstawie kodów kreskowych w załącznikach”;
- „Dołącz do elementu na podstawie zawartości wiadomości e-mail”.
Przykład zastosowania: startowanie po jednym obiegu dla wybranych załączników
Utworzono obieg „Faktura kosztowa”. Dla wszystkich załączników w formacie .pdf dołączonych do każdej przesłanej na skrzynkę pocztową wiadomości (trafiającej do odpowiedniego folderu) uruchamiany jest obieg faktury kosztowej. Do formularza obiegu pobierane są dane, tj. tytuł, data otrzymania i nadawca wiadomości e-mail, oraz dołączany jest plik .pdf, dla którego dany dokument został wystartowany.
Schemat obiegu „Faktura kosztowa” przedstawiono poniżej.
Rys. 1. Schemat obiegu „Faktura kosztowa”
- Rejestracja – krok, którym system przechodzi automatycznie w momencie wystartowania obiegu dla każdego z plików w formacie .pdf dołączonych do wiadomości przesłanej na HotMailBoxa.
- Weryfikacja – weryfikacja poprawności danych na fakturze przez osobę, do której przypisano zadanie.
- Akceptacja – akceptacja faktury lub odesłanie jej do skorygowania.
- Archiwum – krok końcowy pozytywny.
- Anulowane – krok końcowy negatywny.
Konfiguracja HotMailBoxa
Pierwszym krokiem konfiguracji jest utworzenie HotMailBoxa. W tym celu w programie WEBCON BPS Designer Studio przejdź do modułu „Konfiguracja sytemu”, a następnie w drzewie wyboru po lewej stronie kliknij pozycję „HotMailBoxy”. Na górnej belce pojawi się przycisk „Nowy HotMailBox” – kliknij go, aby rozpocząć konfigurację nowego HotMailBoxa.
Rys. 2. Tworzenie nowego HotMailBoxa
Zakładka „Ogólne”
W zakładce „Ogólne” nowego HotMailBoxa dostępnych jest pięć pól do uzupełnienia:
1. „Hotmailbox” – w tej sekcji należy podać nazwę HotMailBoxa oraz serwer, na którym będzie on działał. Uzupełnienie pola „Opis” jest opcjonalne. Aby aktywować HotMailBoxa, zaznacz pole „Aktywny”.
2. „Ustawienia połączenia” – sekcja służy do uzupełniania parametrów połącznia ze skrzynką pocztową. Po zaznaczeniu opcji „Użyj niestandardowych ustawień skrzynki odbiorczej” wybierz typ serwera oraz wpisz jego adres. Następnie uzupełnij dane użytkownika, którego konto będzie wykorzystywane do łączenia się ze skrzynką pocztową. Przy konfiguracji połączenia ze skrzynką pocztową pomocne może okazać się narzędzie „Testuj parametry połączenia”, które sprawdza status połączenia ze skrzynką.
Rys. 3. Okno narzędzia „Testuj parametry połączenia”
3. „Ustawienia folderów (exchange)” – w sekcji definiuje się, z jakiego folderu skrzynki odbiorczej system ma pobierać wiadomości („Folder źródłowy”) i do jakich folderów ma przenosić wiadomości e-mail przetworzone poprawnie („Folder archiwum”) oraz niepoprawnie („Folder błędów”). Foldery te należy uprzednio utworzyć w skrzynce pocztowej, a następnie wybrać je z drzewa wyboru pojawiającego się po naciśnięciu przycisku wielokropka znajdującego się obok pól folderów źródłowego i archiwum.
4. „Tryb działania” – w omawianym przypadku w sekcji tej w polu „Tryb podstawowy” wybierz opcję „Startuj po jednym obiegu dla wybranych załączników”. Następnie w polu „Załączniki, które będą przetwarzane” wybierz, jakie pliki mają być dołączane do obiegu, zaś w polu „Szablon nazwy tworzonego dokumentu” zdefiniuj format nazwy tych plików. W pomocy kontekstowej można podglądnąć dostępne możliwości ustawień szablonu nazwy.
Rys. 4. Pomoc kontekstowa pola „Szablon nazwy tworzonego dokumentu”
W opisywanym przypadku nowy obieg faktury kosztowej jest uruchamiany wyłącznie dla plików .pdf, w związku z czym w polu „Załączniki, które będą przetwarzane” wybierz opcję „Tylko pliki PDF”.
5. „Dodatkowo dołączane załączniki” – sekcja pozwala zdefiniować dodatkowe pliki, które zostaną dołączone do uruchamianego obiegu. W tym miejscu istnieje możliwość dołączenia do obiegu treści wiadomości e-mail w postaci pliku „.eml”. Możliwe jest również zdefiniowanie szablonu określającego, jakie pliki są dodatkowo pobierane. Dostępne zmienne można podglądnąć w pomocy kontekstowej.
Rys. 5. Pomoc kontekstowa pola „Pasujące do szablonu nazwy”
W omawianym przykładzie nie są pobierane żadne dodatkowe pliki.
Rys. 6. Przykładowa konfiguracja zakładki „Ogólne”
Zakładka „Ustawienia zaawansowane”
Po skonfigurowaniu zakładki „Ogólne” przejdź do zakładki „Ustawienia zaawansowane”. Zakładka ta dzieli się na dwie sekcje:
- „Ograniczenie listy nadawców obsługiwanych wiadomości e-mail” – sekcja pozwalająca na przetwarzanie wiadomości e-mail tylko od nadawców zdefiniowanych w źródle danych.
- „Limity przetwarzanych wiadomości e-mail” – sekcja umożliwia określenie maksymalnej liczby wiadomości e-mail przetwarzanych w ciągu dnia oraz w jednej iteracji, a także liczby dni wstecz, z których wiadomości są pobierane.
Przykładowo skonfigurowaną zakładkę „Ustawienia zaawansowane” przedstawiono na rys. 7.
Rys. 7. Przykładowo skonfigurowana zakładka „Ustawienia zaawansowane”
Zakładka „Ustawienia startowania obiegów”
Zakładka „Ustawienia startowania obiegów” posiada dwie sekcje:
- „Tworzenie nowych elementów procesu” – sekcja umożliwia zdefiniowanie jaki dokument, w jakim obiegu i procesie oraz dla jakiej spółki zostanie wystartowany (w omawianym przykładzie jest to dokument „Faktura kosztowa”). W sekcji tej należy również wybrać jaką ścieżką ma przejść system w celu rejestracji dokumentu.
- „Dodatkowe wartości atrybutów” – sekcja pozwala na przypisywanie danych wiadomości e-mail do odpowiednich atrybutów obiegu, np. nadawcę wiadomości lub jej tytuł. Pełna lista dostępnych zmiennych znajduje się w pomocy kontekstowej (rys. 8).
Rys. 8. Pomoc kontekstowa dla pola „Wartości pól elementu”
Konfigurację zakładki „Ustawienia startowania obiegów” w omawianym przykładzie przedstawiono na rys. 9.
Rys. 9. Przykładowo skonfigurowana zakładka „Ustawienia startowania obiegów”
Zapisywanie HotMailBoxa
Po odpowiednim skonfigurowaniu zakładek: „Ogólne”, „Ustawienia zaawansowane” i „Ustawienia startowania obiegów” HotMailBox można zapisać, klikając przycisk „Zapisz” znajdujący się na górnej belce.
Po poprawnym zapisie pojawia się komunikat informujący o czynnościach, jakie należy wykonać, aby wprowadzone w HotMailBoxie zmiany weszły w życie.
Konfiguracja serwisu
Po zapisaniu HotMailBoxa w serwisie włącz rolę „Monitorowanie skrzynki Email/MailApproval”. W tym celu kliknij przycisk „Konfiguracja systemu” w prawym dolnym rogu, w drzewie wyboru po lewej stronie wybierz węzeł „Konfiguracja serwisów”, a następnie zaznacz pozycję „Serwisy” i wybierz odpowiedni serwis.
Po wybraniu serwisu zaznacz rolę „Monitorowanie skrzynki Email/MailApproval”, a następnie zapisz zmiany w konfiguracji serwisu. Do poprawnego działania HotMailBoxa konieczne jest ponowne wczytanie konfiguracji serwisu.
Po naciśnięciu przycisku „Wczytaj ponownie konfigurację” system wyświetla pytanie, czy na pewno ponownie wczytać konfigurację, ponieważ wiąże się to z zatrzymaniem wszystkich aktywnych zadań serwisu. Przerwane operacje zostaną ponownie uruchomione, gdy serwis wczyta swoją konfigurację.
HotMailBox został poprawnie skonfigurowany. Po pojawieniu się wiadomości e-mail zawierającej co najmniej jeden załącznik w postaci pliku .pdf w wybranym folderze źródłowym skrzynki odbiorczej dla każdego z załączonych plików .pdf wystartowany zostanie nowy obieg faktury kosztowej.