getAssociatedRecords

Gets the records that are associated with the given record though the given association. This method functions exactly as the getAllAssociatedRecords method, except it only takes one recordID instead of an array.

Parameters

recordId
The source record for the association.
association
An association string filter. Leave an empty string "" to follow all associations.
maxResults
The maximum number of results to return. All results have a value of -1.

Returns

An array of association objects limited by maxResults if applicable.

Errors

RecordDoesNotExistException
The given context record does not exist.
InvalidArgumentException
Any of the arguments passed in are invalid.
java.lang.Exception
A system error occurred while processing the request.

Sample request

<soapenv:Envelope 
	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 	xmlns:ws="http://ws.tririga.com">
   <soapenv:Body>
      <ws:getAssociatedRecords>
         <ws:recordId>2592271</ws:recordId>
         <ws:associationString></ws:associationString>
         <ws:maxResults>-1</ws:maxResults>
      </ws:getAssociatedRecords>
   </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>
      <getAssociatedRecordsResponse xmlns="http://ws.tririga.com">
         <out>
            <ns1:Association xmlns:ns1="http://dto.ws.tririga.com">
               <associatedModuleId xmlns="http://dto.ws.tririga.com">6</associatedModuleId>
               <associatedObjectTypeId xmlns="http://dto.ws.tririga.com">10002873</associatedObjectTypeId>
               <associatedRecordId xmlns="http://dto.ws.tririga.com">2544355</associatedRecordId>
               <associatedRecordName xmlns="http://dto.ws.tririga.com">test0.006383329817522099</associatedRecordName>
               <associationName xmlns="http://dto.ws.tririga.com">Primary Location</associationName>
               <inverseAssociationName xmlns="http://dto.ws.tririga.com"/>
               <moduleName xmlns="http://dto.ws.tririga.com">Location</moduleName>
               <objectTypeName xmlns="http://dto.ws.tririga.com">triSpace</objectTypeName>
               <recordId xmlns="http://dto.ws.tririga.com">2592271</recordId>
               <reverseAssociationName xmlns="http://dto.ws.tririga.com"/>
               <sourceModuleId xmlns="http://dto.ws.tririga.com">22219</sourceModuleId>
               <sourceObjectTypeId xmlns="http://dto.ws.tririga.com">10010138</sourceObjectTypeId>
            </ns1:Association>
         </out>
      </getAssociatedRecordsResponse>
   </soap:Body>
</soap:Envelope>