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
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:
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.
Execute SOAP action
This action module executes a SOAP action, based on WSDL you specify.
Limitations of the SOAP module
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.
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:
-
In Workfront Fusion, create a new scenario.
-
Insert the HTTP > Make a request module in the scenario.
-
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 -
Open a new web browser window or tab.
-
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 examplehttp://voip.ms/api/v1/server.wsdl
. -
If the WSDL file does not display directly in the web browser, open the downloaded file in a text editor.
-
Search for the
<service>
or<wsdl:service>
tag: -
Once located, copy the URL from the
location
attribute. -
In Workfront Fusion, paste the URL into the HTTP module’s URL field.
-
Open the in a new web browser window/tab.
-
Paste the WSDL URL into the WSDL URL field.
-
Click Browse.
-
Pick from the list of functions to the left, for example
getLanguages
. -
Copy the content of the Request XML text area.
-
In Workfront Fusion, paste the copied content to the module’s URL field.
-
Provide values for selected parameters by replacing the question marks with actual values:
-
Close the module’s configuration by clicking OK.
-
Execute the scenario or module.