Das benutzerdefinierte SMTP-Modul fügt grundlegende Einstellungen hinzu, damit Sie E-Mails direkt aus Ihrer Anwendung versenden können.
Damit das Formular zum Versenden von Briefen in der Anwendung angezeigt wird, müssen Sie die fehlenden Einstellungen und erforderlichen Elemente hinzufügen. Der Aktionsalgorithmus sieht wie folgt aus:
- Fügen Sie eine Seite oder ein Fenster hinzu, in dem sich das Briefformular befindet.
- Verbinden Sie das Modul, fügen Sie ihm SMTP-Serverparameter sowie Ihren Benutzernamen und Ihr Passwort hinzu.
- Erstellen Sie modulbezogene Geschäftsprozesse, Endpunkte und Formulare.
Lassen Sie uns anhand des E-Mail-Dienstes Gmail zeigen, wie Sie dies in einer Webanwendung tun.
Erstelle eine Seite
Gehen Sie zum Editor und erstellen Sie eine neue Seite, von der aus Sie posten werden. Geben Sie den Namen Ihrer Seite ("Titel"), ihre Adresse ("Seiten-URL") und Benutzergruppen an, die Nachrichten senden können ("Für Gruppen anzeigen"). Klicken Sie auf „Speichern“.
Speichern Sie Ihre Änderungen und gehen Sie zum Modulblock.
Hinzufügen und Konfigurieren eines Moduls
Suchen Sie das benutzerdefinierte SMTP-Modul auf der Registerkarte Marktplatz und klicken Sie auf die Schaltfläche Installieren, um es der Anwendung hinzuzufügen.
Gehen Sie zur Registerkarte „Installiert“, auf der sich alle in Ihrer Anwendung installierten Module befinden, und klicken Sie auf das Feld „Benutzerdefiniertes SMTP“, um die Einstellungen zu öffnen. Auf der linken Seite werden grundlegende Informationen zum Modul und eine Schaltfläche zum Entfernen aus der Anwendung angezeigt. Auf der rechten Seite befinden sich die Felder, die Sie ausfüllen müssen:
- Geben Sie in den Feldern "Login" und "Passwort" die Daten des Postfachs ein, von dem aus Sie Nachrichten senden.
- Geben Sie die SMTP-Verbindungseinstellungen an – sie sind für jeden E-Mail-Dienst unterschiedlich. Standardmäßig werden dem Modul Gmail-Einstellungen hinzugefügt.
- Geben Sie im Feld "Vonname" den Namen ein, der den Empfängern Ihrer Briefe angezeigt wird.
Wichtig! Um Nachrichten über Google Mail zu senden, müssen Sie Anwendungen von Drittanbietern in Ihrem Google-Konto aktivieren.
Weitere Informationen darüber, was Module sind, wie sie aktualisiert und angepasst werden können, finden Sie in unserer Dokumentation .
Denken Sie daran, Ihre Änderungen zu speichern.
Erstellen eines Geschäftsprozesses, Endpunkts und Formulars
Der Geschäftsprozess , der Endpunkt und das Formular sind miteinander verbundene Elemente, deren konsistente Einrichtung wichtig ist. Indem sie miteinander interagieren, schließen sie die Konfiguration Ihrer Anwendung ab - und das Formular zum Senden einer Nachricht wird auf der Seite angezeigt.
Weitere Informationen zu diesen Elementen finden Sie in unserer Dokumentation .
Geschäftsprozess
Gehen Sie auf die Registerkarte „Geschäftslogik“ und klicken Sie auf die Schaltfläche, um einen neuen Geschäftsprozess zu erstellen.
Geben Sie den Namen des Prozesses (erforderlich), seine Beschreibung (optional) ein und klicken Sie auf die Schaltfläche „Erstellen“.
Jeder Geschäftsprozess im Editor ist visuell in Blöcke unterteilt - Bestandteile, die für verschiedene Funktionen verantwortlich sind. Wenn ein neuer Prozess erstellt wird, erscheinen darin automatisch „Start“ und „Ende“. Alle anderen Blöcke, die Sie hinzufügen können, werden auf der linken Seite angezeigt.
Nach der Installation fügte das Modul "Benutzerdefiniertes SMTP" dieser Liste "Benutzerdefiniertes SMTP: E-Mail senden" hinzu. Um diesen Block in einen Geschäftsprozess einzubinden, ziehen Sie ihn mit dem Mauszeiger auf das Editorfeld. Das Fenster "Benutzerdefiniertes SMTP: E-Mail senden" wird angezeigt, dessen Felder die Variablen enthalten, von denen der Inhalt Ihres zukünftigen Formulars zum Senden von Nachrichten abhängt:
- "Betreff" - der Betreff des Briefes;
- "Body" - ein Feld mit dem Text des Briefes;
- "An" - die Adresse des Empfängers;
- "Cc" - Adresse zum Senden einer Kopie;
- "From name" - der Name des Absenders;
- "Bcc" ist die Adresse, an die die Blindkopie gesendet werden soll.
Jetzt müssen Sie "Start", "Custom SMTP: Send Email" und "End" verknüpfen - um zu zeigen, dass es sich um einen einzelnen Geschäftsprozess handelt:
1. Bewegen Sie den Mauszeiger über das Feld „Start“ im Block „Start“, halten Sie die linke Maustaste gedrückt und wischen Sie auf das Feld „In“ im Block „Benutzerdefiniertes SMTP: E-Mail senden“ – es wird eine Verbindung zwischen ihnen hergestellt die Blöcke.
2. Erstellen Sie auf ähnliche Weise eine Verknüpfung zwischen dem Feld „Aus“ des Blocks „Benutzerdefiniertes SMTP: E-Mail senden“ und dem Feld „Ende“ des Blocks „Ende“.
Jetzt müssen Sie im Block „Start“ neue Felder (Variablen) erstellen und sie mit Variablen im Block „Benutzerdefiniertes SMTP: E-Mail senden“ verknüpfen. Die Felder, die Sie dem „Start“-Block hinzufügen, werden in Ihrem Nachrichtenübermittlungsformular angezeigt. Stellen Sie sich vor, Sie senden keine Kopien und Blindkopien, sodass der Block "Start" die folgenden Felder enthält:
- „Sender“ (Name des Absenders) – zugeordnet zu from_name;
- "Adresse" (an die es gesendet wurde) - verbunden mit "an";
- "Betreff" (Thema); - mit "Betreff" verknüpft (Variablennamen in verschiedenen Blöcken können gleich sein);
- "Nachricht" (Text des Briefes) - verbunden mit "Body".
Um Variablen zu binden, müssen sie im Typ übereinstimmen. Der Typ einer Variablen kann angezeigt werden, indem Sie auf den Block klicken, in dem sie enthalten ist, und das Bearbeiten-Menü öffnen.
In den Feldern der Blöcke befindet sich neben jeder Variablen ein Symbol, dessen Farbe und Form von seinem Typ abhängt, um die Navigation in ihnen zu erleichtern. In unserem Beispiel gibt es zwei Arten von Variablen:
- "Subject", "body" und "from_name" sind vom Typ "String",
- To, cc und bcc sind vom Typ Email Array.
Variablen erstellen
Um die erste Variable im Block "Start" zu erstellen, klicken Sie darauf - eine Liste wird angezeigt (während sie leer ist). Klicken Sie auf „+“.
Geben Sie im geöffneten Fenster den Namen der Variablen ein: name "sender", geben Sie "String" ein. Klicken Sie auf „Erstellen“.
Fügen Sie in ähnlicher Weise "Adresse", "Betreff" und "Nachricht" hinzu. Nun sieht die Liste der Variablen im „Start“-Block so aus:
Verknüpfen Sie sie mit den entsprechenden Variablen im Block Benutzerdefiniertes SMTP: E-Mail senden:
So sollen am Ende die Beziehungen zwischen den Variablen aussehen. Speichern Sie Ihre Änderungen und fahren Sie mit der Erstellung des Endpunkts fort.
Endpunkt
Klicken Sie auf "Endpunkt erstellen" - Sie finden sich in den Einstellungen auf der Registerkarte "Geschäftslogik" wieder, hier müssen Sie die folgenden Einstellungen vornehmen:
- "Endpunktroute" - der Name des Endpunkts, unter dem Sie seine Funktion verstehen;
- „Endpunktgruppen“ – der Name der Gruppe, in der er sich befinden wird;
- "Anfragetyp" - wählen Sie "POST";
- „Business Process“ – Wählen Sie den von Ihnen erstellten send_email-Geschäftsprozess aus.
Gehen Sie dann auf die Registerkarte "Middleware".
Auf der Registerkarte „Middleware“ müssen Sie die Rechte konfigurieren, um Aktionen mit diesem Endpunkt auszuführen (und damit den zugehörigen Geschäftsprozess zu starten). Mit anderen Worten, Sie legen fest, wer E-Mails aus Ihrer Anwendung versenden kann. Dazu müssen Sie die Einstellung des Berechtigungstokens „Token Auth“ ändern.
Aufmerksamkeit! Wenn diese Einstellung nicht geändert wird, haben alle Benutzer das Recht, E-Mails zu senden!
Klicken Sie auf das Zahnradsymbol neben „Token Auth“. Aktivieren Sie im geöffneten Fenster den Selektor und wählen Sie im Feld "Zugelassene Gruppen" die Gruppe "Admins" (oder eine andere Gruppe, der Sie Zugriff gewähren möchten). Klicken Sie auf "Speichern"
Speichern Sie nun den Endpunkt, indem Sie auf „Erstellen“ klicken.
Nachrichtensendeprozesse sind konfiguriert. Jetzt können Sie eine visuelle Darstellung des Nachrichtenübermittlungsformulars erstellen.
Bilden
Um ein Formular zu erstellen, kehren Sie zum Webanwendungseditor zu der zuvor erstellten Registerkarte zurück. Ziehen Sie ein Formularelement auf die Seitenleinwand.
Klicken Sie im geöffneten Fenster auf "Datensatz erstellen". Die Liste der verfügbaren Endpunkte wird im Feld "Datensatz speichern unter" angezeigt - wählen Sie den gerade erstellten aus. Klicken Sie auf „Zuweisen“.
Die von Ihnen erstellte Form wird auf der Leinwand angezeigt. Klicken Sie auf das Zahnradbild, um zu den Einstellungen zu gelangen.
Geben Sie auf der Registerkarte „Look & Feel“ im Feld „Title“ einen Titel für das Formular ein. Hier können Sie auch sein Aussehen ändern und den Namen sehen, unter dem es in den Einstellungen aufgezeichnet wird.
Auf der Registerkarte "Daten" - Informationen zum Modus des Formulars und zum Endpunkt. Auch hier können Sie die Position der Felder ändern, indem Sie sie relativ zueinander verschieben.
Ordnen Sie die Felder in einer logischen Reihenfolge an: Absender, Adresse, Betreff, Nachricht. Um die detaillierten Einstellungen für jedes Feld (z. B. seinen Namen) zu ändern, klicken Sie auf das Zahnradsymbol daneben. Klicken Sie auf „Speichern“, um Ihre Änderungen zu speichern.
Hinzufügen einer Schaltfläche für ein Formular
Damit das Formular funktioniert, müssen Sie eine Bestätigungsschaltfläche zum Senden hinzufügen. Verwenden Sie das Element "Button" - ziehen Sie es mit dem Mauszeiger in den Bereich unterhalb des Formulars.
Öffnen Sie die Schaltflächeneinstellungen, indem Sie darauf klicken. Ändern Sie auf der Registerkarte „Look & Feel“ die „Beschriftung“ (der Name der Schaltfläche, die in der Anwendung sichtbar sein wird) und den „Namen“ (der Name, der in den Einstellungen angezeigt wird).
Fügen Sie auf der Registerkarte „Trigger“ eine Aktion zum onClick-Trigger hinzu: Wählen Sie im Feld „Ziel“ Ihr Formular aus, im Feld „Aktion“ wählen Sie „Formular senden“. Klicken Sie auf „Speichern“.
Bewahrung, Veröffentlichung und Überprüfung
Speichern Sie alle vorgenommenen Änderungen, veröffentlichen Sie sie, klicken Sie auf das Anwendungssymbol.
Geben Sie die Daten ein, um die Nachricht zu senden. Wenn Sie das Absenderfeld leer lassen, wird automatisch der Name hinzugefügt, den Sie in den Moduleinstellungen eingegeben haben. Senden Sie eine Testnachricht an eine beliebige E-Mail-Adresse, auf die Sie Zugriff haben.
Nach dem Senden sollte eine Bestätigungsmeldung erscheinen und ein Brief mit den angegebenen Daten erscheint beim Empfänger im Posteingangsordner.
Wenn Sie alles gemäß den Anweisungen gemacht haben, aber anstatt zu bestätigen, ein Fehler herauskommt oder der Brief im "Spam"-Ordner landet, schreiben Sie an unseren Telegrammkanal für den technischen Support.
