Вы находитесь здесь:
Настраиваемые веб-компоненты Lightning в сетке подарочных записей в некоммерческой организации
Узнайте, как настраиваемые веб-компоненты Lightning перемещают данные из и в сетку записи подарка.
| ТРЕБУЕМЫЕ ВЫПУСКИ |
|---|
| Доступно в: Lightning Experience |
Доступно в: выпусках Enterprise, Performance, Unlimited и Developer с Education Cloud Доступно в версиях: Версии Enterprise Edition, Unlimited Edition и Developer Edition с Nonprofit Cloud |
- Свойства, отправленные в компонент из сетки записи подарка
Сетка записи подарка передает данные строки в настраиваемые веб-компоненты Lightning посредством свойства params для компонентов ячейки и свойства rowData для модалов. - Отправка данных обратно в сетку записи подарка
Модалы столбцов и компоненты редактирования ячеек используют разные механизмы для возврата данных в сетку записи подарка. - Рекомендации по возврату данных
При возврате данных обратно в сетку записи подарка учитывайте следующие правила для полей раскрывающегося списка и поиска.
Свойства, отправленные в компонент из сетки записи подарка
Сетка записи подарка передает данные строки в настраиваемые веб-компоненты Lightning посредством свойства params для компонентов ячейки и свойства rowData для модалов.
| ТРЕБУЕМЫЕ ВЫПУСКИ |
|---|
| Доступно в: Lightning Experience |
Доступно в: выпусках Enterprise, Performance, Unlimited и Developer с Education Cloud Доступно в версиях: Версии Enterprise Edition, Unlimited Edition и Developer Edition с Nonprofit Cloud |
| Свойство | Описание |
|---|---|
| params |
|
| rowData |
|
Отправка данных обратно в сетку записи подарка
Модалы столбцов и компоненты редактирования ячеек используют разные механизмы для возврата данных в сетку записи подарка.
| ТРЕБУЕМЫЕ ВЫПУСКИ |
|---|
| Доступно в: Lightning Experience |
Доступно в: выпусках Enterprise, Performance, Unlimited и Developer с Education Cloud Доступно в версиях: Версии Enterprise Edition, Unlimited Edition и Developer Edition с Nonprofit Cloud |
Модалы столбца
Модалы столбца отображаются в веб- компоненте wraper Lightning, содержащем заголовок модала (как определено в шаблоне), а также кнопку «Продолжить» и «Отмена».
Кнопка «Продолжить» — это кнопка, нажатая пользователем для закрытия настраиваемого модала. Он вызовет следующие обязательные открытые функции:
| Функция | Описание |
|---|---|
@api validate() |
Возврат объекта с двумя свойствами:
|
@api getComponentValues() |
Возврат набора свойств ключ:значение для применения к строке:
|
Компонент редактирования ячейки
Для возврата данных обратно в сетку записи подарка из компонента редактирования ячейки:
- Создайте объект в качестве сообщения для возврата в сетку записи подарка.
- Опубликуйте событие в канале сообщений
lightning__giftEntryGridComponentAction.
Содержимое текста сообщения строгое. Выполните следующие действия:
// 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}
}
}
Рекомендации по возврату данных
При возврате данных обратно в сетку записи подарка учитывайте следующие правила для полей раскрывающегося списка и поиска.
| ТРЕБУЕМЫЕ ВЫПУСКИ |
|---|
| Доступно в: Lightning Experience |
Доступно в: выпусках Enterprise, Performance, Unlimited и Developer с Education Cloud Доступно в версиях: Версии Enterprise Edition, Unlimited Edition и Developer Edition с Nonprofit Cloud |
Рекомендации по полям раскрывающегося списка:
- Если поля раскрывающегося списка возвращаются в виде простой строки, значение должно представлять API-имя раскрывающегося списка, если метка и API-имя отличаются.
- Поля раскрывающегося списка также могут быть возвращены в качестве объекта в виде
{ value: xx, displayValue: zz }. См. пример ниже:{ giftType: { value: “Organizational”, displayValue: “Organizativo/Doméstico” } }
Рекомендации по полям поиска:
- Поля поиска, не являющиеся столбцами в сетке записи подарка, могут быть возвращены в качестве строки кода только в объекте ответа. Например,
{MyLookupFieldId__c: ‘xxx00000000’} - Поля поиска, являющиеся столбцами полей в сетке записи подарка, например, «Кампания» и «Исходный код связи», должны быть возвращены из настраиваемого веб- компонента Lightning в форме объекта, чтобы убедиться в их правильном отображении в сетке. А вот и пример:
Campaign: { Id: {campaignId}, Name: {campaignName} }

