詳細情報:
FlexCard の有効化と公開
FlexCard の準備ができたことを確認したら、有効化します。有効化したら、Flexcard を Lightning ページまたはエクスペリエンスビルダーサイトのページに追加します。
OmniStudio for Vlocity または Summer '22 以前の OmniStudio Standard を使用している場合、FlexCard を有効にすると、OmniStudio によってカスタム Lightning Web コンポーネントが生成されます。生成された LWC を Lightning ページまたはエクスペリエンスビルダーページに追加します。「Activate, Configure, and Publish Flexcards for OmniStudio Vlocity (OmniStudio Vlocity の Flexcard の有効化、設定、公開)」を参照してください。
Summer '22 以降で OmniStudio Standard を使用する場合は、有効化後に標準 Flexcard コンポーネントを Lightning ページまたはエクスペリエンスビルダーページに追加します。
有効な FlexCard を編集または削除することはできません。変更するには、まず無効化します。
Experience Cloud サイトまたは Lightning ページで Flexcard を参照するには、Salesforce Lightning Component Library から入手できる Flexcard ラッパー コンポーネントを使用します。詳細は、「コンポーネントライブラリ」を参照してください。
Lightning Web Runtime（LWR）Experience Cloud サイトで FlexCard を参照している場合、次に示すように、実行時に読み込む FlexCard の名前を取得するラッパー コンポーネントを使用する必要があります。flexcard-name 属性は必須です。
<namespace-flex-card-standard-runtime-wrapper
flexcard-name="name"
record-id="recordId"
object-api-name="objectApiName"
records="records"
exposed-attributes="exposedAttributes">
</namespace-flex-card-standard-runtime-wrapper>- FlexCard の公開
FlexCard の表示場所などのメタデータ値を定義し、FlexCard のコンポーネント SVG アイコンを更新してから、コンポーネントを Lightning ページまたはエクスペリエンスページに公開します。たとえば、エクスペリエンスサイトで FlexCard を表示するには、[公開オプション] の [対象] で [コミュニティ] ページを有効にします。 - Lightning ページへの FlexCard の追加
作成した FlexCard または既存の Flexcard を Lightning ページに追加し、ユーザーに表示する方法を設定します。 - エクスペリエンスビルダーページへの FlexCard の追加
作成した FlexCard または既存の Flexcard をエクスペリエンスビルダーサイトのページに追加します。 - Lightning Web Runtime サイトでの FlexCard の使用に関する考慮事項
Lightning Web Runtime(LWR)Experience CloudサイトでFlexCardを使用する場合の考慮事項について説明します。
FlexCard の公開
FlexCard の表示場所などのメタデータ値を定義し、FlexCard のコンポーネント SVG アイコンを更新してから、コンポーネントを Lightning ページまたはエクスペリエンスページに公開します。たとえば、エクスペリエンスサイトで FlexCard を表示するには、[公開オプション] の [対象] で [コミュニティ] ページを有効にします。
- アプリケーションランチャーで、[Flexcards] を見つけて選択します。
- リストページから、FlexCard バージョンを選択します。
- 必要に応じて、FlexCard を有効化します。
-
[
] をクリックし、[公開オプション] を選択します。
-
必要に応じて情報を入力します。FlexCard を次のいずれかの対象ページに公開します。
- App Page (アプリケーションページ) - Lightning アプリケーションビルダーのアプリケーションページで FlexCard を使用できるようにします。
- Home Page (ホームページ) - Flexcard を Lightning アプリケーションビルダーのホームページで使用できるようにします。
- Record Page (レコードページ) - Flexcard を Lightning アプリケーションビルダーのレコードページで使用できるようにします。
- Community Page (コミュニティページ) - Flexcard をエクスペリエンスビルダーのページでドラッグアンドドロップコンポーネントとして使用できるようにします。
- Community Default (コミュニティのデフォルト) - コンポーネントが選択されたときにエクスペリエンスビルダーで Flexcard が編集可能なプロパティを公開できるようにします。
「XML 設定ファイル要素」を参照してください。
親 FlexCard の公開オプションを選択する場合、少なくとも 1 つの対象を選択する必要があります。すべての対象をオフにして [保存] をクリックすると、[アプリケーションページ]、[ホームページ]、[レコードページ] オプションがデフォルトの対象として自動的に有効になります。 - 変更内容を保存します。
Lightning ページへの FlexCard の追加
作成した FlexCard または既存の Flexcard を Lightning ページに追加し、ユーザーに表示する方法を設定します。
- [設定] の [クイック検索] ボックスに「Lightning アプリケーションビルダー」と入力し、[Lightning アプリケーションビルダー] を選択します。
- FlexCard を追加するページを見つけて、［Edit］ をクリックします。
- [コンポーネント] ペインの [標準] セクションから Flexcard コンポーネントをキャンバスにドラッグします。
-
必要に応じて、[Flexcard 名] をクリックし、[Flexcard] を選択します。
デフォルトでは、ビルダーは最新の有効な FlexCard を使用します。
- FlexCard ユーザー操作を追跡するには、[Enable OmniStudio Analytics] を選択します。
-
必要に応じて、表示条件などを使用して表示設定を定義します。
「Lightning ページでの表示ルール」を参照してください。
-
ページを有効化し、有効化プロパティを設定します。
「Activate Your Lightning App Page」を参照してください。
- 変更内容を保存します。
エクスペリエンスビルダーページへの FlexCard の追加
作成した FlexCard または既存の Flexcard をエクスペリエンスビルダーサイトのページに追加します。
FlexCard は、Aura または Lightning Web Runtime(LWR)Experience Cloud サイトに追加できます。LWR 互換の FlexCard を作成する方法については、「Activate and Publish a Flexcard」を参照してください。
- [設定] から、[クイック検索] ボックスに「デジタルエクスペリエンス」と入力し、[すべてのサイト] を選択します。
- FlexCard を追加するサイトを見つけて、[ビルダー] をクリックします。
-
をクリックします。Aura ベースの Experience Cloud サイトを使用している場合、[プロセスの自動化] で Flexcard コンポーネントを見つけてキャンバスにドラッグします。LWR サイトを使用している場合は、[顧客とのインタラクション] セクションで Flexcard コンポーネントを見つけます。
- [Flexcard 名] 選択リストから、[Flexcard] を選択します。
-
必要に応じて、[Exposed Attributes (公開属性)] に、設定可能な公開プロパティを JSON コードとして入力します。
たとえば、FlexCard に最大 5 つの取引先を表示するには、変数が AccountRecordLimit の場合、「
{"AccountRecordLimit": 5}」と入力します。複数のプロパティを指定する場合は、{"AccountRecordLimit": 5, "Greeting": "Hello"}のようにキーと値のペアをカンマで区切ります。 -
FlexCard でレコード ID コンテキスト変数を使用している場合、関連レコードデータを表示するには、レコード ID を入力します。
公開された属性と FlexCard のコンテキスト ID についての詳細は、「Configure Flexcard Settings」を参照してください。
-
必要に応じて、オブジェクトの API 参照名を{!objectApiName}形式でパラメーターとして入力します。
たとえば、取引先レコードページの場合は、「
{!Account}」と入力します。 - FlexCard ユーザー操作を追跡するには、[Enable OmniStudio Analytics] を選択します。
- エクスペリエンスビルダーサイトをプレビューし、必要に応じて変更します。
- エクスペリエンスビルダーサイトを公開します。
エクスペリエンスビルダーページへのユーザーアクセスの設定
オムニ UI カードオブジェクトへの「すべてのレコードの参照」アクセス権をユーザーに付与して、エクスペリエンスビルダーサイトで FlexCard が表示されるようにします。また、Apexクラスのアクセスを制御するために必要な権限セットとグループを設定します。
「エクスペリエンスサイトユーザー向けの OmniStudio 標準権限セットの設定」を参照してください。
Lightning Web Runtime サイトでの FlexCard の使用に関する考慮事項
Lightning Web Runtime(LWR)Experience CloudサイトでFlexCardを使用する場合の考慮事項について説明します。
LWR サイトでは、既存の FlexCard と新規作成された FlexCard の両方を使用できます。LWR サイトに埋め込む FlexCard を選択する前に、いくつかの重要な考慮事項を確認してください。
FlexCard は、LWR サイトビルダーの [顧客インタラクション] カテゴリで使用できます。FlexCard が正しく表示され、適切に機能するように、次のポイントをメモし、LWR サイトに適合する FlexCard のみを選択してください。
- FlexCard を変更する場合は、子 FlexCard か親 FlexCard かに関係なく、FlexCard を使用するサイトを必ず再公開してください。メモ サイトビルダーを使用してサイトを再公開する前に、サイトに組み込んだ他の製品の他の要素を考慮してください。すべてが本番環境に対応している場合にのみ再公開します。
- LWR サイトで [OmniScript を開く] オプションを使用するには、必ずページの [プロパティ] セクションで [Load Omniscript from URL (URL から OmniScript を読み込む)] チェックボックスをオンにします。このチェックボックスは OmniScript コンポーネントに追加され、[アクション種別] で設定された URL に存在する OmniScript が読み込まれます。このアクションを機能させるには、lwcos ページも作成する必要があります。詳細は、「Launch an Omniscript from an Omniscript Action on a Flexcard in Experience Cloud (Experience Cloud での FlexCard での OmniScript アクションからの OmniScript の起動)」を参照してください。
- LWR サイトの [スタイル] タブは Flexcard 要素では機能しません。FlexCard デザイナー内で使用できるオプションを使用して引き続き FlexCard のスタイルを制御できますが、LWR サイトビルダーにネイティブな設定とは互換性がありません。
- カスタム LWC がサポートされています。ただし、技術的な制限により、ネストされたカスタム LWC を期待どおりに動作させるには回避策が必要です。LWR サイトはキャッシュされたデータを操作するため、サイトのカスタム LWC 内にネストされた FlexCard と OmniScript が検索されます。存在する場合、ビルド時に適切なコンポーネントが読み込まれます。これを行うには、ここで説明されている 2 つの方法のいずれかを選択します。
- サイトでページを作成し、メイン LWC コンポーネントのネストされたすべてのコンポーネントをこのページに追加します。ナビゲーションオプションとしてユーザーに表示されないようにページを非表示にします。
- カスタム LWC を追加するページで、連動する FlexCard と OmniScript を追加します。次に、各コンポーネントの [表示] タブで表示を制御します。たとえば、[Show Component on Desktop (デスクトップにコンポーネントを表示)] 切り替えをオンにして、「User ID equals Invalid_User」という条件を追加できます。Invalid_User は実際のユーザー ID と一致しない値であるため、この条件は常に false になります。そのため、連動コンポーネントはユーザーに非表示のままですが、LWR サイトでは引き続き検出およびキャッシュできます。
- [デジタルエクスペリエンス] ページから LWR サイトを開くと、サイトでは未認証ユーザーとみなされ、ゲストユーザーが使用できるデータがある FlexCard のみが表示されます。すべてのデータが表示されるようにするには、サイトでログインページを実装します。次に、サイト名の横にある [ワークスペース] リンクに移動します。[管理] をクリックし、左ナビゲーションペインで [ログイン & 登録] タブを見つけます。[ログインページ種別] ドロップダウンに値があり、[Allow employees to log in directly to an Experience Cloud site (Experience Cloud サイトへの従業員の直接ログインを許可)] チェックボックスがオンになっていることを確認します。
-
![[ログインページの設定] オプションが表示されている [ログイン & 登録] ページ](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio-262-0-0-production-jajp/5e7dd1ac-9d7d-45ea-b982-a22c2115c9f8/omnistudio/images/login_on_lwr.png)
- データソースとしてのストリーミング API は LWR では機能しません。
