Beziehungsgraph

Die Avonni Relationship Graph-Komponente bietet eine leistungsstarke und intuitive Möglichkeit, Verbindungen und hierarchische Beziehungen zwischen Salesforce-Datensätzen direkt auf Ihren Lightning-Seiten zu visualisieren. Gehen Sie über einfache Listen hinaus und sehen Sie, wie Ihre Daten wirklich verbunden sind.

Übersicht

Diese Komponente stellt Daten als interaktives Diagramm dar und zeigt Knoten (die Datensätze darstellen) und Linien (die Beziehungen darstellen). Sie eignet sich ideal zum Verständnis komplexer Strukturen wie Kontohierarchien, Organigramme oder Abhängigkeiten zwischen verschiedenen Datensätzen.

Hauptfunktionen

• Visuelle Beziehungszuordnung: Eltern-Kind- und gegebenenfalls andere Nachschlagebeziehungen in einem grafischen Format darstellen.

• Hierarchische Datenanzeige: Unterstützt mehrstufige Verschachtelung (z. B. Konto -> Kontakte -> Fälle).

• Interaktive Erkundung: Benutzer können Knoten häufig erweitern und reduzieren (abhängig von der Konfiguration).

• Datengetrieben: Wird mithilfe der leistungsstarken Avonni Nested Query-Datenquelle befüllt.

• Knotenanpassung: Steuern Sie die Informationen, die auf jedem Knoten angezeigt werden, einschließlich Bezeichnung, Symbol und zusätzlichen Feldern.

• Interaktive Knoten: Fügen Sie dem Eltern- oder Kindknoten im Diagramm direkte Interaktionen hinzu.

Anwendungsfälle

• Visualisierung von Kontohierarchien mit zugehörigen Kontakten und Opportunities.

• Anzeige von Organigrammen (z. B. Benutzerhierarchien basierend auf dem ManagerId Feld).

• Abbildung von Produktstrukturen (z. B. Produktbündel und deren Komponenten).

• Anzeigen von Fallabhängigkeiten oder zugehörigen Knowledge-Artikeln.

• Visualisierung komplexer Projektstrukturen mit Eltern-/Kindaufgaben.

Hinzufügen der Relationship Graph-Komponente

Drag & Drop: Finden Sie in der Komponentenbibliothek (linkes Bedienfeld) die Komponente „Relationship Graph“ und ziehen Sie sie auf Ihre Leinwand.

Konfiguration

Wählen Sie die Relationship Graph-Komponente auf der Leinwand aus, um ihre Eigenschaften im Eigenschaftenbereich aufzurufen. Die Konfiguration umfasst das Verbinden mit Daten, das Zuordnen, wie Daten angezeigt werden, und das Anpassen des Verhaltens.

Verbindung mit hierarchischen Daten (Datenquelle)

Der Relationship Graph ist dafür ausgelegt, mit hierarchischen Daten zu arbeiten. Die primäre Möglichkeit, diese Daten bereitzustellen, ist die Verwendung der Avonni Nested Query-Datenquelle.

1

Datenquelle auswählen

Legen Sie im Eigenschaftenbereich die Datenquelle Eigenschaft auf Avonni Nested Query-Datenquelle.

2

Verschachtelte Abfrage konfigurieren

Klicken Sie auf Abfrage erstellen oder Abfrage bearbeiten.

• Abfrage des übergeordneten Objekts: Definieren Sie die Abfrage für Ihre Top-Level-Datensätze (z. B. Objekt: Account). Fügen Sie bei Bedarf Filter hinzu.

• Kindobjekt(e) hinzufügen: Fügen Sie im Nested Query-Builder Kindbeziehungen hinzu.

  • Wählen Sie das Kindobjekt (z. B. Contact).

  • Geben Sie das Beziehungsfeld am Kind- Objekt an, das es mit dem Eltern- Objekt verbindet (z. B. AccountId bei Contact).

• Weitere Verschachtelung hinzufügen (optional): Sie können gegebenenfalls eine weitere Ebene hinzufügen (z. B. fügen Sie Case als Kind von Contacthinzu und verwenden das ContactId Beziehungsfeld).

• Mehrere übergeordnete Objekte (optional): Je nach Fähigkeit der Komponente könnten Sie mehrere unabhängige übergeordnete Abfragen hinzufügen, wenn Sie unterschiedliche Start-Hierarchien im selben Diagramm anzeigen möchten.

• Abfrage speichern: Speichern Sie Ihre Nested Query-Definition.

Daten auf Graph-Knoten abbilden (Datenzuordnungen)

Dieser wichtige Abschnitt definiert wie die Daten aus jeder Ebene Ihrer Nested Query visuell auf den Graph-Knoten angezeigt werden.

1

Auf Datenzuordnungen zugreifen

Im Eigenschaftenbereich finden Sie den Abschnitt „Datenzuordnungen“ .

2

Elementebene auswählen

In der Regel sehen Sie Abschnitte, die den in Ihrer Nested Query definierten Ebenen entsprechen (z. B. „Account Item“, „Contact Item“, „Case Item“). Wählen Sie die Ebene aus, die Sie konfigurieren möchten.

3

Attribute für jede Ebene zuordnen

Für die ausgewählte Elementebene (z. B. Account):

• Bezeichnung: Wählen Sie das Feld aus den Abfrageergebnissen aus, das den primären Anzeigetext für den Knoten darstellen soll (z. B. Account.Name).

• Symbolname (optional): Wählen Sie ein Feld mit einem SLDS-Symbolnamen oder geben Sie einen statischen Symbolnamen ein (z. B. standard:account) um ein Symbol auf dem Knoten anzuzeigen.

• Zusätzliche Felder (optional): Fügen Sie weitere Felder aus der Abfrage hinzu, die Sie als sekundäre Informationen auf dem Knoten anzeigen möchten.

• Erweitert (optional - für Elternknoten): (Boolean) Legen Sie fest, ob die Knoten dieser Ebene standardmäßig erweitert sein sollen, um ihre Kinder beim Laden des Diagramms anzuzeigen. Binden Sie an ein Boolesches Feld oder legen Sie einen statischen Wert fest.

4

Zuordnungen wiederholen

Wiederholen Sie Schritt 3 für jede Elementebene (z. B. konfigurieren Sie Zuordnungen für Kontakte und dann für Fälle).

Kopfzeilenkonfiguration

Passen Sie die über dem Diagramm angezeigte Kopfzeile an.

• Titel: (Text) Geben Sie einen Titel für das Diagramm ein (z. B. „Account Relationships“).

• Symbolname: (Text, optional) Ein Symbol für die Kopfzeile.

• Aktionen: (Aktionen, optional) Fügen Sie Kopfzeilen-Schaltflächen für Aktionen hinzu, die sich auf das gesamte Diagramm beziehen (z. B. „Alle erweitern“, „Alle reduzieren“, „Aktualisieren“). Diese verwenden standardmäßige Avonni-Interaktionen.

Knotenkonfiguration

Passen Sie das Erscheinungsbild der Erweitern-/Reduzieren-Steuerelemente an Knoten mit Kindern an.

• Symbolname für Erweitern: (Text) Symbolname für die Schaltfläche zum Erweitern eines Knotens (z. B. utility:add).

• Symbolname für Reduzieren: (Text) Symbolname für die Schaltfläche zum Reduzieren eines Knotens (z. B. utility:dash).

Interaktionskonfiguration

Fügen Sie den Graph-Knoten direkte Interaktivität hinzu. Interaktionen werden typischerweise im Abschnitt „Datenzuordnungen“ Abschnitt für jede Elementebene oder gegebenenfalls als allgemeine Komponenteninteraktionen konfiguriert.

• Gruppen-/Elternknoten-Aktionen: Definieren Sie Interaktionen, die durch Klicken auf die obersten (Eltern-)Knoten ausgelöst werden.

• Element-/Kindknoten-Aktionen: Definieren Sie Interaktionen, die durch Klicken auf einzelne Kindknoten ausgelöst werden.

• Gängige Interaktionsaktionen für Graph-Knoten:

  • Navigieren: Verwenden Sie dies, um den Benutzer zu einer anderen Seite zu leiten. Ein sehr häufiger Anwendungsfall ist das Öffnen der Datensatzseite für den angeklickten Knoten.

    • Konfigurationsbeispiel: Setzen Sie den Seitereferenztyp auf Datensatzseite, wählen Sie den korrekten Objekt-API-Namen für diese Knotenebene und setzen Sie die Datensatz-ID auf das Item Name Attribut, das Sie für diesen Knoten zugeordnet haben.

  • Flow-Dialog öffnen / Flow-Panel öffnen: Starten Sie einen Screen Flow in einem Modal oder Seitenbereich, um den Benutzer durch einen mit dem angeklickten Knoten verbundenen Prozess zu führen (z. B. Details bearbeiten, eine zugehörige Aufgabe erstellen, einen Anruf protokollieren).

    • Konfigurationsbeispiel: Wählen Sie den gewünschten Screen Flow aus und übergeben Sie die ID des angeklickten Knotens (mithilfe des Item Name Attributs) als Eingabevariable an den Flow.

  • Flow ausführen: Lösen Sie einen autostarteten Flow für Hintergrundverarbeitung im Zusammenhang mit dem angeklickten Knoten aus (z. B. Aktualisierung des Datensatzstatus, Senden einer E-Mail-Benachrichtigung oder Erstellen einer Standardaufgabe).

    • Konfigurationsbeispiel: Wählen Sie den relevanten autostarteten Flow aus und übergeben Sie die ID des Knotens (aus Item Name) als Eingabevariable.

  • Toast anzeigen: Zeigen Sie dem Benutzer eine kurze Informationsnachricht an, die möglicherweise Details aus anderen Feldern enthält, die für den angeklickten Knoten zugeordnet sind

Beispiel: Konto -> Kontakt -> Fall-Hierarchie

1. Datenquelle (Verschachtelte Abfrage):

   • Eltern: Account

   • Kind 1: Contact (Verknüpft über AccountId,

   • Kind 2 (unter Contact verschachtelt): Case (Verknüpft über ContactId,)

2. Datenzuordnungen:

   • Account-Element: Bezeichnung: Name, Symbolname: standard:account, Erweitert: true

   • Contact-Element: Bezeichnung: Name, Symbolname: standard:contact

   • Case-Element: Bezeichnung: CaseNumber, Item Name: Id, Symbolname: standard:case, Zusätzliche Felder: Status

Ergebnis: Ein interaktives Diagramm, das Konten zeigt, die erweiterbar sind, um zugehörige Kontakte anzuzeigen, welche wiederum erweiterbar sind, um zugehörige Fälle anzuzeigen. Ein Klick auf einen Knoten navigiert zu seiner Datensatzseite.

Wichtige Überlegungen

• Datenmodell: Erfordert klare Eltern-Kind-Beziehungen (Nachschlagefelder) in Ihren Salesforce-Daten.

• Verschachtelte Abfrageeinrichtung: Das korrekte Konfigurieren der Nested Query-Datenquelle ist entscheidend.

• Leistung: Sehr große oder tief verschachtelte Hierarchien (mit vielen tausend Knoten) können die Ladeleistung erheblich beeinträchtigen. Verwenden Sie nach Möglichkeit Filter in Ihrer Abfrage.

• Klarheit: Gestalten Sie die Anzeige Ihres Diagramms, einschließlich Bezeichnungen und zusätzlicher Felder, so, dass sie klar und übersichtlich ist.

Zusammenfassung

Der Avonni Relationship Graph bietet eine leistungsstarke visuelle Möglichkeit, hierarchische Daten direkt auf Ihren Lightning-Seiten zu erkunden und zu interagieren. Durch die Nutzung verschachtelter Abfragen und die Konfiguration expliziter Datenzuordnungen können Sie komplexe Beziehungen in intuitive, handlungsfähige Visualisierungen ohne Code verwandeln.