Benachrichtigungen in Jitterbit App Builder

Übersicht

Benachrichtigungen sind Meldungen, die App Builder an die Benutzer deiner Anwendung sendet, wenn ein Ereignis auftritt, z. B. ein Klick auf eine Schaltfläche oder eine geplante Überprüfung. Eine Benachrichtigung kann per E-Mail, Textnachricht, In-App-Warnung oder Push-Benachrichtigung zugestellt werden und dem Empfänger optional die Möglichkeit geben, durch Navigation zu einer Seite oder Auslösung eines Ereignisses zu antworten.

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

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

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

3. Antwortoptionen hinzufügen
   Ermögliche den Empfängern optional, durch Navigation zu einer Seite oder Auslösung eines Ereignisses zu antworten.

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

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

Schritt 1: Benachrichtigungsserver einrichten

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

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

• SMS (Textnachricht), gesendet über Twilio.

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

• Push, gesendet über Jitterbit Blabber, für Apps mit dem Jitterbit Wrapper oder einem benutzerdefinierten Wrapper, 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: Die Art 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 am Ende auf das Symbol , 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 der Purpose gesetzt auf Notification, vom Notifications-Tab der App Workbench. Die Regel definiert den Nachrichteninhalt der Benachrichtigung und wählt das öffentliche Datenobjekt (Zustellungsmethode) aus, das zum Senden 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 Zustellungsmethode sendet eine Benachrichtigung über ein bestimmtes öffentliches Datenobjekt, das die Details der Benachrichtigung bestimmt. Falls das erforderliche Datenobjekt nicht verfügbar ist, musst du möglicherweise eine Datenquellenverbindung erstellen zu App Builder (Sealed) für die App, 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 dieselbe Weise wie beim Bearbeiten einer anderen Geschäftsregel. Die Spalten, die für jede Zustellungsmethode verfügbar sind, finden Sie unter Öffentliche Datenobjekte nach Zustellungsmethode unten.

Öffentliche Datenobjekte nach Liefermethode

Jede Liefermethode versendet eine Benachrichtigung über ein spezifisches öffentliches Datenobjekt — einen vordefinierten Satz von Spalten, der Details wie den Empfänger, Absender und Lieferverhalten bestimmt. Die Liefermethode, die man beim Erstellen einer Benachrichtigung auswählt, bestimmt, welches öffentliche Datenobjekt die Spalten der Benachrichtigung zuordnen müssen, in der mvSQL-Definition des Rule Builder.

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

Gemeinsame Spalten

Diese Spalten sind für jedes unten beschriebene öffentliche Datenobjekt gleich:

E-Mail

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

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

Falls die Benachrichtigung Optionen enthält, gibt die Spalte AppBuilderUrl die URL an, die beim Generieren von Links zu diesen Optionen verwendet wird. Wenn AppBuilderUrl nicht angegeben ist, verwendet App Builder die standardmäßige URL der Website des Servers, die unter IDE > Security Providers > More (im Panel Configuration) > Sites konfiguriert ist. Weitere Informationen finden Sie unter Websites 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-Benachrichtigung

Die Spalten des öffentlichen Datenobjekts App Builder-Benachrichtigung 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:

Benachrichtigungsmeldung schreiben

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

Die Nachricht unterstützt Substitutionen 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. Substitutionen können eine optionale url-Markierung hinzufügen, um anzuzeigen, dass der Wert eine URL ist und URL-Kodierung erfordert, z. B. {{fieldname|url}}. Eine optionale HTML-Markierung behandelt HTML-Markup im Wert als Klartext, z. B. ersetzt {{fieldname|HTML}} einen Wert von <b>Jitterbit</b> als Jitterbit.

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

Für E-Mails muss auch ein Betreff angegeben werden, der ebenfalls Substitutionen unterstützt. Wie das Feld Text führt das Lassen dieses Feldes leer dazu, dass das Benachrichtigungsereignis mit einem Fehler fehlschlägt.

Übersetzungen

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

Du musst diese Übersetzungsschlüssel manuell zum Übersetzungspaket der App hinzufügen; App Builder importiert sie nicht automatisch.

Wenn du die Nachricht mit More > Edit HTML bearbeitest, füge den Übersetzungsschlüssel als einfache Zeichenkette hinzu, anstatt als HTML, sonst schlägt die Suche fehl.

Weitere Informationen zum Einrichten von Sprachen und Übersetzungspaketen findest du unter Translations.

Schritt 3: Antwortoption hinzufügen

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

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

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

So fügt man eine Antwortoption zu einer Benachrichtigung hinzu:

1. Klicke im Bereich Options der Benachrichtigung auf die Schaltfläche + Option.
2. Stelle Index ein, um die Reihenfolge der Option relativ zu anderen Optionen zu bestimmen.
3. Stelle Name ein, um die Option zu kennzeichnen. Bei einer SMS Reply-Option ist dies auch der Text, mit dem der Empfänger antworten muss.
4. Stelle Option Type auf Link oder SMS Reply ein.
5. Wähle für eine Link-Option 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. Klicke auf Save.

Das Navigieren zur in Link To Page ausgewählten Seite schließt die Antwort für eine Link-Option ab. Wenn diese Seite auch ein Business-Logic-Event daran gebunden hat, wird das Event ausgeführt, bevor die Seite gerendert wird, und das Abschließen der Antwort hängt dann auch davon ab, dass dieses Event erfolgreich ausgeführt wird. Weitere Informationen zu den Einschränkungen für dieses Event findest du unter Data object event binding.

Data object event binding

Wenn die in einem Antwortoption Link To Page-Feld verlinkte Seite auch ein Business-Logic-Event daran gebunden hat, muss dieses Event entweder zum ersten Panel der Seite (das 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 Antwortoption gebunden werden.

Stell dir beispielsweise eine gestapelte Seite mit zwei nebeneinander angeordneten Gruppen vor: Die erste mit Index 10 enthält die Customer- und CustomerAddress-Panels, die zweite mit Index 20 enthält die Employee- und EmployeeAddress-Panels:

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 System-Events. Du kannst 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. Allerdings gehen alle Nachrichten oder Validierungsergebnisse des Events bis dahin verloren, da App Builder diese für Events auf Seitenebene nicht für den Empfänger anzeigt. Dies lässt sich umgehen, indem man Daten in den Panels der Seite anzeigt, die sich je nach erfolgreicher Ausführung des Events ändern. Aus demselben Grund verhindert eine Validierungswarnung einfach, dass das Event ausgeführt wird, da es keine Mechanismen gibt, mit denen der Empfänger diese akzeptieren oder ablehnen kann.

An diesem Punkt hast du alles, was du brauchst, um eine Benachrichtigung zu erstellen: einen Server, um sie zu versenden, eine Regel, die ihre Nachricht und ihre Daten definiert, und optional eine oder mehrere Antwortoption.

Vollständige Übersichten

Die folgenden Beispiele führen dich durch den gesamten Prozess der Erstellung einer Benachrichtigung, von der Einrichtung einer Versandmethode bis zum Hinzufügen einer Antwortoption. Das erste Beispiel verwendet App Builder Alert als Versandmethode, das zweite verwendet Text Message (SMS).

Beispiel für Benachrichtigungseinrichtung

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

1. Erstelle die Benachrichtigung und stelle ihre Liefermethode ein:

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

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

      Hinweis

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

   7. Klicke auf Create.

2. Definiere die 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:

      Spalte	Alias	Ziel
      'all'	To	To
      "C".CustomerId	CustomerId	Binding()
      "C".CustomerName	CustomerName

      Hinweis

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

3. Schreibe die Meldung 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 Meldung im Feld Body ein, beispielsweise:

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

   5. Klicke auf das Symbol und gib eventuell 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. Stelle Index auf 10.
      2. Stelle Name auf Review.
      3. Wähle den Wert Link To Page. Verlinke in diesem Beispiel zur Seite Customers. Falls die Seite, zu der du verlinken möchtest, nicht angezeigt wird, stelle sicher, dass sie in ihren Edge Case-Einstellungen als Public markiert ist.
      4. Klicke auf Save.

5. In diesem Beispiel wird angenommen, dass die Seite Customers bereits als Public markiert ist und auf ihrem ersten Panel ein Ereignis namens Request Approval definiert ist. Verbinde dieses Ereignis mit dem 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.
   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 für SMS-Benachrichtigungseinrichtung

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

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 + Security Provider.
      1. Gib einen Namen ein (z. B. Http Basic Auth).
      2. Wähle HTTP Basic Authentication als Type.
      3. Klicke auf Enabled, um 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 öffnet sich.

         Hinweis

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

      2. Klicken Sie auf More > Keys. Das Dialogfeld Keys wird geöffnet.

      3. Klicken Sie auf Create. Das Dialogfeld Generate Key wird geöffnet.
      4. Wählen Sie den zuvor erstellten Http Basic Auth-Provider aus.
      5. Klicken Sie auf Save.

   Hinweis

   Dieser Provider erstellt einen geheimen Key. Die Kombination aus User Name und geheimem Key wird bei der Konfiguration von Twilio verwendet.

2. Konfigurieren Sie Twilio zum Senden und Empfangen von SMS-Nachrichten:

   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 (Notifications, 2-way) und verbinden Sie eine Twilio-Telefonnummer damit.
      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. Erfassen Sie die Twilio-Anmeldedaten:

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

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

   1. Navigieren Sie zu IDE > Notification Servers.
   2. Doppelklicken Sie auf die SMS-Zeile.
   3. Fügen Sie die folgende Konfiguration hinzu:
      • User Name: Geben Sie Ihre Twilio Account Sid ein.
      • Password: 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 More > 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 Save.

5. Erstellen und konfigurieren Sie nun die SMS-Benachrichtigung selbst, indem Sie denselben allgemeinen Prozess wie im vorherigen Beispiel befolgen. Wählen Sie diesmal jedoch Text Message als Delivery Method anstelle von 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 Name 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 Datenquellen-Verbindung zu App Builder (Sealed) für die App, an der Sie arbeiten.

      6. Klicken Sie auf Create.

   2. Definieren Sie das mvSQL der Benachrichtigung und ordnen Sie die Telefonnummer und Kundenspalten dem Text Message-Objekt 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 Antwortalternativen hinzu: eine, auf die der Empfänger per SMS antworten kann, und eine, die zu einer Seite verlinkt:

      1. Klicken Sie auf die Registerkarte Benachrichtigungen.

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

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

      3. 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 Kunde. Falls die gewünschte Seite nicht angezeigt wird, überprüfen Sie, dass sie in ihren Edge Case-Einstellungen als Öffentlich markiert ist.
         4. Setzen Sie den Optionstyp auf Link.
         5. Klicken Sie auf Speichern.

      4. 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 Kunde und führen das Ereignis Approve aus.
         4. Setzen Sie den Optionstyp auf SMS-Antwort.
         5. Klicken Sie auf Speichern.

   4. Dieses Beispiel setzt voraus, dass die Seite Kunden bereits als Öffentlich markiert ist und ein Ereignis namens Request Approval in ihrem ersten Panel definiert ist. 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 Geschäftslogik.
      3. Klicken Sie auf die Schaltfläche Ereignisse.
      4. Wählen Sie das Ereignis aus. Beispiel: Request Approval.
      5. Klicken Sie im Bereich Aktionen auf Vorhandene registrieren.
      6. Wählen Sie Benachrichtigung als Aktionstyp.
      7. Wählen Sie die Benachrichtigung aus, die wir im vorherigen Schritt erstellt haben. Beispiel: Customer_RequestApprovalSms.
      8. Klicken Sie auf Speichern.
      9. Überprüfen Sie, dass die expliziten Bindungen korrekt sind. Beispiel: CustomerId - CustomerId.

   5. 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 wurden und die App Builder automatisch an einen bestimmten Empfänger sendet, wenn ein Geschäftsereignis auftritt, sind Systembenachrichtigungen Rundschreiben, die ein Administrator manuell sendet oder zeitgesteuert später an eine Gruppe von Benutzern auf einmal versendet, z. B. an alle Benutzer mit Zugriff auf eine Anwendung oder an eine bestimmte Sicherheitsgruppe oder Rolle. Administratoren nutzen Systembenachrichtigungen für Dinge wie geplante Wartungsfenster oder Anwendungsupdates, die nicht an einen bestimmten Datensatz gebunden oder durch ein Ereignis ausgelöst werden müssen.

Systembenachrichtigungen werden aktiven Benutzern angezeigt und verbleiben in ihrem Benachrichtigungscenter (unter dem Hamburger-Menü), bis sie abgewiesen oder abgelaufen sind. Systembenachrichtigungen sind Teil der Funktion Wartung 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 > Wartung und dann die Registerkarte Benachrichtigungen (verfügbar ab App Builder 4.44). Führen Sie dann diese Schritte aus:

1. Klicken Sie im Bereich Geplante Benachrichtigungen auf die Schaltfläche Zeitplan oder sofort senden.

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

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

     • Alle

     • Eine Gruppe von Benutzern basierend auf:

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

       • Sicherheitsgruppen.

       • Die Rollen der Datenquelle.

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

   • Zeitplan für: (Optional) Planen Sie, dass eine Benachrichtigung später gesendet wird (z. B. eine Stunde vor einem geplanten Anwendungsupdate).

   • Läuft ab am: Ein Datum/eine Uhrzeit, zu der die Benachrichtigung abläuft und nicht mehr für Benutzer angezeigt wird. Zu diesem Zeitpunkt wird die Benachrichtigung aus ihren Benachrichtigungscentern entfernt für Benutzer, 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 den Benutzer zu ändern, der den Dienst ausführt, gehen Sie wie folgt vor:

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

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