Benachrichtigungen im Jitterbit App Builder
Einführung
Benachrichtigungen sind Nachrichten, die an angemeldete App-Nutzer gesendet werden, wenn etwas passiert. Sie können über die folgenden Methoden gesendet werden:
-
Email
-
SMS (unter Verwendung des Twilio-Dienstes)
-
App Builder-Alarm (ein Popup innerhalb der App, das erscheint, wenn der Benutzer in einer App angemeldet ist)
Systembenachrichtigungen sind Arten von Benachrichtigungen, die von Systemadministratoren an ausgewählte Benutzer gesendet werden, wenn etwas passiert, normalerweise ein Ereignis, das mehrere Benutzer betrifft.
Seit App Builder 4.44 können Sie IDE > Wartung (Beta) auswählen und dann die Registerkarte Benachrichtigungen auswählen, um Benachrichtigungen anzuzeigen und zu verwalten.
Benachrichtigungen
Eine Benachrichtigungsnachricht kann mehrere Optionen enthalten, die definieren, wie der Benutzer reagieren kann.
Für Emails und App Builder-Alarm werden URLs in der Nachricht enthalten, die zurück zu App Builder verlinken.
Für SMS können Benutzer mit dem Namen der Option antworten, um das zugehörige Ereignis auszuführen.
Benachrichtigungslinks sind 7 Tage lang aktiv, nach denen sie ablaufen und nicht mehr aktiv sind. (Diese Ablaufzeit kann nicht geändert werden.)
Wenn Optionen in einer Benachrichtigung vorhanden sind, wird die Antwort des Benutzers automatisch von App Builder verfolgt.
Benachrichtigungen können Dateianhänge vieler Dateitypen enthalten (z. B. .PDF, .DOCX, .TXT, .XLSX usw.). Wenn Sie Dateianhänge verwenden, verwendet die Benachrichtigung das Verzeichnis data/pdf, wenn kein anderes Verzeichnis angegeben ist. Alternativ, wenn Sie eine FileDataSourceId angeben, ist dies der Ort, an dem App Builder nach dem/den Anhang(en) sucht.
Um die öffentlichen Datenobjekte zu verwenden, die für die Benachrichtigung erforderlich sind, muss Ihre Anwendung App Builder (Sealed) als verfügbaren Datenquelle für die App konfiguriert haben. Neben der Verfügbarkeit als Datenquelle für die Anwendung müssen Sie eine Verbindung zwischen den Datenquellen herstellen oder konfigurieren.
App Builder verwendet die URL-Informationen, die in der Benachrichtigungsregel angegeben sind, sofern verfügbar. Wenn sie nicht gefunden werden, greift App Builder auf die Standard-URL der Serverseite zurück. Der Standardwert der Serverseite wird von IDE > Sicherheitsanbieter > Mehr (aus dem Konfigurationspanel) > Seiten konfiguriert. Weitere Informationen zu Seiten und URLs finden Sie im Artikel Seiten und Aliase.
Optionen
Benachrichtigungen können 0 oder mehr Optionen haben. Wenn keine Optionen vorhanden sind, wird keine Benutzerantwort erwartet. In diesem Fall wird die Benutzerantwort nicht verfolgt, und es werden keine Links zur ausgehenden Nachricht hinzugefügt. Dies wird als Informative Benachrichtigung betrachtet.
Wenn eine Benachrichtigung 1 oder mehr Optionen enthält, wird eine Nachricht mit URL-Links zurück zum App Builder gesendet, die es dem Benutzer ermöglichen, auf irgendeine Weise zu antworten. Die Antwort des Benutzers auf die Nachricht (d.h. welche Option sie ausgewählt haben) wird von der Benachrichtigung verfolgt.
Konfiguration
Benachrichtigungsoptionen können auf zwei Arten konfiguriert werden:
-
Link zur Seite: Ein Link wird bereitgestellt, der es dem Benutzer ermöglicht, zu einer Seite zu navigieren. Das erfolgreiche Navigieren zur Seite wird als vollständige Antwort auf die Option betrachtet.
-
Seitenereignis ausführen: Ein Link wird bereitgestellt, der den Benutzer zu einer Seite sendet und ein bestimmtes Ereignis ausführt, bevor die Seite gerendert wird. Die Antwort des Benutzers wird als vollständig betrachtet, sobald das Ereignis ausgelöst wird.
Damit eine Seite für eine dieser Optionen in Frage kommt, muss die Seite als Geteilt markiert sein.
Beispiel
Ein Administrator kann ein Ereignis ausführen, das dazu führt, dass eine Email an einen Benutzer gesendet wird. Die Email enthält einen Text und die folgenden drei Schaltflächen:
-
Überprüfen: Wenn darauf geklickt wird, wird der Benutzer zu einer bestimmten Seite geleitet.
-
Genehmigen: Wenn darauf geklickt wird, wird der Benutzer zu einer anderen Seite geleitet und führt ein Ereignis gegen einige Datenobjekte auf der Seite aus.
-
Ablehnen: Wenn darauf geklickt wird, wird der Benutzer zu einer anderen Seite geleitet und führt ein Ereignis gegen die Datenobjekte derselben Seite oder einer anderen Seite aus.
Das Ereignis muss ausgeführt werden, bevor die Seite gerendert wird, da es Daten betreffen kann, die in den Panels auf der Seite enthalten sind. Um ein Ereignis auszuführen, muss der App-Entwickler Folgendes tun:
-
Die Link Zu-Seite als Geteilt konfigurieren.
-
Das Ereignis entweder im Datenobjekt für die Seite oder als eine der Datenquellen für das Einzelzeilen-Panel auf der Seite einfügen. (Eine weitere Veranschaulichung dieses Punktes ist im Abschnitt zur Datenobjekt-Ereignisbindung unten verfügbar.)
Datenobjekt-Ereignisbindung
Der App Builder beschränkt die Ereignisse, die an einen Link gebunden werden können. Diese Einschränkung erlaubt nur Ereignisse, die zu einem Datenobjekt oder einer Tabelle gehören, die an ein ungebundenes Einzelzeilen-Panel auf der Zielseite gebunden sind. Zum Beispiel, betrachten Sie eine Seite, die 6 Einzelzeilen-Panels hat:
Kunde→Kundenadresse→KundenkarteMitarbeiter→Mitarbeiteradresse→Mitarbeiterkarte
In diesem Beispiel sind die Panels Kunde und Mitarbeiter nicht an andere Panels auf der Seite gebunden. Daher kann ein Entwickler Ereignisse aus den Datenquellen dieser beiden Panels auswählen (neben einem Seiten-Datenobjekt, falls eines angegeben ist).
Der App Builder beschränkt auch die Ereignisse, die an Nicht-Systemereignisse gebunden werden können. Zum Beispiel kann der Entwickler nicht auf die Speichern, Einfügen, Aktualisieren oder Löschen Ereignisse verlinken.
Benachrichtigungsregistrierung
Verlinkung zu einer Benachrichtigung
Die Benachrichtigungsregistrierungs-Seite im App Builder ermöglicht es dem Entwickler, eine Benachrichtigung mit einer Anwendung zu verlinken. Dies ist eine 1 zu 1 Beziehung. Zusätzliche Informationen zur Benachrichtigungsnachricht können innerhalb der Benachrichtigungsregistrierung konfiguriert werden.
Nachrichten Erstellung
Die Benachrichtigungsnachricht kann im Template-Bereich der Benachrichtigungsregistrierungs-Seite definiert werden. Dies ist der Hauptinhalt der Benachrichtigung selbst.
Substitutionen werden im Template durchgeführt und verwenden die {{fieldname}} Syntax. Substitutionen können ein optionales url-Flag hinzufügen, um anzuzeigen, dass der Wert eine URL ist und URL-Codierung erfordert, z.B. {{fieldname|url}}.
Für die Substitution kann der Text enthalten:
Hallo {{CustomerName}},
In diesem Beispiel muss CustomerName in den Spalten der Benachrichtigungsregel zusammen mit den anderen erforderlichen Feldern enthalten sein.
Für Emails kann ein Betreff auf der Benachrichtigungsregistrierungsseite angegeben werden. Das Betreff-Feld unterstützt ebenfalls Substitutionen.
Übersetzungen
Benachrichtigungen unterstützen grundlegende Übersetzungen. Es gibt drei Felder, die für Übersetzungen verwendet werden:
-
Benachrichtigungsoption Name.
-
Benachrichtigungsregistrierungs Nachricht.
-
Benachrichtigungsregistrierungs Betreff (für Emails).
Beim Erstellen der Benachrichtigungsnachricht wird der App Builder versuchen, Übersetzungen für jedes dieser Felder zu finden, vorausgesetzt, dass deren Inhalt den entsprechenden Übersetzungsschlüssel angibt. Der Entwickler muss die Schlüssel auch manuell zum Übersetzungsbundle der App hinzufügen (sie werden derzeit nicht automatisch für eine App importiert). Beim Template-Feld muss darauf geachtet werden, den Übersetzungsschlüssel als Rohzeichenfolge und nicht als HTML hinzuzufügen. Es gibt ein "Code"-Symbol unten rechts im Feld Benachrichtigungsregistrierungs-Template, mit dem Sie die Zeichenfolge direkt bearbeiten können.
Einschränkungen
-
Das Ereignis, das im Optionslink ausgeführt wird, gehört zu den Seiten- oder einem Einzelzeilen-Panel-Datenobjekt. Derzeit zeigen wir keine Validierungsergebnisse oder Postnachrichten für Ereignisse auf Seitenebene an. Mit anderen Worten, das Ereignis wird zuerst ausgeführt, und wenn es abgeschlossen ist, wird der Benutzer zu seiner Seite umgeleitet. Wenn sie auf ihrer Seite ankommen, gehen die Ereignisergebnisse verloren. Daher wird das System dem Endbenutzer keine Ergebnisse anzeigen, wenn das Ereignis eine Postnachricht hat oder die Validierung fehlschlägt. Der Entwickler kann dies leicht umgehen, indem er Daten in seinen Panels anzeigt, die sich basierend auf der erfolgreichen Ausführung eines Ereignisses ändern.
Aufgrund der oben genannten Einschränkung führen Validierungswarnungen dazu, dass ein Ereignis nicht ausgeführt wird. Wir haben keine Benutzeroberfläche, die es dem Benutzer ermöglicht, die Warnung zu akzeptieren oder abzulehnen.
-
Die Datei-Tabelle aus einer Amazon S3-Datenquelle kann von einer Benachrichtigungsregel nicht abgerufen werden.
Öffentliche Benachrichtigungsdatenobjekte
Die öffentlichen Datenobjekte, die als Benachrichtigungsziele verwendet werden, sind unten definiert.
Gemeinsame Spalten
Diese Spalten sind in den öffentlichen Benachrichtigungsdatenobjekten gemeinsam:
| Name | Obligatorisch | Mehrfachziel | Beispiel | Beschreibung |
|---|---|---|---|---|
| Binding() | Nein | Ja | CustomerID | Wenn angegeben, identifiziert dies den Datensatz, der mit der Option für diese Benachrichtigung übereinstimmt. Mehrere Bindungen können definiert werden. |
Das Email öffentliche Datenobjekt ist ähnlich, aber nicht ganz konsistent mit der Funktionalität des SMTP Email Plugins. Die Spalten für das Email öffentliche Datenobjekt sind wie folgt:
Hinweis
Wenn Sie mehr als eine Email-Adresse zum Senden an oder Cc verwenden, trennen Sie die Werte mit einem Komma.
| Name | Obligatorisch | Mehrere Ziele | Beispiel | Beschreibung |
|---|---|---|---|---|
| To() | Ja | Ja | 'user1@zudy.com,user2@zudy.com' | Durch Kommas getrennte Liste von Email-Adressen, an die gesendet werden soll. Mehrere To()-Felder können verwendet werden, um an mehrere Empfänger zu senden (neben der Verwendung von durch Kommas getrennten Werten). Eine Ausnahme wird ausgelöst, wenn dieses Feld nicht bereitgestellt oder null ist. |
| Cc() | Nein | Ja | 'user1@zudy.com,user2@zudy.com' | Durch Kommas getrennte Liste von Email-Adressen, die in Cc gesetzt werden. Ähnlich wie bei To() können mehrere Ziele für die automatische Verkettung angegeben werden. |
| From | Nein | Nein | 'noreply@zudy.com' | Definiert die Absenderadresse für die Email. Wenn From nicht bereitgestellt wird, wird die Absenderadresse verwendet, die im Be_NotificationEndpoint-Datensatz definiert ist. |
| App BuilderUrl | Hängt ab | Nein | 'https://example.com/MyApp Builder' | App BuilderUrl ist obligatorisch, wenn die Benachrichtigung Optionen enthält. Diese URL wird verwendet, um Links zu den verschiedenen Benachrichtigungsoptionen zu generieren. Dies ist die URL, um den App Builder aus der Sicht des Nachrichtenempfängers zu erreichen. Erfordert keinen abschließenden Schrägstrich. |
| Attachment() | Nein | Nein | 'somepath/files/*' | Wenn bereitgestellt, werden Datei(en) an die Email angehängt. Wenn der Attachment()-String mit einem Sternchen (*) endet, wird angenommen, dass der String einen Verzeichnispfad darstellt, und alle Dateianhänge im Verzeichnis werden an die Email angehängt. |
| FileDataSourceId | Nein | Nein | UUID | Eindeutiger Bezeichner, der auf die Datenquelle verweist, die verwendet werden soll, um die Datei-Anhänge zu finden. |
| Language | Nein | Nein | 'es' | Wenn bereitgestellt, werden Übersetzungen sowohl für die Felder Template als auch Subject der zugehörigen Benachrichtigungsregistrierung versucht. Ebenso wird der Name der Benachrichtigungsoptionen übersetzt. |
Textnachricht
Das Textnachricht öffentliche Datenobjekt wird zum Versenden von SMS verwendet. Die Spalten für das Textnachricht öffentliche Datenobjekt sind wie folgt:
| Name | Obligatorisch | Mehrere Ziele | Beispiel | Beschreibung |
|---|---|---|---|---|
| To() | Ja | Ja | '+15559990000' | Eine einzelne Telefonnummer im von Twilio erwarteten Format. Mehrere To()-Felder können verwendet werden, um an mehrere Empfänger zu senden. Eine Ausnahme wird ausgelöst, wenn dieses Feld nicht bereitgestellt oder null ist. |
| Sprache | Nein | Nein | 'es' | Wenn bereitgestellt, werden Übersetzungen für das Template-Feld der zugehörigen Benachrichtigungsregistrierung versucht. Außerdem wird der Name der Benachrichtigungsoptionen in einer zukünftigen Version übersetzt. |
App Builder-Benachrichtigung
Das öffentliche Datenobjekt App Builder-Benachrichtigung ist ähnlich, aber nicht ganz konsistent mit dem öffentlichen Datenobjekt Create_Notification. Die Spalten des öffentlichen Datenobjekts App Builder-Benachrichtigung sind wie folgt:
| Name | Obligatorisch | Mehrere Ziele | Beispiel | Beschreibung |
|---|---|---|---|---|
| To() | Ja | Nein | all | Diese Spalte repräsentiert den Benutzer, an den wir senden. Eine Ausnahme wird ausgelöst, wenn dieses Feld nicht bereitgestellt oder null ist. Sie können die folgenden speziellen Ausdrücke verwenden:
|
| Von | Nein | Nein | who('userid') | Diese Spalte repräsentiert den Benutzer, von dem diese Nachricht stammt. Wenn nicht bereitgestellt, wird der Benutzer, der die Aktion ausführt, angenommen. |
| Persistent | Nein | Nein | 1 | Boolean-Wert, der angibt, ob die Benachrichtigung als persistent betrachtet werden soll. Dieses Attribut ist nur anwendbar, wenn eine Benachrichtigung an eine UserId gesendet wird. Alle Benachrichtigungen haben eine Schaltfläche "Verwerfen", die die Benachrichtigung aus dem Benachrichtigungsfeld des Benutzers entfernt. Der Benutzer kann die Benachrichtigung ignorieren oder sein Fenster schließen oder sich aus dem App Builder abmelden. Wenn persistent wahr (1) ist, wird die Benachrichtigung wiederholt angezeigt, jedes Mal, wenn der Benutzer sich im App Builder anmeldet, bis der Benutzer die Benachrichtigung aktiv verwirft. Verwenden Sie diese Technik, um sicherzustellen, dass eine Benachrichtigung vom Benutzer gelesen wird. |
| Timeout | Nein | Nein | 15 | Wenn bereitgestellt, stellt Timeout die Zeit (in Sekunden) dar, die gewartet werden soll, bevor das Benachrichtigungs-Popup automatisch geschlossen wird. |
| SendToPushNotificationEnabledUser | Nein | Nein | 0 | Wenn bereitgestellt, kann die App Builder-Benachrichtigung so konfiguriert werden, dass sie nur an Benutzer gesendet wird, die kein Gerät mit aktivierten Push-Benachrichtigungen haben. Dies ermöglicht es einem Entwickler, eine App Builder-Benachrichtigung und eine Push-Benachrichtigung im selben Ereignis zu senden und zu verhindern, dass ein Benutzer sowohl eine Desktop-Benachrichtigung als auch eine Push-Benachrichtigung erhält. |
Push-Benachrichtigung
Das Push-Benachrichtigungs-Objekt für öffentliche Daten ermöglicht es, eine Push-Benachrichtigung an einen Benutzer zu senden. Die Spalten des Push-Benachrichtigungs-Objekts für öffentliche Daten sind wie folgt:
| Name | Obligatorisch | Mehrere Ziele | Beispiel | Beschreibung |
|---|---|---|---|---|
| An | Ja | Nein | 85cc99ff-b4a6-4a32-bfeb-537d346ee52c | An ist der Benutzer (UserID), an den wir die Push-Benachrichtigung senden. Wenn der Benutzer kein Gerät für Push-Benachrichtigungen hat, wird die Benachrichtigungsregel dennoch erfolgreich sein, aber es wird keine Nachricht gesendet. Eine Ausnahme wird ausgelöst, wenn dieses Feld nicht angegeben oder null ist. |
| AnAppUserId | Nein | Nein | 100 | Wenn der Benutzer durch eine Anwendungsbenutzer-ID gekennzeichnet ist, sollte dieser Wert zusätzlich zum Feld An angegeben werden. |
| Von | Ja | Nein | who('userid') | Von repräsentiert den Benutzer, von dem diese Nachricht stammt. |
| Badge | Nein | Nein | 1 | Wenn angegeben, wird dies die Badge-Nummer auf dem Anwendungs-Icon festlegen. |
Benachrichtigungseinrichtung
Beispiel für die Benachrichtigungseinrichtung
Dies sind die Schritte, die erforderlich sind, um eine Benachrichtigung einzurichten. (Dieses Beispiel zeigt das Hinzufügen einer Kundengenehmigungsbenachrichtigung zur Northwinds-Kundenseite.)
-
Benachrichtigung erstellen: Erstellen Sie eine Regel, die ein öffentliches Datenobjekt für Benachrichtigungen anvisiert:
- Navigieren Sie zu App Workbench.
- Klicken Sie auf Benachrichtigungen.
- Klicken Sie auf + Benachrichtigung.
- Weisen Sie einen Namen zu. Zum Beispiel
CustomersRequestApprovalAlert. - Bestätigen Sie, dass der Zweck Benachrichtigung ist.
- Wählen Sie App Builder Alert als Ziel aus. Wenn dieses Datenobjekt nicht verfügbar ist, erstellen Sie eine Datenquellenverbindung zu App Builder (Sealed) für die App, an der Sie arbeiten.
- Klicken Sie auf Speichern.
-
Benachrichtigung mvSQL definieren:
- Klicken Sie auf die Schaltfläche +Tabellen.
- Fügen Sie Ihre 'select from'-Tabelle hinzu. Zum Beispiel
Customers. -
Fügen Sie die folgenden Spalten hinzu und klicken Sie auf die Registerkarte Spalten, um sie zu definieren:
Spalte Alias Ziel alle An An "C".CustomerId CustomerId Binding() "C".CustomerName CustomerName Hinweis
Beachten Sie, dass wir
CustomerNamehinzufügen, damit wir es später als Platzhalterparameter in unserer Benachrichtigungsnachricht verwenden können.
-
Benachrichtigungsoptionen definieren:
- Navigieren Sie zu App Workbench.
- Klicken Sie auf Benachrichtigungen.
- Wählen Sie die Geschäftsregel für die Benachrichtigung aus. Zum Beispiel:
CustomerRequestApprovalAlert. -
Geben Sie die Nachrichteninformationen für die Benachrichtigung in das Feld Body ein.
Zum Beispiel: Bitte überprüfen Sie den folgenden Kunden:
Kunde:
{{CustomerName}} -
Klicken Sie auf das Stiftsymbol und geben Sie technische Hilfe ein, um die Benachrichtigung anderen Entwicklern zu erklären.
-
(Optional) Definieren Sie eine Zielseite und ein Vorstartereignis, das ausgeführt werden soll:
- Wählen Sie auf der Seite App Workbench > Benachrichtigungen die Benachrichtigung aus.
- Klicken Sie auf die Schaltfläche + Option.
- Erstellen Sie eine neue Option:
- Setzen Sie Index auf 10.
- Setzen Sie Name auf Überprüfung.
- Wählen Sie den Wert Link zur Seite aus. In unserem Beispiel verlinken wir zur Northwinds-Seite 'Kunde'. Wenn die Seite, zu der Sie verlinken möchten, nicht angezeigt wird, stellen Sie sicher, dass sie in den Edge Case-Einstellungen als "Geteilt" markiert ist.
- Klicken Sie auf das Häkchen, um den Datensatz zu speichern.
-
Benachrichtigung mit einem Ereignis registrieren: Benachrichtigung als Aktion mit einem Ereignis registrieren. In diesem Fall gehen wir davon aus, dass das Ereignis mit einem Button auf der Startseite verbunden ist. Wir nehmen auch an, dass das Ereignis 'Genehmigung anfordern' heißt.
- Navigieren Sie zum Ereignis für das Datenobjekt.
- Klicken Sie auf das Business Logic-Symbol.
- Klicken Sie auf die Events-Schaltfläche.
- Wählen Sie das Ereignis aus. Zum Beispiel:
Genehmigung anfordern. - Klicken Sie im Aktionsbereich auf Vorhandene registrieren.
- Wählen Sie Benachrichtigung als Aktionstyp.
- Wählen Sie die Benachrichtigung aus, die wir im vorherigen Schritt erstellt haben. Zum Beispiel:
CustomerRequestApprovalAlert. - Klicken Sie auf Speichern.
- Überprüfen Sie, ob die Expliziten Bindungen korrekt sind. Zum Beispiel:
CustomerId - CustomerId.
-
Test: An diesem Punkt ist die Benachrichtigung vollständig eingerichtet. Navigieren Sie zu Ihrer Seite und klicken Sie auf den Button, der das Benachrichtigungsereignis ausführt. Alle App Builder-Benutzer im System sollten ein Popup mit der Benachrichtigungsnachricht sehen.
Beispiel für die Einrichtung einer SMS-Benachrichtigung
Dies sind die Schritte, die erforderlich sind, um eine SMS-Benachrichtigung einzurichten. (Dieses Beispiel zeigt das Hinzufügen einer Kunden-Genehmigungsbenachrichtigung zur Northwinds-Kunden-Seite.)
Hinweis
Sie benötigen ein Twilio-Konto, um die Einrichtung abzuschließen.
-
App Builder-Sicherheit einrichten
- Navigieren Sie zu IDE > Sicherheitsanbieter.
- Klicken Sie im Bereich Benutzerauthentifizierung auf + Benutzerauthentifizierung.
- Geben Sie einen Namen ein (z. B.
Http Basic Auth). - Wählen Sie HTTP Basic Authentication als Typ aus.
- Klicken Sie auf Aktiviert, um es zu aktivieren.
- Klicken Sie auf Speichern.
- Geben Sie einen Namen ein (z. B.
- Navigieren Sie zu IDE > Benutzerverwaltung.
- Doppelklicken Sie auf den Benutzerdatensatz, den Sie authentifizieren möchten, wenn eine SMS-Antwort eingeht.
- Beachten Sie, dass dieser Benutzer Zugriff auf Folgendes haben muss:
- App Builder-Anwendung.
- Das Ereignis, das bei der Benachrichtigung selbst ausgeführt wird.
- Klicken Sie auf das Schlüssel-Symbol aus der Authentifizierung.
- Klicken Sie auf Erstellen.
- Wählen Sie den zuvor erstellten Http Basic Auth-Anbieter aus.
- Klicken Sie auf Speichern.
Hinweis
Der geheime "Schlüssel", der für diesen Anbieter erstellt wird. Die Kombination aus dem Benutzernamen und dem geheimen Schlüssel wird bei der Konfiguration von Twilio verwendet.
-
Twilio einrichten:
-
Messaging-Dienst erstellen:
- Melden Sie sich bei Ihrem Twilio-Konto an.
- Navigieren Sie zu Communications Cloud > Programmable SMS.
- Klicken Sie auf Messaging Services.
- Erstellen Sie einen neuen Messaging-Dienst (Benachrichtigungen, 2-Wege) und fügen Sie eine Twilio-Telefonnummer hinzu.
- Notieren Sie sich die MessagingServiceSid. Diese wird später für die Konfiguration verwendet.
- Aktivieren Sie die Option "Eingehende Nachricht verarbeiten".
- Geben Sie die folgende Anforderungs-URL ein:
- https://<benutzername>:<geheimer_schlüssel>@<Ihr_vinyl_server>/webhook/v1/vinyl/bridge_inbound
- Z. B. https://admin:P124asfgOmkA@vinyl.zudy.com/webhook/v1/vinyl/bridge_inbound
-
Twilio-Anmeldeinformationen sammeln
- Navigieren Sie zu Console Dashboard > Einstellungen.
- Notieren Sie sich die LIVE-Anmeldeinformationen:
- Account Sid
- Auth Token
-
-
SMS-Endpunkt konfigurieren:
- Navigieren Sie zu IDE > Benachrichtigungsserver.
- Doppelklicken Sie auf den 'SMS'-Datensatz.
- Fügen Sie die folgende Konfiguration hinzu:
- Benutzername: Twilio Account Sid
- Passwort: Twilio Auth Token
- MessagingServiceSid: Twilio Messaging Service Sid
-
Website-URL konfigurieren:
- Navigieren Sie zu IDE > Sicherheitsanbieter.
- Klicken Sie unter Konfiguration auf Mehr > Seiten.
- Klicken Sie auf + Seite.
- Setzen Sie den URL-Wert auf die URL Ihrer Website. Zum Beispiel:
https://vinyl.zudy.com. - Klicken Sie auf Speichern.
-
SMS-Benachrichtigung konfigurieren:
-
Benachrichtigung erstellen: Erstellen Sie eine Regel, die ein öffentliches Datenobjekt für Benachrichtigungen anvisiert:
- Navigieren Sie zu App Workbench > Benachrichtigungen.
- Klicken Sie auf + Benachrichtigung.
- Weisen Sie einen Namen zu.
- Wählen Sie Benachrichtigung als Zweck.
- Wählen Sie Textnachricht als Ziel. Wenn Sie dieses Datenobjekt nicht sehen, erstellen Sie eine Datenquellenverbindung zu App Builder (Versiegelt) für die App, an der Sie arbeiten.
- Klicken Sie auf Speichern.
-
Definieren Sie die Benachrichtigung mvSQL:
-
Klicken Sie auf die Schaltfläche +Tabelle und fügen Sie die Tabelle hinzu, die die Regel benötigt. Z.B.
Customers. -
Klicken Sie auf die Registerkarte Spalten und fügen Sie die folgenden Spalten hinzu:
Spalte Alias Ziel '+15551112222' (ersetzen Sie durch Ihre Telefonnummer) To() To() "C".CustomerId CustomerId Binding() "C".CustomerName CustomerName Hinweis
Wir fügen "CustomerName" hinzu, damit wir es später als Platzhalterparameter in unserer Benachrichtigungsnachricht verwenden können.
-
-
Definieren Sie die Benachrichtigungsoptionen: Neben der Definition der Nachrichteninformationen werden wir zwei Optionen für dieses Benachrichtigungsbeispiel definieren. Eine, die durch das Antworten auf die SMS aktiviert wird, und eine andere, die einen Link zu einer Seite darstellt:
- Klicken Sie auf die Navigationsregisterkarte Benachrichtigung.
-
Geben Sie die folgende Nachricht in den Nachrichteninhalt ein:
Antworten Sie {{1}} zur Genehmigung von {{CustomerName}}. Überprüfen Sie {{Review}} -
Klicken Sie auf die Schaltfläche +Option im Optionsbereich:
- Setzen Sie Index auf 10.
- Setzen Sie Name auf Überprüfung.
- Wählen Sie die Seite aus, zu der verlinkt werden soll. In unserem Beispiel verlinken wir zur 'Kunden'-Seite von Northwinds. Wenn die Seite, zu der Sie verlinken möchten, nicht angezeigt wird, stellen Sie sicher, dass sie in den Edge Case-Einstellungen als "Geteilt" markiert ist.
- Setzen Sie den Option Typ auf 'Link'.
- Klicken Sie auf die Schaltfläche +Option im Optionsbereich
- Setzen Sie Index auf 20.
- Setzen Sie Name auf 1.
- Wählen Sie die Seite aus, zu der verlinkt werden soll. In unserem Beispiel verlinken wir zur 'Kunden'-Seite von Northwinds und führen das Ereignis 'Genehmigen' aus.
- Setzen Sie den Option Typ auf 'SMS-Antwort'.
-
Registrieren Sie die Benachrichtigung als Aktion mit einem Ereignis. In diesem Fall gehen wir davon aus, dass das Ereignis mit einer Schaltfläche auf der Startseite verknüpft ist. Wir nehmen auch an, dass das Ereignis 'Genehmigung anfordern' heißt:
-
-
Navigieren Sie zum Ereignis für das Datenobjekt.
- Klicken Sie auf das Business Logic-Symbol.
- Klicken Sie auf die Events-Schaltfläche.
- Wählen Sie das Ereignis aus. Zum Beispiel: Genehmigung anfordern.
- Klicken Sie im Aktionsbereich auf Register Existing.
- Wählen Sie Notification als Aktions Type.
- Wählen Sie die Benachrichtigung aus, die wir im vorherigen Schritt erstellt haben. Zum Beispiel:
Customer_RequestApprovalSms. - Klicken Sie auf Save.
-
Überprüfen Sie, ob die Explicit Bindings korrekt sind. Zum Beispiel: E.g.
CustomerId-CustomerId. -
Push-Benachrichtigung konfigurieren: Push-Benachrichtigungen werden ähnlich wie andere Benachrichtigungen im App Builder konfiguriert. Der Administrator des App Builder-Servers muss den Push-Benachrichtigungsendpunkt korrekt konfigurieren, damit sie wie erwartet funktionieren. Wenn Sie Push-Benachrichtigungen mit der Blabber-API konfigurieren, müssen Sie die iOS-Begleit-App herunterladen, sich mit den entsprechenden Anmeldeinformationen beim entsprechenden Server anmelden und die Push-Benachrichtigungen in der App selbst aktivieren. Darüber hinaus ist ein API-Schlüssel erforderlich, um die Konfiguration abzuschließen.
-
Testen: An diesem Punkt ist die Benachrichtigung vollständig eingerichtet. Navigieren Sie zu Ihrer Seite und klicken Sie auf die Schaltfläche, die das Benachrichtigungsereignis ausführt.
Systembenachrichtigungen
Systembenachrichtigungen werden aktiven Benutzern angezeigt und bleiben im Notification Center (unter dem Hamburger-Menü), wenn sie abgelehnt werden.
Administratoren können Systembenachrichtigungen sofort senden oder planen, dass sie gesendet werden.
Um eine Systembenachrichtigung einzurichten, befolgen Sie diese Schritte:
-
Wählen Sie IDE > Maintenance (Beta) und wählen Sie dann die Registerkarte Notifications.
-
Klicken Sie im Panel Scheduled Notifications auf die Schaltfläche Schedule or Send Now.
-
Geben Sie im Dialogfeld Notification Werte für die folgenden Felder ein:
-
To: Klicken Sie auf das Menü und wählen Sie dann eine der folgenden Optionen aus:
- All
-
Eine Gruppe von Benutzern basierend auf Folgendem:
-
Ihrem Zugriff auf eine Anwendung oder Datenquelle, die durch ihre Gruppen oder Rollen gewährt wurde.
-
Sicherheitsgruppe.
-
Rollen der Datenquelle.
-
-
Von: Definiert, wer die Benachrichtigung gesendet hat (normalerweise der Dienstbenutzer).
-
Geplant für: (Optional) Planen Sie eine Benachrichtigung, die später gesendet werden soll (zum Beispiel eine Stunde vor einem geplanten Anwendungsupgrade).
-
Läuft ab am: Ein Datum/Uhrzeit, wann die Benachrichtigung abläuft und nicht mehr den Benutzern angezeigt wird. Zu diesem Zeitpunkt wird die Benachrichtigung von den Benutzern, die die Nachricht gesehen und abgelehnt haben, aus ihren Benachrichtigungszentren entfernt.
-
Inhalt: Der Inhalt der Nachricht, die den Benutzern angezeigt wird.
-
-
Klicken Sie auf die Schaltfläche Senden oder Planen.
Ein Hintergrunddienst sendet geplante Benachrichtigungen. Standardmäßig wird der Dienst vom Dienstbenutzer-Konto ausgeführt. Um zu ändern, welcher Benutzer den Dienst ausführt, befolgen Sie diese Schritte:
-
Wählen Sie IDE > Wartung (Beta) und wählen Sie dann die Registerkarte Einstellungen.
-
Klicken Sie auf das Menü Hintergrundbenachrichtigungsbenutzer und wählen Sie den Benutzer aus, der den Dienst ausführen soll.