Element Wczytaj e-maile pozwala zaimportować wiadomość zapisaną w pliku EML i powiązać ją z obiektem bieżącej kartoteki. Przydaje się wtedy, gdy korespondencja powstała poza bs4 core, a ma zostać dołączona do sprawy, klienta lub projektu.
Nie jest to zwykłe wgranie załącznika. Plik jest analizowany jako wiadomość, a program zapisuje jej dane i tworzy powiązanie w chmurze powiązań.
1. Dostępność elementu #
Dodawanie tego rodzaju elementu jest dostępne dla superadministratora. Element jest przeznaczony do zwykłego interfejsu programu; nie jest oferowany tak samo na formularzu portalu ani publicznej stronie WWW.
Przygotuj formularz w kartotece istniejącego obiektu. Import od razu zapisuje wiadomość i wiąże ją z kontekstem strony. Dlatego najpierw zapisz nowy obiekt, do którego ma trafić korespondencja.
2. Konfiguracja formularza #
- Włącz tryb konstruktor i otwórz właściwą stronę formularza.
- Przejdź do konfiguracji strony i Elementy formularza.
- Dodaj element o Typ: Wczytaj e-maile.
- Ustaw Nazwa, na przykład „Dołącz wiadomości EML”.
- Uzupełnij Opis informacją o wymaganym formacie.
- Dobierz Szerokość oraz Szerokość w wersji lite.
- Sprawdź parametr włączony i uprawnienia do elementu.
Domyślnie wykorzystywana jest kontrolka plikowa. Nie trzeba wiązać jej ze zwykłym polem plikowym obiektu: element wykonuje własny import wiadomości. Ustawienia ogólne opisuje instrukcja elementów formularza.
3. Wymagany format pliku #
Program sprawdza dwa warunki:
- rozszerzenie pliku musi być eml;
- przekazany typ MIME musi wynosić message/rfc822.
Plik MSG, PDF z wydrukiem wiadomości ani dokument z przeklejoną treścią nie spełniają tych wymagań. Sama zmiana rozszerzenia na EML nie zmienia formatu pliku.
Jeżeli prawidłowo wyglądający plik zostaje odrzucony, sprawdź komunikat o rozszerzeniu lub typie MIME. Sposób zapisania wiadomości i przesłania jej przez przeglądarkę ma znaczenie. Ograniczenia rozmiaru przesyłanych danych po stronie serwera również mogą zatrzymać import.
4. Co jest zapisywane? #
Parser odczytuje między innymi temat, nadawcę, adresatów, datę wiadomości oraz treść tekstową lub HTML. Mechanizm analizuje także części wiadomości, w tym załączniki. Po poprawnym utworzeniu wiadomości import dodaje jej powiązanie z obiektem formularza.
Ten import nie wskazuje konkretnej zsynchronizowanej skrzynki pocztowej. Właściciel i odpowiedzialny są przydzielani w kontekście zalogowanego użytkownika. Nie należy więc oczekiwać identycznego przypisania jak po pobraniu tej samej wiadomości przez synchronizację konta e-mail.
Nie należy traktować importu jako gwarancji pomijania duplikatów przy ponownym wgraniu pliku. Najpierw sprawdź, czy wiadomości nie ma już w programie.
5. Odświeżanie po imporcie #
W Atrybuty elementu dostępne jest Po edycji zapisz zmiany i przeładuj stronę. W ścieżce tego importu po zakończeniu przesyłania atrybut powoduje przeładowanie strony. Nie zastępuje wcześniejszego zapisania obiektu, do którego ma być przypisana wiadomość.
Import przebiega od razu podczas wgrywania plików, a nie dopiero przy późniejszym kliknięciu zwykłego przycisku zapisu formularza. Nie odkładaj więc niepowiązanych, niezapisanych zmian formularza na moment importu.
6. Przykład: korespondencja do sprawy serwisowej #
- Zapisz wiadomość z zewnętrznego programu pocztowego w oryginalnym formacie EML.
- Otwórz istniejącą sprawę serwisową w bs4 core.
- Użyj elementu Wczytaj e-maile i wskaż plik.
- Sprawdź komunikat o poprawnym imporcie.
- Otwórz zaimportowaną wiadomość, sprawdź temat, datę, treść i załączniki.
- Zweryfikuj jej powiązanie ze sprawą oraz dostęp zwykłego użytkownika.
7. Jak udostępnić wiadomości przy obiekcie? #
Sam element importu nie tworzy na formularzu listy wszystkich wiadomości. Aby użytkownik widział zaimportowaną korespondencję przy sprawie, przygotuj odpowiednią stronę zestawienia i sposób wyszukiwania wiadomości po ich powiązaniach.
Nie konfiguruj tego elementu jak zwykłego importu danych tabelarycznych. Ma odrębny parser i ścieżkę zapisu. Po wdrożeniu sprawdź także uprawnienia do odczytu wiadomości, a nie tylko dostęp do przycisku importu.
