--- title: "Edit a SOAP-Type Data Connector" slug: "edit-a-soap-type-data-connector" updated: 2024-08-13T09:15:12Z published: 2024-08-13T09:15:12Z canonical: "docs.processmaker.com/edit-a-soap-type-data-connector" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.processmaker.com/llms.txt > Use this file to discover all available pages before exploring further. # Edit a SOAP-Type Data Connector Edit how to authenticate and interact with a SOAP data source for a Data Connector. **Permissions** Your user account or group membership must have the following permissions to edit Resources for a Data Connector unless your user account has the **Make this user a Super Admin** setting selected: - Data Connectors: Edit Data Connectors - Data Connectors: View Data Connectors See the [Data Connectors](/v1/docs/permission-descriptions-for-users-and-groups#data-connectors) permissions or ask your Administrator for assistance. ## Edit Configuration for a Data Connector's SOAP Data Source Follow these steps to edit the configuration settings how a [Data Connector](/v1/docs/data-connectors) authenticates with a SOAP data source: 1. Verify that this SOAP-type Data Connector uses a WSDL file to authenticate with the data source. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/1d012868-c602-4c23-bd41-f009322c7d3b.png) 2. In the **User** setting, enter the client username that authenticates with the connecting SOAP service. This is a required setting. 3. In the **Password** setting, enter the client password that authenticates with the connecting SOAP service. This is a required setting. 4. From the **Local WSDL File** setting, click the **Select File** button, and then select the WSDL file from which to authenticate with the connecting SOAP service. A new WSDL file replaces a previously configured PEM file. This is a required setting. 5. From the **Local XSD File** setting, click the **Select File** button, and then select the XSD file(s) that correspond with the WSDL file. After adding a local XSD file, optionally use any of the following buttons for that XSD file: - Click the **Download XSD File** button![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/612b256d-9d3c-4a4e-9fd4-279504a4af16.png)to download the selected XSD file to your computer or local network. - Click the **Delete XSD File** button![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/85d1f4c4-7b2e-4df0-929c-c30dd2984a46.png)to delete the selected XSD file. - Click the **View XSD File** button![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/87cb5189-5639-43a5-a98f-e92e87511a15.png)to view the selected XSD file in a separate browser window. 6. From the **Location** setting, optionally enter a custom URL to the connecting SOAP service different than that configured in the local WSDL file. If the **Location** setting contains a value, this value supersedes the URL configured in the WSDL file. 7. If no other changes are necessary, click **Save**. The following message displays: **The Data Connector was saved**. ## Provide WSDL and XSD Files Follow these steps to provide a Web Service Description Language (WSDL) file for SOAP authentication after selecting the **WSDL File** option from the **Authentication** section: 1. Verify that this SOAP-type Data Connector uses a local certificate file to authenticate with the data source. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/ac3c41a8-2dbc-432c-956a-6047a308d2ce.png) 2. In the **Service URL** setting, enter the SOAP service HTTP URL from which the SOAP service monitors for incoming requests. Ensure that the service URL references the Web Service Description Language (WSDL) file that describes the SOAP service, such as `http://www.URL.asmx?WSDL`. This is a required setting. 3. From the **Local Certificate File** setting, click the **Select File** button, and then select the Privacy Enhanced Mail (PEM) file type from which to authenticate with the connecting SOAP service. A new PEM file replaces a previously configured PEM file. This is a required setting. 4. From the **Passphrase** setting, optionally enter the password to access the selected local certificate file. 5. If no other changes are necessary, click **Save**. The following message displays: **The Data Connector was saved**. ### Provide a Local Certificate File Follow these steps to provide a local certificate file for SOAP authentication after selecting the **Local Certificate** option from the **Authentication** section: 1. Verify that this SOAP-type Data Connector uses password authentication to authenticate with the data source. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/86359e5c-fef3-47d7-a56d-cf9806141685.png) 2. In the **Service URL** setting, enter the SOAP service HTTP URL from which the SOAP service monitors for incoming requests. Ensure that the service URL references the Web Service Description Language (WSDL) file that describes the SOAP service, such as `http://www.URL.asmx?WSDL`. This is a required setting. 3. In the **User** setting, enter or edit the username that authenticates with the SOAP service. This setting is required. 4. In the **Password** setting, enter or edit the password that authenticates with the SOAP service. This setting is required. 5. From the **Password Type** setting, select with which type of password the SOAP service authenticates: - **None:** Select the **None** option to not send the password to the SOAP service. ProcessMaker does not recommend this practice since there is no security with the SOAP service. - **Password Text:** Select the **Password Text** option to send a plain-text password to the SOAP service. - **Password Digest:** Select the **Password Digest** option when the password is a MD5 (Message Digest) value to be transmitted to the SOAP service. Digest authentication has an advantage over basic authentication in that it does not send a plain-text password over the network. The server then uses this digest value for password comparisons. 6. In the **Proxy Host** setting, enter or edit the proxy host that the SOAP service uses. 7. In the **Proxy Port** setting, enter or edit the port that the proxy host monitors for connections. 8. If no other changes are necessary, click **Save**. The following message displays: **The Data Connector was saved**. ### Edit Password Authentication Settings Follow these steps to configure basic authentication settings after selecting the **Password** option from the **Authentication** section: 1. [View your Data Connectors](/v1/docs/view-and-search-for-data-connectors#view-all-scripts). The **Data Connectors** tab displays. 2. Click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/6921d04c-0cfc-4884-8ed9-0e13a3caec24.png) menu, and then select the **Edit** option for the Data Connector to edit. The **Configuration** tab displays with the following indicators: - The **SOAP** tag displays to indicate the Data Connector authenticates with a SOAP data source. - The **Debug Mode** icon displays to indicate whether debug mode is enabled. 1. Edit the following information about the SOAP-type Data Connector as necessary: - In the **Name** setting, edit the name of the Data Connector. Data Connector names must be unique in your organization and can only use apostrophe characters (`'`) and spaces. This is a required setting. - In the **Description** setting, edit the description of the Data Connector. - From the **Category** drop-down menu, select one or more Data Connector Categories to associate with this Data Connector. In doing so, [Data Connector Categories](/v1/docs/data-connector-categories) may be sorted from the [**Data Connectors**](/v1/docs/view-and-search-for-data-connectors#view-all-scripts) page. To remove a Data Connector Category that is currently selected, click the![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/03e03160-c6f5-4f1e-ac4c-b6a08ef0e814.png)icon for that selection or press `Enter` when the drop-down is visible. This is a required setting. - From the **Project** drop-down menu, optionally select the [Project(s)](/v1/docs/projects) that this Data Connector becomes an asset. This setting only displays Projects of which you are a member. To remove a Project that is currently selected, click the![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/03e03160-c6f5-4f1e-ac4c-b6a08ef0e814.png)icon for that selection or press `Enter` when the drop-down is visible. - In the **Authentication** section, from the **Method** drop-down menu, select how the REST-type Data Connector authenticates with the data source: - **Password:** Select the **Password** option to send only username and password credentials as authentication when connecting to the data source. See [Edit Password Authentication Settings](/v1/docs/edit-a-soap-type-data-connector#edit-basic-auth-settings). - **Local Certificate:** Select the **Local Certificate** option to upload a Privacy Enhanced Mail (PEM) file type from which to authenticate with the connecting SOAP service. See [Provide a Local Certificate File](/v1/docs/edit-a-soap-type-data-connector#provide-a-local-certificate-file). - **WSDL File:** Select the **WSDL File** option to upload a Web Service Description Language (WSDL) file with its corresponding XSD file(s) that define authentication for the connecting SOAP service. See [Provide WSDL and XSD Files](/v1/docs/edit-a-soap-type-data-connector#provide-wsdl-and-xsd-files). 2. If no other changes are necessary, click **Save**. The following message displays: **The Data Connector was saved**. ## Add Resources to a SOAP Data Connection > [!NOTE] > ### Availability of a SOAP Web Service's Operations > > A SOAP Web service's operations from which to specify a Resource to run are not available until after the [SOAP-type Data Connector is created](/v1/docs/create-a-new-data-connector) and saved. The Data Connector must first authenticate with the Web service via its WSDL file before that service's operations become available. Follow these steps to add a [Resource](/v1/docs/data-connectors#what-is-a-resource) to a SOAP-type Data Connector: 1. [View your Data Connectors](/v1/docs/view-and-search-for-data-connectors#view-all-scripts). The **Data Connectors** page displays. 2. Click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/6921d04c-0cfc-4884-8ed9-0e13a3caec24.png) menu, and then select the **Edit** option for the SOAP-type Data Connector to edit. The **Configuration** tab displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/530f014b-0a4e-4f3c-ba75-859c588aa1f4.png) 3. Click the **Resources** tab. Resources configured for this Data Connector display. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/377a54fc-4d09-4d33-9187-6d69ebefc550.png) 4. Click the **+Resource** button. The **Create Resource** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/db3dae5b-119c-4db2-bf68-af6a41ada9d5.png) 5. In the **Name** setting, enter the name of this Resource. The ProcessMaker Platform asset that references this Resource displays the **Name** setting value. For example, a Resource with the name `Get Values` displays that name when configuring a [Select List](/v1/docs/select-list-control) control to use this Data Connector to indicate the Resource's operation. Therefore, provide a concise but relevant name for this Resource so other Process designers understand its function. This is a required setting. 6. In the **Description** setting, enter a description of this Resource. Descriptions do not display from ProcessMaker Platform assets when configuring them with a Data Connector. 7. From the **Category** drop-down menu, select one or more [Data Connector Categories](/v1/docs/data-connector-categories) to associate with this Resource. In doing so, Data Connector Categories may be sorted from the [**Data Connectors**](/v1/docs/view-and-search-for-data-connectors#view-all-scripts) page. To remove a Data Connector Category that is currently selected, click the![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/03e03160-c6f5-4f1e-ac4c-b6a08ef0e814.png)icon for that selection or press `Enter` when the drop-down is visible. This is a required setting. 8. From the **Operation** drop-down menu, select which Web service operation this Resource performs. The WSDL file or Web service configured for this Data Connector specifies which operations are available from this drop-down menu. 9. Click **Add**. A new Resource is created. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/e6b9841e-80b0-48f3-97d4-9c71f63b509c.png) 10. Do one of the following: - Optionally, view the parameters to this Resource's configured operation. The parameter(s) are sent to the Web service when this Resource performs its operation. See [View Web Service Operation Parameters](/v1/docs/edit-a-soap-type-data-connector#add-resource-parameters). - Optionally, test the Resource to determine if its configured operation successfully performs. See [Test a Resource in a Data Connector](/v1/docs/edit-a-soap-type-data-connector#test-a-resource-in-a-data-connector). ### View Web Service Operation Parameters Optionally, view the parameter(s) for the operation configured for a Resource. Understanding the following for each parameter helps inform how to correspond Request data with a Web service operation's parameter(s): - Understand what the operation's parameters are to map them to Request data in the Data Connector connector. - Understand which parameter(s) are required or optional, and therefore plan how to map parameter response data to Request data. - Understand what each parameter's data type is. Follow these guidelines to view the Web service operation parameter(s) for a SOAP-type Data Connector's Resource: 1. [Add](/v1/docs/edit-a-rest-type-data-connector#add-an-endpoint-to-a-processmaker-data-connector) or [view](/v1/docs/edit-a-rest-type-data-connector#view-an-endpoint-in-a-processmaker-data-connector) the Resource for the Data Connector to which to add parameters. The **Configuration** tab displays basic configuration settings for that Data Connector. 2. Click the **Resources** tab. Resources for that Data Connector display. If the Resources tab is not enabled, this SOAP-type Data Connector is not properly configured with a Web Service Description Language (WSDL) file. See [Edit Configuration for a Data Connector's SOAP Data Source](/v1/docs/edit-a-soap-type-data-connector#edit-configuration-for-a-data-connectors-soap-data-source). 3. Click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/6921d04c-0cfc-4884-8ed9-0e13a3caec24.png) menu, and then select the **Edit** option for the Resource to view the parameter(s) for its Web service operation. The **Configuration** tab for that Resource displays with the name of the Web service operation [selected for this Resource](/v1/docs/edit-a-soap-type-data-connector#add-resources-to-a-soap-data-connection). 4. Click the **Params** tab. The **Params** tab displays the following for informational purposes only: - **Operation:** Below the **Operation** label displays the name of the Web service operation configured for this Resource. - **Parameters:** Below the Web service operation name are the parameter(s) for that operation. If the operation has no parameters, **[empty]** displays below the operation name. Parameters indicate whether they are required are optional using the following icons: - **Required:** The![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/6fcf62ad-1d2e-461c-8895-b7cd89261e52.png)icon displays to indicate the parameter is required. - **Optional:** The![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/6ebd3bd6-fbca-4cf0-b9fe-58bd14a6d3c5.png)icon displays to indicate the parameter is optional. - **No parameters:** Below the Web service operation displays **Parameters [empty]** if that operation does not have any parameters. Below is an example. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/5f43eedc-a70d-4230-bffb-21a4fa656f45.png) - **WSDL XML:** To the right-side of the Web service operation name and parameter(s) is the WSDL's XML schema. Highlighted in the XML schema is the name of the operation where its XML specification begins. Below is an example. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/0bb2ddb8-5182-4292-bc51-9cbb6ac0ecdd.png) 5. Optionally, browse the WSDL's XML schema. Click the Web service operation name to display a search field with browsing functions. Follow these guidelines: - In the search field, enter the name of the service operation to locate in the WSDL's XML schema. Use the following syntax to search for an operations name: `name="OperationName"` where `OperationName` is the operation name to find. Search by using the **Match Case**, **Match Whole Word**, or **Use Regular Expression** options. - Use the **Previous Match** option to browse for the previous instance of the search results. - Use the **Next Match** option to browse for the next instance of the search results. - Use the **Find in Selection** option to locate the search result in the current selection. ### Test a Resource in a Data Connector After [adding a Resource to a Data Connector](/v1/docs/edit-a-soap-type-data-connector#add-resources-to-a-soap-data-connection), test it to determine if the Resource successfully performs its configured Web service operation successfully. > [!NOTE] > Testing a Resource only verifies that Resource's availability, but does not validate the Data Connector's proper authentication to the SOAP Web service. SOAP Web services can have diverse authentication responses and only by using that service's operations this can responses be identified. SOAP Web services do not follow a standard error responses or authentication settings. Therefore, unless the service provider documented responses or expected errors in the WSDL file, only by using that service's operations can responses be determined. Follow these steps to test a SOAP-type Data Connector's Resource: 1. [Add](/v1/docs/edit-a-rest-type-data-connector#add-resources-to-a-processmaker-data-connector) or [view](/v1/docs/edit-a-rest-type-data-connector#view-or-edit-a-resource-in-a-processmaker-data-connector) the Resources for the SOAP-type Data Connector to test. The **Configuration** tab displays basic configuration settings for that Resource. 2. Click the **Response Body** tab. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/fdbe5d0d-ce4d-4cf7-9a2c-518913d375f6.png) 3. Do one of the following: - **Perform the Web service operation to receive its response:** Click the **Send** button. - **Send sample Request data with the call to the Web service operation:** In the **Test Request JSON** panel, enter the sample Request data to be added to the body of the request to the Web service operation, and then click the **Send** button. 4. Enable the tree toggle ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/3624eb35-aaa3-4cc8-b592-dc0cf6cd8c77.png) to see the tree representation of JSON as a data model to understand the different structural elements within it. To navigate in the **Data Browser** canvas, see [Data Browser](/v1/docs/json-data-visualization#data-browser). ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b86b9a39-4f8e-4967-95d3-07dc93fdc572.png) Web service operation's response in the Data Browser canvas If the Resource successfully performs the Web service operation, the operation's response displays in the **Response Body** tab. Above the **Test Request JSON** panel displays the data source response status, response time, and size display. To search the response body, enter into the search field that is above the response body the text to locate, and then click **Search**. ## View or Edit a Resource in a SOAP Data Connector Follow these steps to view or edit a SOAP-type Data Connector's Resource: 1. [View your Data Connectors](/v1/docs/view-and-search-for-data-connectors#view-all-scripts). The **Data Connectors** page displays. 2. Click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/6921d04c-0cfc-4884-8ed9-0e13a3caec24.png) menu, and then select the **Edit** option for the SOAP-type Data Connector to view or edit. The **Configuration** tab displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/530f014b-0a4e-4f3c-ba75-859c588aa1f4.png) 3. Click the **Resources** tab. Resources configured for this Data Connector display.![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/fbb96d8d-8a7f-4c9d-b605-8c0d92154823.png) 4. Click the **Edit** icon![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/62596942-22d3-46fd-aee8-69e97a5c5e13.png)for the Resource to view or edit. Settings for the Resource display.![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b94e4be4-ca5b-4b3f-97ef-13f957de3c8e.png) 5. Edit the following settings as necessary: - In the **Name** setting, edit the name of this Resource. The ProcessMaker Platform asset that references this Resource displays the **Name** setting value. For example, a Resource with the name `Get Values` displays that name when configuring a [Select List](/v1/docs/select-list-control) control to use this Data Connector to indicate the Resource's operation. Therefore, provide a concise but relevant name for this Resource so other Process designers understand its function. This is a required setting. - In the **Description** setting, edit the description of this Resource. Descriptions do not display from ProcessMaker Platform assets when configuring them with a Data Connector. 6. Do one of the following: - Optionally, view the parameters to this Resource's configured operation. The parameter(s) are sent to the Web service when this Resource performs its operation. See [View Web Service Operation Parameters](/v1/docs/edit-a-soap-type-data-connector#add-resource-parameters). - Optionally, test the Resource to determine if its configured operation successfully performs. See [Test a Resource in a Data Connector](/v1/docs/edit-a-soap-type-data-connector#test-a-resource-in-a-data-connector). > After editing a Resource, [test it](/v1/docs/edit-a-soap-type-data-connector#test-a-resource-in-a-processmaker-data-connector) to determine if the Resource successfully makes a request to the data source endpoint successfully. ## Delete a Resource from a Data Connector Follow these steps to delete a Data Connector's Resource: 1. [View your Data Connectors](/v1/docs/view-and-search-for-data-connectors#view-all-scripts). The **Data Connectors** page displays. 2. Click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/6921d04c-0cfc-4884-8ed9-0e13a3caec24.png) menu, and then select the **Edit** option for the Data Connector to delete a Resource. The **Configuration** tab displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/530f014b-0a4e-4f3c-ba75-859c588aa1f4.png) 3. Click the **Resources** tab. Resources configured for this Data Connector display.![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/fbb96d8d-8a7f-4c9d-b605-8c0d92154823.png) 4. Click the **Delete** icon![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/d530835c-4a9e-47d5-b164-86b198b4f785.png)for the Resource to delete. A message displays to confirm deletion of the Resource. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/9a6aede3-3dff-4552-854d-37ad9ef1f23a.png) 5. Click **Confirm**.