Open topic with navigation

The Send Web Service Request action directs the Integration Service to send an HTTP request to a web service (REST or SOAP).

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

Action

• Name: Specifies the name of the action. If desired, you can replace the default name by typing a new name in the field.

• Description: Allows you to save a description for the action.

• Run Action: Allows you to specify how often you want to run the action.

  • Always: Specifies that the Integration Service will run the action each time it runs the integration.

  • Never: Specifies that the Integration Service will not run the action when it runs the integration.

  • Conditionally, based on variable: Specifies that the Integration Service will run the action only when a selected variable meets a specified condition. Use this option in situations where there is only one condition that determines whether or not the action will run. Once you have enabled this option, you can create the conditional statement in the input box provided.

    Input box controls

    • Variable: Enter the variable that you want to use for the conditional statement. Alternatively, you can add a variable for the conditional statement value.

    • [Relational Operator]: Specifies the relational operator to use for the conditional statement. Click the existing operator to open a list of additional operators, and select the one you want to use. 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.

    • Value: 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.

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

       

  • Conditionally, based on expression: Specifies the conditions under which the Integration Service will run the action. Use this option for situations that require more than one conditional statement. Once you have enabled this option, you can create the conditional expression in the input box provided by creating the desired conditional statements. 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.

    Input box controls (Tree View tab)

    • [Conditional Joiner]: Specifies the conditional joiner for the conditional statements within the group. The default conditional joiner is And.

      Click the existing conditional joiner to access a menu that allows you to configure your conditional expression in one of the following ways:

      • Select a different conditional joiner: The menu options include a list of conditional joiners. Select the conditional joiner you want to use for the conditional statements. For more information about the supported conditional joiners, see Conditional Joiners.

      • Add Condition: Click to add another conditional statement to the current group.

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

      • Remove Group: Available in the menu when the menu has been opened from a sub-group. Click to delete the sub-group.

      • Clear All: Available in the menu when the menu has been opened from the top-most group. Click to delete all conditional statements (including sub-groups).

    • : Visible just to the right of each conditional joiner in your expression. Click to add a conditional statement to the group associated with that joiner.

    • :  Visible when you position the cursor over an existing conditional statement. Click to delete the conditional statement.

    • Variable: Enter the variable that you want to use for the conditional statement. Alternatively, you can add a variable for the conditional statement.

    • [Relational Operator]: Specifies the relational operator to use for the conditional statement. Click the existing operator to open a list of additional operators, and select the one you want to use. 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.

    • Value: 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 will be hidden.

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

Web Service Request

• URL: Enter the URL of the web server that you want to send to. Alternatively, you can add a variable to specify the URL.

• Method: Select the web request HTTP method that you want to use. Options include POST, GET, PUT, DELETE, or HEAD.

• Content-type: Select the content-type to use for the web request. Available when you have selected either a POST or PUT method.

• HTTP Headers: Enter the HTTP header properties and values to be sent with the web request. 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. Available when you have selected either POST or PUT for the Method property.

• Query String: Specifies the query string that you want to be sent with a GET, DELETE or HEAD web request HTTP method. Available when you have selected either GET, DELETE or HEAD for the Method property.

  • Embedded Template:

    • Value: Use the input box provided to enter the template you want the action to use. Alternatively, you can add a variable to specify the template, or add a special character to the value you have entered.

    • Import: Opens the Open File dialog so that you can browse to and select a file containing the desired script. The contents of the file are imported into the Value input box.

    • Export: Opens the Save File dialog so that you can save the contents of the Value input box as an external file. You can save the value as a new file, or replace the contents of an existing file.

  • Variable:

    • Variable: Type the variable that you want to use for the source. Alternatively, you can add a variable.

  • External File:

    • Location: Specifies the file system where the source folder exists. 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.

    • File Name: Specifies the file path. You can type the folder location and file name or click Browse to locate and select the desired file. Alternatively, you can add a variable to specify the desired file, or add a special character to the value you have entered.

    • File Encoding: Specifies the encoding used by the source file.

  • HTTP Request Variable:

    • Variable Name: Specifies the variable name for the HTTP request variable that you want to use as the source.

    • Value: Specifies the value for the HTTP request variable.

Authentication

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

  • Anonymous: Allows any user to access the client without providing a user name and password.

  • Use current Windows credentials: Uses the current Windows user account to connect to the client.

  • Use specified credentials: Uses the user name, domain, and password that you provide to connect to the client.

Response

• Successful Status Codes: Enables you to specify the status codes that you deem successful.

• Save Web Service Response to Variable: Specifies the variable to which you want to save the web service response. Enter the desired variable in the input box. Alternatively, you can add a variable.

Advanced Options

• Wrap source content in SOAP Body tag: Specifies that the source content will be wrapped in a SOAP Body tag before being sent.

• Send Timeout: Specifies the amount of time in seconds to wait for a response from the client before the action fails.

• Retry Count: Specifies the number of times to re-send the request if the action fails.

Test Send Web Service Request

• Test: Runs the action. 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. Therefore the action will run without any data from the integration that you may have configured it to use. For information on testing your integration, refer to Using the Test Pane.

User Account

• 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.

• Specify user credentials: When enabled, the action runs using the credentials specified.

Error Handling and Diagnostics

• Ignore errors and continue running actions: When enabled, specifies that if the action fails, the remaining actions will continue to run.

  When this property is not enabled and the action fails, the resulting behavior depends on the following scenarios:  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: When enabled, specifies that if the action fails, the Integration Service will try to run it again.

• Maximum retries: Specifies the maximum number of times the Integration Service will try to run the action again. Available when Retry if failed is enabled.

• Retry interval: Specifies the amount of time the Integration Service will wait after the action has failed before trying to run the action again. Available when Retry if failed is enabled.