Datensatz-Auswahl
Überblick
Die Avonni Record Picker-Komponente ist ein vorgefertigtes UI-Element für die Salesforce Dynamic Components App. Sie ermöglicht Benutzern das Suchen. Diese Komponente ist ideal für Formulare, Workflows oder Schnittstellen, die eine schnelle Datensatzauswahl erfordern.
Anwendungsfälle
Fallformular: Wählen Sie ein zugehöriges Konto oder einen Kontakt zur Fallzuweisung aus.
Opportunity-Seite: Wählen Sie ein übergeordnetes Konto oder eine Kampagne für den Kontext aus.
Formular für benutzerdefinierte Objekte: Wählen Sie verknüpfte Datensätze (z. B. Projektmanager für ein Project__c) aus.
Service-Workflow: Weisen Sie Techniker oder Assets aus durchsuchbaren Listen zu.
Veranstaltungsmanagement: Wählen Sie Veranstaltungsorte oder Sponsoren aus benutzerdefinierten Objekten aus.
Dateneingabe: Vereinfachen Sie das Verknüpfen von Datensätzen in Dynamic Component-Formularen.
Konfiguration
Grundlegende Eigenschaften
Diese steuern die Kernfunktionen und die Beschriftung.
API-Name
Text
Eindeutiger Bezeichner für die Instanz.
RecordPicker
Beschriftung
Text
Angezeigte Beschriftung für das Eingabefeld.
"Kontakt auswählen"
Objekt-API-Name
Zeichenkette
API-Name des Salesforce-Objekts, das abgefragt werden soll (z. B. Account, Contact, Custom_Object__c).
Contact
Wert
Bindung
Speichert die ID des ausgewählten Datensatzes (zugänglich über $Component.RecordPicker.Value).
An Variable binden zur Verwendung
Feldhilfe
Text (Optional)
Hilfetext, der neben der Beschriftung zur Orientierung angezeigt wird.
"Nach einem Kontakt suchen."
Variante
Auswählen
Beschriftungsstil: Standard (oben), label-inline (daneben), label-hidden, label-stacked (animiert nach oben).
Standard
Platzhalter
Text
Hinweistext, wenn das Feld leer ist.
"Eingeben zum Suchen..."
Erforderlich
Boolean
Erzwingt eine Auswahl; mit Formularvalidierung verwenden.
Ein
Deaktiviert
Boolean
Verhindert die Interaktion mit der Komponente.
Aus
Infobereich anzeigen
Diese konfigurieren die Anzeige der Vorschläge.
Primäres Feld
Zeichenkette
Feld, das zuerst in den Vorschlägen angezeigt wird (standardmäßig das Namensfeld).
Name
Zusätzliches Feld
Array (String)
Ein zusätzliches einzelnes Feld für Vorschläge (Array mit einem Feld-API-Namen).
["Email"]
Suchinformationsbereich
Diese steuern das Suchverhalten.
Modus
Auswählen
Suchabgleich: Enthält (treffen überall), Beginnt mit (treffen am Anfang).
Enthält
Primäres Feld
Zeichenkette
Hauptfeld für Suchanfragen (nur Text oder Formel-Text).
Name
Zusätzliches Feld
Zeichenkette
Ein zusätzliches Feld für Suchanfragen (nur Text oder Formel-Text).
Email
Tipp: Stellen Sie den Modus auf 'Enthält' für flexible Suchen ein; verwenden Sie Primär-/Zusatzfelder, um sich auf relevante Daten zu konzentrieren. (Platzhalter für Screenshot: Record Picker mit Vorschlägen.)
Interaktionen-Tab
Definieren Sie Aktionen bei Datensatzauswahl.
Bei Änderung
Einstellungen
Auslösen bei Auswahl: Verwenden Sie $Component.RecordPicker.Value (Datensatz-ID) für Aktionen (z. B. Datensatz aktualisieren, Navigieren, Toast anzeigen).
Beispiele
Dieses Beispiel konfiguriert die Avonni Record Picker-Komponente in der Dynamic Components App, um auf einer Lightning-Seite eine Liste von Kontakten mit vollständigem Namen und E-Mail anzuzeigen, zur Datensatzseite des ausgewählten Kontakts zu navigieren, indem der vom Komponentenwert erzeugte Wert verwendet wird.
Fügen Sie den Record Picker zu einer Lightning-Seite hinzu:
Ziehen Sie im Dynamic Components Builder die Avonni Record Picker-Komponente auf eine Lightning-Seite (z. B. eine Kontaktlistenansichtsseite).
Warum das? Platziert den Record Picker auf der Seite, auf der Benutzer damit interagieren können, z. B. in einer benutzerdefinierten Lightning-App oder Datensatzseite.
Record Picker konfigurieren:
Konfigurieren Sie im Eigenschaftenbereich:
API-Name: ContactSelector
Beschriftung: "Kontakt auswählen"
Objekt-API-Name: Contact
Platzhalter: "Kontakte durchsuchen..."
Primäres Feld: Name (zeigt den vollständigen Namen an)
Zusätzliches Feld: ["Email"] (zeigt die E-Mail neben dem Namen an)
Modus: Enthält
Warum das? Der Record Picker zeigt auf der Lightning-Seite eine durchsuchbare Liste von Kontakten an, zeigt deren vollständigen Namen und E-Mail an, wobei die ausgewählte ID über $Component.ContactSelector.Value verfügbar ist.
Interaktion festlegen:
Konfigurieren Sie im Interaktionen-Tab des Record Pickers:
Bei Datensatzauswahl:
Fügen Sie eine Navigations- Aktion hinzu:
Ziel: Navigieren Sie zur Kontakt-Datensatzseite mit /{$Component.ContactSelector.Value} (dem von der Komponente erzeugten Wert für die ausgewählte Datensatz-ID).
Warum das? Das Ereignis "Bei Datensatzauswahl" wird ausgelöst, wenn ein Kontakt ausgewählt wird, und navigiert zur entsprechenden Datensatzseite. Das Attribut $Component.ContactSelector.Value der Komponente gibt dynamisch die Datensatz-ID (z. B. 003xxxxxxxxxxxx) des ausgewählten Elements zurück, wodurch die korrekte Weiterleitung ohne eine separate Variable ermöglicht wird.
Hinweis: Das Attribut $Component.ContactSelector.Value der Record Picker-Komponente gibt dynamisch die Datensatz-ID des ausgewählten Elements zurück, die direkt in der Navigations-URL verwendet wird.
Ergebnis: Benutzer suchen und wählen einen Kontakt auf der Lightning-Seite aus, und die Interaktion navigiert zur Datensatzseite des ausgewählten Kontakts unter Verwendung der ID aus $Component.ContactSelector.Value.
Wichtige Überlegungen
Objektauswahl: Stellen Sie sicher, dass der Objekt-API-Name mit einem gültigen Salesforce-Objekt mit durchsuchbaren Feldern übereinstimmt.
Suchfelder: Verwenden Sie für Primär-/Zusatzfelder Text- oder Formel-Text-Felder, um Fehler zu vermeiden.
Dynamische Bindungen: Binden Sie den Wert an eine Variable zur Verwendung in Flows oder Aktualisierungen; verwenden Sie {!Record.FieldApiName} für kontextabhängige Kopfzeilen auf Datensatzseiten.
Erforderliche Felder: Kombinieren Sie Erforderlich mit Formularvalidierung, um Auswahlen durchzusetzen.
Leistung: Testen Sie mit großen Datensätzen; begrenzen Sie Suchfelder für schnellere Performance.
Barrierefreiheit: Sorgen Sie für klare Beschriftungen/Platzhalter; testen Sie die Tastaturnavigation für Vorschläge.
Fehlerbehebung bei häufigen Problemen
Keine Vorschläge angezeigt: Überprüfen Sie Objekt-API-Name und Suchfelder; prüfen Sie Benutzerberechtigungen.
Suche funktioniert nicht: Bestätigen Sie, dass Modus und Primär-/Zusatzfeld textbasiert sind; testen Sie mit Beispielbegriffen.
Wert wird nicht erfasst: Stellen Sie sicher, dass der Wert an eine Variable gebunden ist; prüfen Sie die Interaktionseinstellungen.
UI-Probleme: Passen Sie die Variante für Platzbedarf an; testen Sie die Sichtbarkeit des Platzhalters auf Mobilgeräten.
Erforderlich nicht durchgesetzt: Fügen Sie Validierungslogik im Flow hinzu; stellen Sie sicher, dass Erforderlich eingeschaltet ist.
Langsame Performance: Begrenzen Sie Suchfelder; optimieren Sie Objektabfragen.
Zusammenfassung
Die Avonni Record Picker-Komponente vereinfacht die Datensatzauswahl in Salesforce Dynamic Components mit flexiblen Such- und Anzeigeoptionen. Sie ist perfekt für Formulare und Workflows, die schnelle Nachschlagen erfordern.
Zuletzt aktualisiert
War das hilfreich?