Data Source Wizard について
学習の目的
この単元を完了すると、次のことができるようになります。
- FlexCard を作成するための Data Source Wizard のステップを挙げる。
- FlexCard の定義方法を説明する。
- データソース種別の選択方法を説明する。
- データソースの選択方法を説明する。
- データソース入力の設定方法を説明する。
Data Source Wizard で FlexCard を作成する
FlexCard を作成する場合、Data Source Wizard によって次の一連のステップが実行されます。
- FlexCard を定義する。
- データソース種別を選択する。
- データソースを選択する。
- データソース入力を設定する。
1.FlexCard を定義する
このステップでは、FlexCard の名前、タイトル、作成者、説明、テーマなどの基本設定を行えます。また、この FlexCard を子カードとして設定すると、他の FlexCard に埋め込むこともできます。
名前と作成者の命名規則
FlexCard には、名前と作成者に対して厳格な命名規則があります。英数文字とアンダースコアのみを使用できます。スペース、ダッシュ、連続したアンダースコア、非英数文字は使用しないでください。FlexCard 名には、キャメルケース、パスカルケース、またはスネークケースを使用することをお勧めします。
これらの命名規則に従った FlexCard 名の例は次のとおりです。
- teamAccount
- TeamAccount
- team_account
これらのガイドラインの詳細は、ヘルプの FlexCard の命名規則記事を参照してください。
タイトル
タイトルを設定することで、生成された FlexCard Lightning Web コンポーネントを Lightning アプリケーションビルダーとコミュニティビルダーで見つけることができます。
テーマ
FlexCard のテーマには 2 つのオプションがあります。Salesforce Lightning Design System (SLDS) を使用する場合は [Lightning] を、Newport Design System を使用する場合は [Newport] を選択します。Newport はデザイナーと Web 開発者向けの CSS フレームワークツールです。1 か所ですべての OmniStudio コンポーネントのスタイルを簡単に変更したり、今後すべてのページに使用できる最適化されたカスタム CSS を生成したりできます。
FlexCard を保存すると、名前、作成者、またはテーマを編集できなくなります。編集を完了する必要がある場合は、FlexCard をコピーして、コピー作成時にこれらの設定を更新します。
2.データソース種別を選択する
FlexCard には、Salesforce オブジェクトや外部データソースからのデータ、またはサンプル (モック) データが表示されます。データソース種別によって、FlexCard がデータを取得する方法が決まります。
ウィザードでは、オプションがどのような場合に選択するかの簡単な説明と共に表示されます。
このソースは、FlexCard を有効化する前であればいつでも更新できます。たとえば、FlexCard の作成とテストを行いながら、カスタムソースを選択したり、サンプルデータを使用したりできます。その後、FlexCard の準備が整ったら、ライブデータソースに接続します。
では、使用できるデータソースの種別を確認しましょう。
- Apex REST は、Apex クラスの REST エンドポイントを使用してデータを返します。
- Apex Remote は、Apex Remote クラスとメソッドを使用してデータを返します。
- Custom は、サンプル JSON を使用して、最終的に別のデータソースに置き換えられる一時データで FlexCard を設定します。
- SOQL Query は、Salesforce Object Query Language (SOQL) を使用して、組織の Salesforce データから特定の情報を検索します。例: SELECT Name, Id FROM Account LIMIT 5。
- SOSL Search は、Salesforce Object Search Language (SOSL) を使用して、検索インデックスにテキストベースの検索クエリを作成します。
- Streaming API は、Salesforce ストリーミング API を使用して、Salesforce データの変更に関連付けられていない一般イベントの通知を送信します。
- SDK はソフトウェア開発キット (SDK) のメソッドを使用してデータを取得し、FlexCard の項目に入力します。
また、OmniStudio データツールを使用することもできます。
- Omnistudio Data Mapper は、Data Mapper Extract インターフェースを使用して Salesforce オブジェクトからデータを返します。
- Integration Procedure は、Integration Procedure を使用して内部と外部の複数のソースからデータを返します。
FlexCard には、データソースとして [None (なし)] を指定することもできます。親 FlexCard が親のデータソースのデータを子 FlexCard にプッシュするように設定されている場合、その子にはデータソースは必要ありません。子 FlexCard にデータソースがある場合は、親 FlexCard はデータソースを必要としないことがあります。
3.データソースを選択する
データソース種別を選択内容に応じて、データソース自体に表示するプロパティが決まります。この例では、Integration Procedure が選択されています。
使用する Integration Procedure を選択し、入力パラメーターを設定して、Integration Procedure に渡す変数を定義することで取得するデータを把握できるようにします。
この例では、Integration Procedure に取引先レコードの詳細を取得するように指示します。
4.データソース入力を設定する
このページでは、テスト変数を追加することで、実際のデータを使用して FlexCard をプレビューできます。FlexCard の作成を開始する前に、データソースからのテスト応答とパフォーマンスメトリクスを確認したり、JSON 形式で返されたデータをプレビューしたりできます。[Result JSON Path (結果の JSON パス)] (1) を絞り込むと、関連するデータのみが FlexCard に取り込まれます。
これで Data Source Wizard のすばらしい機能を理解できました。次は、データとアクションを FlexCard に表示する方法を見ていきましょう。