Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

Simple Object Access Protocol (SOAP) is a standard protocol specification for message exchange based on XML. Communication between the web service and client happens using XML messages. 

On Adeptia Connect, you can connect an application to any other application or service that supports SOAP APIs. For example, you can send stock prices from your Google Spreadsheet to an application that supports SOAP APIs.

SOAP This application is supported only available at Destination only. 

Field (Account) Information

While configuring the Source or Destination of a Template or Transaction, you find an Account option to need to create an account to configure your application with Adeptia Connect. Using Account configurationWhile creating an account, you need to specify the location from where Adeptia Connect will access the data is to be accessed. In this process, provide the details of the application account to grant permission to access data..

Click Image Added to add an account.

Image Added

Specify the following information for SOAP:

...

  1. Type a unique SOAP account name.
  2. Select the location of your Web Services Description Language (WSDL) file. WSDL is an XML-based interface definition language that is used for describing the functionality offered by a web service.
    • On Local Disk: Select this option if your WSDL file is on a local computer or on a LAN network.
    • Over HTTP: Select this option if your WSDL file is at an HTTP location.
    If you have selected On Local Disk option then do the following:
    1. Browse to and select the WSDL file.
    2. Select WSDL file references other files check box if your uploaded WSDL file is referring to other files. On selecting this check box, File References field appears. 
    3. Upload your referential WSDL or XSD file(s) in a single zip file only. Also just keep the folder structure of the zip file as per the references made by the WSDL or XSD file(s).



    If you have selected Over HTTP option then type the HTTP URL of the WSDL file, the endpoint URL of the SOAP web service.




  3. Click Process WSDL to fetch the information from your the uploaded WSDL file. A Soap account can be saved only after you fetch the WSDL information. 
    The information about the service, binding, and endpoint URL are automatically populated.
    • Service NameService is defined as a collection of network endpoints or ports. If there is only one service name in your the uploaded WSDL file then Adeptia Connect shows that service name as selected. If , it will appear as default selected in the Service Name automatically. However, if there are multiple service names in your the WSDL file then you need to select the service from the drop-down list. 

    • Binding NameBindings defines the message format and protocol details for a web service.  If you select a required service, Adeptia Connect populates the value in the Binding field automatically. This field displays only those bindings, that corresponds to the service name, that you select in the Service Name field. If in the WSDL definition file there is only one binding for any service name then by default you will see only that binding in the WSDL file then it will appear as default selected in the Binding fieldName automatically. However, if there are multiple bindings for a service name then you will see all the bindings in in the WSDL file then you need to select the binding from the drop-down list.
       
    • Endpoint URLThe operations and messages are described abstractly and then bound to a concrete network protocol and message format to define an endpoint. It is the URL where the web service will eventually hit. A lot of WSDL files by default come with a dummy endpoint that does not point to the actual location of the service but instead contains a dummy link. 



  4. If the web a web service you are accessing is secure then define the security settings. Select Enable client authentication check box to authenticate both server and client identity.
  5. On selecting the check box, you need to select the Keystore.



  6. Select authorization used in the web service. By default authorization is disabled, however, you may choose basic authorization for a web service. Basic authorization is a widely used protocol for simple username/password authentication. 

    Image Modified

  7. Click Save.

Actions

An Action specifies how the data will be transferred at the destination location. While configuring the Destination (Target) of a Template, you need to choose an action.

The Web Services operation performs a specific request action against a URL endpoint. Whenever the destination application or service uses SOAP APIs, the actions are displayed according to the uploaded WSDL. It may vary with different WSDL files. 

Image Modified

When applicable, type the SOAP header content that you want to include in the request.