SOAP アクティビティ出力変数を自動マッピングする

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:3分
  • ServiceNowアクティビティデザイナーを使用すると、SOAP テストペイロードのパラメーター値を [出力] ステージの変数に自動的にマッピングできます。

    始める前に

    必要なロール:web_service_admin、activity_admin、activity_creator

    このタスクについて

    注:
    オーケストレーションがエンドポイントに接続してデータを返すのに十分な情報を提供している場合は、アクティビティデザイナーのどのステージからでも入力変数をテストできます。通常、[実行コマンド] ステージが、入力のテストの準備ができているポイントです。

    手順

    1. アクティビティデザイナーでは、[実行コマンド] ステージに進みます。
    2. 必要に応じて、適切な MID サーバーを定義します。
      MID サーバーが見つからない場合、またはターゲットに接続できない場合、テストは失敗します。
    3. [アクティビティをテスト] をクリックして、入力パラメーターをテストします。
      パラメーターとフィールドの実際の値を追加した場合、指定したターゲットに対してこれらの値が実行され、結果のペイロードが返されます。入力変数をフィールドとパラメーターにマップした場合、これらの変数にテスト値を割り当てるためのダイアログ ボックスが表示されます。
    4. 必要に応じてテスト値を入力し、[OK] をクリックしてペイロードを表示します。
      [応答] フォームの [Raw 出力] タブに、ペイロード全体が表示されます。
      自動マッピングコントロール
    5. 次の自動マッピング オプションのいずれかを選択します。
      • ローカルに自動マップ:値をアクティビティ内で使用するためにローカル変数に直接マップします。
      • 出力する自動マップ:値を出力変数に直接マッピングして、ワークフロー内の他のアクティビティに渡します。出力変数への自動マッピングによって、オブジェクトのアレイが作成されます。それぞれに、クエリ結果からの列名が含まれます。

    SOAP メッセージ WSDL にアクセスするための認証情報を提供する

    テストペイロードで要求している SOAP WSDL に認証が必要な場合、SOAP メッセージまたは SOAP アクティビティのいずれかに基本認証情報を指定する必要があります。

    始める前に

    必要なロール:web_service_admin、activity_admin、activity_creator

    ServiceNow インスタンスは、WSDL へのアクセスに基本認証情報のみサポートします。SOAP 機能または SOAP メッセージがこれらの認証情報を提供しない場合は、それらを SOAP アクティビティテンプレートで設定する必要があります。オーケストレーションでは、次の優先順位を使用して、使用するベーシック認証情報を決定します。
    • SOAP メッセージ:他の認証情報が定義されていない場合は、SOAP メッセージの認証情報が使用されます。
    • SOAP 関数:SOAP 関数の認証情報は、SOAP メッセージ用に構成された認証情報を上書きします。
    • SOAP アクティビティテンプレート:SOAP アクティビティテンプレートの認証情報は、SOAP 関数と SOAP メッセージ認証情報の両方を上書きします。

    手順

    1. 移動先 すべて > システム Web サービス > アウトバウンド > SOAP メッセージ.
    2. アクティビティで使用する SOAP メッセージを選択します。
    3. SOAP メッセージ レコードで、[WSDL のダウンロード] チェック ボックスをオンにします。
    4. [認証タイプ] フィールドで、[基本] を選択します。
      [基本認証プロファイル] フィールドが表示されます。
    5. この SOAP メッセージで使用する基本認証プロファイルを選択します。
      図 : 1. SOAP メッセージのベーシック認証
      SOAP メッセージのベーシック認証
    6. あるいは、SOAP 実行コマンドを設定する でベーシック認証情報を設定できます。
      1. [認証] フィールドで、[ベーシック認証情報で上書きする] を選択します。
        [認証情報] フィールドが表示されます。
      2. WSDL へのアクセスに使用する基本認証情報を選択します。
        この設定は、SOAP メッセージで設定された認証情報を上書きします。
        図 : 2. 基本認証情報を上書きする
        基本認証情報を上書きする