機械翻訳について

SSLを介した個別のユーザー資格証明を使用したGroovyからの外部SOAP Webサービスのコール

この例では、外部の保護されたSOAP webサービスへの接続を作成し、アプリケーション・コンポーザで使用されるGroovyスクリプトからWebサービスをコールする方法を示します。 webサービスは、個別のユーザー資格証明とsecure sockets layer (SSL)を持つセキュリティ・スキームを使用します。

次の表に、このシナリオの主な決定がまとめます。

検討事項

この例の場合

webサービス接続に使用する名前は?

mathsws

使用するWeb Services Description Language (WSDL)ファイルのURLは何ですか。

https://external-hosted:7102/MathsWS-Model-context-root/UsernameTokenOverSSLSecurity?wsdl

このWSDLファイルは、目的のSSLセキュリティ・スキームを指定します。

ノート:

ここに示すURLは、任意の例です。 サービス・プロバイダから実際のWSDL URLを取得する必要があります。

どの資格証明キーを使用しますか。

mylogin

webサービスはどこから呼び出されますか。

カスタム・フィールドのデフォルト値の計算に使用されるGroovyスクリプト式から。

Groovyスクリプトから呼び出されるwebサービス・メソッドはどれですか。

getSum

このメソッドは、2つの整数引数値の合計を返します。

webサービスからのレスポンスでタイムスタンプを無視する必要がありますか。

はい。

タイムスタンプを無視するには、「タイムスタンプ検証の無効化」チェック・ボックスを選択します。 これは、相互運用性の問題に対処するために必要になる場合があります。

SSLで保護されたGroovyスクリプトからwebサービスをコールするには、次のタスクを実行します:

  1. webサービス接続を作成します。

  2. webサービス・コールをGroovyスクリプトに追加し、コールが成功したことを確認します。

前提要件

次の前提条件ステップが完了していることを確認します:

  1. webサービス・プロバイダから、使用するWSDL URLおよびユーザー資格証明の詳細を取得します。

  2. webサービス・プロバイダからサーバーの認証局(CA) SSL証明書を取得します。

  3. 計算されたデフォルト値を持つオブジェクトのカスタム・フィールドを作成します。

  4. フィールドのデフォルト値の計算に使用される式のGroovyスクリプトを準備します。 Groovyコードでは、引数値を準備する必要があります。この例では、合計される2つの値です。

Webサービス接続の作成

webサービス接続を作成する場合は、Webサービスの名前、WSDLファイルのURLおよびセキュリティ・スキーム設定を指定します。 この名前は、アプリケーション・コンポーザの式ビルダーでwebサービスのリストで使用される識別子にすぎません。

  1. アプリケーション・コンポーザで、「共通設定」ペインで「Webサービス」を選択します。

  2. 「Webサービス」ページで、新規アイコンをクリックし、SOAPをクリックします。

  3. 「SOAP Webサービス接続の作成」ページの「名前」フィールドにmathswsと入力します。

    名前にピリオドを含めることはできません。

  4. WSDL URLフィールドにhttps://external-hosted:7102/MathsWS-Model-context-root/UsernameTokenOverSSLSecurity?wsdl lと入力し、「WSDLの読取り」をクリックします。

    管理者が問題を解決するには、サービス・リクエストを作成する必要があります。

  5. 管理者のサービス・リクエストを作成します:

    1. webサービス・プロバイダからサーバーの認証局(CA) SSL証明書を取得します。

    2. サービス・リクエストにSSL証明書を添付し、WSDLのロケーションとエラーの詳細を含めます

    3. サービス要求を送信します。

    管理者は、SSL証明書をOracle Fusion CRMトラスト・ストアに追加します。

  6. SSL証明書がインポートされたことを管理者に知らせるまで待ってから、サービス・リクエストをクローズします。

  7. ステップ1 ~ 4を繰り返します。

  8. 「資格証明キー」フィールドの横にある新規キー・アイコンをクリックします。

  9. 「キーの作成」ダイアログ・ボックスで、「資格証明キー」フィールドに名前(この例ではmylogin)を入力し、webサービス・プロバイダが提供するユーザー名とパスワードの資格証明を入力して、OKをクリックします。

  10. Webサービスからのレスポンス・ヘッダーのタイムスタンプが無視されるように、「タイムスタンプ検証の無効化」を選択します。

  11. 「保存してクローズ」をクリックします。

    webサービス接続が作成され、名前とWSDL URLが「Webサービス」ページにリストされます。

GroovyスクリプトへのWebサービス・コールの追加

Groovyスクリプトを作成または編集するときに表示される「式ビルダー」ダイアログには、接続を作成したwebサービスをリストする「Webサービス」タブがあります。 webサービスごとに、Groovyスクリプトで使用可能なメソッドへのコールを含めることができます。

  1. アプリケーション・コンポーザで、webサービス・コールを含む式を使用するカスタム・フィールドを編集します。

  2. 「式ビルダー」アイコンをクリックします。

  3. 「式ビルダー」ダイアログで、「Webサービス」タブを選択します。

  4. 「Webサービス」リストからmathswsを選択します。

  5. 「関数」リストからgetSumを選択します。

  6. webサービス・コールを挿入するスクリプト内の位置にカーソルを置きます。

  7. 「挿入」をクリックして、webサービス・メソッドを呼び出すコードを挿入します。

  8. webサービス・コールの引数として2つの整数値が指定されるようにスクリプトを更新します。

  9. 「送信」をクリックします。

  10. webサービス・コールが成功することを確認します。この例では、カスタム・フィールドに予想されるデフォルト値が必要です。