Webservice

The Webservice control allows you to access external processes and harness them within the script, via published Web services.

This control has its own Standard property window.

  • Name: The name of the control
  • Bind to Database Field: Used to map the control to a database field
  • Comment: Allows you to add details of the control use, which will be output to any documentation produced
  • OnAction: Allows you to define a function to run when the control's Events are triggered. Click Clear to remove this function.

  • Style: Allows you to select a style defined in the Style Editor
  • Font: Allows you to define the font used for the text
  • Tooltip: The text to be displayed when you hover the mouse over the control
  • Background Colour: Allows you to set the background colour of the control
  • Foreground Colour: Allows you to set the text colour
  • Is right-to-left: Inverts the writing direction allowing you to type from the right to the left

  • Webservice Address: The URL for the service to query. This will contact the Web service and request a list of the web methods available.

    You will then be able to select a method from the Select Web service Method drop-down list. This updates the Input and Output fields with information on the data that needs to be passed to the web method and the result that you will get back.

  • Select Webservice Method: The individual method you would like to use
  • Pass NT Credentials (checkbox): This option is used to indicate that the agents NT Login details need to be sent as part of the connection information to the web service.
  • Raise error as OnChange Event (checkbox): Check this to trigger the OnChange action for each error raised. The error state can be check by looking at the value of the script variable SCRIPTERROR – which will be OK if everything ran without any error.
  • Call via HTTP Post (checkbox): This option allows you to specify that the web service should be called using a HTTP Post command rather than via a SOAP request. 

  • Inputs/Ouputs: If you click a field it will show an ellipsis (…) picker button. Click it to bring up a dialog box for mapping the field to a screen control database field or free text value.