Zielseitenobjekt
Das Zielobjekt-API-Name ist eine grundlegende Einstellung für Ihre Avonni Dynamic Component. Es legt das primäre Salesforce-Objekt fest, mit dem Ihre Komponente interagieren wird (z. B. Account, Contact, Opportunity, My_Custom_Object__c). Es liefert den wesentlichen Datenkontext für die Operationen und die Anzeige Ihrer Komponente.
So legen Sie den Namen der Zielseite fest
Sie können das Zielseitenobjekt für Ihre Dynamic Component auf zwei Arten definieren oder aktualisieren:
Beim Erstellen einer neuen Dynamic Component:
Wenn Sie auf der Startseite der Avonni Components App auf "Neu" klicken, um eine Dynamic Component zu erstellen, enthält der anfängliche Einrichtungsdialog eine Option (häufig eine Dropdown-Liste) mit der Bezeichnung "Zielseitenobjekt".
Bevor Sie die Erstellung der Komponente abschließen, wählen Sie das gewünschte Salesforce-Objekt aus dieser Liste aus. Dies legt den anfänglichen Kontext für Ihre neue Komponente fest.
Für bestehende Komponenten (über Einstellungen):
Öffnen Sie Ihre Dynamic Component im Component Builder.
Klicken Sie auf das Einstellungen Symbol (normalerweise ein Zahnrad ⚙️ in der oberen linken Ecke des Builders).
Suchen Sie im erscheinenden Einstellungsbereich die Zielseitenobjekt Eigenschaft.
Wählen Sie das Salesforce-Objekt aus der Dropdown-Liste aus oder ändern Sie es.
Denken Sie daran, zu speichern Ihre Dynamic Component, nachdem Sie hier Änderungen vorgenommen haben.
Warum ist der Name der Zielseite wichtig?
Die korrekte Einstellung des Zielobjekt-API-Namens schaltet wichtige Funktionen für den Datenzugriff frei:
Ermöglicht den Felder-Tab: Sobald festgelegt, füllt der Felder- Tab in der Component Library (linkes Panel) sich mit allen verfügbaren Feldern des ausgewählten Objekts. Sie können diese Felder dann per Drag & Drop auf Ihre Leinwand ziehen und so automatisch datengebundene Komponenten erstellen.
Stellt aktuelle Datensatzdaten bereit (auf Datensatzseiten): Dies ist entscheidend für Komponenten, die auf Salesforce- Datensatzseitenplatziert werden. Wenn der Name der Zielseite mit dem Objekt der Datensatzseite übereinstimmt (z. B. wenn Sie ihn auf
Accountsetzen und die Komponente auf einer Account-Seite platzieren):Das
$Component.recordwird die globale Variable automatisch verfügbar und gibt Ihnen direkten Zugriff auf alle Felddaten des aktuellen Datensatzes der gerade angezeigt wird. Zum Beispiel können Sie den Namen des Datensatzes mit$Component.record.Name.
anzeigen. Die ID des aktuellen Datensatzes ist ebenfalls leicht zugänglich, typischerweise über
$Component.record.Idoder durch Auswahl der@recordIdOption im Ressourcenwähler.
Vereinfacht die Anzeige verwandter Daten: Das Wissen um das primäre Objekt und der einfache Zugriff auf die ID des aktuellen Datensatzes (über
$Component.record.Idoder@recordId) sind wesentlich für die Konfiguration von Abfragen oder Filtern, um Listen von verwandten Datensätzen anzuzeigen (z. B. alle Kontakte anzuzeigen, die mit dem aktuellen Account verknüpft sind).
Wann man den Namen der Zielseite verwenden sollte
Datensatz-Detailseiten: Sie werden fast immer das Zielseitenobjekt festlegen, wenn Sie Komponenten erstellen, die ausdrücklich für Datensatzseiten vorgesehen sind, da dies der primäre Weg ist, auf die Daten des aktuellen Datensatzes zuzugreifen.
Anzeige verwandter Listen/Daten: Wann immer Ihre Komponente Daten anzeigen oder mit Daten interagieren muss, die mit einem bestimmten auf einer Seite angezeigten Datensatz zusammenhängen.
Kontextuelle Komponenten: Jede Komponente, deren Verhalten oder angezeigte Informationen auf einen bestimmten Datensatz kontextualisiert werden müssen.
Master-Detail-Beziehungen: Beim Erstellen von Master-Detail-ähnlichen Beziehungen zwischen Komponenten innerhalb Ihrer Dynamic Component (z. B. eine Account-Liste, die eine zugehörige Kontaktliste steuert) kann der durch das Zielseitenobjekt bereitgestellte Kontext für den übergeordneten Seiten-Datensatz ein Ausgangspunkt sein
Wann Sie es vielleicht nicht
benötigen Eigenständige Komponenten (kein Datensatzkontext):
Wenn Ihre Komponente völlig unabhängig von einem bestimmten Datensatz ist und nicht direkt auf Datensatzdaten zugreifen muss (z. B. ein generischer Rechner, ein statisches Informationspanel oder eine Komponente auf einer App-Seite, die organisationsweite Zusammenfassungen ohne speziellen Datensatzfokus anzeigt), müssen Sie das Zielseitenobjekt möglicherweise nicht festlegen. In solchen Fällen würden Sie typischerweise die Avonni Query Data Source verwenden, um die benötigten Daten abzurufen, ohne auf einen Seiten-Datensatzkontext angewiesen zu sein. Verwendung nur von Variablen, die anderweitig initialisiert wurden: Wenn alle Datensatzdaten, die Ihre Komponente benötigt, explizit über Eingabevariablenübergeben werden (z. B. wenn eine Komponente in einem Modal oder Panel gestartet wird und eine Datensatz-ID als Eingabe erhält, die dann eine lokale Record-Variable über eine "Beim Laden Felder-Tab "-Aktion füllt), müssen Sie das übergeordnete Zielseitenobjekt möglicherweise nicht unbedingt festlegen, obwohl es dennoch helfen kann, die
für ein einfacheres Layout-Design zu füllen.
Im Wesentlichen $Component.record Legen Sie das Zielseitenobjekt fest, wenn Ihre Komponente direkten Zugriff auf die Daten eines bestimmten Datensatzes auf einer Datensatzseite benötigt. Dies schaltet die
Zuletzt aktualisiert
War das hilfreich?