クライアント側ドキュメント生成を詳しく調べる
学習の目的
この単元を完了すると、次のことができるようになります。
- ドキュメントテンプレートにデータを渡す 3 つの方法を説明する。
- サンプルのクライアント側 OmniScript の要素を説明する。
ドキュメント生成プロセスの構築
これまでに、Salesforce システム管理者の Linda が Candace とチームに最適なドキュメントテンプレートを作成する過程を見てきました。
Microsoft Word や PowerPoint のテンプレートを作成し、トークンを適切な場所に挿入しました。テンプレートを Salesforce の Document Template Designer にインポートし、設定を定義し、テンプレートをテストして問題なく機能することを確認しました。今みなさんが考えているのは、「Candace のチームが使用できるように、Linda はドキュメントテンプレートをビジネスプロセスにどうやって組み込むのだろうか」ということではないでしょうか。
OmniStudio Document Generation のドキュメントはすべて、JSON インプットデータをテンプレートに渡して作成されます。このテンプレートは先ほど作成しました。JSON インプットデータは OmniScript またはカスタムクラスによって提供されるか、指定した DataRaptor を使用してデータをテンプレートに抽出できます。
- 営業担当がドキュメントを生成するためにフォームに入力する必要があるなど、ユーザー操作が必要な場合は、クライアント側ドキュメント生成プロセスを使用します。
- トリガーに応答してドキュメントを生成するなどのプロセスを自動化する場合や、ドキュメントが大きい場合は、サーバー側ドキュメント生成を使用します。
クライアント側ドキュメント生成について詳しく見ていきましょう。
データをドキュメントテンプレートに渡す
クライアント側ドキュメント生成では、データをドキュメントテンプレートに渡す方法が 3 つあります。
- 提供されたサンプル OmniScript をカスタマイズする。
- 新しい OmniScript を作成する。
- JSON インプットを使用する。
カスタマイズされたサンプルのクライアント側 OmniScript
OmniStudio Document Generation には、ドキュメントを生成するサンプル OmniScript が含まれています。OmniScript は、オブジェクト ID やドキュメントのフォーマットオプションといった必要な情報を収集するステップを表します。最後のステップで、ダウンロード用に生成されたドキュメントのプレビューが表示されます。
サンプル OmniScript は汎用的に作られているため、ユースケースに合わせてカスタマイズすることができます。サンプルをドキュメントテンプレートに使用するには、必ずテンプレートに DataRaptor Extract と DataRaptor Transform を含めてください。サンプル OmniScript はドキュメントに使用する Salesforce データを抽出するようにはなっていません。この DataRaptor は前の単元で Document Template Designer を使用して設定しました。
OmniScript を使用したユーザーデータの収集
ドキュメントを生成するには、ユーザーデータを収集する別の OmniScript を使用してドキュメントに渡すこともできます。たとえば、自動車保険契約の OmniScript でお客様の名前、生年月日、住所、車の詳細を尋ね、そのデータをテンプレートに渡します。この OmniScript にはすでに DataRaptor または Integration Procedure が含まれているため、テンプレートに必要なのは DataRaptor Transform のみで、前の例のように DataRaptor Extract は必要ありません。
カスタムクラスの JSON インプット
品目数が 200 を越えるなど、ドキュメントのデータ量が多い場合、カスタム Apex クラスを使用してデータを抽出し、JSON インプットを生成できます。そうすれば、OmniScript または DataRaptor Extract は必要ありません。この方法を使用するには、Document Template Designer でカスタム Apex クラスをドキュメントテンプレート自体に接続します。
サンプルのドキュメント生成 OmniScript
OmniStudio Document Generation をすばやく活用する簡単な方法の 1 つは、サンプル OmniScript を使用することです。Linda はこれを使用して Cloud Kicks 営業チームのためにドキュメント生成プロセスを作成しました。サンプルはテンプレートをテストするために使用したり、独自の OmniScript を作成するための開始点として使用できます。エンドユーザーはレコードページから OmniScript を起動してドキュメントを生成できます。
[OmniScript] タブにある「docGenerationSample/fndSingleDocxLwc」という名前のサンプル OmniScript を見つけてください。
Linda はサンプル OmniScript の新しいバージョンを作成します。このバージョンを新しいドキュメント生成 OmniScript の開始点として使用します。そうすると、元のサンプル OmniScript はそのまま変更されないため、Linda はまた後で元のサンプル OmniScript を使用して他の OmniScript を作成することができます。
サンプル OmniScript の要素と、Linda がユースケースに合わせてカスタマイズする手順を一緒に見ていきましょう。サンプルのクライアント側ドキュメント生成 OmniScript には、OmniScript が呼び出されると順次実行される 7 つのステップが含まれています。
画像内のプラスアイコン (+) が示すホットスポットをクリックすると詳細が表示されます。
クライアント側ドキュメント生成は、ユーザー操作を必要とするビジネスプロセスや、小さなドキュメントを生成する場合に適したオプションです。次の単元では、サーバー側ドキュメント生成とその利点について学習します。
