Custom SMTP Moduł dodaje możliwość wysyłania wiadomości e-mail w aplikacji.
Instalacja i konfiguracja
Aby zainstalować ten moduł w projekcie, przejdź do sekcji Modules i znaleźć Custom SMTP.
Po instalacji wymagane jest skonfigurowanie następujących pól:
- Login (wymagane) - adres e-mail, który ma być używany do wysyłania wiadomości e-mail.
- Password (wymagane) - hasło z wybranego adresu email.
- Server address (wymagane) - serwer adresowy, który jest używany do wysyłania wiadomości e-mail. Domyślnie: smtp.gmail.com (Gmail).
- Server port (wymagany) - numer portu wybranego adresu serwera. Domyślnie: 587 (Gmail).
- Use TLS (nie wymagane) - protokół bezpieczeństwa warstwy transportowej. Domyślnie jest wyłączony.
- From Name (nie wymagane) - nazwa nadawcy, która ma być domyślnie używana.
Poniższy BP jest generowany domyślnie dla użycia backendu:
- Custom SMTP: Send email - wyślij wiadomość e-mail zgodnie z podanymi polami:
- Subject [string] - temat maila;
- Body [text] - email body;
- To [email array] - array of receiver's emails;
- Сс [email array] - array of emails in copy;
- From_name [string] - nazwa nadawcy;
- Bcc [email array] - tablica odbiorców ślepej kopii;
Przykład użycia.
Oto prosty przykład wysyłania podstawowej wiadomości e-mail z podanym tekstem do wybranego e-maila po naciśnięciu przycisku.
W tym przykładzie użyjemy domyślnych Gmail w tym przykładzie. Przede wszystkim należy przygotować Gmail konto do wysyłania maili za pomocą aplikacji firm trzecich:
- Otwórz Gmail ustawienia konta;
- Przejdź do Forwarding and POP/IMAP zakładkę;
- Przełącz na. IMAP Access;
- Zapisz zmiany;
Następnie należy zainstalować Custom SMTP moduł do swojego projektu i odpowiednio go skonfigurować.
Gdy moduł jest już skonfigurowany, należy utworzyć Endpoint dla Custom SMTP: Send email proces biznesowy:
- Utwórz nową Endpoint grupa;
- Utwórz nową instancję endpointa w nowo utworzonej grupie;
- Ustaw ją jak na poniższym obrazku;
Po wykonaniu tych czynności można przystąpić do tworzenia frontendu aplikacji. W tym przykładzie projekt wygląda jak na poniższym obrazku.
Email jest wysyłany po kliknięciu przycisku (onClick), a odpowiedni proces biznesowy wygląda tak:
- InputEmail Get Properties - uzyskaj adres e-mail odbiorcy z Input Email składnik;
- To Array - zamienia adres email na tablicę adresów, ponieważ Server request POST /sendemail/ pobiera tablice tylko na wejściu;
- InputText Get Properties - pobiera tekst wiadomości e-mail z Input Text składnika;
- Server request POST /sendemail/ - pobiera wartości z komponentów wejściowych i wykonuje Custom SMTP: Send email proces biznesowy w backendzie.