Variable

Variable Ressourcen in Avonni Dynamic Components speichern Daten vorübergehend innerhalb einer Komponente. Sie sind für dynamisches Verhalten unerlässlich, unterscheiden sich jedoch wesentlich von Variablen in Salesforce Flows.

Übersicht

Eine Variable ist ein benannter Container, der einen Wert eines bestimmten Datentyps enthält. Variablen werden verwendet, um:

• Komponentenstatus verfolgen: Den aktuellen Zustand darstellen (z. B. erweitert/zusammengeklappt, angewendeter Filter, Sichtbarkeitskennzeichen).

• Zwischenberechnungen: Vorübergehende Werte während Berechnungen halten.

• Datenübergabe: Daten zwischen verschiedenen Teilen Ihrer Komponente und mit verschachtelten Komponenten teilen (mittels Input/Output).

• Bedingte Logik: Sichtbarkeit steuern oder Aktionen auslösen.

• Record-ID halten: Eine Salesforce-Datensatz-ID halten.

Erstellen einer Variable

1. Ressourcen-Panel: Klicken Sie auf das Ressourcen Schaltfläche.

2. Neue Ressource: Klicken Sie auf "+" oder "Neue Ressource."

3. Wählen Sie "Variable".

4. Konfigurieren:

   • API-Name: Eindeutiger, beschreibender Name (z. B. isPanelVisible, selectedAccountId).

   • Beschreibung (optional): Erklären Sie den Zweck der Variable.

   • Datentyp:

     • Boolean: true oder false.

     • Datum: Ein Datum.

     • Datum/Uhrzeit: Ein Datum und eine Uhrzeit.

     • Zahl: Eine Zahl.

     • Datensatz: Ein Referenz auf einen Salesforce-Datensatz (typischerweise die ID). Verwenden Sie eine "On Load"-Interaktion mit "Get Records", um zu füllen die vollständigen Datensatzdaten bevor wenn die Komponente gerendert wird.

     • Text: Eine Zeichenkette.

   • Mehrere Werte zulassen (Sammlung): Wenn angekreuzt, hält die Variable eine : Navigiert zur Startseite des Objekts (in der Regel eine Listenansicht). von Werten (des gewählten Datentyps).

   • Verfügbarkeit außerhalb dieser Dynamic Component:

     • Verfügbar für Input: Erlaubt einem Eltern- Komponente (oder URL-Parameter), festzulegen den Wert dieser Variable.

     • Verfügbar für Output: Erlaubt einem Eltern- Komponente, um zu lesen den Wert dieser Variable.

   • Anfangswert (optional): Legen Sie einen Standardwert fest.

Verwendung von Variablen

• Werte anzeigen: Binden Sie Komponenten-Eigenschaften (wie den Werteiner Textkomponente) an die Variable.

• Komponenteneigenschaften: Binden Sie Eigenschaften wie Sichtbar oder Deaktiviert an Boolesche Variablen.

• Filter: Verwenden Sie Variablen in Datenquellen-Filtern (z. B. in einer Query-Datenquelle).

• Interaktionen: Übergeben Sie Variablen als Eingabe an Aktionen oder erfassen Sie Aktionsausgaben in Variablen.

• Formeln: Verwenden Sie Variablen innerhalb von Formel-Ressourcen.

Sie aus Variablen aus einer Liste im Eigenschaften-Panel oder in der Interaktionskonfiguration; Sie geben normalerweise keine spezielle Syntax ein.

Wichtige Hinweise: Datenpersistenz (oder deren Fehlen!)

• Datensatzänderung setzt Variablen zurück: Jede Interaktion, die einen Salesforce-Datensatz erstellt, aktualisiert, löscht oder upserted, wird alle Variablen in der Dynamic Component auf ihre Anfangswerte zurücksetzen. Dies ist ein wesentlicher Unterschied zu Flows.

• Workarounds für Persistenz: Wenn Sie Werte über Datensatzänderungen hinweg beibehalten müssen, haben Sie einige Optionen, none von denen keine ideal ist, aber sie sind Workarounds:

  • URL-Parameter: Daten in der URL übergeben. Dies ist begrenzt und kann URLs unübersichtlich machen.

  • Benutzerdefinierte Logik (Flows): Verwenden Sie einen Flow, um die Datensatzaktualisierungen zu handhaben und die Datenpersistenz sorgfältig zu verwalten innerhalb des Flows. Dann übergeben Sie das Endergebnis zurück an die Dynamic Component. Dies ist die robusteste, aber auch komplexeste Option.

  • Lokaler Speicher (Vorsicht): Es könnte möglich sein, die Verwendung des Browser-Local-Storage (über JavaScript) zu prüfen. Dies ist eine fortgeschrittene Technik und hat Einschränkungen sowie Sicherheitsimplikationen.

• Schreibgeschützte Daten Für schreibgeschützte Daten funktioniert es einwandfrei.

• On-Load-Interaktion: Jedes Mal, wenn ein Salesforce-Datensatz aktualisiert wird, wird die On-Load-Interaktion ausgelöst, um den Kontext zu aktualisieren.

Beispiele

Anzeigeder Account-Details (On Load)

1. Erstellen Sie eine Datensatzvariable: currentAccount (Typ: Konto).

2. Fügen Sie Ihrer Komponente eine "On Load"-Interaktion hinzu Dynamic Component:

   • Aktionstyp: Datensätze abrufen

   • Objekt-API-Name: Konto

   • Datensatz-ID: @recordId

   • Felder: Wählen Sie Id, Name, Branche.

   • Datensatzvariable: {!currentAccount}

3. Fügen Sie Textkomponenten hinzu und binden Sie deren Wert Eigenschaften an {!currentAccount.Name}, {!currentAccount.Industry}, usw