Benachrichtigungen in Jitterbit App Builder

Übersicht

Benachrichtigungen sind Nachrichten, die App Builder an die Benutzer deiner Anwendung sendet, wenn ein Ereignis eintritt, z. B. ein Klick auf eine Schaltfläche oder eine geplante Überprüfung. Eine Benachrichtigung kann als E-Mail, SMS, In-App-Warnung oder Push-Benachrichtigung zugestellt werden und kann dem Empfänger optional ermöglichen, durch Navigation zu einer Seite oder Auslösung eines Ereignisses zu reagieren.

Diese Seite beschreibt die drei Schritte, die zum Einrichten von Benachrichtigungen in deinen Anwendungen erforderlich sind:

1. Benachrichtigungsserver einrichten
   Konfiguriere den Server, der zum Versand von Benachrichtigungen verwendet wird.

2. Benachrichtigung erstellen
   Definiere den Nachrichteninhalt und das Objekt, das zum Versand verwendet wird.

3. Antwortoptionen hinzufügen
   Optional kannst du Empfängern ermöglichen, durch Navigation zu einer Seite oder Auslösung eines Ereignisses zu reagieren.

Diese Seite enthält auch vollständige Anleitungen des gesamten Prozesses mit zwei Beispielen: eine In-App-Benachrichtigung und eine SMS.

Für Nachrichten, die von Administratoren auf einmal an mehrere Benutzer gesendet werden, anstatt durch ein Anwendungsereignis ausgelöst zu werden, siehe Systembenachrichtigungen.

Schritt 1: Benachrichtigungsserver einrichten

Bevor du eine Benachrichtigung versenden kannst, musst du mindestens einen Benachrichtigungsserver für die Versandmethode konfigurieren, die du verwenden möchtest. App Builder unterstützt die folgenden Versandmethoden:

• E-Mail, versendet über einen SMTP-Server.

• SMS (Textnachricht), versendet über Twilio.

• In-App (App Builder-Warnung), ein Popup, das dem Empfänger angezeigt wird, während er in der App angemeldet ist.

• Push, versendet über Jitterbit Blabber für Apps, die den Jitterbit Wrapper oder einen Branded Wrapper verwenden, oder über OneSignal für native Mobile Apps mit deinem eigenen OneSignal-Konto.

Um Benachrichtigungsserver anzuzeigen und zu verwalten, wähle IDE > Notification Servers:

Die Liste der Server besteht aus den folgenden Spalten:

• Name: Der Name des Servers.

• Type: Der Typ der Benachrichtigung, die mit diesem Server eingerichtet werden kann.

• Description: Eine kurze Beschreibung.

• URI: Die URI (falls zutreffend).

• Status: Der aktuelle Status des Servers.

Doppelklicke auf eine beliebige Zeile oder klicke auf das Symbol am Ende, um Details eines bestimmten Servers anzuzeigen und zu bearbeiten. Jeder Server außer In-app erfordert eine Einrichtung vor der Verwendung:

• SMTP (E-Mail) erfordert, dass die Absenderadresse, die URI und die Abschnitte Security ausgefüllt werden.
• Blabber, OneSignal und SMS erfordern, dass der Abschnitt Security ausgefüllt wird.

Schritt 2: Benachrichtigung erstellen

Das Erstellen einer Benachrichtigung bedeutet das Erstellen einer Geschäftsregel mit dem Purpose auf Notification gesetzt, über die Registerkarte Notifications der App Workbench. Die Regel definiert den Nachrichteninhalt der Benachrichtigung und wählt das öffentliche Datenobjekt (Versandmethode) aus, das zum Versand verwendet wird, z. B. Email, Text Message, App Builder Alert oder Push Notification.

So erstellst du eine Benachrichtigung:

1. Navigiere zu App Workbench > Notifications.
2. Klicke auf + Notification.
3. Gib einen Name ein.
4. Bestätige, dass Purpose auf Notification gesetzt ist.
5. Wähle die Delivery Method aus, die du verwenden möchtest. Jede Versandmethode versendet eine Benachrichtigung über ein spezifisches öffentliches Datenobjekt, das die Details der Benachrichtigung bestimmt. Wenn das benötigte Datenobjekt nicht verfügbar ist, musst du möglicherweise eine Datenquellenverbindung zu App Builder (Sealed) für die App erstellen, an der du arbeitest.
6. Klicke auf Create.

Durch Klicken auf Create wird der Rule Builder im Bearbeitungsmodus geöffnet, in dem du die Spalten definierst, die die Benachrichtigung verwendet, auf die gleiche Weise wie beim Bearbeiten einer anderen Geschäftsregel. Die für jede Versandmethode verfügbaren Spalten findest du unter Öffentliche Datenobjekte nach Versandmethode unten.

Öffentliche Datenobjekte nach Zustellmethode

Jede Zustellmethode sendet eine Benachrichtigung über ein spezifisches öffentliches Datenobjekt – einen vordefinierten Satz von Spalten, der Details wie Empfänger, Absender und Zustellverhalten bestimmt. Die Zustellmethode, die Sie beim Erstellen einer Benachrichtigung auswählen, bestimmt, welches öffentliche Datenobjekt Ihre Benachrichtigungsspalten in der mvSQL-Definition des Rule Builder zuordnen müssen.

Die folgenden Abschnitte beschreiben die für jedes öffentliche Datenobjekt verfügbaren Spalten sowie die Spalten, die allen gemeinsam sind.

Gemeinsame Spalten

Diese Spalten sind allen unten beschriebenen öffentlichen Datenobjekten gemeinsam:

E-Mail

Die Spalten für das öffentliche Datenobjekt E-Mail sind wie folgt:

Benachrichtigungen, die per E-Mail versendet werden, können Dateianhänge vieler Dateitypen enthalten, z. B. .pdf, .docx, .txt oder .xlsx, unter Verwendung der unten beschriebenen Spalten Attachment() und FileDataSourceId. App Builder fügt standardmäßig Dateien aus dem Verzeichnis data/pdf oder aus dem durch FileDataSourceId angegebenen Verzeichnis an.

Falls die Benachrichtigung Optionen enthält, gibt die Spalte AppBuilderUrl die URL an, die beim Generieren von Links zu diesen Optionen verwendet wird. Falls AppBuilderUrl nicht angegeben ist, greift App Builder auf die Standard-URL der Server-Website zurück, die unter IDE > Security Providers > More (im Panel Konfiguration) > Sites konfiguriert ist. Weitere Informationen finden Sie unter Sites und Aliase.

Textnachricht

Das öffentliche Datenobjekt Textnachricht wird zum Versenden von SMS-Nachrichten verwendet. Die Spalten des öffentlichen Datenobjekts Textnachricht sind wie folgt:

App Builder-Warnung

Die Spalten des öffentlichen Datenobjekts App Builder-Warnung sind wie folgt. Dieses Objekt ähnelt dem öffentlichen Datenobjekt Notification_Create, ist aber nicht identisch damit.

Push-Benachrichtigung

Das öffentliche Datenobjekt Push-Benachrichtigung sendet eine Push-Benachrichtigung an einen Benutzer. Die Spalten des öffentlichen Datenobjekts Push-Benachrichtigung sind wie folgt:

Benachrichtigungsnachricht schreiben

Um die Nachricht der Benachrichtigung zu schreiben, klicken Sie erneut auf die Registerkarte Benachrichtigungen und wählen Sie Ihre Benachrichtigung im Bereich Benachrichtigungsregeln aus. Geben Sie die Nachricht im Feld Body des Bereichs Nachricht ein. Dieses Feld ist erforderlich, und die Benachrichtigungsereignis schlägt mit einem Fehler fehl, wenn es leer gelassen wird.

Die Nachricht unterstützt Ersetzungen mit der Syntax {{fieldname}}, die App Builder beim Senden der Benachrichtigung durch den entsprechenden Spaltenwert ersetzt. Der Text kann beispielsweise Folgendes enthalten:

Hallo {{CustomerName}},

In diesem Beispiel muss CustomerName in den Spalten der Benachrichtigungsregel zusammen mit den anderen erforderlichen Feldern enthalten sein. Ersetzungen können ein optionales Flag url hinzufügen, um anzugeben, dass der Wert eine URL ist und URL-Codierung erfordert, z. B. {{fieldname|url}}. Ein optionales Flag HTML behandelt HTML-Markup im Wert als Klartext, z. B. {{fieldname|HTML}} ersetzt einen Wert von <b>Jitterbit</b> als Jitterbit.

Für die meisten Nachrichten reicht es aus, das Feld Body im Klartext zu bearbeiten. Falls Sie eine benutzerdefinierte Formatierung über Klartext hinaus benötigen, klicken Sie auf Mehr > HTML bearbeiten, um das zugrunde liegende HTML der Nachricht direkt zu bearbeiten.

Bei E-Mails muss auch ein Betreff angegeben werden, der ebenfalls Ersetzungen unterstützt. Wie beim Feld Body führt das Leerenlassen zu einem Fehler beim Benachrichtigungsereignis.

Übersetzungen

Falls Ihre Anwendung mehrere Sprachen unterstützt, können Sie auch eine Benachrichtigung übersetzen. Drei Felder unterstützen dies: der Text der Benachrichtigung, ihr Betreff (für E-Mails) und der Name jeder Antwortoption. Anstatt Literaltext in diese Felder einzugeben, geben Sie einen Übersetzungsschlüssel ein. App Builder sucht den Wert für die Sprache des Empfängers im Übersetzungspaket der App auf, wenn die Benachrichtigung gesendet wird.

Sie müssen diese Übersetzungsschlüssel manuell zum Übersetzungspaket der App hinzufügen; App Builder importiert sie nicht automatisch.

Wenn Sie die Nachricht mit More > Edit HTML bearbeiten, fügen Sie den Übersetzungsschlüssel als einfache Zeichenkette statt als HTML hinzu, sonst schlägt die Suche fehl.

Weitere Informationen zum Einrichten von Sprachen und Übersetzungspaketen finden Sie unter Translations.

Schritt 3: Antwortalternativen hinzufügen

Eine Benachrichtigung kann optional eine oder mehrere Antwortalternativen enthalten, mit denen der Empfänger antworten kann. Eine Benachrichtigung ohne Alternativen ist rein informativ: App Builder verfolgt keine Antwort und fügt der Nachricht keine Links hinzu.

Wenn eine Benachrichtigung eine oder mehrere Alternativen hat, verfolgt App Builder die Antwort des Empfängers automatisch. Bei E-Mails und App Builder-Benachrichtigungen ist jede Alternative ein anklickbarer Link zurück in App Builder. Bei SMS antwortet der Empfänger mit dem Namen der Alternative, um diese auszuwählen.

Benachrichtigungslinks verfallen nach 7 Tagen und können nicht so konfiguriert werden, dass sie länger bestehen bleiben.

So fügen Sie eine Antwortalternative zu einer Benachrichtigung hinzu:

1. Klicken Sie im Panel Options der Benachrichtigung auf die Schaltfläche + Option.
2. Legen Sie Index fest, um die Reihenfolge der Alternative im Verhältnis zu anderen Alternativen zu bestimmen.
3. Legen Sie Name fest, um die Alternative zu identifizieren. Bei einer SMS Reply-Alternative ist dies auch der Text, mit dem der Empfänger antworten muss.
4. Legen Sie Option Type auf Link oder SMS Reply fest.
5. Wählen Sie für eine Link-Alternative die Seite aus, auf die in Link To Page verlinkt werden soll. Die Seite muss in ihren Edge Case-Einstellungen als Public gekennzeichnet sein.
6. Klicken Sie auf Save.

Das Navigieren zur in Link To Page ausgewählten Seite schließt die Antwort für eine Link-Alternative ab. Wenn diese Seite auch ein Business-Logic-Event gebunden hat, wird das Event vor dem Rendern der Seite ausgeführt, und das Abschließen der Antwort hängt dann auch davon ab, dass das Event erfolgreich ausgeführt wird. Informationen zu den Einschränkungen, die für dieses Event gelten, finden Sie unter Data object event binding weiter unten.

Data object event binding

Wenn die in einem Link To Page-Feld einer Antwortalternative verlinkte Seite auch ein Business-Logic-Event gebunden hat, muss dieses Event entweder zum ersten Panel der Seite (dem Panel mit dem niedrigsten Index in der oberen linken Position) oder zum öffentlichen Datenobjekt der Seite selbst gehören, falls eines definiert ist. Events, die zu einem anderen Panel auf der Seite gehören, können nicht an eine Antwortalternative gebunden werden.

Betrachten Sie beispielsweise eine gestapelte Seite mit zwei nebeneinander angeordneten Gruppen: die erste mit Index 10 enthält die Panels Customer und CustomerAddress, und die zweite mit Index 20 enthält die Panels Employee und EmployeeAddress:

Customer ist das erste Panel der Seite, daher sind seine Events berechtigt. CustomerAddress, Employee und EmployeeAddress sind nicht berechtigt, da keines von ihnen das erste Panel der Seite ist.

App Builder erlaubt auch nur die Bindung an benutzerdefinierte Events, nicht an Systemevents. Sie können beispielsweise nicht an die Events Save, Insert, Update oder Delete binden.

Wenn das gebundene Event abgeschlossen ist, leitet App Builder den Empfänger zur Seite weiter, aber jede Nachricht nach dem Event oder jedes Validierungsergebnis des Events geht dann verloren, da App Builder diese dem Empfänger für Events auf Seitenebene nicht anzeigt. Sie können dies umgehen, indem Sie Daten in den Panels der Seite anzeigen, die sich je nachdem ändern, ob das Event erfolgreich ausgeführt wurde. Aus demselben Grund verhindert eine Validierungswarnung einfach die Ausführung des Events, da es keine Mechanismen für den Empfänger gibt, um diese zu akzeptieren oder abzulehnen.

An diesem Punkt haben Sie alles, was Sie zum Erstellen einer Benachrichtigung benötigen: einen Server, um sie bereitzustellen, eine Regel, die ihre Nachricht und Daten definiert, und optional eine oder mehrere Antwortalternativen.

Vollständige Anleitungen

Die folgenden Beispiele führen Sie durch den gesamten Prozess der Erstellung einer Benachrichtigung, vom Einrichten einer Bereitstellungsmethode bis zum Hinzufügen einer Antwortalternative. Das erste Beispiel verwendet App Builder Alert als Bereitstellungsmethode; das zweite verwendet Text Message (SMS).

Beispiel-Benachrichtigungseinrichtung

Dieses Beispiel fügt eine Kundenfreigabebenachrichtigung zur Seite Customers einer hypothetischen Anwendung namens Northwinds hinzu und verwendet App Builder Alert als Zustellmethode.

1. Erstelle die Benachrichtigung und lege die Zustellmethode fest:

   1. Navigiere zu App Workbench.
   2. Klicke auf Notifications.
   3. Klicke auf + Notification.
   4. Vergib einen Namen. Beispiel: CustomersRequestApprovalAlert.
   5. Bestätige, dass Purpose auf Notification eingestellt ist.

   6. Wähle App Builder Alert als Delivery Method aus.

      Hinweis

      Falls dieses Datenobjekt nicht verfügbar ist, erstelle eine Datenquellenverbindung zu App Builder (Sealed) für die App, an der du arbeitest.

   7. Klicke auf Create.

2. Definiere das mvSQL der Benachrichtigung und ordne die Tabelle Customers den Spalten zu, die das Objekt App Builder Alert benötigt:

   1. Klicke auf die Schaltfläche +Tables.
   2. Füge deine Tabelle Select From hinzu, in diesem Fall Customers.

   3. Füge die folgenden Spalten hinzu und klicke auf die Registerkarte Columns, um sie zu definieren:

      Column	Alias	Target
      'all'	To	To
      "C".CustomerId	CustomerId	Binding()
      "C".CustomerName	CustomerName

      Hinweis

      CustomerName wird hier hinzugefügt, damit es später als Substitutionsparameter in der Benachrichtigungsmeldung verwendet werden kann.

3. Schreibe die Nachricht der Benachrichtigung:

   1. Navigiere zu App Workbench.
   2. Klicke auf Notifications.
   3. Wähle die Benachrichtigung aus, die du in Schritt 1 erstellt hast, in unserem Beispiel CustomerRequestApprovalAlert.

   4. Gib die Nachricht in das Feld Body ein, beispielsweise:

      Please review the following customer:
      Customer: {{CustomerName}}

   5. Klicke auf das Symbol und gib eine beliebige Technical Help ein, um die Benachrichtigung für andere Entwickler zu erklären.

4. (Optional) Füge eine Antwortoption hinzu, die auf eine Seite verlinkt:

   1. Wähle auf der Seite App Workbench > Notifications die Benachrichtigung aus.
   2. Klicke auf die Schaltfläche + Option.
   3. Erstelle eine neue Option:
      1. Setze Index auf 10.
      2. Setze Name auf Review.
      3. Wähle den Wert Link To Page aus. In diesem Beispiel verlinke zur Seite Customers. Falls die Seite, auf die du verlinken möchtest, nicht angezeigt wird, stelle sicher, dass sie in ihren Edge Case-Einstellungen als Public gekennzeichnet ist.
      4. Klicke auf Save.

5. Dieses Beispiel setzt voraus, dass die Seite Customers bereits als Public gekennzeichnet ist und ein Ereignis namens Request Approval auf ihrem ersten Panel definiert ist. Binde dieses Ereignis an den Link der Option, damit es ausgeführt wird, wenn der Empfänger darauf folgt:

   1. Navigiere zum Ereignis für das Datenobjekt.
   2. Klicke auf das Symbol Business Logic.
   3. Klicke auf die Schaltfläche Events.
   4. Wähle das Ereignis aus. Beispiel: Request Approval.
   5. Klicke im Panel Actions auf Register Existing.
   6. Wähle Notification als Action Type aus.
   7. Wähle die Benachrichtigung aus, die wir im vorherigen Schritt erstellt haben. Beispiel: CustomerRequestApprovalAlert.
   8. Klicke auf Save.
   9. Überprüfe, dass die Explicit Bindings korrekt sind. Beispiel: CustomerId - CustomerId.

6. Teste die Benachrichtigung. Navigiere zu deiner Seite und klicke auf die Schaltfläche, die das Benachrichtigungsereignis ausführt. Alle angemeldeten App Builder-Benutzer sollten ein Popup mit der Benachrichtigungsmeldung sehen.

Beispiel-SMS-Benachrichtigungseinrichtung

Dieses Beispiel fügt dieselbe Kundenfreigabebenachrichtigung zur gleichen Seite Customers hinzu und verwendet Text Message (SMS) als Zustellmethode.

1. Richte App Builder-Sicherheit ein, damit App Builder eingehende SMS-Antworten von Twilio authentifizieren kann:

   1. Navigiere zu IDE > Security Providers.
   2. Klicke auf + User Authentication im Panel User Authentication.
      1. Gib einen Namen ein (z. B. Http Basic Auth).
      2. Wähle HTTP Basic Authentication als Type aus.
      3. Klicke auf Enabled, um es zu aktivieren.
      4. Klicke auf Save.

   3. Navigiere zu IDE > User Management.

      1. Suche im Panel Users den Benutzer, den du authentifizieren möchtest, wenn eine SMS-Antwort eingeht. Doppelklicke auf die Zeile des Benutzers oder klicke auf das Symbol am Ende. Das Dialogfeld User wird geöffnet.

         Hinweis

         Dieser Benutzer muss Zugriff auf die App Builder-Anwendung und auf das Ereignis haben, das in der Benachrichtigung selbst ausgeführt wird.

      2. Klicken Sie auf Mehr > Schlüssel. Das Dialogfeld Schlüssel wird geöffnet.

      3. Klicken Sie auf Erstellen. Das Dialogfeld Schlüssel generieren wird geöffnet.
      4. Wählen Sie den zuvor erstellten Http Basic Auth-Anbieter aus.
      5. Klicken Sie auf Speichern.

   Hinweis

   Dieser Anbieter erstellt einen geheimen Schlüssel. Die Kombination aus Benutzername und geheimem Schlüssel wird bei der Konfiguration von Twilio verwendet.

2. Richten Sie Twilio ein, um SMS-Nachrichten zu senden und zu empfangen:

   1. Erstellen Sie einen Messaging-Service:

      1. Melden Sie sich bei Ihrem Twilio-Konto an.
      2. Navigieren Sie zu Communications Cloud > Programmable SMS.
      3. Klicken Sie auf Messaging Services.
      4. Erstellen Sie einen neuen Messaging Service (Benachrichtigungen, bidirektional) und fügen Sie eine Twilio-Telefonnummer hinzu.
      5. Notieren Sie sich die MessagingServiceSid. Diese wird später für die Konfiguration benötigt.
      6. Aktivieren Sie die Option Process Inbound Message.
      7. Geben Sie die folgende Request-URL ein und ersetzen Sie <username>, <secret_key> und <your_AppBuilder_Server> durch Ihre Werte: https://<username>:<secret_key>@<your_AppBuilder_Server>/webhook/v1/vinyl/bridge_inbound

   2. Sammeln Sie Twilio-Anmeldedaten:

      1. Navigieren Sie zu Console Dashboard > Einstellungen.
      2. Notieren Sie sich die folgenden Live-Anmeldedaten:
         • Account Sid
         • Auth Token

3. Verbinden Sie App Builder mit Twilio, indem Sie die im vorherigen Schritt gesammelten Anmeldedaten verwenden:

   1. Navigieren Sie zu IDE > Notification Servers.
   2. Doppelklicken Sie auf die Zeile SMS.
   3. Fügen Sie die folgende Konfiguration hinzu:
      • Benutzername: Geben Sie Ihre Twilio Account Sid ein.
      • Passwort: Geben Sie Ihr Twilio Auth Token ein.
      • MessagingServiceSid: Geben Sie Ihre Twilio MessagingServiceSid ein.

4. Legen Sie die Website-URL fest, die App Builder beim Generieren von Links in der SMS-Nachricht verwendet:

   1. Navigieren Sie zu IDE > Security Providers.
   2. Klicken Sie unter Configuration auf Mehr > Sites.
   3. Klicken Sie auf + Site.
   4. Legen Sie den URL-Wert auf Ihre Website-URL fest. Beispiel: https://vinyl.jitterbit.com.
   5. Klicken Sie auf Speichern.

5. Erstellen und konfigurieren Sie nun die SMS-Benachrichtigung selbst, indem Sie denselben allgemeinen Prozess wie im vorherigen Beispiel befolgen, aber dieses Mal wählen Sie Text Message als Delivery Method statt App Builder Alert:

   1. Erstellen Sie die Benachrichtigung und legen Sie ihre Zustellmethode fest:

      1. Navigieren Sie zu App Workbench > Notifications.
      2. Klicken Sie auf + Notification.
      3. Weisen Sie ihr einen Namen zu.
      4. Wählen Sie Notification als Purpose aus.

      5. Wählen Sie Text Message als Delivery Method aus.

         Hinweis

         Wenn dieses Datenobjekt nicht verfügbar ist, erstellen Sie eine Datenquellenverbindung zu App Builder (Sealed) für die App, an der Sie arbeiten.

      6. Klicken Sie auf Erstellen.

   2. Definieren Sie das mvSQL der Benachrichtigung und ordnen Sie die Telefonnummer und Kundenspalten dem Objekt Text Message zu:

      1. Klicken Sie auf die Schaltfläche +Table und fügen Sie die Tabelle hinzu, die die Regel benötigt. Z. B. Customers.

      2. Klicken Sie auf die Registerkarte Columns und fügen Sie die folgenden Spalten hinzu:

         Column	Alias	Target
         '+15551112222' (ersetzen Sie durch Ihre Telefonnummer)	To()	To()
         "C".CustomerId	CustomerId	Binding()
         "C".CustomerName	CustomerName

         Hinweis

         CustomerName wird hier hinzugefügt, damit es später als Substitutionsparameter in der Benachrichtigungsnachricht verwendet werden kann.

   3. Schreiben Sie die Nachricht und fügen Sie zwei Antwortoptionen hinzu: eine, auf die der Empfänger per SMS antworten kann, und eine, die auf eine Seite verlinkt:

6. Klicken Sie auf die Registerkarte Benachrichtigungen.

7. Geben Sie die folgende Nachricht in das Feld Text ein:

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

8. Klicken Sie auf die Schaltfläche + Option im Bereich Optionen:

   1. Setzen Sie Index auf 10.
   2. Setzen Sie Name auf Review.
   3. Wählen Sie die Seite aus, auf die verlinkt werden soll. In unserem Beispiel verlinken wir auf die Northwinds-Seite Customer. Falls die gewünschte Seite nicht angezeigt wird, stellen Sie sicher, dass sie in ihren Edge Case-Einstellungen als Public gekennzeichnet ist.
   4. Setzen Sie Option Type auf Link.
   5. Klicken Sie auf Save.

9. Klicken Sie auf die Schaltfläche + Option im Bereich Optionen:

   1. Setzen Sie Index auf 20.
   2. Setzen Sie Name auf 1.
   3. Wählen Sie die Seite aus, auf die verlinkt werden soll. In unserem Beispiel verlinken wir auf die Northwinds-Seite Customer und führen das Ereignis Approve aus.
   4. Setzen Sie Option Type auf SMS Reply.
   5. Klicken Sie auf Save.

10. Dieses Beispiel setzt voraus, dass die Seite Customers bereits als Public gekennzeichnet ist und ein Ereignis namens Request Approval auf ihrem ersten Panel definiert hat. Binden Sie dieses Ereignis an die Option Link, damit es ausgeführt wird, wenn der Empfänger darauf klickt:

    1. Navigieren Sie zum Ereignis für das Datenobjekt.
    2. Klicken Sie auf das Symbol Business Logic.
    3. Klicken Sie auf die Schaltfläche Events.
    4. Wählen Sie das Ereignis aus. Beispiel: Request Approval.
    5. Klicken Sie auf Register Existing im Bereich Actions.
    6. Wählen Sie Notification als Action Type aus.
    7. Wählen Sie die Benachrichtigung aus, die wir im vorherigen Schritt erstellt haben. Beispiel: Customer_RequestApprovalSms.
    8. Klicken Sie auf Save.
    9. Überprüfen Sie, dass die Explicit Bindings korrekt sind. Beispiel: CustomerId - CustomerId.

11. Testen Sie die Benachrichtigung. Navigieren Sie zu Ihrer Seite und klicken Sie auf die Schaltfläche, die das Benachrichtigungsereignis ausführt.

Systembenachrichtigungen

Im Gegensatz zu den Benachrichtigungen, die weiter oben auf dieser Seite beschrieben sind und die App Builder automatisch an einen bestimmten Empfänger sendet, wenn ein Geschäftsereignis eintritt, sind Systembenachrichtigungen Broadcast-Nachrichten, die ein Administrator manuell sendet oder zeitlich plant, um sie später an eine Gruppe von Benutzern gleichzeitig zu senden, beispielsweise an alle mit Zugriff auf eine Anwendung oder an eine bestimmte Sicherheitsgruppe oder Rolle. Administratoren nutzen Systembenachrichtigungen für Dinge wie geplante Wartungsfenster oder Anwendungs-Upgrades, die nicht an einen bestimmten Datensatz gebunden oder durch ein Ereignis ausgelöst werden müssen.

Systembenachrichtigungen werden aktiven Benutzern angezeigt und bleiben in ihrem Notification Center (unter dem Hamburger-Menü), bis sie verworfen oder abgelaufen sind. Systembenachrichtigungen sind Teil der Funktion Maintenance und unterstützen nur In-App-Benachrichtigungen. Sie sind auch umgebungsspezifisch: Im Gegensatz zu Anwendungsbenachrichtigungen, die mit Ihrem Code zwischen Umgebungen migriert werden, muss eine Systembenachrichtigung in jeder Umgebung neu erstellt werden.

Um eine Systembenachrichtigung einzurichten, wählen Sie IDE > Maintenance und dann die Registerkarte Notifications (verfügbar seit App Builder 4.44) aus, und führen Sie diese Schritte aus:

1. Klicken Sie im Bereich Scheduled Notifications auf die Schaltfläche Schedule or Send Now.

2. Geben Sie im Dialogfeld Notification Werte für die folgenden Felder ein:

   • To: Klicken Sie auf das Feld und wählen Sie dann eines der folgenden Elemente aus:

     • All

     • Eine Gruppe von Benutzern basierend auf Folgendem:

       • Ihr Zugriff auf eine Anwendung oder Datenquelle, gewährt durch ihre Gruppen oder Rollen.

       • Sicherheitsgruppen.

       • Die Rollen der Datenquelle.

   • From: Definiert, wer die Benachrichtigung gesendet hat (normalerweise der Service-Benutzer).

   • Schedule For: (Optional) Planen Sie eine Benachrichtigung, die später gesendet werden soll (beispielsweise eine Stunde vor einem geplanten Anwendungs-Upgrade).

   • Expires On: Ein Datum/eine Uhrzeit, zu der die Benachrichtigung abläuft und Benutzern nicht mehr angezeigt wird. Zu diesem Zeitpunkt wird die Benachrichtigung aus den Benachrichtigungszentren der Benutzer entfernt, die die Nachricht gesehen und verworfen haben.

3. Body: Der Inhalt der Nachricht, die Benutzern angezeigt wird.

4. Klicken Sie auf die Schaltfläche Send oder Schedule.

Ein Hintergrunddienst versendet geplante Benachrichtigungen. Standardmäßig wird der Dienst vom Konto Service User ausgeführt. Um zu ändern, welcher Benutzer den Dienst ausführt, führen Sie diese Schritte aus:

1. Wählen Sie IDE > Maintenance und dann die Registerkarte Settings.

2. Klicken Sie auf das Menü Background Notification User und wählen Sie den Benutzer aus, der den Dienst ausführen soll.