例: 統合カタログへのサービスプロセスの移行
Service Process Studio のサービスプロセス定義を標準商品レコードに変換することで、受入要求の管理方法を簡素化します。すべての商品とサービスを 1 か所でまとめて管理します。
必要なエディション
| 使用可能なインターフェース: Lightning Experience |
| 使用可能なエディション: Financial Services Cloud と統合カタログが付属する Enterprise Edition、Unlimited Edition、および Developer Edition。 |
開始する前に、Service Process Studio で最初に作成された有効なストップチェック支払サービスプロセスがあることを確認します。
この ToDo では、例として [Stop Check Payment (チェック支払を停止)] サービスプロセスを使用して移行手順を示します。このシナリオでは、元のサービスプロセス定義に Check Number、Check Date、Amount などの 3 つの属性と、対応する API 参照名 Check_Number、Check_Date、Amount が含まれます。次の手順に従ってこの特定のプロセスを移行し、ロジックを調整して独自のサービスプロセスを移行します。
-
統合カタログでサービスを作成します。
統合カタログでは、Product2 レコードを使用してサービスを定義します。このレコードを作成して、サービスの一意の商品 ID を生成します。
- アプリケーションランチャーで、[統合カタログ] を見つけて選択します。
- [ホーム] ページで、[新規] をクリックし、[サービスプロセス] を選択します。
- [名前] に「Stop Check Payment」と入力し、残りのフィールドに入力します。
- 変更内容を保存します。
-
統合カタログのサービスデザイナーで、次のアクションを実行します。
- [次へ] をクリックします。
-
[属性] ステップで、元のサービスプロセス定義の属性を再作成します。
[チェック番号] 属性では、データ型として [テキスト] を使用します。[チェック日] 属性のデータ型として [日付] を使用します。[金額] 属性のデータ型として [数値] を使用します。「プロセス属性の設定」を参照してください。
メモ 受入プロセスまたは履行プロセスでミスマッチエラーが発生しないように、各属性の API 参照名を元の Service Process Studio 定義の API 参照名と一致させてください。 - [受入フォーム] ステップで、[Stop Check Payment (小切手支払を停止)] サービスに関連付ける受入フォームと履行フローを添付します。「Design Request Intake Form (要求受入フォームの設計)」を参照してください。
- [履行フロー] ステップで、[小切手支払を停止] サービスに関連付ける履行フローを追加します。「Configure Request Fulfillment」を参照してください。
- [詳細オプション] の [インテグレーション] ステップで、[小切手支払を停止] サービスに関連付けるインテグレーション定義を追加します。
-
この新しいサービスのブラウザー URL で、レコード ID をコピーします (例: 01tDn00000Wxyz)。
01tDn00000Wxyz は、サービスの商品 ID です。
- 変更を保存し、[小切手支払を停止] サービスを有効化します。
-
OmniStudio データマッパー変換を作成します。
受入フォームデータを CustomAttributes JSON 構造に対応付けます。統合カタログコネクト API では、CustomAttributes という特定の JSON ノード内でラップされたすべてのサービス固有のデータが必要です。既存の OmniScript ではデータがフラットなキー-値形式で保存される可能性があるため、API のペイロードを正しく構造化するにはこの変換が必要です。

- 作成したデータマッパー変換で、[変換] タブに移動します。
- [Manage Input/Output Type (入力/出力種別の管理)] をクリックします。
-
[入力 JSON を編集] 項目に、入力 JSON を入力します。
入力 JSON は、サービスプロセス要求を送信する直前のデータを OmniScript 内に存在するとおりに表します。
支払確認の停止サービスプロセスのサンプル入力 JSON 構造を次に示します。
{ "Check_Number": "1042", "Check_Date": "2026-02-15", "Amount": "2500" } -
[予想される JSON 出力を編集] に、予想される出力 JSON を入力します。
期待出力 JSON は、統合カタログ Connect API で必要なペイロード形式です。
[Stop Check Payment (小切手支払を停止)] サービスプロセスの CustomAttributes ノードが含まれる、予期される出力 JSON 構造の例を次に示します。
{ "CustomAttributes": { "checkNumber": "1042", "checkDate": "2026-02-15", "amount": "2500" } } -
OmniScript の入力項目を CustomAttributes ノードの対応する出力項目に対応付けます。「変換の入力と出力のマッピング」を参照してください。
対応付けられた入力項目と出力項目の例を次に示します。

-
OmniStudio Integration Procedure を作成します。
統合カタログ Connect API をコールしてサービスプロセスデータを渡すように Integration Procedure を設定します。元の Service Process Studio では、Service Process Connect API を使用してサービスプロセス要求のケースが作成されていました。統合カタログでは、ServiceRequestCaseApiService という商品駆動型 API が使用されます。この API では、新しく作成されたケースをカタログ項目にリンクするために productId を渡す必要があります。また、各特定のサービス属性を個別のキーと値のペアとして対応付ける必要があります。これにより、統合カタログで受入データが正確に読み取られ、ケースレコードに対して正しく構造化されます。Integration Procedure の名前を後で使用するためにコピーします。
- 作成した Integration Procedure で、[Remote Action (リモートアクション)] ステップを追加します。
- リモートクラスとして「serviceprocess.ServiceRequestCaseApiService」と入力します。
-
リモートメソッドとして「callServiceRequestApiToCreateCase」と入力します。

- [Additional Input (追加入力)]、[Additional Output (追加出力)]、[Failure Response (失敗時の応答)] セクションを展開します。
- [Additional Input (追加入力)] セクションで、productId、svcCatalogItemDefApiName、inputToRequestPayloadTransformDataMapper キーを追加します。
- productId キーに、サービスの商品 ID を入力します。たとえば、01tDn00000Wxyz です。
- svcCatalogItemDefApiName キーには、サービスの名前を入力します。例: 小切手支払の停止。
- inputToRequestPayloadTransformDataMapper キーに、作成したデータマッパー変換の API 参照名を入力します。
-
同じ [追加入力] セクションで、サービスプロセスの各属性を新しいキーと値のペアとして追加します。たとえば、キーを [金額] に設定し、OmniScript のデータを Integration Procedure に対応付ける値を設定します。
[小切手支払を停止] サービスプロセスの Integration Procedure への入力例を次に示します。

- Integration Procedure を保存して有効化します。
-
[Stop Check Payment Service Process (チェック支払サービスを停止)] プロセスの受入 OmniScript を更新します。
- 既存の OmniScript のバージョンを作成します。
- サービスプロセス要求のケースを作成する CreateCase ステップを見つけて選択します。
- [インテグレーション手順アクションのプロパティ] の [インテグレーション手順] 項目に、作成したインテグレーション手順の名前を追加します。
- [追加ペイロード] セクションで、サービスプロセスのすべての属性をキーと値のペアとして追加します。
- Omniscript を有効化します。

