Services Integration Framework Guide

10.5

Back Next

GetAssignedRecords

GetAssignedRecords fetches the current user’s records that were assigned by an AssignUnmergedRecords request. Can request records in either the Unmerged or the Onhold state.

The request contains a package, a record state (UNMERGED or ON_HOLD), and a maximum number of records to return. The response contains a set of records and a token to use to fetch more results. Use GetSearchResults to get subsequent sets of records.

Use Case

This is the common scenario for using the GetAssignedRecords request:

GetAssignedRecords used to retrieve assigned records for display in the user interface of a custom-designed application
—The most common use of GetAssignedRecords is to retrieve the records that are assigned to a specific user for display in a custom-designed UI.

Usage Example

The following example requests the UNMERGED records for the CUSTOMER_UPDATE package that are assigned to the user making this request.

GetAssignedRecordsRequest request = new GetAssignedRecordsRequest();
request.setSiperianObjectUID("PACKAGE.CUSTOMER_UPDATE");
request.setRecordsToReturn(10);
request.setRecordState(RecordState.UNMERGED);
request.setReturnTotal(false);

GetAssignedRecordsResponse response = (GetAssignedRecordsResponse) sipClient.process(request);