REST/SOAP call and retrieval Mapping

Added a new task type in workflows “Run Web Service”. To use this task type we should use a new map with a new mapping type “Webservice Mapping”.

In the pertinent task can be attached just one map. If we click on '+' button we can see a list of all “Webservice Mapping” maps(defines the webservice method parameters that will be launched).

GET, PUT, POST, DELETE methods are supported.

An example of Map for SOAP Call:

<?xml version="1.0"?>
<map>
<originmodule>
<originid>49</originid>
<originname>Accounts</originname>
</originmodule>
<targetmodule>
<targetid>49</targetid>
<targetname>Accounts</targetname>
</targetmodule>
 
<wsconfig>
<wsurl>http://ec.europa.eu/taxation_customs/vies/checkVatService.wsdl</wsurl>
<wshttpmethod>POST</wshttpmethod>
<methodname>checkVat</methodname>
<wsresponsetime></wsresponsetime>
<wsuser></wsuser>
<wspass></wspass>
<wsproxyhost></wsproxyhost>
<wsproxyport></wsproxyport>
<wsheader>
<header> 
<keyname>Content-type</keyname> 
<keyvalue>application/json</keyvalue> 
</header>
<header> 
<keyname></keyname> 
<keyvalue></keyvalue> 
</header>
</wsheader>
<wstype>SOAP</wstype>
<inputtype>JSON</inputtype>
<outputtype>JSON</outputtype> 
</wsconfig>
 
<fields>
<field>
<fieldname>countryCode</fieldname>
<fieldID></fieldID>
<Orgfields>
<Orgfield>
<OrgfieldName>bill_code</OrgfieldName>
<OrgfieldID></OrgfieldID>
</Orgfield>
<delimiter>--None--</delimiter>
</Orgfields>
</field>
<field>
<fieldname>vatNumber</fieldname>
<fieldID></fieldID>
<Orgfields>
<Orgfield>
<OrgfieldName>bill_country</OrgfieldName>
<OrgfieldID></OrgfieldID>
</Orgfield>
<delimiter>--None--</delimiter>
</Orgfields>
</field>
</fields>
 
<Response>
<field>
<fieldname>vatNumber</fieldname>
<Orgfields>
<Orgfield>
<OrgfieldName>siccode</OrgfieldName>
</Orgfield>
<delimiter>--None--</delimiter>
</Orgfields>
</field>
<field>
<fieldname>name</fieldname>
<Orgfields>
<Orgfield>
<OrgfieldName>accountname</OrgfieldName>
</Orgfield>
<delimiter>--None--</delimiter>
</Orgfields>
</field>
</Response>
</map>
  • <wsurl>Endpoint where we send the data</wsurl>
  • <methodname>define the method that should be called</methodname>
  • <wstype>REST or SOAP</wstype>
  • <inputtype>XML/URL for SOAP; JSON/URL/URLRESTFUL for REST</inputtype>
  • <outputtype>JSON for REST; XML for SOAP</outputtype>
  • <fields>block that contains the input parameter fields</fields>
  • <fieldname>input parameter for REST/SOAP call(in the block fields)</fieldname>
  • <OrgfieldName>fieldname in CoreBOS where we get the input parameter value</OrgfieldName>
  • <Response>block that contains the response fields</Response>
  • <fieldname>the value we get back from ws(in the block Response)</fieldname>
  • <OrgfieldName>fieldname in CoreBOS to update/insert the WS response</OrgfieldName>

coreBOS Documentación