Zum Inhalt springen

Benachrichtigungen im Jitterbit App Builder

Einführung

Benachrichtigungen sind Nachrichten, die an angemeldete App-Benutzer gesendet werden, wenn etwas passiert. Sie können über die folgenden Methoden gesendet werden:

  • Email

  • SMS (mit dem Twilio-Dienst)

  • App Builder Alarm (ein In-App-Popup, das angezeigt wird, wenn der Benutzer bei 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 auswählen IDE > Wartung (Beta), und wählen Sie dann die Tab Benachrichtigungen aus, um Benachrichtigungen anzuzeigen und zu verwalten.

Benachrichtigungen

Eine Benachrichtigungsnachricht kann mehrere Optionen enthalten, die definieren, wie der Benutzer reagieren kann.

Bei Emails und App Builder-Benachrichtigungen sind in der Nachricht URLs enthalten, die zurück zum App Builder verweisen.

Bei SMS können Benutzer mit dem Namen der Option antworten, um das zugehörige Ereignis auszuführen.

Benachrichtigungslinks sind 7 Tage lang aktiv. Danach verfallen sie und sind nicht mehr aktiv. (Diese Ablaufzeit kann nicht geändert werden.)

Wenn in einer Benachrichtigung Optionen vorhanden sind, wird die Antwort des Benutzers automatisch vom App Builder verfolgt.

Benachrichtigungen können Dateianhänge verschiedener Dateitypen enthalten (z. B. .PDF, .DOCX, .TXT, .XLSX usw.). Wenn Sie Dateianhänge verwenden, verwendet die Benachrichtigung die data/pdf Verzeichnis, wenn kein anderes Verzeichnis angegeben ist. Alternativ ist dies der Speicherort, an dem App Builder nach den Anhängen sucht, wenn Sie eine FileDataSourceId angeben.

Um die für die Benachrichtigung erforderlichen öffentlichen Datenobjekte zu verwenden, muss App Builder (Sealed) als verfügbare Datenquelle für Ihre Anwendung konfiguriert sein. Zusätzlich zur Verfügbarkeit als Datenquelle für die Anwendung müssen Sie eine Verknüpfung zwischen den Datenquellen herstellen oder konfigurieren.

App Builder verwendet die in der Benachrichtigungsregel angegebenen URL Informationen, sofern verfügbar. Falls diese nicht gefunden werden, greift App Builder auf die Standard URL der Server-Site zurück. Der Standardwert der Server-Site wird unter IDE > Sicherheitsanbieter > Mehr (im Konfigurationsbereich) > Sites konfiguriert. Weitere Informationen zu Sites und URL finden Sie unter Sites und Aliase Artikel.

Optionen

Benachrichtigungen können null oder mehr Optionen enthalten. Wenn keine Optionen vorhanden sind, wird keine Benutzerantwort erwartet. In diesem Fall wird die Benutzerantwort nicht verfolgt und der ausgehenden Nachricht werden keine Links hinzugefügt. Dies gilt als Informationsbenachrichtigung.

Wenn eine Benachrichtigung eine oder mehrere Optionen enthält, wird eine Nachricht mit URL Links zurück an den App Builder gesendet, über die der Benutzer reagieren kann. Die Antwort des Benutzers auf die Nachricht (d. h. welche Option er ausgewählt hat) wird in der Benachrichtigung protokolliert.

Konfiguration

Benachrichtigungsoptionen können auf zwei Arten konfiguriert werden:

  1. Link zur Seite: Über einen Link kann der Nutzer zu einer Seite navigieren. Erfolgreiches Navigieren zur Seite gilt als vollständige Antwort auf die Option.

  2. Seitenereignis ausführen: Über einen Link wird der Nutzer zu einer Seite weitergeleitet und führt ein bestimmtes Ereignis aus, bevor die Seite gerendert wird. Die Antwort des Nutzers gilt als abgeschlossen, sobald das Ereignis ausgelöst wird.

Um eine Seite für eine dieser Optionen nutzen zu können, muss sie als Freigegeben gekennzeichnet sein.

Beispiel

Ein Administrator kann ein Ereignis ausführen, das den Versand einer Email an einen Benutzer auslöst. Die Email enthält Text und die folgenden drei Schaltflächen:

  1. Überprüfung: Durch Klicken wird der Benutzer auf eine bestimmte Seite weitergeleitet.

  2. Genehmigen: Wenn der Benutzer darauf klickt, wird er auf eine andere Seite weitergeleitet und führt ein Ereignis für einige Datenobjekte auf der Seite aus.

  3. Ablehnen: Wenn der Benutzer darauf klickt, wird er auf eine andere Seite weitergeleitet und führt ein Ereignis für dieselbe Seite oder die Datenobjekte einer anderen Seite aus.

Das Ereignis muss vor dem Rendern der Seite ausgeführt werden, da es sich auf Daten in den Seitenbereichen auswirken kann. Um ein Ereignis auszuführen, muss der App-Entwickler Folgendes tun:

  • Konfigurieren Sie die Seite Link zu als Geteilt.

  • Fügen Sie das Ereignis entweder in das Datenobjekt der Seite oder als eine der einzeiligen Datenquellen auf der Seite ein. (Weitere Erläuterungen hierzu finden Sie weiter unten im Abschnitt „Ereignisbindung von Datenobjekten“).

Datenobjekt-Ereignisbindung

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

  • CustomerCustomerAddressCustomerMap- EmployeeEmployeeAddressEmployeeMap in diesem Beispiel Customer Und Employee Panels sind nicht an andere Panels auf der Seite gebunden. Daher kann ein Entwickler Ereignisse aus diesen beiden Panel-Datenquellen auswählen (zusammen mit einem Seitendatenobjekt, falls eines angegeben ist).

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

Benachrichtigungsregistrierung

Verknüpfen mit einer Benachrichtigung

Auf der Seite Benachrichtigungsregistrierung im App Builder kann der Entwickler eine Benachrichtigung mit einer Anwendung 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 vorgenommen und verwenden die {{fieldname}} Syntax. Ersetzungen können eine optionale url Flag, um anzuzeigen, dass der Wert eine URL ist und eine URL-Kodierung erfordert, z. B. {{Feldname|url}}.

Zur Substitution kann der Text enthalten:

Hello {{CustomerName}},

In diesem Beispiel CustomerName muss 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:

  1. Benachrichtigungsoption Name.

  2. Benachrichtigungsregistrierung Nachricht.

  3. Benachrichtigungsregistrierung Betreff (für Emails).

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

Einschränkungen

  1. Das im Optionslink ausgeführte Ereignis gehört zu den Seitendaten oder einem einzeiligen Panel-Datenobjekt. Derzeit werden für Ereignisse auf Seitenebene keine Validierungsergebnisse oder Post-Meldungen angezeigt. Das heißt, das Ereignis wird zuerst ausgeführt. Nach Abschluss wird der Benutzer auf seine Seite umgeleitet. Beim Erreichen der Seite gehen die Ereignisergebnisse verloren. Wenn das Ereignis eine Post-Meldung enthält oder die Validierung fehlschlägt, zeigt das System dem Endbenutzer diese Ergebnisse daher nicht an. Entwickler können dies einfach umgehen, indem sie in ihren Panels Daten anzeigen, 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 verfügen über keine Benutzeroberfläche, die es dem Benutzer ermöglicht, die Warnung zu akzeptieren oder abzulehnen.

  2. 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

Die folgenden Spalten sind in allen öffentlichen Benachrichtigungsdatenobjekten gleich:

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

Email

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

Notiz

Wenn Sie zum Senden an oder in CC mehr als eine Email-Adresse verwenden, trennen Sie die Werte durch ein Komma.

Name Obligatorisch Mehrere Ziele Beispiel Beschreibung
An() Ja Ja 'user1@zudy.com,user2@zudy.com' Komma-getrennte Liste der 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 Exception wird ausgelöst, wenn dieses Feld nicht angegeben wird oder leer 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 für die automatische Verkettung angegeben werden.
Von Nein Nein 'noreply@zudy.com' Definiert die Absenderadresse für die Email. Wenn „Von“ nicht angegeben ist, wird die im Be_NotificationEndpoint-Datensatz definierte Absenderadresse verwendet.
App BuilderUrl Hängt ab Nein ' https://example.com/MyApp Builder' App BuilderUrl ist obligatorisch, wenn die Benachrichtigung Optionen enthält. Diese URL wird zum Generieren von Links zu den verschiedenen Benachrichtigungsoptionen verwendet. Dies ist die URL, um App Builder aus Sicht des Nachrichtenempfängers zu erreichen. Ein abschließender Schrägstrich ist nicht erforderlich.
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. Auch der Name der Benachrichtigungsoptionen wird übersetzt.

Textnachricht

Das öffentliche Datenobjekt Textnachricht wird zum Versenden 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 an mehrere Empfänger gesendet werden. Eine Ausnahme wird ausgelöst, wenn dieses Feld nicht angegeben oder leer ist.
Sprache Nein Nein 'es' Falls angegeben, werden Übersetzungen für das Feld „Vorlage“ der zugehörigen Benachrichtigungsregistrierung versucht. Auch der Name der Benachrichtigungsoptionen wird in einer zukünftigen Version übersetzt.

App Builder Alarm

Das öffentliche Datenobjekt App Builder Alert ähnelt dem öffentlichen Datenobjekt Create_Notification, ist aber nicht vollständig mit diesem konsistent. Die Spalten des öffentlichen Datenobjekts App Builder Alert lauten wie folgt:

Name Obligatorisch Mehrere Ziele Beispiel Beschreibung
An() Ja Nein alle Diese Spalte stellt den Benutzer dar, an den wir senden. Eine Ausnahme wird ausgelöst, wenn dieses Feld nicht angegeben oder leer ist. Sie können die folgenden speziellen Ausdrücke verwenden:
  • 'session', um die Sitzung des aktuellen Benutzers anzusprechen.
  • 'all', um alle aktuell angemeldeten Benutzer anzusprechen.
  • Um an einen oder mehrere bestimmte Benutzer zu senden, geben Sie deren UserId-Werte durch Kommas getrennt an.
  • Um an eine Gruppe, Rolle, Anwendung, Datenquelle oder eine bekannte Sitzung zu senden, verwenden Sie Recipient() Laufzeit.
Von Nein Nein who('userid') Diese Spalte gibt den Benutzer an, von dem diese Nachricht stammt. Falls 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 „Ablehnen“, mit der die Warnung aus dem Benachrichtigungsfeld des Benutzers entfernt wird. Der Benutzer kann die Warnung ignorieren, das Fenster schließen oder sich vom App Builder abmelden. Wenn „Persistent“ true (1) ist, wird die Warnung bei jeder Anmeldung beim App Builder wiederholt angezeigt, bis der Benutzer die Warnung aktiv ablehnt. Verwenden Sie diese Technik, um sicherzustellen, dass eine Warnung vom Benutzer gelesen wird.
Timeout Nein Nein 15 Falls angegeben, gibt Timeout die Zeitspanne (in Sekunden) an, die gewartet werden soll, bevor das Warn-Popup automatisch geschlossen wird.
SendToPushNotificationEnabledUser Nein Nein 0 Falls angegeben, kann die App Builder Benachrichtigung so konfiguriert werden, dass sie nur an Benutzer gesendet wird, deren Gerät keine Push-Benachrichtigungen unterstützt. Dies ermöglicht es einem Entwickler, gleichzeitig eine App Builder-Benachrichtigung und eine Push-Benachrichtigung zu senden und zu verhindern, dass ein Benutzer sowohl eine Desktop-Benachrichtigung als auch eine Push-Benachrichtigung erhält.

Push-Benachrichtigung

Das öffentliche Datenobjekt Push-Benachrichtigung ermöglicht das Senden einer Push-Benachrichtigung an einen Nutzer. Die Spalten des öffentlichen Datenobjekts Push-Benachrichtigung lauten wie folgt:

Name Obligatorisch Mehrere Zielgruppen 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 besitzt, ist die Benachrichtigungsregel zwar erfolgreich, es wird jedoch keine Nachricht gesendet. Eine Ausnahme wird ausgelöst, wenn dieses Feld nicht angegeben oder leer 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 hiermit die Badge-Nummer auf dem Anwendungssymbol festgelegt.

Benachrichtigungs-Setup

Beispiel für eine Benachrichtigungseinrichtung

Dies sind die erforderlichen Schritte zum Einrichten einer Benachrichtigung. (Dieses Beispiel zeigt das Hinzufügen einer Kundengenehmigungsbenachrichtigung zur Northwinds-Kundenseite.)

  1. Benachrichtigung erstellen: Erstellen Sie eine Regel, die auf ein öffentliches Benachrichtigungsdatenobjekt abzielt:

    1. Navigieren Sie zu App Workbench.
    2. Klicken Sie auf Benachrichtigungen.
    3. Klicken Sie auf + Benachrichtigung.
    4. Weisen Sie einen Namen zu. Beispiel: CustomersRequestApprovalAlert.
    5. Bestätigen Sie, dass der Zweck Benachrichtigung ist.
    6. Wählen Sie App Builder Alert als Ziel. Wenn dieses Datenobjekt nicht verfügbar ist, erstellen Sie eine Datenquellenverbindung zum App Builder (versiegelt) für die App, in der Sie arbeiten.
    7. Klicken Sie auf Speichern.
  2. Definieren Sie die Benachrichtigung mvSQL:

    1. Klicken Sie auf die Schaltfläche +Tabellen.
    2. Fügen Sie Ihre Auswahltabelle hinzu. Zum Beispiel Customers.
    3. Fügen Sie die folgenden Spalten hinzu und klicken Sie zum Definieren auf die Registerkarte Tab:

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

      Hinweis

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

  3. Benachrichtigungsoptionen festlegen:

    1. Navigieren Sie zu App Workbench.
    2. Klicken Sie auf Benachrichtigungen.
    3. Wählen Sie die Benachrichtigungsregel aus. Beispiel: CustomerRequestApprovalAlert.
    4. Geben Sie die Nachrichteninformationen für die Benachrichtigung in das Feld Text ein.

      Beispiel: Bitte bewerten Sie den folgenden Kunden:

      Kunde: {{CustomerName}}

    5. Klicken Sie auf das Bleistiftsymbol und geben Sie die technische Hilfe ein, um anderen Entwicklern die Benachrichtigung zu erläutern.

  4. (Optional) Definieren Sie eine Zielseite und ein auszuführendes Prelaunch-Ereignis:

    1. Wählen Sie auf der Seite App Workbench > Benachrichtigungen die Benachrichtigung aus.
    2. Klicken Sie auf die Schaltfläche + Option.
    3. Erstellen Sie eine neue Option:
      1. Setzen Sie Index auf 10.
      2. Setzen Sie Name auf „Überprüfen“.
      3. Wählen Sie den Wert Link zur Seite. In unserem Beispiel verlinken wir auf die Kundenseite von Northwinds. Sollte die gewünschte Seite nicht angezeigt werden, stellen Sie sicher, dass sie in den Edge Case-Einstellungen als „Geteilt“ markiert ist.
    4. Klicken Sie auf das Häkchen, um den Datensatz zu speichern.
  5. Benachrichtigung mit einem Ereignis registrieren: Benachrichtigung als Aktion mit einem Ereignis registrieren. 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.

    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 Aktionsbereich auf Vorhandene registrieren.
    6. Wählen Sie Benachrichtigung als Aktionstyp.
    7. Wählen Sie die im vorherigen Schritt erstellte Benachrichtigung aus. Beispiel: CustomerRequestApprovalAlert.
    8. Klicken Sie auf Speichern.
    9. Überprüfen Sie, ob die Expliziten Bindungen korrekt sind. Beispiel: CustomerId - CustomerId.
  6. Test: Die Benachrichtigung ist nun vollständig eingerichtet. Navigieren Sie zu Ihrer Seite und klicken Sie auf die Schaltfläche, die das Benachrichtigungsereignis auslöst. Alle App Builder Benutzer im System sollten ein Popup mit der Benachrichtigung sehen.

Beispiel für die Einrichtung einer SMS-Benachrichtigung

So richten Sie eine SMS-Benachrichtigung ein. (Dieses Beispiel zeigt das Hinzufügen einer Kundengenehmigungsbenachrichtigung zur Northwinds-Kundenseite.)

Notiz

Sie benötigen ein Twilio-Konto, um die Einrichtung abzuschließen.

  1. App Builder Sicherheit einrichten

    1. Navigieren Sie zu IDE > Sicherheitsanbieter.
    2. Klicken Sie im Bereich „Benutzerauthentifizierung“ auf + Benutzerauthentifizierung.
      1. Geben Sie einen Namen ein (z. B. Http Basic Auth).
      2. Wählen Sie HTTP-Basisauthentifizierung als Typ.
      3. Klicken Sie zum Aktivieren auf Aktiviert.
      4. Klicken Sie auf Speichern.
    3. Navigieren Sie zu IDE > Benutzerverwaltung.
      1. Doppelklicken Sie auf den Benutzerdatensatz, als den Sie sich authentifizieren möchten, wenn eine SMS-Antwort eingeht.
      2. Beachten Sie, dass dieser Benutzer Zugriff auf Folgendes haben muss:
        • App Builder Anwendung.
        • Das Ereignis, das bei der Benachrichtigung selbst ausgeführt wird.
    4. Klicken Sie unter Authentifizierung auf das Symbol Schlüssel.
    5. Klicken Sie auf Erstellen.
    6. Wählen Sie den zuvor erstellten Http Basic Auth-Anbieter aus.
    7. 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.

  2. Twilio einrichten:

    1. Messaging-Dienst erstellen:

      1. Melden Sie sich bei Ihrem Twilio Konto an.
      2. Navigieren Sie zu Communications Cloud > Programmierbare SMS.
      3. Klicken Sie auf Messaging-Dienste.
      4. Erstellen Sie einen neuen Nachrichtendienst (Benachrichtigungen, bidirektional) und fügen Sie ihm 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 „Eingehende Nachricht verarbeiten“.
      7. 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
    2. Twilio-Anmeldeinformationen sammeln

      1. Navigieren Sie zu Konsolen-Dashboard > Einstellungen.
      2. Notieren Sie die LIVE-Anmeldeinformationen:
        • Kontoseite
        • Authentifizierungstoken
  3. SMS- Endpoint konfigurieren:

    1. Navigieren Sie zu IDE > Benachrichtigungsserver.
    2. Doppelklicken Sie auf den „SMS“-Eintrag.
    3. Fügen Sie die folgende Konfiguration hinzu:
      • Benutzername: Twilio-Kontoseite
      • Passwort: Twilio-Authentifizierungstoken
      • MessagingServiceSid: Twilio Messaging Service Sid
  4. Website URL konfigurieren:

    1. Navigieren Sie zu IDE > Sicherheitsanbieter.
    2. Klicken Sie unter „Konfiguration“ auf Mehr > Sites.
    3. Klicken Sie auf + Site.
    4. Legen Sie den URL Wert auf die URL Ihrer Website fest. Beispiel: https://vinyl.zudy.com.
    5. Klicken Sie auf Speichern.
  5. SMS-Benachrichtigung konfigurieren:

    1. Benachrichtigung erstellen: Erstellen Sie eine Regel, die auf ein öffentliches Benachrichtigungsdatenobjekt abzielt:

      1. Navigieren Sie zu App Workbench > Benachrichtigungen.
      2. Klicken Sie auf + Benachrichtigung.
      3. Weisen Sie einen Namen zu.
      4. Wählen Sie Benachrichtigung als Zweck.
      5. Wählen Sie Textnachricht als Ziel. Wenn dieses Datenobjekt nicht verfügbar ist, erstellen Sie eine Datenquellenverbindung zum App Builder (versiegelt) für die App, in der Sie arbeiten.
      6. Klicken Sie auf Speichern.
    2. Definieren Sie die Benachrichtigung mvSQL:

      1. Klicken Sie auf die Schaltfläche +Tabelle und fügen Sie die Tabelle hinzu, die die Regel erfordert. Beispiel: Customers.

      2. 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".Kunden-ID Kunden-ID Binding()
        "C".Kundenname Kundenname

        Notiz

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

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

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

        Reply {{1}} to approve {{CustomerName}}. Review {{Rezension}}
        
      3. Klicken Sie im Optionenfeld auf die Schaltfläche „+Option“:

        1. Setzen Sie Index auf 10.
        2. Setzen Sie Name auf „Überprüfung“.
        3. Wählen Sie die zu verlinkende Seite aus. In unserem Beispiel verlinken wir auf die Kundenseite von Northwinds. Sollte die gewünschte Seite nicht angezeigt werden, stellen Sie sicher, dass sie in den Edge Case-Einstellungen als „Freigegeben“ markiert ist.

        4. Setzen Sie die Option Typ auf „Link“. 4. Klicken Sie im Optionsfeld auf die Schaltfläche „+Option“.

        5. Setzen Sie Index auf 20.
        6. Setzen Sie Name auf 1.
        7. Wählen Sie die zu verlinkende Seite aus. In unserem Beispiel verlinken wir auf die Northwinds-Seite „Kunde“ und führen das Ereignis „Genehmigen“ aus.
        8. Setzen Sie die Option Typ auf „SMS-Antwort“.
    4. 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 gehen außerdem davon aus, dass das Ereignis „Genehmigung anfordern“ heißt:

      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: Genehmigung anfordern.
      5. Klicken Sie im Aktionsbereich auf Vorhandenes registrieren.
      6. Wählen Sie Benachrichtigung als Aktions-Typ aus.
      7. Wählen Sie die im vorherigen Schritt erstellte Benachrichtigung aus. Beispiel: Customer_RequestApprovalSms.
      8. Klicken Sie auf Speichern.
      9. Überprüfen Sie, ob die Expliziten Bindungen korrekt sind. Beispiel: Z. B. CustomerId- CustomerId.
    5. Push-Benachrichtigungen konfigurieren: Push-Benachrichtigungen werden ähnlich wie andere Benachrichtigungen im App Builder konfiguriert. Der Serveradministrator des App Builder muss den Endpoint für Push-Benachrichtigungen korrekt konfigurieren, damit diese 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 Push-Benachrichtigungen in der App selbst aktivieren. Zusätzlich ist ein API Schlüssel erforderlich, um die Konfiguration abzuschließen.

    6. Test: Die Benachrichtigung ist nun vollständig eingerichtet. Navigieren Sie zu Ihrer Seite und klicken Sie auf die Schaltfläche, die das Benachrichtigungsereignis ausführt.

Systembenachrichtigungen

Systembenachrichtigungen werden aktiven Nutzern angezeigt und verbleiben nach dem Schließen in deren Benachrichtigungscenter (unter dem Hamburger-Menü).

Administratoren können Systembenachrichtigungen sofort versenden oder deren Versand planen.

So richten Sie eine Systembenachrichtigung ein:

  1. Wählen Sie IDE > Wartung (Beta), und wählen Sie dann die Tab Benachrichtigungen aus.

  2. Klicken Sie im Bereich Geplante Benachrichtigungen auf die Schaltfläche Planen oder Jetzt senden.

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

    • Zu: Klicken Sie auf das Menü und wählen Sie dann eine der folgenden Optionen aus:

      • Alle
      • Eine Benutzergruppe basierend auf Folgendem:

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

        • Sicherheitsgruppe.

        • Rollen der Datenquelle.

    • Von: Definiert, wer die Benachrichtigung gesendet hat (normalerweise der Servicebenutzer).

    • Planen für: (Optional) Planen Sie eine Benachrichtigung, die später gesendet werden soll (z. B. eine Stunde vor einem geplanten Anwendungsupgrade).

    • Läuft ab am: Ein Datum/eine Uhrzeit, an dem/der die Benachrichtigung abläuft und den Benutzern nicht mehr angezeigt wird. Zu diesem Zeitpunkt wird die Benachrichtigung aus den Benachrichtigungscentern der Benutzer entfernt, die die Nachricht gesehen und abgelehnt haben.

    • Text: Der Inhalt der den Benutzern angezeigten Nachricht.

  4. Klicken Sie auf die Schaltfläche Senden oder Planen.

Ein Hintergrunddienst sendet geplante Benachrichtigungen. Standardmäßig wird der Dienst vom Dienstbenutzer-Konto ausgeführt. So ändern Sie den Benutzer, der den Dienst ausführt:

  1. Wählen Sie IDE > Wartung (Beta), und wählen Sie dann die Tab Einstellungen aus.

  2. Klicken Sie auf das Menü Benutzer für Hintergrundbenachrichtigungen und wählen Sie dann den Benutzer aus, der den Dienst ausführen soll.