Usted está aquí:
Componentes web Lightning personalizados en cuadrícula de entrada de regalo en organizaciones sin fines de lucro
Comprenda cómo los componentes web Lightning personalizados mueven datos desde y a la cuadrícula Entrada de regalo.
| EDICIONES REQUERIDAS |
|---|
| Disponible en: Lightning Experience |
Disponible en: Ediciones Enterprise, Performance, Unlimited y Developer con Education Cloud Disponible en: Ediciones Enterprise, Unlimited y Developer con Nonprofit Cloud |
- Propiedades enviadas a un componente desde la cuadrícula Entrada de regalo
La cuadrícula Entrada de regalo pasa datos de filas a componentes web Lightning personalizados a través de la propiedad params para componentes de celda y la propiedad rowData para cuadros modales. - Envío de datos de vuelta a la cuadrícula de entrada de regalo
Los cuadros modales de columna y los componentes de modificación de celdas utilizan diferentes mecanismos para devolver datos a la cuadrícula Entrada de regalo. - Consideraciones para la devolución de datos
Cuando devuelva datos a la cuadrícula Entrada de regalo, tenga en cuenta estas reglas para campos de lista de selección y búsqueda.
Propiedades enviadas a un componente desde la cuadrícula Entrada de regalo
La cuadrícula Entrada de regalo pasa datos de filas a componentes web Lightning personalizados a través de la propiedad params para componentes de celda y la propiedad rowData para cuadros modales.
| EDICIONES REQUERIDAS |
|---|
| Disponible en: Lightning Experience |
Disponible en: Ediciones Enterprise, Performance, Unlimited y Developer con Education Cloud Disponible en: Ediciones Enterprise, Unlimited y Developer con Nonprofit Cloud |
| Propiedad | Descripción |
|---|---|
| parámetros |
|
| rowData |
|
Envío de datos de vuelta a la cuadrícula de entrada de regalo
Los cuadros modales de columna y los componentes de modificación de celdas utilizan diferentes mecanismos para devolver datos a la cuadrícula Entrada de regalo.
| EDICIONES REQUERIDAS |
|---|
| Disponible en: Lightning Experience |
Disponible en: Ediciones Enterprise, Performance, Unlimited y Developer con Education Cloud Disponible en: Ediciones Enterprise, Unlimited y Developer con Nonprofit Cloud |
Modalidades de columna
Los cuadros modales de columna se representan en un componente web Lightning envolvente que incluye el título del cuadro modal (como se define en la plantilla), así como un botón Continuar y Cancelar.
El botón Continuar es en el que el usuario hará clic para cerrar su cuadro modal personalizado. Llamará a estas funciones expuestas obligatorias:
| Función | Descripción |
|---|---|
@api validate() |
Devuelve un objeto con dos propiedades:
|
@api getComponentValues() |
Devuelva un conjunto de propiedades key:value para aplicar a la fila:
|
Componente Modificar celda
Para devolver datos a la cuadrícula Entrada de regalo desde un componente de modificación de celda:
- Cree un objeto como el mensaje para volver a la cuadrícula de entrada de regalo.
- Publique un evento en el canal de mensajes de
lightning__giftEntryGridComponentAction.
El contenido del cuerpo del mensaje es estricto. Siga la estructura de este ejemplo:
// 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}
}
}
Consideraciones para la devolución de datos
Cuando devuelva datos a la cuadrícula Entrada de regalo, tenga en cuenta estas reglas para campos de lista de selección y búsqueda.
| EDICIONES REQUERIDAS |
|---|
| Disponible en: Lightning Experience |
Disponible en: Ediciones Enterprise, Performance, Unlimited y Developer con Education Cloud Disponible en: Ediciones Enterprise, Unlimited y Developer con Nonprofit Cloud |
Consideraciones sobre los campos de lista de selección:
- Si los campos de lista de selección se devuelven como una cadena sencilla, el valor debe representar el nombre de API de la lista de selección en el caso de que la etiqueta y el nombre de API sean diferentes.
- Los campos de lista de selección también se pueden devolver como un objeto en forma de
{ value: xx, displayValue: zz }. A continuación se ofrece un ejemplo:{ giftType: { value: “Organizational”, displayValue: “Organizativo/Doméstico” } }
Consideraciones de campo de búsqueda:
- Los campos de búsqueda que no son columnas en la cuadrícula Entrada de regalo se pueden devolver como solo una cadena de Id. solo en un objeto de respuesta. Por ejemplo,
{MyLookupFieldId__c: ‘xxx00000000’} - Los campos de búsqueda que son columnas de campo en la cuadrícula Entrada de regalo, como Campaña y Código fuente de alcance, deben devolverse desde un componente web Lightning personalizado en un formulario de objeto para asegurarse de que se representan correctamente en la cuadrícula. A continuación se incluye un ejemplo:
Campaign: { Id: {campaignId}, Name: {campaignName} }
