この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

LightningMessageChannel (ベータ)

Lightning メッセージチャネルに関連付けられたメタデータを表します。Lightning メッセージチャネルは、UI テクノロジ (Lightning Web コンポーネント、Aura コンポーネント、および Visualforce) 間で通信するための安全なチャネルを表します。Metadata メタデータ型を拡張し、その fullName 項目を継承します。

LightningMessageChannel はベータ機能としてのプレビュー版であり、Salesforce とのマスターサブスクリプション契約における「サービス」には含まれません。この機能はお客様各自の裁量で使用し、購入するときは、現在正式にリリースされている製品および機能に基づいて判断してください。Salesforce はこの機能の特定期間内の正式リリースまたはリリースの有無を保証しません。また、いかなる時点でもこの機能を終了できるものとします。LightningMessageChannel は、評価目的のみで、本番での使用を目的にしたものではありません。この機能は、そのままの状態で提供され、サポートされておらず、ここから生じる、またはこれに関連する被害または損害に対して、Salesforce はいかなる責任も負いません。すべての制約、Salesforce の権利の保留、本サービスに関する義務、および関連する Salesforce 以外のアプリケーションならびにコンテンツの条件は、この機能の使用に等しく適用されます。フィードバックと提案は、Trailblazer Community からお寄せください。

メモ

ファイルのサフィックスおよびディレクトリの場所

LightningMessageChannel コンポーネントのサフィックスは .messageChannel で、messageChannels フォルダに保存されます。

バージョン

LightningMessageChannel コンポーネントは、API バージョン 47.0 以降で使用できます。

項目

項目名	項目の型	説明
description	string	Lightning メッセージチャネルの説明。
isExposed	boolean	Lightning メッセージチャネルが他の名前空間のコンポーネントに公開されるか (`true`)、否か (`false`) を示します。デフォルト値は `false` です。管理パッケージ内にあるか、別のメッセージチャネルコンポーネントで参照されるメッセージチャネルで `isExposed` を `true` に設定すると、`false` に変更することはできません。他の組織またはコンポーネントがすでにメッセージチャネルに依存しているため、コードが破損する可能性があります。
lightningMessageFields	LightningMessageField[]	特定の Lightning メッセージチャネルのメッセージペイロード項目のリスト。
masterLabel	string	必須。Lightning メッセージチャネルのラベル。

LightningMessageField

特定の Lightning メッセージチャネルのメッセージペイロード項目を表します。

項目名	項目の型	説明
description	string	Lightning メッセージ項目の説明。
fieldName	string	必須。Lightning メッセージ項目の一意の識別子。

宣言的なメタデータの定義のサンプル

以下は簡単な LightningMessageChannel コンポーネン��の例です。

1<?xml version="1.0" encoding="UTF-8"?>
2<LightningMessageChannel xmlns="http://soap.sforce.com/2006/04/metadata">
3    <masterLabel>SampleMessageChannel</masterLabel>
4    <isExposed>true</isExposed>
5    <description>This is a sample Lightning Message Channel.</description>
6</LightningMessageChannel>

LightningMessageFields を含む LightningMessageChannel コンポーネントの例を次に示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<LightningMessageChannel xmlns="http://soap.sforce.com/2006/04/metadata">
3    <masterLabel>SampleMessageChannel</masterLabel>
4    <isExposed>true</isExposed>
5    <description>This is a sample Lightning Message Channel.</description>
6    <lightningMessageFields>
7        <fieldName>recordId</fieldName>
8        <description>This is the record Id that changed</description>
9    </lightningMessageFields>
10    <lightningMessageFields>
11        <fieldName>recordData</fieldName>
12        <description>The current data representing the record that changed</description>
13    </lightningMessageFields>
14</LightningMessageChannel>

前の定義を参照する package.xml の例を次に示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3    <types>
4        <members>*</members>
5        <name>LightningMessageChannel</name>
6    </types>
7    <version>47.0</version>
8</Package>

マニフェストファイル内のワイルドカードのサポート

このメタデータ型では、package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) がサポートされます。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。

メタデータ API 開発者ガイド