> For the complete documentation index, see [llms.txt](https://docs.emobiq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.emobiq.com/emobiq-client/006-actions-and-visual-logic/action-reference/cordova/dataset/soapcall.md).

# soapCall

## Description

Directly access or call a SOAP Web Service.

## Input / Parameters

| No | Name      | Description                                                               | Data Type | Required |
| -- | --------- | ------------------------------------------------------------------------- | --------- | -------- |
| 1  | connector | Name of connector and created in the Services and Global Components page. | String    | Yes      |
| 2  | function  | The function from the Web Service to be executed.                         | String    | Yes      |
| 3  | data      | This contains the main parameter in the function being called.            | Object    | No       |

## Output

Coming soon.

## Callback

Coming soon.

## Video

Coming soon.

## Example

The user wants to call the SOAP Web Service.

### Step

1. To create SOAP Connector in Services and define the name, url and timeOut.\
   Name: soap\
   url: <http://203.116.137.100:51059/Training/Main.asmx> ( Please refer to the picture below, there is a example of main web service.We have take one of the operation which is login as an example to apply for this function.)\
   timeOut: 3000

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-058babca98162d4993d286aa1220c12e5d16d86f%2FsoapCall-step-1.png?alt=media)

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-b62d0b6ce70095ab3273334b17d3ac0357878135%2FsoapCall-step-2.png?alt=media)
2. Call the function "soapCall"and define the connector, function and set the function"toObject" to data.\
   connector: soap\
   function: login\
   data: toObject<br>

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-87d6918b22207f4980432b90e0029955f72c2308%2FsoapCall-step-3.png?alt=media)
3. Define the toObject(parameter)which are username and password and the component value.\
   username: componentValue (for defined the name in textbox.)\
   component: txtUsername<br>

   password: componentValue ( for defined the password in textbox.)\
   component: txtPassword<br>

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-9db231bcbcd8f2bc02c22c7d31aed629854108da%2FsoapCall-step-4.png?alt=media)

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-71c2e597852856a39d777a17b2aa44764982dc83%2FsoapCall-step-5.png?alt=media)

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-46128ffe5fce4e337bbf96ecf025654342f0466d%2FsoapCall-step-6.png?alt=media)
4. Add a console for display the response from console.<br>

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-dcf7d1da6520b8b6ac5de65fec2a2ac3e9e557c9%2FsoapCall-step-7.png?alt=media)

### Result

![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-0b653ffb12f5a1a0ea8c9e22cf8482d1de885a7d%2FsoapCall-result-1.png?alt=media)

## Notes

* N/A