Ti trovi qui:
Componenti Web Lightning personalizzati nella griglia di immissione regalo nel settore non profit
Informazioni su come i componenti Web Lightning personalizzati spostano i dati da e verso la griglia di immissione regalo.
| EDIZIONI RICHIESTE |
|---|
| Disponibile in: Lightning Experience |
Disponibile in: Enterprise Edition, Performance Edition, Unlimited Edition e Developer Edition con Education Cloud Disponibile nelle versioni: Enterprise Edition, Unlimited Edition e Developer Edition con Nonprofit Cloud |
- Proprietà inviate a un componente dalla griglia di immissione regalo
La griglia di immissione regalo passa i dati delle righe ai componenti Web Lightning personalizzati tramite la proprietà params per i componenti delle celle e la proprietà rowData per le finestre modali. - Invio dei dati alla griglia di immissione regalo
Le finestre modali delle colonne e i componenti di modifica delle celle utilizzano meccanismi diversi per restituire i dati alla griglia di immissione regalo. - Considerazioni sulla restituzione dei dati
Quando si restituiscono i dati alla griglia di immissione regalo, tenere presenti queste regole per i campi elenco di selezione e di ricerca.
Proprietà inviate a un componente dalla griglia di immissione regalo
La griglia di immissione regalo passa i dati delle righe ai componenti Web Lightning personalizzati tramite la proprietà params per i componenti delle celle e la proprietà rowData per le finestre modali.
| EDIZIONI RICHIESTE |
|---|
| Disponibile in: Lightning Experience |
Disponibile in: Enterprise Edition, Performance Edition, Unlimited Edition e Developer Edition con Education Cloud Disponibile nelle versioni: Enterprise Edition, Unlimited Edition e Developer Edition con Nonprofit Cloud |
| Proprietà | Descrizione |
|---|---|
| paragrafi |
|
| rowData |
|
Invio dei dati alla griglia di immissione regalo
Le finestre modali delle colonne e i componenti di modifica delle celle utilizzano meccanismi diversi per restituire i dati alla griglia di immissione regalo.
| EDIZIONI RICHIESTE |
|---|
| Disponibile in: Lightning Experience |
Disponibile in: Enterprise Edition, Performance Edition, Unlimited Edition e Developer Edition con Education Cloud Disponibile nelle versioni: Enterprise Edition, Unlimited Edition e Developer Edition con Nonprofit Cloud |
Modalità colonna
Le modalità colonna vengono visualizzate all'interno di un componente Lightning Web wrapper che include il titolo modale (come definito nel modello), oltre a un pulsante Continua e Annulla.
Il pulsante Continua è quello su cui l'utente farà clic per chiudere la finestra modale personalizzata. Verranno chiamate le seguenti funzioni esposte richieste:
| Funzione | Descrizione |
|---|---|
@api validate() |
Restituisce un oggetto con due proprietà:
|
@api getComponentValues() |
Restituisce un insieme di proprietà key:value da applicare alla riga:
|
Componente Modifica cella
Per restituire i dati alla griglia di immissione regalo da un componente di modifica delle celle:
- Costruire un oggetto come messaggio per tornare alla griglia di immissione regalo.
- Pubblicare un evento nel canale dei messaggi
lightning__giftEntryGridComponentAction.
Il contenuto del corpo del messaggio è rigoroso. Seguire la struttura di questo esempio:
// 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}
}
}
Considerazioni sulla restituzione dei dati
Quando si restituiscono i dati alla griglia di immissione regalo, tenere presenti queste regole per i campi elenco di selezione e di ricerca.
| EDIZIONI RICHIESTE |
|---|
| Disponibile in: Lightning Experience |
Disponibile in: Enterprise Edition, Performance Edition, Unlimited Edition e Developer Edition con Education Cloud Disponibile nelle versioni: Enterprise Edition, Unlimited Edition e Developer Edition con Nonprofit Cloud |
Considerazioni sui campi elenco di selezione:
- Se i campi elenco di selezione vengono restituiti come stringa semplice, il valore deve rappresentare il nome API dell'elenco di selezione nel caso in cui l'etichetta e il nome API siano diversi.
- I campi elenco di selezione possono anche essere restituiti come oggetto sotto forma di
{ value: xx, displayValue: zz }. Ecco un esempio:{ giftType: { value: “Organizational”, displayValue: “Organizativo/Doméstico” } }
Considerazioni sui campi di ricerca:
- I campi di ricerca che non sono colonne nella griglia di immissione regalo possono essere restituiti solo come stringa ID in un oggetto risposta. Ad esempio,
{MyLookupFieldId__c: ‘xxx00000000’} - I campi di ricerca che sono colonne di campo nella griglia di immissione regalo, ad esempio Codice fonte campagna e Codice sorgente contatto, devono essere restituiti da un componente Web Lightning personalizzato in un modulo oggetto per assicurarsi che vengano visualizzati correttamente nella griglia. Ecco un esempio:
Campaign: { Id: {campaignId}, Name: {campaignName} }
