Echtzeit-Updates

Überblick

Platform Events ermöglichen Ihren Avonni Dynamic Components (Chat, Kanban, Liste, Datentabelle usw.) auf Änderungen zu lauschen die in Ihrer Salesforce-Organisation stattfinden und ihre Daten automatisch in Echtzeit zu aktualisieren.

Standardmäßig sehen Sie eine Änderung nicht, wenn ein anderer Benutzer oder ein automatisierter Prozess einen Datensatz aktualisiert, während Sie ihn anzeigen, bis Sie die Seite manuell aktualisieren. Dieses Feature löst dieses Problem und stellt sicher, dass Ihre Benutzer stets die aktuellsten Informationen ohne Unterbrechung sehen.

Dieses Handbuch führt Sie durch die einmalige Einrichtung in Salesforce, die erforderlich ist, um diese Funktion zu aktivieren.

Um Echtzeit-Updates zu ermöglichen, benötigen Sie drei Dinge:

  1. Ein Platform Event: Ein „Signal“, das Salesforce sendet, wenn sich etwas ändert.

  2. Ein Trigger Flow: Eine Automatisierung, die das Signal auslöst, wenn ein Datensatz erstellt oder aktualisiert wird.

  3. Komponenten-Konfiguration: Die Avonni Dynamic Component, die auf dieses Signal lauscht.


Konfigurationsdurchgang

Um die Einrichtung zu erklären, verwenden wir ein gängiges Szenario: Einen Case-Chat sofort zu aktualisieren, wenn ein neuer Kommentar gepostet wird.

Das Ziel ist es, die Case-Record-Page darüber zu benachrichtigen, dass eine Änderung stattgefunden hat, damit der Chat aktualisiert werden kann.

1

Erstellen Sie ein Platform Event

Wir benötigen ein benutzerdefiniertes Event-Objekt, das als unser „Benachrichtigungssignal“ fungiert.

  1. Gehen Sie zu Setup > Integrationen > Platform Events.

  2. Klicken Sie auf Neues Platform Event.

  3. Bezeichnung: Geben Sie ein Chat Notification (oder Record Change Event).

  4. Pluralbezeichnung: Chat Notifications.

  5. Veröffentlichungsverhalten: Wählen Sie Publish After Commit.

  6. Klicken Sie auf Speichern.

Fügen Sie ein Payload-Feld hinzu

Wir benötigen ein Feld, das die ID des geänderten Datensatzes trägt, damit die Komponente weiß, welche Daten aktualisiert werden sollen.

  1. Im Bereich "Custom Fields & Relationships" Ihres neuen Platform Events klicken Sie auf Neu.

  2. Wählen Sie Text als Datentyp.

  3. Feldbezeichnung: RecordId.

  4. Länge: 18.

  5. Feldname: RecordId (API-Name wird sein RecordId__c).

  6. Klicken Sie auf Speichern.

Hinweis: Sie können weitere Felder hinzufügen, wenn Sie bestimmte Daten übergeben möchten, aber die Record-ID ist normalerweise ausreichend, um Komponenten zu aktualisieren.

2

Erstellen Sie einen Trigger Flow

Nun müssen wir Salesforce tatsächlich anweisen, dieses Event auszulösen, wenn sich ein Datensatz ändert.

  1. Gehen Sie zu Setup > Process Automation > Flows.

  2. Klicken Sie auf Neuer Flow und wählen Sie Record-Triggered Flow.

  3. Start konfigurieren:

    • Objekt: CaseComment (oder das Objekt, das Ihre Komponente anzeigt).

    • Trigger: Ein Datensatz wird erstellt (oder aktualisiert).

    • Optimieren für: Aktionen und verwandte Datensätze.

  4. Element hinzufügen: Datensätze erstellen.

    • Bezeichnung: Platform Event veröffentlichen.

    • Objekt: Wählen Sie das in Schritt 1 erstellte Platform Event (z. B., Chat Notification).

    • Feldwerte festlegen:

      • RecordId__c{!$Record.ParentId}

    • Warum ParentId? Da der Chat auf der Case Seite angezeigt wird, müssen wir den Case benachrichtigen, dass etwas passiert ist. Wenn ein Kommentar erstellt wird, nehmen wir seine Übergeordneten-ID und senden diese aus.

  5. Speichern und Aktivieren des Flows.

3

Verbinden Sie Ihre Komponente

Jetzt, da das Backend Signale sendet, müssen Sie Ihre Avonni Dynamic Component nur noch „einstellen“.

  1. Öffnen Sie Ihre Komponente im Avonni Component Builder.

  2. Stellen Sie sicher, dass die Datenquelle auf Abfrage.

  3. eingestellt ist Öffnen Sie > Erweiterte Optionen.

  4. Query Refresh EMP

    • Füllen Sie die Einstellungen aus: Kanalname: Der API-Name Ihres Events (z. B.,).

    • Chat_Notification__e Schlüsselfeldname: RecordId__c).

    • Der API-Name des Payload-Feldes (z. B., Schlüsselfeldwert (optional):

      • Leer lassen. Verhalten: RecordId Wenn Sie dieses Feld leer lassen, vergleicht die Komponente automatisch dasdes Events mit dem aktuell auf dem Bildschirm angezeigten Datensatz ({!RecordId}

). Wenn sie übereinstimmen, aktualisiert sie sich. Ergebnis:


Ihre Komponente aktualisiert nun ihre Daten automatisch, wann immer der Flow aus Schritt 2 ausgeführt wird.

Testen Ihrer Konfiguration

  1. Um zu überprüfen, ob Echtzeit-Updates funktionieren: Öffnen Sie Ihre Salesforce-Record-Seite in zwei getrennten Browser-Tabs

  2. (oder verwenden Sie für den zweiten ein Inkognito-Fenster).

  3. Veröffentlichen Sie in Tab 1 eine neue Nachricht (oder aktualisieren Sie einen Datensatz).


Beobachten Sie Tab 2. Die Komponente sollte sich sofort aktualisieren, um die Änderung anzuzeigen, ohne dass Sie auf Aktualisieren klicken.

Fehlerbehebung

  • Wenn die Komponente nicht aktualisiert wird: Berechtigungen prüfen:

  • Stellen Sie sicher, dass der Benutzer die Berechtigung hat, das Platform Event-Objekt zu lesen/zu erstellen. API-Namen prüfen: Stellen Sie sicher, dass Kanalname den __e Suffix enthält und Schlüsselfeldname das.

  • __c Prüfen Sie den Flow-Debug:

Zuletzt aktualisiert

War das hilfreich?