Felder

Das Avonni Dynamic Components-Paket bietet eine leistungsstarke Möglichkeit, Salesforce-Daten direkt auf Ihren App- und Datensatzseiten anzuzeigen und damit zu interagieren. Um auf Datenfelder in Ihrer Dynamic Component zuzugreifen, verwenden Sie die Registerkarte Felder mit entweder dem API-Namen des Zielobjekts Einstellung oder einer Datensatzvariablen des entsprechenden Objekttyps.

Übersicht

Die Registerkarte Felder ermöglicht es Ihnen, Salesforce-Felder einfach zu Ihren Komponenten hinzuzufügen und datengebundene Elemente zu erstellen ohne Code zu schreiben. Sie können:

Datensatzdaten anzeigen: Feldwerte eines bestimmten Salesforce-Datensatzes anzeigen.
Dateneingabe/Bearbeitung ermöglichen: Benutzer können Feldwerte eingeben oder ändern.
Aktionen auslösen: Verwenden Sie Datensatzdaten in Interaktionen (z. B. um eine Datensatz-ID an einen Flow zu übergeben).

So funktioniert es: Zugriff auf Felder

Die Registerkarte Felder bietet eine praktische Möglichkeit, datengebundene Komponenten zu Ihrer Leinwand hinzuzufügen. Um die Registerkarte Felder zu befüllen, haben Sie zwei Optionen:

Option 1: API-Name des Zielobjekts (für Datensatzseiten und allgemeinen Objektzugriff)

Klicken Sie auf das Einstellungssymbol (oben links im Component Builder).
Stellen Sie den API-Namen des Zielobjekts ein auf den API-Namen des Salesforce-Objekts, mit dem Sie arbeiten möchten (z. B. Account, Contact, My_Custom_Object__c). Dies ist typischerweise das Objekt der Datensatzseite, auf der Sie die Komponente platzieren werden.
Öffnen Sie die Komponentenbibliothek (linkes Bedienfeld) und klicken Sie auf die Felder Registerkarte. Sie sehen nun eine Liste von Feldern des ausgewählten Objekts.
Wenn Sie Felder von hierher ziehen, wird die erstellte Komponente automatisch an die spezielle $Component.record Variable gebunden und mit den Daten des aktuellen Datensatzes vorbefüllt.

Option 2: Datensatzvariable (für bestimmte Datensätze oder benutzerdefinierte Logik)

Erstellen Sie eine Datensatzvariable: Im Ressourcen Bereich erstellen Sie eine neue Variable Ressource und legen Sie ihren Datentyp auf Datensatzfest. Wählen Sie das passende Salesforce-Objekt für den Datensatztyp.
Befüllen der Datensatzvariable: In der Regel verwenden Sie eine "Beim Laden"-Interaktion mit einer "Datensätze abrufen"-Aktion, um einen bestimmten Datensatz abzurufen und in Ihrer Datensatzvariable zu speichern. (Siehe die "Beim Laden-Interaktion"-Dokumentation für Details..
Öffnen Sie die Komponentenbibliothek (linkes Bedienfeld) und klicken Sie auf die Felder Registerkarte. Sie sollten eine Liste von Feldern sehen, die dem Objekttyp der Datensatzvariable entsprechen.
Wenn Sie Felder ziehen, wird die erstellte Komponente an Ihre Datensatzvariable gebunden.

Die `$Component.record` Variable

Wenn Sie den API-Namen des Zielobjekts festlegen, stellt Avonni Dynamic Components automatisch eine spezielle Variable zur Verfügung: $Component.record.

Auf Datensatzseiten: Wenn Ihre Dynamic Component auf einer Datensatzseite, $Component.record die Daten für den aktuellen Datensatzenthält. Zum Beispiel $Component.record.Name würde der Name des Kontos auf einer Kontodatensatzseite gehalten werden.
Nicht auf Datensatzseiten: Wenn Ihre Komponente nicht auf einer Datensatzseite (z. B. auf einer App-Seite) platziert ist, $Component.record kann leer oder undefiniert sein. In solchen Fällen würden Sie häufig eine Abfrage-Datenquelle verwenden, um Daten abzurufen und dann mit diesen Daten statt $Component.record.

Speichern oder Löschen von Feld Daten: Verwendung von Interaktionen

Wenn Sie Felder mithilfe der Felder Registerkarte auf Ihre Dynamic Component-Leinwand ziehen, sind diese typischerweise an Daten gebunden (entweder an die $Component.record globale Variable auf einer Datensatzseite oder an eine spezifische Datensatzvariable-Ressource). Dadurch können Benutzer die Daten ansehen und, falls konfiguriert, direkt innerhalb dieser Komponenten (wie Texteingaben, Auswahllisten usw.) bearbeiten.

Wichtige Informationen

Das Bearbeiten eines Feldes auf der Leinwand speichert diese Änderung nicht automatisch in Salesforce. Sie müssen separate Interaktionen konfigurieren, um Aktionen wie Aktualisierungen speichern, neue Datensätze erstellen oder Datensätze löschen basierend auf den angezeigten oder eingegebenen Daten in diesen Feldern auszuführen. Diese Interaktionen werden meist durch Klicken einer Avonni-Schaltfläche Komponente ausgelöst.

Wichtige Interaktionen für Datensatzoperationen

Hier sind die primären Interaktionen, die Sie verwenden werden, damit Ihre Felder aktiv werden:

Aktualisieren aus Datensatzvariable:
- Anwendungsfall: Verwenden Sie dies, wenn Sie Daten in eine spezifische Datensatzvariable geladen haben (mithilfe einer "Beim Laden" > "Datensätze abrufen"-Aktion oder indem Sie verschiedene Eingabefelder an ihre Felder binden) und Sie Änderungen aus dieser Variable zurück in den entsprechenden Salesforce-Datensatz speichern möchten.
- Wie: Fügen Sie dies dem "Speichern"- oder "Aktualisieren"-Button unter dessen "Beim Klicken"-Ereignis hinzu und stellen Sie sicher, dass Sie die richtige Datensatzvariable in der Konfiguration der Interaktion auswählen.
Erstellen aus Datensatzvariable:
- Anwendungsfall: Verwenden Sie dies, um einen neuen Salesforce-Datensatz zu erstellen, indem Sie Daten verwenden, die Benutzer in Eingabefelder eingegeben haben, die an eine bestimmte Datensatzvariable gebunden sind (häufig bei benutzerdefinierten Formularen).
- Wie: Fügen Sie dies dem "Erstellen", "Absenden" oder "Neu speichern"-Button unter dessen "Beim Klicken"-Ereignis hinzu und wählen Sie die Datensatzvariable aus, die die Daten des neuen Datensatzes enthält.
Upsert aus Datensatzvariable:
- Anwendungsfall: Kombiniert Erstellungs- und Aktualisierungslogik. Es wird einen vorhandenen Datensatz aktualisieren, wenn eine ID in der Datensatzvariable vorhanden ist, oder andernfalls einen neuen erstellen.
- Wie: Konfigurieren Sie es ähnlich wie Erstellen/Aktualisieren und verknüpfen Sie es mit der entsprechenden Datensatzvariable.
Löschen aus Datensatzvariable:
- Anwendungsfall: Löscht den Salesforce-Datensatz, dessen ID in der angegebenen Datensatzvariable steht.
- Wie: Fügen Sie dies dem "Löschen"-Button unter dessen "Beim Klicken"-Ereignis hinzu. Entscheidend ist, dass es dringend empfohlen wird, vor dieser Aktion eine "Bestätigung öffnen"-Interaktion zu verwenden, um den Benutzer um Bestätigung zu bitten und versehentliche Löschungen zu vermeiden. Sie müssen die Datensatzvariable auswählen, die die ID des zu löschenden Datensatzes enthält.

Beispiel: Anzeigen und Bearbeiten des Kontonamens

Zielobjekt festlegen: Legen Sie in den Einstellungen Ihrer Dynamic Component das Zielseitennamen auf Account.
Feld ziehen: Öffnen Sie die Felder Registerkarte in der Komponentenbibliothek. Finden Sie das Name Feld (unter Account) und ziehen Sie es auf die Leinwand. Avonni erstellt wahrscheinlich ein Texteingabefeld Komponente ausgelöst.
Schaltfläche hinzufügen: Ziehen Sie eine Schaltfläche Komponente auf die Leinwand. Beschriften Sie sie mit "Speichern".
Fügen Sie der Schaltfläche eine "Beim Klicken"-Interaktion hinzu:
- Wählen Sie die Schaltfläche aus.
- Gehen Sie zum Interaktionen-Bereich.
- Fügen Sie eine "Beim Klicken"-Interaktion hinzu.
- Aktionstyp: Wählen Sie Aktualisieren aus Datensatzvariable und wählen Sie die entsprechende Datensatzvariable aus.

Wenn Sie diese Dynamic Component nun auf einer Kontodatensatzseite platzieren:

Das Texteingabefeld wird den aktuellen Kontonamen anzeigen (weil es an $Component.record.Name).
gebunden ist). Der Benutzer kann den Namen
im Texteingabefeld bearbeiten. Das Klicken der "Speichern"-Schaltfläche löst den Flow aus, um die Änderungen zu

speichern.

Wichtige Vorteile Schnelle Entwicklung:
Erstellen Sie schnell datengebundene Komponenten, ohne Code zu schreiben. Visuelle Konfiguration:
Die Drag-and-Drop-Oberfläche und die automatische Komponentenerstellung machen den Prozess intuitiv. Datenkonsistenz:

Fehlerbehandlung:

Stellt sicher, dass Ihre Komponenten stets die richtigen Daten des aktuellen Datensatzes anzeigen.

Zuletzt aktualisiert vor 23 Tagen

War das hilfreich?