36 Oracle Sales CloudでのSOAP Webサービス起動のトラブルシューティング
Oracle Sales Cloudでは、SOAP Webサービス起動の結果をログに記録してから、アプリケーション・コンポーザのランタイム・メッセージ・ツールを使用して、記録されたログ・エントリを表示できます。
一般的な概要
SOAP Webサービス起動の結果をトラブルシューティングするには、起動の結果をログに記録するメカニズムを設定する前に、最初にWebサービスをOracle Sales Cloudに登録する必要があります。Oracle Sales Cloudオブジェクト・ページ上のボタンに関連付けられたグローバル関数をコールすることにより、結果をログに記録できます。最後に、結果を分析するには、Webサービスの出力が格納されたOracle Sales Cloudのランタイム・メッセージ・コンテナにアクセスする必要があります。
前提条件
Oracle Sales CloudでSOAP Webサービス起動の結果を記録および表示する前に、次の各事項について検討してください。
-
次のOracle Sales Cloudユーザー・ロールの1つがあることを確認します。
-
CRMアプリケーション管理者
-
アプリケーション実装コンサルタント
-
営業管理者
注意:
これらのロールのいずれもない場合は、管理者に問い合わせてください。 -
-
Oracle Sales Cloudにサインオンします。
-
テストの場合、アクティブ化した開発サンドボックスで作業していることを確認してください。「Oracle Sales Cloudサンドボックスでの作業の概要」を参照してください。
-
必要なSOAP Webサービスが予期したとおりに公開されて動作していることを確認してください。
-
Oracle Sales CloudでSOAP Webサービスを構成および起動する方法の詳細は、「Oracle Sales CloudでのSOAP Webサービスの使用」を参照してください。
SOAP Webサービス参照の作成
Oracle Sales Cloudアプリケーション・コンポーザ・ユーティリティを使用して、使用対象のSOAP Webサービスを登録できます。
-
WSDL URL
-
予期される入力パラメータ
-
レスポンス出力の構造
-
使用中のセキュリティ・スキーム
始めに、次の手順に従います。
SOAP Webサービスをコールするグローバル関数の作成
Oracle Sales Cloudアプリケーション・コンポーザ・ユーティリティを使用して、「グローバル関数」ノードの下に新しい関数を作成できます。
注意:
このタスクの後半では、この関数を拡張し、SOAP Webサービス・レスポンスのログ記録をアプリケーション・コンポーザのランタイム・メッセージに含める必要があります。新しいグローバル関数を作成したため、これがアプリケーション・コンポーザの「グローバル関数」リージョンに表示されます。
グローバル関数へのログ文の追加
Oracle Sales Cloudアプリケーション・コンポーザのランタイム・メッセージ・コンテナにログ・エントリを記録するために、任意のGroovyスクリプトでprintln
関数を使用できます。この例では、前のサブタスクで作成したグローバル関数を変更します。
println
文が既存のグローバル関数に含まれました。これらのログ・エントリは、使用されているアプリケーション・コンテナ用のアプリケーション・コンポーザのランタイム・メッセージ・コンテナで使用できます。グローバル関数をコールするアクションの作成
このサブタスクでは、既存のOracle Sales Cloudグローバル関数をコールするアクションを作成します。下記の手順では、説明を目的としてアプリケーション・コンポーザ内の営業アプリケーション・コンテナと商談オブジェクトを使用します。
グローバル関数をコールするボタンの追加
このサブタスクでは、アプリケーション・コンポーザを使用して、Oracle Sales Cloudで既存のアクションを起動するボタンを構成します。下記の手順では、説明を目的として営業アプリケーション・コンテナと商談オブジェクトを使用します。また、詳細ページ・レイアウトの下の「デフォルト・レイアウト」をカスタマイズします。
ランタイム・メッセージのログ記録の有効化
このサブタブでは、Oracle Sales Cloudアプリケーション・コンポーザを使用して、ランタイム・メッセージでのアプリケーション・スクリプトのログ記録を有効化します。
ランタイム・メッセージにログ記録されたWebサービス出力の表示
このサブタブが完了した後、Oracle Sales Cloudのランタイム・メッセージ・ログを使用してWebサービス起動の出力を表示および分析できるようになります。この例では、営業アプリケーション・コンテナを使用します。
重要:
次のステップを実行する前に、ランタイム・メッセージ・コンテナに一定量のWebサービス出力が記録されていることを確認してください。このドキュメントの前のサブタスクが正常に完了したら、該当するSOAP Webサービスを起動し、ランタイム・メッセージ内の結果を取り込むことができます。始めに、次の手順に従います。
注意:
ログ・レコードの先頭にアプリケーション・コンテナ名が追加されている場合、それに基づいてソートおよびフィルタできます。現在のユーザーのOracle Sales Cloudの「アプリケーション・スクリプト・ログ」が、選択したアプリケーション・コンテナの「ランタイム・メッセージ」リージョンに表示されます。