YouTube ChannelSchedule a CallSubscribe for Updates

Quick Action öffnen

Übersicht

Die Interaktion „Open Quick Action“ ermöglicht es Ihnen, Salesforce-Quick-Actions direkt aus einer Avonni Dynamic Component heraus zu starten. Dadurch können standardmäßige oder benutzerdefinierte Quick Actions nahtlos ausgelöst werden, ohne dass Benutzer zu Datensatzdetailseiten navigieren müssen, was Arbeitsabläufe vereinfacht und die Dateneingabe beschleunigt.

Konfiguration

Die Interaktion „Open Quick Action“ verbindet eine Benutzeraktion (z. B. das Klicken auf eine Schaltfläche) mit einer Salesforce-Quick-Action. Bei Konfiguration öffnet sie das Quick-Action-Modal, füllt optional Formularfelder vor und übergibt Kontextinformationen wie Datensatz-IDs.

Fügen Sie diese Interaktion jedem unterstützten Avonni-Komponent über das Eigenschaftsfenster der Komponente unter „Interactions“ hinzu. Wählen Sie als Interaktionstyp „Open Quick Action“ aus.

Zielname

Hier wählen Sie aus, welche Aktion an Ihrer Komponente die Quick Action auslösen soll. Wenn Sie Aktionen zu Komponenten hinzufügen (z. B. Header-Aktionen in einer Datentabelle oder Zeilenaktionen), werden diese in diesem Dropdown verfügbar.

Wie es funktioniert

  • Zuerst erstellen Sie eine Aktion an Ihrer Komponente (z. B. eine „Send Email“ als Zeilenaktion in einer Datentabelle)

  • Dieser Aktionsname erscheint dann als Option im Dropdown für den Zielnamen

  • Wählen Sie die Aktion aus, die Sie mit dieser Quick-Action-Interaktion verbinden möchten

Beispiel: Wenn Sie Ihrer Datentabelle eine Zeilenaktion namens „Send Email“ hinzugefügt haben, würden Sie „Send Email“ im Dropdown für den Zielnamen auswählen, um diese Aktion mit der Quick Action zu verknüpfen.

Quellobjekt

Dies legt den Objektkontext für Ihre Quick Action fest:

  • Für objektspezifische Quick Actions: Geben Sie den API-Namen des Standard- oder benutzerdefinierten Objekts ein (z. B. Kontakt, Konto, Opportunity, Benutzerdefiniertes_Objekt__c)

  • Für globale Quick Actions: Lassen Sie dieses Feld leer

Warum das wichtig ist: Objektspezifische Quick Actions sind an ein bestimmtes Objekt gebunden und erscheinen im Aktionsmenü dieses Objekts. Globale Quick Actions funktionieren organisationsweit und sind nicht an ein bestimmtes Objekt gebunden.

Quick Action API-Name

Dies ist der API-Name der Quick Action, die Sie starten möchten. Das Format hängt davon ab, ob sie objektspezifisch oder global ist:

Für objektspezifische Quick Actions: Fügen Sie vor dem API-Namen der Quick Action den API-Namen des Objekts gefolgt von einem Punkt (.) ein.

Format: ObjectAPIName.QuickActionAPIName

Beispiele:

  • Contact.SendEmail - Send Email-Aktion auf dem Contact-Objekt

  • Account.LogACall - Log a Call-Aktion auf dem Account-Objekt

  • Opportunity.NewTask - Create Task-Aktion auf dem Opportunity-Objekt

  • Custom_Object__c.Custom_Action__c - Benutzerdefinierte Aktion auf einem benutzerdefinierten Objekt

Für globale Quick Actions: Verwenden Sie nur den API-Namen der Quick Action (kein Objektpräfix).

Beispiele:

  • NewContact - Globale Aktion zum Erstellen eines Kontakts

  • NewTask - Globale Aktion zum Erstellen einer Aufgabe

  • LogACall - Globale Aktion zum Protokollieren eines Anrufs

  • SendEmail - Globale Aktion zum Senden einer E-Mail

So finden Sie den API-Namen:

  • Gehen Sie zu Setup → Object Manager → [Ihr Objekt] → Buttons, Links and Actions

  • Oder Setup → Global Actions (für globale Aktionen)

  • Suchen Sie Ihre Aktion und notieren Sie ihren API-Namen

Datensatz-ID (Optional)

Dies gibt an, mit welchem Datensatz die Quick Action verknüpft sein oder welchen Kontext sie verwenden soll. Geben Sie eine Referenz auf ein Feld oder eine Variable ein, die die Datensatz-ID enthält.

Häufige Verwendungszwecke:

  • record:Id - Der aktuell betrachtete Datensatz (falls auf einer Datensatzseite)

  • {!Datatable1.selectedRowsKeyValue} - Der aus einer Datentabelle ausgewählte Datensatz

  • {!variableName} - Eine Variable, die eine Datensatz-ID speichert

Wann die Datensatz-ID verwendet werden sollte:

  • Wenn die Quick Action wissen muss, auf welchen Datensatz sie sich bezieht

  • Für Aktionen wie „Send Email“, die einen zugehörigen Datensatz benötigen

  • Zum Erstellen zugehöriger Datensätze (z. B. Erstellen einer Aufgabe, die mit einem Account verknüpft ist)

Vorausgefüllte Werte (Optional)

Damit können Sie Felder im Quick-Action-Formular automatisch vor dem Öffnen ausfüllen, was Benutzern Zeit spart und die Konsistenz der Daten gewährleistet.

Für jeden vorausgefüllten Wert:

  • Feld-API-Name: Der API-Name des Feldes in der Quick Action, das Sie vorausfüllen möchten (z. B. Betreff, Status, Priorität)

  • Wert: Was Sie eintragen möchten – dies kann sein:

    • Ein statischer Wert (z. B. „Follow-up Call“)

    • Ein dynamischer Wert aus Ihrer Komponente (z. B. {!accountName.value})

    • Eine Ressourcenvariable (z. B. {!selectedStatus})

Beispielszenarien:

  • Füllen Sie das Betreff-Feld einer Aufgabe mit „Follow-up: " + Kontoname voraus

  • Setzen Sie den Status eines neuen Falls auf „Neu“

  • Füllen Sie das Feld „Related To“ mit der aktuellen Account-ID

  • Setzen Sie die Priorität standardmäßig auf „Hoch“ für dringende Aktionen

Fehlerbehebung

Die Quick Action öffnet sich nicht

  • Überprüfen Sie, ob der Quick Action API-Name korrekt ist (Groß-/Kleinschreibung beachten)

  • Prüfen Sie, ob die Quick Action in Ihrer Organisation existiert und aktiv ist

  • Stellen Sie sicher, dass Sie das richtige Format verwenden (Object.Action für objektspezifische, nur Action für globale)

  • Überprüfen Sie, ob der Benutzer Berechtigungen hat, auf die Quick Action zuzugreifen

Fehler „Quick Action not found“

  • Überprüfen Sie den API-Namen in Setup noch einmal

  • Stellen Sie sicher, dass Sie bei objektspezifischen Aktionen den Objektnamen angegeben haben (z. B. Contact.SendEmail)

  • Für globale Aktionen stellen Sie sicher, dass Sie kein Objektpräfix hinzugefügt haben

Datensatz-ID wird nicht korrekt übergeben

  • Überprüfen Sie, ob der API-Name Ihrer Datentabelle mit dem in der Formel verwendeten übereinstimmt

  • Prüfen Sie, ob in der Tabelle tatsächlich eine Zeile ausgewählt ist

  • Verwenden Sie das richtige Attribut (.selectedRowsKeyValue für Einzelauswahl)

Vorausgefüllte Werte erscheinen nicht

  • Stellen Sie sicher, dass die Feld-API-Namen genau mit den Feldnamen der Quick Action übereinstimmen

  • Prüfen Sie, ob die Felder tatsächlich im Quick-Action-Layout enthalten sind

  • Stellen Sie sicher, dass Ihre Wertausdrücke gültig sind und den richtigen Datentyp zurückgeben

Benutzer sieht einen Fehler beim Absenden der Quick Action

  • Dies ist typischerweise ein Salesforce-Validierungsfehler und kein Konfigurationsproblem

  • Überprüfen Sie Salesforce-Validierungsregeln und Pflichtfelder

  • Stellen Sie sicher, dass vorausgefüllte Werte die Feldanforderungen erfüllen

Brauchen Sie weitere Hilfe?

Wenn Sie Fragen zur Implementierung von Quick-Action-Interaktionen für Ihren spezifischen Anwendungsfall haben oder Probleme mit der Quick-Action-Konfiguration auftreten, zögern Sie nicht, sich an uns zu wenden. Wir sind hier, um Ihnen zu helfen, mit Avonni-Komponenten optimierte Arbeitsabläufe zu erstellen

Zuletzt aktualisiert

War das hilfreich?