associateRecords
Creates an association between two records. If a reverse association is defined for this forward association, the reverse association is also created.
Parameters
associations is the array of association objects to create.
Returns
ResponseHelperHeader is the status of the association that was passed in.
Errors
- java.lang.Exception
- A problem occurred with any of the individual associations or a system error occurred while the request was processed.
- ModuleDoesNotExistException
- The module does not exist.
- ObjectTypeDoesNotExistException
- The object type does not exist.
- RecordDoesNotExistException
- The record that was passed in does not exist.
- InvalidArgumentException
- Any of the arguments that are passed in are an invalid exception.
- AccessException
- The user does not have access to modify the record.
Sample request
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.tririga.com"
xmlns:dto="http://dto.ws.tririga.com">
<soapenv:Body>
<ws:associateRecords>
<ws:Associations>
<!--Zero or more repetitions:-->
<dto:Association>
<dto:associatedRecordId>12346</dto:associatedRecordId>
<dto:associationName>Associated To</dto:associationName>
<dto:recordId>12345</dto:recordId>
</dto:Association>
</ws:Associations>
</ws:associateRecords>
</soapenv:Body>
</soapenv:Envelope>
Sample response
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soap:Body>
<associateRecordsResponse xmlns="http://ws.tririga.com">
<out>
<anyFailed xmlns="http://dto.ws.tririga.com">false</anyFailed>
<failed xmlns="http://dto.ws.tririga.com">0</failed>
<responseHelpers xmlns="http://dto.ws.tririga.com">
<ResponseHelper>
<key xsi:nil="true"/>
<name>12346_Associated To_12345</name>
<recordId>12346</recordId>
<status>Successful</status>
<value xsi:nil="true"/>
</ResponseHelper>
</responseHelpers>
<successful xmlns="http://dto.ws.tririga.com">1</successful>
<total xmlns="http://dto.ws.tririga.com">1</total>
</out>
</associateRecordsResponse>
</soap:Body>
</soap:Envelope>