Konstante

Überblick

Eine Konstante Ressource ist ein benannter Wert, der festgelegt wird einmal und während des gesamten Lebenszyklus der dynamischen Komponente unverändert bleibt. Dies bietet mehrere Vorteile:

Zentralisierte Konfiguration: Speichern Sie wichtige Werte an einem Ort, sodass sie leicht aktualisiert werden können, ohne mehrere Komponenten oder Interaktionen durchsuchen zu müssen.
Lesbarkeit: Die Verwendung eines beschreibenden Konstantennamens (z. B. DEFAULT_COUNTRY_CODE) macht die Konfiguration Ihrer Komponente leichter verständlich als die Verwendung eines festkodierten Werts (z. B. 'US').
Wartbarkeit: Wenn ein konstanter Wert geändert werden muss (z. B. ein neuer Standard-Ländercode), müssen Sie ihn nur an einem Ort (der Konstantenressource) aktualisieren.
Typensicherheit: Konstanten haben einen definierten Datentyp (Text, Zahl, Boolean usw.), was hilft, Fehler zu vermeiden.

Anwendungsfälle

Hier sind einige häufige Szenarien, in denen Konstantenressourcen hilfreich sind:

Standardwerte: Stellen Sie Standardwerte für Eingabefelder, Filter oder andere Komponenten-Einstellungen bereit. Beispiel: Ein Standard-Ländercode für ein Adressformular.
Konfigurationseinstellungen: Speichern Sie Konfigurationsoptionen, die das Verhalten Ihrer Komponente steuern. Beispiel: Eine maximale Anzahl von Datensätzen, die in einer Liste angezeigt werden sollen.
Nachschlagewerte: Definieren Sie eine Menge fester Werte, die in Vergleichen oder Berechnungen verwendet werden können. Beispiel: Statuscodes, Kategorienamen, Fehlercodes.
API-Endpunkte (vorsichtige Überlegung): Sie könnten eine API-Endpunkt-URL als Konstante speichern, aber seien Sie vorsichtig, wenn sich der Endpunkt ändern könnte (z. B. zwischen Entwicklungs-, Test- und Produktionsumgebungen). Custom Metadata Types oder Named Credentials sind im Allgemeinen bessere Optionen für API-Endpunkte.
Boolesche Flags: Verwenden Sie boolesche Konstanten, um feste Zustände oder Bedingungen darzustellen. Beispiel: IS_DEBUG_MODE (gesetzt auf true oder false).
Record Type Ids: Speichern Sie Record Type Ids.

Erstellen einer Konstantenressource

Um eine Konstante Ressource in Ihrer Avonni Dynamic Component zu erstellen:

Öffnen Sie das Ressourcen-Panel: Klicken Sie auf die Ressourcen Schaltfläche (normalerweise im Seiteneditor oder Komponenten-Panel zu finden).
Erstellen Sie eine neue Ressource: Klicken Sie auf die Schaltfläche, um eine neue Ressource zu erstellen (oft ein "+"-Symbol oder eine Schaltfläche mit der Bezeichnung "Neue Ressource").
Wählen Sie "Konstante": Wählen Sie "Konstante" als Ressourcentyp.
Konfigurieren Sie die Konstante:
- API-Name: Geben Sie einen eindeutigen Bezeichner für die Konstante ein. Verwenden Sie einen beschreibenden Namen, der einer konsistenten Namenskonvention folgt (z. B. DEFAULT_COUNTRY_CODE, MAX_LIST_ITEMS). Dieser Name ist die Referenz, die Sie in Ihrer Komponente verwenden werden. Der API-Name muss eindeutig sein.
- Beschreibung (optional): Geben Sie eine kurze Beschreibung des Zwecks der Konstante an. Dies ist hilfreich für Dokumentation und Wartbarkeit.
- Datentyp: Wählen Sie den passenden Datentyp für die Konstante:
  - Boolean: true oder false.
  - Datum: Ein Datumswert (z. B. 2024-07-26).
  - Datum/Uhrzeit: Ein Datum- und Uhrzeitwert (z. B. 2024-07-26T14:30:00Z).
  - Zahl: Ein numerischer Wert (Ganzzahl oder Dezimalzahl).
  - Datensatz: Wird verwendet, um eine Referenz auf einen Salesforce-Datensatz zu speichern, typischerweise durch dessen ID. Sie werden hier im Allgemeinen nicht alle Felder eines Datensatzes definieren. Stattdessen speichern Sie die 15- oder 18-stellige ID des Datensatzes.
  - Text: Eine Textzeichenfolge.
- Wert: Geben Sie den anfänglichen und einzigen Wert für die Konstante ein. Dieser Wert kann nach der Erstellung der Konstante nicht mehr geändert werden. Der angegebene Wert muss dem Datentyp entsprechen.

Verwendung einer Konstantenressource

Sobald Sie eine Konstantenressource erstellt haben, können Sie diese einfach in der gesamten Konfiguration Ihrer dynamischen Komponente referenzieren. Sie müssen keine spezielle Syntax manuell eingeben. Stattdessen wählen Sie die Konstante aus einer Liste:

Suchen Sie die Eigenschaft: Finden Sie im Eigenschaften-Panel der Komponente (oder in den Einstellungen einer Interaktion) die Eigenschaft, in der Sie den Konstantenwert verwenden möchten. Dies kann ein Filterwert, der Standardwert einer Komponente, der Inhalt eines Textfeldes usw. sein.
Wählen Sie die Ressource aus: Suchen Sie nach einer Dropdown-Liste, einer Auswahl-Schaltfläche oder einem Symbol (oft ein Variablen-/Ressourcen-Symbol) neben der Eigenschaft. Dies zeigt an, dass Sie einen dynamischen Wert wählen können. Klicken Sie darauf.
Wählen Sie Ihre Konstante: Die verfügbaren Ressourcen (Variablen und Konstanten) werden angezeigt. Wählen Sie Ihre Konstantenressource aus der Liste aus. Das System fügt automatisch die korrekte Referenz zur Konstante ein. Sie wird in der Regel zwischen geschweiften Klammern { } angezeigt.

Beispiele:

In einem Filter: Sie konfigurieren einen Filter in einer Datentabelle. Sie möchten nach Landfiltern. Anstatt 'US'einzugeben, klicken Sie auf die Ressourcenauswahl-Schaltfläche neben dem Feld "Wert" und wählen Ihre DEFAULT_COUNTRY_CODE Konstante aus der Liste.
In einer Komponenten-Eigenschaft: Sie legen den Standardwert eines Text-Eingabefeldes fest. Anstatt den Standardwert direkt einzugeben, klicken Sie auf die Ressourcenauswahl-Schaltfläche und wählen Ihre Konstante.
Bedingte Sichtbarkeit: Wenn Sie eine Konstante mit dem Namen SHOW_ADVANCED_OPTIONS vom Typ Boolean erstellt haben, wählen Sie in einer Sichtbarkeitsbedingung Ihre Konstante direkt aus den verfügbaren Ressourcen aus

Wichtige Überlegungen

Unveränderlichkeit: Konstanten können nach ihrer Erstellung nicht geändert werden. Wenn Sie einen Wert benötigen, der sich ändern kann, verwenden Sie stattdessen eine Variable Ressource.
Namenskonventionen: Verwenden Sie klare und konsistente Namenskonventionen für Ihre Konstanten (z. B. alles in Großbuchstaben mit Unterstrichen: MAX_RECORDS).
Datentypen: Wählen Sie den korrekten Datentyp für Ihre Konstante.
Alternativen: Für sensible Daten oder Werte, die außerhalb der Komponente verwaltet werden müssen (z. B. API-Schlüssel, umgebungsspezifische Einstellungen), sollten Sie statt Konstanten Custom Metadata Types, Custom Settings oder Named Credentials in Betracht ziehen.

Zusammenfassung

Konstantenressourcen in Avonni Dynamic Components bieten eine Möglichkeit, feste Werte effizient zu verwalten und tragen zu besser organisierten, lesbaren und wartbaren Komponenten bei. Verwenden Sie sie für Standardwerte, Konfigurationen und Werte, die sich während des Lebenszyklus der Komponente nicht ändern sollten.

Zuletzt aktualisiert vor 5 Tagen

War das hilfreich?

Guten Abend