Benachrichtigungen im Jitterbit App Builder

Eine Benachrichtigung ist ein Konzept auf Anwendungsebene, das es einem Entwickler ermöglicht, eine Benachrichtigung oder Nachricht an einen Benutzer zu senden. Diese Nachricht kann mehrere Optionen enthalten, die definieren, wie der Benutzer auf die Nachricht reagieren kann. Wenn in einer Benachrichtigung Optionen vorhanden sind, wird die Antwort des Benutzers automatisch verfolgt von App Builder. Benachrichtigungen unterstützen Dateianhänge aller Dateitypen (z. B. .PDF, .DOCX, .TXT, .XLSX usw.). Wenn Sie Dateianhänge verwenden, verwendet Benachrichtigung die data/pdf Verzeichnis, wenn kein anderes Verzeichnis angegeben ist. Alternativ, wenn Sie eine FileDataSourceId angeben, ist dies der Speicherort App Builder sucht nach den Anhängen.

Um die für die Benachrichtigung erforderlichen öffentlichen Datenobjekte zu verwenden, benötigt Ihre Anwendung App Builder (Versiegelt), um als verfügbare Datenquelle für die App konfiguriert zu werden. Sie müssen nicht nur eine verfügbare Datenquelle für die Anwendung sein, sondern auch eine Verknüpfung zwischen den Datenquellen herstellen oder konfigurieren.

In Bezug auf die URL, die zum Senden von Benachrichtigungen verwendet wird, App Builder verwendet die in der Benachrichtigungsregel angegebenen URL Informationen, sofern diese verfügbar sind. Wenn sie nicht gefunden werden, App Builder greift auf die Standard URL der Server-Site zurück. Der Standardwert der Server-Site wird über IDE > Sicherheitsanbieter > Mehr (über das Konfigurationsfenster) > Sites konfiguriert. Weitere Informationen zu Sites und URL finden Sie unter Sites und Aliase Artikel.

Hinweis

Benachrichtigungslinks sind standardmäßig 7 Tage lang aktiv. Nach Ablauf der 7 Tage verfallen sie und sind keine aktiven Links mehr. Dies ist derzeit keine konfigurierbare Einstellung in App Builder.

Nachrichtentypen

Eine Benachrichtigung kann einen der folgenden Nachrichtentypen verwenden:

Email - Nicht überraschend, eine Email.
SMS - Eine vom Twilio-Dienst gesendete und empfangene SMS-Nachricht.
App Builder Warnung - Ein Popup, das im Browser des Benutzers angezeigt wird, wenn er angemeldet ist App Builder. Früher als Benachrichtigung bezeichnet.

Alle Nachrichtentypen unterstützen das Hinzufügen von Optionen, die dem Benutzer die Möglichkeit bieten, auf eine Nachricht zu antworten. Für Emails und App Builder Warnungen, URLs sind in der Nachricht enthalten, die zurückverweisen auf App Builder. Beim SMS-Zustellungstyp können Sie auch auf eine SMS mit dem Namen der Option antworten, um das zugehörige Ereignis auszuführen.

Zukünftige Versionen von App Builder wird wahrscheinlich das Senden von Nachrichten an REST-Server unterstützen.

Optionen

Benachrichtigungen können 0 oder mehr Optionen haben. Wenn eine Benachrichtigung keine Optionen enthält, wird keine Benutzerantwort erwartet und folglich wird die Benutzerantwort nicht verfolgt. Der ausgehenden Nachricht werden keine Links hinzugefügt. Dies wird als Informationsbenachrichtigung betrachtet.

Wenn eine Benachrichtigung eine oder mehrere Optionen enthält, wird eine Nachricht mit URL Links zurück in App Builder die es dem Benutzer ermöglichen, auf irgendeine Weise zu antworten. Die Antwort des Benutzers auf die Nachricht (d. h. welche Option er ausgewählt hat) wird durch die Benachrichtigung verfolgt.

Konfiguration

Benachrichtigungsoptionen können auf zwei Arten konfiguriert werden:

Link zur Seite - Es wird ein Link bereitgestellt, der es dem Benutzer ermöglicht, zu einer Seite zu navigieren. Das erfolgreiche Navigieren zur Seite gilt als vollständige Antwort auf die Option.
Seitenereignis ausführen - Es wird ein Link bereitgestellt, der den Benutzer zu einer Seite schickt und ein bestimmtes Ereignis ausführt, bevor die Seite gerendert wird. Auch hier gilt die Antwort des Benutzers als abgeschlossen, sobald das Ereignis ausgelöst wird.

Damit eine Seite für eine der oben genannten Optionen in Frage kommt, muss sie als Geteilt markiert sein.

Beispielsweise kann ein Administrator ein Ereignis ausführen, das dazu führt, dass eine Email an einen Endbenutzer gesendet wird. Die Email enthält Text und drei Schaltflächen:

Überprüfen - Durch Klicken auf „Überprüfen“ gelangt der Benutzer zu einer bestimmten Seite in App Builder.
Genehmigen - Durch Klicken auf „Genehmigen“ wird der Benutzer möglicherweise auf eine andere Seite weitergeleitet UND ein Ereignis für einige Datenobjekte auf der Seite ausgeführt.
Ablehnen - Durch Klicken auf „Ablehnen“ kann der Benutzer auf eine andere Seite weitergeleitet UND ein Ereignis für dieselbe Seite oder die Datenobjekte einer anderen Seite ausgeführt werden.

Das Ereignis muss ausgeführt werden, bevor die Seite gerendert wird, da es sich auf Daten auswirken kann, die in den Bedienfeldern auf der Seite enthalten sind. Um ein Ereignis auszuführen, muss der Entwickler:

Konfigurieren Sie die Seite Link zu als Geteilt.
Fügen Sie das Ereignis entweder in das Datenobjekt für die Seite oder als eine der Einzelzeilendatenquellen auf der Seite ein. Weitere Erläuterungen zu diesem Punkt finden Sie weiter unten im Abschnitt „Datenobjekt-Ereignisbindung“.

Datenobjekt-Ereignisbindung

App Builder begrenzt die Ereignisse, die an einen Link gebunden werden können. Insbesondere lässt diese Einschränkung nur Ereignisse zu, die zu einem Datenobjekt/einer Tabelle gehören, das/die an ein ungebundenes einzeiliges Panel auf der Zielseite gebunden ist. Betrachten wir beispielsweise eine Seite mit 6 einzeiligen Panels:

Kunde -> Kundenadresse -> Kundenkarte
Mitarbeiter -> Mitarbeiteradresse -> Mitarbeiterkarte

In diesem Beispiel sind die Kunden- und Mitarbeiterfelder nicht an andere Felder auf der Seite gebunden. Daher kann ein Entwickler Ereignisse aus den Datenquellen dieser beiden Felder auswählen (zusammen mit einem Seitendatenobjekt, falls eines angegeben ist).

App Builder begrenzt auch die Ereignisse, die an Nicht-Systemereignisse gebunden werden können. Beispielsweise kann der Entwickler keine Verknüpfung zu den Ereignissen Speichern, Einfügen, Aktualisieren oder Löschen herstellen.

Benachrichtigungsregistrierung

Verknüpfen mit einer Benachrichtigung

Die Seite Benachrichtigungsregistrierung in App Builder ermöglicht es dem Entwickler, eine Benachrichtigung mit einer Anwendung zu verknüpfen. Dies ist eine 1:1-Beziehung. Zusätzliche Informationen zur Benachrichtigungsnachricht können innerhalb der Benachrichtigungsregistrierung konfiguriert werden.

Nachrichtenerstellung

Die Benachrichtigungsnachricht kann im Abschnitt Vorlage der Seite Benachrichtigungsregistrierung definiert werden. Dies ist der Hauptinhalt der Benachrichtigung selbst.

Ersetzungen werden auf der Vorlage durchgeführt und verwenden die {{Feldname}} Syntax. Ersetzungen können einen optionalen url Flag, um anzuzeigen, dass der Wert eine URL ist und eine URL-Kodierung erfordert, z. B. {{Feldname|url}}.

In Bezug auf die Substitution kann der Körper enthalten:

Hello {{CustomerName}},

In diesem Fall muss CustomerName zusammen mit den anderen erforderlichen Feldern in den Spalten der Benachrichtigungsregel enthalten sein.

Für Emails kann auf der Seite „Benachrichtigungsregistrierung“ ein Betreff angegeben werden. Das Feld Betreff unterstützt auch Ersetzungen.

Übersetzungen

Benachrichtigungen unterstützen rudimentäre Übersetzungen. Es gibt drei Felder, die für Übersetzungen verwendet werden:

Benachrichtigungsoption Name
Benachrichtigung Registrierung Nachricht
Benachrichtigungsregistrierung Betreff (für Emails)

Beim Erstellen der Benachrichtigungsnachricht App Builder versucht, für jedes dieser Felder Übersetzungen zu finden, vorausgesetzt, dass ihr Inhalt den entsprechenden Übersetzungsschlüssel angibt. Der Entwickler muss die Schlüssel auch manuell zum Übersetzungspaket für die App hinzufügen (derzeit werden sie für eine App nicht automatisch importiert). Beim Feld Vorlage muss darauf geachtet werden, dass der Übersetzungsschlüssel als Rohzeichenfolge und nicht als HTML hinzugefügt wird. Unten rechts im Feld „Benachrichtigungsregistrierungsvorlage“ befindet sich ein „Code“-Symbol, mit dem Sie die Zeichenfolge direkt bearbeiten können.

Einschränkungen

Das im Optionslink ausgeführte Ereignis gehört zu den Seitendaten oder einem Datenobjekt eines einzeiligen Panels. Derzeit zeigen wir keine Validierungsergebnisse oder Post-Meldungen für Ereignisse auf Seitenebene an. Mit anderen Worten: Das Ereignis wird zuerst ausgeführt. Wenn es abgeschlossen ist, wird der Benutzer auf seine Seite umgeleitet. Bis er auf seiner Seite ankommt, sind die Ereignisergebnisse verloren. Wenn das Ereignis also eine Post-Meldung enthält oder die Validierung fehlschlägt, zeigt das System dem Endbenutzer diese Ergebnisse nicht an. Der Entwickler kann dies leicht umgehen, indem er in seinen Panels Daten anzeigt, die sich je nach erfolgreicher 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 eingerichtet, die es dem Benutzer ermöglicht, die Warnung zu akzeptieren oder abzulehnen.
Die Datei-Tabelle aus einer Amazon S3 Datenquelle kann nicht durch eine Benachrichtigungsregel abgerufen werden.

Öffentliche Benachrichtigungsdatenobjekte

Die als Benachrichtigungsziele verwendeten öffentlichen Datenobjekte sind unten definiert.

Gemeinsame Spalten

Diese Spalten sind in allen öffentlichen Benachrichtigungsdatenobjekten gleich:

Name	Obligatorisch	Mehrere Ziele	Beispiel	Beschreibung
Binding()	Nein	Ja	CustomerID	Falls angegeben, wird hiermit der Datensatz identifiziert, der mit der Option für diese Benachrichtigung übereinstimmt. Es können mehrere Bindungen definiert werden.

Email

Das öffentliche Datenobjekt Email ähnelt der Funktionalität des SMTP- Email-Plugins, ist jedoch nicht vollständig mit dieser konsistent. Die Spalten für das öffentliche Datenobjekt Email lauten wie folgt:

Notiz

Wenn Sie zum Senden an oder Cc mehr als eine Email-Adresse verwenden, trennen Sie die Werte mit einem Komma.

Name	Obligatorisch	Mehrere Ziele	Beispiel	Beschreibung
An()	Ja	Ja	'user1@zudy.com,user2@zudy.com'	Komma-getrennte Liste von Email Adressen, an die gesendet werden soll. Mehrere An()-Felder können gezielt an mehrere Empfänger gesendet werden (zusätzlich zur Verwendung von Komma-getrennten Werten). Eine Ausnahme wird ausgelöst, wenn dieses Feld nicht angegeben oder null ist.
Cc()	Nein	Ja	'user1@zudy.com,user2@zudy.com'	Komma-getrennte Liste von Email Adressen, die in CC gesetzt werden sollen. Ähnlich wie bei To() können mehrere Ziele zur automatischen Verkettung angegeben werden.
Von	Nein	Nein	'noreply@zudy.com'	Definiert die Absenderadresse für die Email. Wenn „Von“ nicht angegeben ist, wird die im Datensatz Be_NotificationEndpoint definierte Absenderadresse verwendet.
App Builder URL	Hängt ab	Nein	'https://example.com/MyApp Builder'	App Builder Die URL ist obligatorisch, wenn die Benachrichtigung Optionen enthält. Diese URL wird beim Generieren von Links zu den verschiedenen Benachrichtigungsoptionen verwendet. Dies ist die URL, die Sie erreichen können App Builder aus der Sicht des Nachrichtenempfängers. Erfordert keinen abschließenden Schrägstrich.
Attachment()	Nein	Nein	'somepath/files/*'	Falls angegeben, werden Dateien an die Email angehängt. Wenn die Zeichenfolge Attachment() mit einem Sternchen (*) endet, wird davon ausgegangen, dass die Zeichenfolge einen Verzeichnispfad darstellt, und alle Dateianhänge im Verzeichnis werden an die Email angehängt.
FileDataSourceId	Nein	Nein	UUID	Eindeutige Kennung, die auf die Datenquelle verweist, auf die verwiesen werden soll, um die Dateianhänge zu finden.
Sprache	Nein	Nein	'es'	Falls angegeben, werden Übersetzungen sowohl für die Felder Vorlage als auch Betreff der zugehörigen Benachrichtigungsregistrierung versucht. Außerdem wird der Name der Benachrichtigungsoptionen übersetzt.

Textnachricht

Das öffentliche Datenobjekt Textnachricht wird zum Senden von SMS verwendet. Die Spalten für das öffentliche Datenobjekt Textnachricht lauten wie folgt:

Name	Obligatorisch	Mehrere Ziele	Beispiel	Beschreibung
An()	Ja	Ja	'+15559990000'	Eine einzelne Telefonnummer im von Twilio erwarteten Format. Mehrere An()-Felder können gezielt an mehrere Empfänger gesendet werden. Eine Ausnahme wird ausgelöst, wenn dieses Feld nicht angegeben wird oder null ist.
Sprache	Nein	Nein	'es'	Falls angegeben, werden Übersetzungen für das Feld Vorlage der zugehörigen Benachrichtigungsregistrierung versucht. Außerdem wird der Name der Benachrichtigungsoptionen in einer zukünftigen Version übersetzt.

App Builder Alarm

Die Benachrichtigung App Builder Das öffentliche Datenobjekt „Alert“ ist dem öffentlichen Datenobjekt „Create_Notification“** ähnlich, aber nicht vollständig konsistent. Die Spalten des App Builder Das öffentliche Datenobjekt „Alert“ lautet wie folgt:

Name	Obligatorisch	Mehrere Ziele	Beispiel	Beschreibung
An()	Ja	Nein	alle	An steht für den Benutzer, an den wir senden. Eine Ausnahme wird ausgelöst, wenn dieses Feld nicht angegeben wird oder null ist. Kann spezielle Ausdrücke verwenden: „Sitzung“, um auf die Sitzung des aktuellen Benutzers abzuzielen. „alle“, um auf alle aktuell angemeldeten Benutzer abzuzielen. App Builder. Zum Senden an eine bestimmte App Builder Benutzer, geben Sie die Benutzer-ID des Benutzers an.
Von	Nein	Nein	who('userid')	Von steht für den Benutzer, von dem diese Nachricht stammt. Wenn nicht angegeben, wird der Benutzer angenommen, der die Aktion ausführt.
Persistent	Nein	Nein	1	Boolescher Wert, der angibt, ob die Warnung als persistent betrachtet werden soll. Dieses Attribut ist nur anwendbar, wenn eine Warnung an eine Benutzer-ID gesendet wird. Alle Warnungen verfügen über eine Schaltfläche „Verwerfen“, mit der die Warnung aus dem Benachrichtigungsfeld des Benutzers entfernt wird. Der Benutzer kann die Warnung ignorieren, sein Fenster schließen oder sich abmelden. App Builder Wenn persistent true (1) ist, wird die Warnung wiederholt angezeigt, jedes Mal, wenn sich der Benutzer anmeldet App Builder, bis der Benutzer die Warnung aktiv ablehnt. Verwenden Sie diese Technik, um sicherzustellen, dass eine Warnung vom Benutzer gelesen wird.
Timeout	Nein	Nein	15	Wenn angegeben, stellt Timeout die Zeitspanne (in Sekunden) dar, die gewartet werden soll, bevor das Warn-Popup automatisch geschlossen wird.
SendToPushNotificationEnabledUser	Nein	Nein	0	Falls angegeben, App Builder Der Alarm kann so konfiguriert werden, dass er nur an Benutzer gesendet wird, die kein Gerät mit aktivierter Push-Benachrichtigung haben. Dies ermöglicht es einem Entwickler, an App Builder Warn- und Push-Benachrichtigung im selben Ereignis und Verhinderung, dass ein Benutzer sowohl eine Desktop-Benachrichtigung als auch eine Push-Benachrichtigung erhält.

Push-Benachrichtigung

Das öffentliche Datenobjekt Push-Benachrichtigung ermöglicht es der Benachrichtigung, eine Push-Benachrichtigung an einen Benutzer zu senden. Die Spalten des öffentlichen Datenobjekts Push-Benachrichtigung lauten wie folgt:

Name	Obligatorisch	Mehrere Ziele	Beispiel	Beschreibung
An	Ja	Nein	85cc99ff-b4a6-4a32-bfeb-537d346ee52c	An ist der Benutzer (Benutzer-ID), an den wir die Push-Benachrichtigung senden. Wenn der Benutzer kein Push-Benachrichtigungsgerät hat, wird die Benachrichtigungsregel trotzdem erfolgreich sein, es wird jedoch keine Nachricht gesendet. Eine Ausnahme wird ausgelöst, wenn dieses Feld nicht angegeben oder null ist.
ToAppUserId	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 steht für den Benutzer, von dem diese Nachricht stammt.
Badge	Nein	Nein	1	Falls angegeben, wird hierdurch die Badge-Nummer auf dem Anwendungssymbol festgelegt.

Benachrichtigungs-Setup

Beispiel für eine Benachrichtigungseinrichtung

Schritte zum Einrichten einer Benachrichtigung. Wir gehen davon aus, dass wir der Northwinds-Kundenseite eine Kundengenehmigungsbenachrichtigung hinzufügen.

Benachrichtigung erstellen

Erstellen Sie eine Regel, die auf ein öffentliches Benachrichtigungsdatenobjekt abzielt.

Schritte zum Erstellen einer Benachrichtigung

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. Wenn dieses Datenobjekt nicht verfügbar ist, erstellen Sie eine Datenquellenverbindung zu App Builder(Versiegelt) für die App, in der Sie arbeiten.
Klicken Sie auf Speichern

Benachrichtigung mvSQL definieren

Klicken Sie auf die Schaltfläche +Tabellen
Fügen Sie Ihre Auswahltabelle hinzu. Zum Beispiel Kunden
Fügen Sie die folgenden Spalten hinzu und klicken Sie zum Definieren auf die Tab „Spalten“:

Spalte	Alias	Ziel
alle	An	An
"C".CustomerId	Kunden-ID	Binding()
"C".Kundenname	Kundenname

Hinweis

Beachten Sie, dass wir CustomerName hinzufügen, damit wir ihn später als Ersatzparameter in unserer Benachrichtigungsnachricht verwenden können.

Definieren Sie Benachrichtigungsoptionen

Navigieren Sie zu App Workbench
Klicken Sie auf Benachrichtigungen
Wählen Sie die Benachrichtigungs-Geschäftsregel aus. Beispiel: CustomerRequestApprovalAlert
Geben Sie die Nachrichteninformationen für die Benachrichtigung in das Feld Text ein
- Beispiel: Bitte überprüfen Sie den folgenden Kunden:
- Kunde: {{CustomerName}}
Klicken Sie auf das Bleistiftsymbol und geben Sie die technische Hilfe ein, um anderen Entwicklern die Benachrichtigung zu erläutern.

Definieren Sie optional eine Zielseite und ein Prelaunch-Ereignis, das ausgeführt werden soll.

Wählen Sie auf der Seite App Workbench > Benachrichtigungen die Option Benachrichtigung
Klicken Sie auf die Schaltfläche + Option
Erstellen Sie eine neue Option.
- Setze Index auf 10
- Name zum Überprüfen festlegen
- Wählen Sie den Wert Link zur Seite. In unserem Beispiel verlinken wir zur „Kunden“-Seite von Northwinds. Wenn die Seite, auf die Sie verlinken möchten, nicht angezeigt wird, stellen Sie sicher, dass sie in den Edge Case-Einstellungen als „Geteilt“ markiert wurde.
Klicken Sie auf das Häkchen, um den Datensatz zu speichern

Benachrichtigung bei einem Ereignis registrieren

Registrieren Sie eine 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 gehen außerdem davon aus, dass das Ereignis „Genehmigung anfordern“ heißt.

Navigieren Sie zum Ereignis für das Datenobjekt
Klicken Sie auf das Symbol Geschäftslogik
Klicken Sie auf die Schaltfläche Ereignisse
Wählen Sie das Ereignis aus. Beispiel: Genehmigung anfordern
Klicken Sie im Aktionsbereich auf Vorhandenes registrieren
Wählen Sie Benachrichtigung als Aktionstyp
Wählen Sie die Benachrichtigung aus, die wir im vorherigen Schritt erstellt haben. Beispiel: CustomerRequestApprovalAlert
Klicken Sie auf Speichern
Überprüfen Sie, ob die Expliziten Bindungen korrekt sind. Beispiel: CustomerId - CustomerId

Testen Sie es!

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. Alle App Builder Benutzer des Systems sollten ein Popup mit der Benachrichtigungsmeldung sehen.

Einrichten einer SMS-Benachrichtigung

Schritte zum Einrichten einer SMS-Benachrichtigung. Wir gehen davon aus, dass wir der Northwinds-Kundenseite eine Kundengenehmigungsbenachrichtigung hinzufügen.

Um die Einrichtung abzuschließen, benötigen Sie Zugriff auf ein Twilio-Konto.

Aufstellen App Builder Sicherheit

Navigieren Sie zu IDE > Sicherheitsanbieter
Klicken Sie im Fenster „Benutzerauthentifizierung“ auf + Benutzerauthentifizierung.
- Geben Sie einen Namen ein (z. B. „Http Basic Auth“)
- Wählen Sie „HTTP Basic Authentication“ als Typ
- Klicken Sie zum Aktivieren auf „Aktiviert“
- Klicken Sie auf Speichern
Navigieren Sie zu IDE > Benutzerverwaltung
- Doppelklicken Sie auf den Benutzerdatensatz, mit dem Sie sich 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 unter Authentifizierung auf das Symbol Schlüssel
Klicken Sie auf Erstellen
Wählen Sie den zuvor erstellten Anbieter „Http Basic Auth“ aus
Klicken Sie auf Speichern

Notiz

Der geheime „Schlüssel“, der für diesen Anbieter erstellt wird. Die Kombination aus Benutzername und geheimem Schlüssel wird bei der Konfiguration von Twilio verwendet.

Twilio einrichten

Messagingdienst erstellen

Melden Sie sich bei Ihrem Twilio-Konto an
Navigieren Sie zu Communications Cloud > Programmierbare SMS
Klicken Sie auf Messaging-Dienste
Erstellen Sie einen neuen Messaging-Dienst (Benachrichtigungen, 2-Wege) und fügen Sie ihm eine Twilio Telefonnummer hinzu
Notieren Sie sich die MessagingServiceSid. Diese wird später für die Konfiguration benötigt
Aktivieren Sie die Option „Eingehende Nachricht verarbeiten“
Geben Sie die folgende Anforderungs URL ein:
- https://:@/webhook/v1/vinyl/bridge_inbound
- Z. B. https://admin:P124asfgOmkA@vinyl.zudy.com/webhook/v1/vinyl/bridge_inbound

Twilio Anmeldeinformationen sammeln

Navigieren Sie zu Konsolen-Dashboard > Einstellungen
Notieren Sie sich die LIVE-Anmeldeinformationen:
- Konto-Sid
- Authentifizierungstoken

SMS- Endpoint konfigurieren

Navigieren Sie zu IDE > Benachrichtigungsserver
Doppelklicken Sie auf den „SMS“-Eintrag
Fügen Sie die folgende Konfiguration hinzu:
- Benutzername -> Twilio-Kontoseite
- Passwort -> Twilio Authentifizierungstoken
- MessagingServiceSid -> Twilio Messaging Service-Seite

Website-URL konfigurieren

Navigieren Sie zu IDE > Sicherheitsanbieter
Klicken Sie unter „Konfiguration“ auf Mehr > Sites
Klicken Sie auf + Site
Legen Sie den URL Wert auf die URL Ihrer Website fest. Beispiel: https://vinyl.zudy.com
Klicken Sie auf Speichern

SMS-Benachrichtigung konfigurieren

Benachrichtigung erstellen

Erstellen Sie eine Regel, die auf ein öffentliches Benachrichtigungsdatenobjekt abzielt.

Schritte zum Erstellen einer Benachrichtigung

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 dieses Datenobjekt nicht verfügbar ist, erstellen Sie eine Datenquellenverbindung zu App Builder(Versiegelt) für die App, in der Sie arbeiten.
Klicken Sie auf Speichern

Benachrichtigung mvSQL definieren

Klicken Sie auf die Schaltfläche +Tabelle und fügen Sie die Tabelle hinzu, die die Regel erfordert
- ZB Kunden
Klicken Sie auf die Tab Spalten und fügen Sie die folgenden Spalten hinzu:

Spalte	Alias	Ziel
'+15551112222' (ersetzen Sie es durch Ihre Telefonnummer)	An()	An()
"C".CustomerId	Kunden-ID	Binding()
"C".Kundenname	Kundenname

Hinweis

Wir fügen „Kundenname“ hinzu, damit wir ihn später als Ersatzparameter in unserer Benachrichtigungsnachricht verwenden können.

Definieren Sie Benachrichtigungsoptionen

Zusätzlich zur Definition der Nachrichteninformationen definieren wir zwei Optionen für dieses Benachrichtigungsbeispiel. Eine wird durch die Beantwortung der SMS aktiviert, die andere ist ein Link zu einer Seite.

Klicken Sie auf die Tab Benachrichtigung
Geben Sie die folgende Nachricht in den Nachrichtentext ein:

Reply {{1}} to approve {{CustomerName}}. Review {{Rezension}}

Klicken Sie im Optionsfeld auf die Schaltfläche +Option
- Setzen Sie Index auf 10
- Setzen Sie Name auf Review
- Wählen Sie die Seite aus, auf die verwiesen werden soll. In unserem Beispiel verlinken wir auf die Seite „Kunden“ von Northwinds. Wenn die Seite, auf die Sie verlinken möchten, nicht angezeigt wird, stellen Sie sicher, dass sie in den Edge Case-Einstellungen als „Geteilt“ markiert wurde.
- Setzen Sie die Option Typ auf „Link“
Klicken Sie im Optionsfeld auf die Schaltfläche +Option
- Setzen Sie Index auf 20
- Setzen Sie Name auf 1
- Wählen Sie die Seite aus, auf die verwiesen werden soll. In unserem Beispiel verlinken wir auf die „Kunden“-Seite von Northwinds und führen das „Genehmigen“-Ereignis aus.
- Setzen Sie die Option Typ auf „SMS-Antwort“

Benachrichtigung bei einem Ereignis registrieren

Registrieren Sie eine 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 gehen außerdem davon aus, dass das Ereignis „Genehmigung anfordern“ heißt.

Navigieren Sie zum Ereignis für das Datenobjekt
Klicken Sie auf das Symbol Geschäftslogik
Klicken Sie auf die Schaltfläche Ereignisse
Wählen Sie das Ereignis aus. Beispiel: Genehmigung anfordern
Klicken Sie im Aktionsbereich auf Vorhandenes registrieren
Wählen Sie Benachrichtigung als Aktions-Typ
Wählen Sie die Benachrichtigung aus, die wir im vorherigen Schritt erstellt haben. Beispiel: Customer_RequestApprovalSms
Klicken Sie auf Speichern
Überprüfen Sie, ob die expliziten Bindungen korrekt sind. Beispiel: Z. B. CustomerId- CustomerId

Push-Benachrichtigung konfigurieren

Push-Benachrichtigungen werden ähnlich wie andere Benachrichtigungen in App Builder. Der App Builder Der Serveradministrator muss den Push-Endpoint richtig konfigurieren, damit er wie erwartet funktioniert.

Wenn Sie Push-Benachrichtigungen mit der Blabber API konfigurieren, müssen Sie die iOS-Begleit-App herunterladen, sich mit den richtigen Anmeldeinformationen beim entsprechenden Server anmelden und Push-Benachrichtigungen in der App selbst aktivieren. Darüber hinaus ist ein API Schlüssel erforderlich, um die Konfiguration abzuschließen.

Testen Sie es!

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.