ÃÛ¶¹ÊÓƵ

SOAP module

You can use the SOAP module to connect to SOAP APIs in ÃÛ¶¹ÊÓƵ Workfront Fusion.

SOAP module and its fields

The SOAP connector includes only one module, Execute SOAP action

Execute SOAP action

This action module executes the specified SOAP action.

Access requirements

Expand to view access requirements for the functionality in this article.

You must have the following access to use the functionality in this article:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
ÃÛ¶¹ÊÓƵ Workfront package Any
ÃÛ¶¹ÊÓƵ Workfront license

New: Standard

Or

Current: Work or higher

ÃÛ¶¹ÊÓƵ Workfront Fusion license**

Current: No Workfront Fusion license requirement.

Or

Legacy: Workfront Fusion for Work Automation and Integration

Product

New:

  • Select or Prime Workfront package: Your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion.
  • Ultimate Workfront package: Workfront Fusion is included.

Or

Current: Your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion.

For more detail about the information in this table, see Access requirements in documentation.

For information on ÃÛ¶¹ÊÓƵ Workfront Fusion licenses, see ÃÛ¶¹ÊÓƵ Workfront Fusion licenses.

SOAP module and its fields

When you configure SOAP modules, Workfront Fusion displays the fields listed below. A bolded title in a module indicates a required field.

If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another.

Map toggle

Execute SOAP action

This action module executes a SOAP action, based on WSDL you specify.

WSDL
Select the WSDL that you want the module to use. To create a WSDL, click Add next to the field and fill in the fields.
HTTP headers
For each HTTP header that you want to add, click Add item and enter the header's name and value.
SOAP headers
For each SOAP header that you want to add, click Add item and enter the header's name, value, namespace, and XMLNS.
Force SOAP headers
Enable this option to configure headers for SOAP 1.2.

Limitations of the SOAP module

NOTE
Redirects are disabled during WDSL loading. This is a security feature, but may mean that unverified redirects are blocked when the module is run.

The SOAP module is currently in beta and does not support:

  • Redefine elements
  • Fraction digits restrictions
  • Total digits restrictions
  • White space restrictions
  • Multiple parts in input and output messages. Only single part messages are supported
  • Custom XML Schema elements defined with the help of SOAP Encoding schemas and elements.
recommendation-more-help

Example:

The following would not be recognized correctly by Workfront Fusion:

<complexType name="ArrayOfFloat">
   <complexContent>
      <restriction base="soapenc:Array">
         <attribute ref="soapenc:arrayType"
            wsdl:arrayType="xsd:integer[]"/>
      </restriction>
   </complexContent>
</complexType>

This example includes the soapenc:Array, soapenc:arrayType and wsdl:arrayType references, which are not yet supported in Workfront Fusion.

Workaround

If the SOAP module refuses to process the WSDL file or throws various errors in the module’s configuration, you may try using the universal HTTP > Make a request module instead:

  1. In Workfront Fusion, create a new scenario.

  2. Insert the HTTP > Make a request module in the scenario.

  3. Open the module’s configuration and fill in the following fields:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Method POST
    Body type Raw
    Content type XML (application/xml)
    Parse response Enabled
  4. Open a new web browser window or tab.

  5. Paste the WSDL URL into the web browser’s address bar and fetch the XML file.

    The WSDL URL usually ends with ?wsdl, but not necessarily, for example http://voip.ms/api/v1/server.wsdl.

  6. If the WSDL file does not display directly in the web browser, open the downloaded file in a text editor.

  7. Search for the <service> or <wsdl:service> tag:

  8. Once located, copy the URL from the location attribute.

  9. In Workfront Fusion, paste the URL into the HTTP module’s URL field.

  10. Open the in a new web browser window/tab.

  11. Paste the WSDL URL into the WSDL URL field.

  12. Click Browse.

  13. Pick from the list of functions to the left, for example getLanguages.

  14. Copy the content of the Request XML text area.

  15. In Workfront Fusion, paste the copied content to the module’s URL field.

  16. Provide values for selected parameters by replacing the question marks with actual values:

  17. Close the module’s configuration by clicking OK.

  18. Execute the scenario or module.

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3