Sie befinden sich hier:
Benutzerdefinierte Lightning Webkomponenten im Spendeneintragsraster für gemeinnützige Organisationen
Machen Sie sich damit vertraut, wie benutzerdefinierte Lightning Webkomponenten Daten aus und in das Spendeneintragsraster verschieben.
| ERFORDERLICHE EDITIONEN |
|---|
| Verfügbar in: Lightning Experience |
Verfügbar in: Editionen Enterprise, Performance, Unlimited und Developer mit Education Cloud Verfügbarkeit: Enterprise, Unlimited und Developer Edition mit Nonprofit Cloud |
- Über das Spendeneintragsraster an eine Komponente gesendete Eigenschaften
Über die Eigenschaft params für Zellenkomponenten und die Eigenschaft rowData für Modalfenster übergibt das Raster für Spendeneinträge Zeilendaten an benutzerdefinierte Lightning Webkomponenten. - Zurücksenden von Daten an das Spendeneintragsraster
Spaltenmodale und Zellenbearbeitungskomponenten verwenden unterschiedliche Mechanismen, um Daten an das Spendeneintragsraster zurückzugeben. - Überlegungen zum Zurückgeben von Daten
Beachten Sie beim Zurückgeben von Daten an das Spendeneintragsraster die folgenden Regeln für Auswahllisten- und Nachschlagefelder.
Über das Spendeneintragsraster an eine Komponente gesendete Eigenschaften
Über die Eigenschaft params für Zellenkomponenten und die Eigenschaft rowData für Modalfenster übergibt das Raster für Spendeneinträge Zeilendaten an benutzerdefinierte Lightning Webkomponenten.
| ERFORDERLICHE EDITIONEN |
|---|
| Verfügbar in: Lightning Experience |
Verfügbar in: Editionen Enterprise, Performance, Unlimited und Developer mit Education Cloud Verfügbarkeit: Enterprise, Unlimited und Developer Edition mit Nonprofit Cloud |
| Eigenschaft | Beschreibung |
|---|---|
| Parameter |
|
| rowData |
|
Zurücksenden von Daten an das Spendeneintragsraster
Spaltenmodale und Zellenbearbeitungskomponenten verwenden unterschiedliche Mechanismen, um Daten an das Spendeneintragsraster zurückzugeben.
| ERFORDERLICHE EDITIONEN |
|---|
| Verfügbar in: Lightning Experience |
Verfügbar in: Editionen Enterprise, Performance, Unlimited und Developer mit Education Cloud Verfügbarkeit: Enterprise, Unlimited und Developer Edition mit Nonprofit Cloud |
Spaltenmodale
Spaltenmodale werden in einer Lightning Webkomponente des Wrappers dargestellt, die den Modaltitel (wie in der Vorlage definiert) sowie die Schaltfläche "Fortfahren" und "Abbrechen" enthält.
Auf die Schaltfläche Fortfahren klickt der Benutzer, um Ihr benutzerdefiniertes Modalfenster zu schließen. Sie ruft die folgenden erforderlichen sichtbaren Funktionen auf:
| Funktion | Beschreibung |
|---|---|
@api validate() |
Geben Sie ein Objekt mit zwei Eigenschaften zurück:
|
@api getComponentValues() |
Geben Sie einen Satz von Eigenschaften key:value zurück, der auf die Zeile angewendet werden soll:
|
Komponente "Zellenbearbeitung"
Zurückgeben von Daten an das Spendeneintragsraster über eine Zellenbearbeitungskomponente:
- Erstellen Sie ein Objekt als Nachricht, die zum Spendeneintragsraster zurückkehren soll.
- Veröffentlichen Sie ein Ereignis im
lightning__giftEntryGridComponentAction-Nachrichtenkanal.
Der Inhalt des Nachrichtentexts ist streng. Befolgen Sie die Struktur dieses Beispiels:
// Build the "message" object to send back to
// Gift Entry Grid following the documented contract
const message = {
// Required properties (do not change the values below)
action: "ColumnEdit",
componentName: this.tagName,
colId: this._params?.colDef?.colId,
// 'details' is an optional property:
// - include if there is data to write to the row
// in Gift Entry
details: {
// rowId and rowIndex must be included in details
rowId: this.params?.data?.id, // Required
rowIndex: this.params?.data?.rowIndex, // Required
// All GiftEntry fields to write to rowData
// and as object in a key:value collection.
// To clear the value of a field on the GiftEntry rowData
// object, return null instead of undefined
giftEntryFields : { key: value, ... },
// rowProperties is optional, but if passed can be
// referenced by other custom components. Data in this
// object are not persisted to the GiftEntry record.
rowProperties: { key : value, ... },
// Special Use: If your custom column component is
// forcing a matched gift transaction, use these
// properties to send the matching transaction ID
// and NAME back to grid for proper handling:
matchingGiftTransactionId: {giftTransactionId},
matchingGiftTransactionName: {giftTransactionName}
}
}
Überlegungen zum Zurückgeben von Daten
Beachten Sie beim Zurückgeben von Daten an das Spendeneintragsraster die folgenden Regeln für Auswahllisten- und Nachschlagefelder.
| ERFORDERLICHE EDITIONEN |
|---|
| Verfügbar in: Lightning Experience |
Verfügbar in: Editionen Enterprise, Performance, Unlimited und Developer mit Education Cloud Verfügbarkeit: Enterprise, Unlimited und Developer Edition mit Nonprofit Cloud |
Überlegungen zu Auswahllistenfeldern:
- Wenn Auswahllistenfelder als einfache Zeichenfolge zurückgegeben werden, sollte der Wert für den API-Namen der Auswahlliste stehen, falls sich die Bezeichnung und der API-Name unterscheiden.
- Auswahllistenfelder können auch als Objekt in Form von
{ value: xx, displayValue: zz }zurückgegeben werden. Beispiel:{ giftType: { value: “Organizational”, displayValue: “Organizativo/Doméstico” } }
Überlegungen zu Nachschlagefeldern:
- Nachschlagefelder, die keine Spalten im Raster für Spendeneinträge sind, können nur als ID-Zeichenfolge in einem Antwortobjekt zurückgegeben werden. Beispiel:
{MyLookupFieldId__c: ‘xxx00000000’} - Nachschlagefelder, bei denen es sich um Feldspalten im Spendeneintragsraster handelt, beispielsweise "Kampagne" und "Quellcode für die Kontaktaufnahme", sollten aus einer benutzerdefinierten Lightning Webkomponente in einem Objektformular zurückgegeben werden, um sicherzustellen, dass sie ordnungsgemäß im Raster dargestellt werden. Beispiel:
Campaign: { Id: {campaignId}, Name: {campaignName} }
