ナビ付きでトピックを開く

[Web サービス要求の送信] 操作では、Integration Service から HTTP 要求が Web サービス (REST または SOAP) に送信されます。

You can configure the following properties for the Send Web Service Request action:

アクション

• 名前: 操作の名前を指定します。 必要な場合は、フィールドに新しい名前を入力して既定名を置き換えられます。

• 説明: 操作の説明を保存できます。

• Run Action: 操作を実行する頻度を指定できます。

  • 常に: Integration Service で統合が実行されるたびに操作が実行されます。

  • しない: Integration Service での統合の実行時に操作は実行されません。

  • Conditionally, based on variable: Specifies that the Integration Service will run the action only when a selected variable meets a specified condition. このオプションは、操作を実行するかどうかを決定する条件が 1 つのみの場合に使用してください。 このオプションを有効にすると、表示される入力ボックスに条件ステートメントを作成できます。

    入力ボックスコントロール

    • 変数: 条件ステートメントに使用する変数を入力します。 Alternatively, you can add a variable for the conditional statement value.

    • [Relational Operator]: 条件ステートメントに使用するリレーショナル演算子を指定します。 既存の演算子をクリックすると、追加の演算子のリストが表示され、使用する演算子を選択できます。 For more information, refer to Relational Operators. The operators available in the list depend on whether you have selected Text or Decimal for the Type option.

    • 値: Specifies the value(s) to use for the conditional statement. Some operators, such as Is null and Is not null, do not require a value to be specified. In these situations, the Value field is not available.

    • 種類: Specifies whether the conditional statement is evaluating a text or decimal value.

       

  • 式に基づく条件に従う: Specifies the conditions under which the Integration Service will run the action. このオプションは、条件ステートメントが複数必要な場合に使用します。 このオプションを有効にすると、必要な条件ステートメントを作成することによって、表示された入力ボックスに条件式を作成できます。 You create and edit your conditional expression on the Tree View tab. Click the Text View tab to see a read-only text view of the conditional expression.

    入力ボックスコントロール (ツリービュータブ)

    • [Conditional Joiner]: グループ内の条件ステートメントの条件付き結合子を指定します。 The default conditional joiner is And.

      既存の条件付き結合子をクリックすると、以下のいずれかの方法で条件式を設定できるメニューが表示されます。

      • Select a different conditional joiner: The menu options include a list of conditional joiners. 条件ステートメントで使用する条件付き結合子を選択します。 For more information about the supported conditional joiners, see Conditional Joiners.

      • Add Condition: クリックして現在のグループに他の条件ステートメントを追加します。

      • Add Group: Click to add a sub-group of conditional statements to the current group.

      • Remove Group: メニューがサブグループから開かれたときに表示されます。 クリックしてサブグループを削除します。

      • Clear All: メニューが最上位グループから開かれたときに表示されます。 クリックすると、すべての条件ステートメント (サブグループを含め) が削除されます。

    • : 式内の各条件付き結合子の右隣に表示されます。 クリックすると、その結合子に関連づけられたグループに条件ステートメントが追加されます。

    • : 既存の条件ステートメントにカーソルを載せると表示されます。 Click to delete the conditional statement.

    • 変数: 条件ステートメントに使用する変数を入力します。 Alternatively, you can add a variable for the conditional statement.

    • [Relational Operator]: 条件ステートメントに使用するリレーショナル演算子を指定します。 既存の演算子をクリックすると、追加の演算子のリストが表示され、使用する演算子を選択できます。 For more information, refer to Relational Operators. The operators available in the list depend on whether you have selected Text or Decimal for the Type option.

    • 値: Specifies the value(s) to use for the conditional statement. Some operators, such as Is null and Is not null do not require a value to be specified. このような場合、値フィールドは非表示になります。

    • 種類: Specifies whether the conditional statement is evaluating a text or decimal value.

Web サービス要求

• URL: 送信宛先の Web サーバーの URL を入力します。 または、変数を追加して URL を指定できます。

• 方法: 使用する Web 要求 HTTP メソッドを選択します。 POST、GET、PUT、DELETE または HEAD などのオプションが使用できます。

• 内容種類: Select the content-type to use for the web request. POST または PUT メソッドを使用している場合のみ使用できます。

• HTTP ヘッダー: HTTP ヘッダープロパティと、Web 要求と共に送信する値を指定します。 You can select from a dictionary of HTTP header properties and values, or you can add a variable to specify the header property or value. You can also add a special character to the value you have entered.

Source

• Content-Data: Specifies the content-data that you want to be sent with a POST or a PUT web request HTTP method. [方法] プロパティで POST または PUT を使用している場合に使用できます。

• クエリ文字列: GET、DELETE または HEAD Web 要求 HTTP メソッドで送信するクエリ文字列を指定します。 [方法] プロパティで GET、DELETE または HEAD を使用している場合に使用できます。

  • 埋め込みテンプレート:

    • 値: 表示される入力ボックスを使用して、操作で使用するテンプレートを入力します。 Alternatively, you can add a variable to specify the template, or add a special character to the value you have entered.

    • インポート: Opens the Open File dialog so that you can browse to and select a file containing the desired script. ファイルの内容が、[値] 入力ボックスにインポートされます。

    • エクスポート: [値] 入力ボックスの内容を外部ファイルに保存できる [ファイルの保存] ダイアログが開きます。 値を新しいファイルとして保存するか、または既存ファイルの内容と置換できます。

  • 変数:

    • 変数: ソースに使用する変数を入力します。 または、変数を追加できます。

  • 外部ファイル:

    • 場所: ソースフォルダが存在するファイルシステムを指定します。 File systems or locations can include local file systems or network shares, Librarian, or a supported cloud storage location. For more information about supported cloud storage locations, see Administration Console's Cloud Storage Page.

    • ファイル名: ファイルパスを指定します。 フォルダの場所とファイル名を入力するか、[参照] をクリックして参照し、目的のファイルを選択します。 Alternatively, you can add a variable to specify the desired file, or add a special character to the value you have entered.

    • ファイルのエンコーディング: ソースファイルによって使用されるエンコーディングを指定します。

  • HTTP 要求変数:

    • 変数名: ソースとして使用する HTTP 要求変数の変数名を指定します。

    • 値: HTTP 要求変数の値を指定します。

証明

• 方法: Specifies the authentication method that the action uses to connect to the client.

  • 名前がありません: Allows any user to access the client without providing a user name and password.

  • 最新の Windows 証明書を使用してください: Uses the current Windows user account to connect to the client.

  • 指定された証明書を使用してください: Uses the user name, domain, and password that you provide to connect to the client.

レスポンス

• 成功状態コード: Enables you to specify the status codes that you deem successful.

• Web サービス応答を変数に保存: Web サービス応答を保存する変数を指定します。 Enter the desired variable in the input box. または、変数を追加できます。

詳細オプション

• SOAP Body タグにソース内容を包含: Specifies that the source content will be wrapped in a SOAP Body tag before being sent.

• 送信タイムアウト: Specifies the amount of time in seconds to wait for a response from the client before the action fails.

• 再試行回数: Specifies the number of times to re-send the request if the action fails.

テスト: Web サービス要求の送信

• テスト: 操作を実行します。 The Message pane displays information on the success or failure of the action.

  Clicking the Test button executes the action only and does not run the integration. このため、使用するよう設定した統合からのデータは使用せずに操作が実行されます。 For information on testing your integration, refer to Using the Test Pane.

ログオン設定

• Inherit from parent action: When enabled, the action inherits the user account credentials specified on the Actions property page. Alternatively, if the action is part of a Group action, it will inherit the user account credentials specified on the immediate parent Group action’s property page.

• ユーザーの認証情報を指定: このオプションを有効にすると、操作は、指定された資格情報を使用して実行されます。

エラー処理および診断

• Ignore errors and continue running actions: このオプションを有効にすると、操作が失敗したときに他の操作の実行が継続されます。

  このプロパティが有効でない場合は、操作が失敗したときの動作は以下のシナリオによって異なります。 If you have specified Sequentially for the Execute Actions property of the selected action's hierarchical Actions or Group property page, no further actions within that group are executed. If you have specified In Parallel for the Execute Actions property of the action's hierarchical Actions or Group property page, the actions within that same group are not affected; the errors are ignored and the other actions within the group are executed. If the selected action is within a Group action, no actions outside of that Group action are affected.

• Retry if failed: このオプションを有効にすると、操作が失敗したときに操作の実行が再試行されます。

• Maximum retries: 操作の実行の最大再試行回数を指定します。 Available when Retry if failed is enabled.

• Retry interval: 操作の失敗時に操作の実行を再試行するまでの時間を指定します。 Available when Retry if failed is enabled.