Link Bportal task (projects - activities and activities - subactivities)

bportalTasksLink(p_companyID, p_code, p_codeParent, )

 

You can use this endpoint to link Tasks (projects - activities and activities - subactivities) from our software.

Parameters

Name Type Required Description
p_companyID string Yes The security code you have been provided with, string (32)
p_codeParent string Yes The upper level Task's code which we want to link (project or activity).
p_codeChild string Yes The lower level Task's code (activity or subactivity).

Return values

LINKED – the linking was a success.

ERROR_NO_SECURITY_HASH - user did not supply p_companyId security code.

ERROR_UNKNOWN_SECURITY_HASH - supplied security code p_companyId is invalid.

PARENT_TASK_NOT_FOUND – no Task was found with the supplied p_codeParent.

CHILD_TASK_NOT_FOUND – no Task was found with the supplied p_codeChild.

ALREADY_LINKED – a link between the 2 Tasks the user wants to link exists already.

INCORRECT_LEVEL_LINKING – the Tasks identified by the supplied p_codeParent and p_codeChild values does not comply to the rule of linking only projects – activities and activities – subactivities.

ERROR_LINKING – an unexpected error occurred during linking

Sample

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:uen="uen:esws">
<soapenv:Header/>
<soapenv:Body>
<uen:Esws.bportalTasksLink soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<p_companyID xsi:type="xsd:string">^4p;tU0Q+#dEIhTWkuj5FnLD^aOLqVu0</p_companyID>
<p_codeParent xsi:type="xsd:string">2222</p_code>
<p_codeChild xsi:type="xsd:string">3333</p_code>
</uen:Esws.bportalTasksLink>
</soapenv:Body>
</soapenv:Envelope>

Response

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="uen:esws">
<SOAP-ENV:Body>
<ns1:Esws.bportalTasksLinkResponse xmlns:ns1="uen:esws">
<return xsi:type="xsd:string">LINKED</return>
</return>
</ns1:Esws.bportalTasksLinkResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>