The RecordKey parameter is required to uniquely identify the record for which the aggregate effective period must be retrieved.

The HistoryDate parameter specifies the date for which you retrieve base object data that is effective at the specified point in time. If HistoryDate is equal to or earlier than HIST_CREATE_DATE, no records are returned.

For Oracle environments, milliseconds for HistoryDate are truncated. If HistoryDate is later than HIST_CREATE_DATE by less than a second, no records are returned. If you have Daylight Saving Time (DST) enabled for the operating system and HistoryDate is later than HIST_CREATE_DATE by less than one hour during DST, no records are returned.

The following is a common scenario for using the GetEffectivePeriods request:

Retrieve the period for which a customer's billing address is valid.

The following example gets the effective period for a record with ROWID_OBJECT key 28 from the base object C_BO:

GetEffectivePeriodsRequest req=new GetEffectivePeriodsRequest();
RecordKey rec=new RecordKey();
rec.setRowid("28");
req.setRecordKey(rec);
req.setSiperianObjectUid("BASE_OBJECT.C_BO");
GetEffectivePeriodsResponse response = (GetEffectivePeriodsResponse)sipClient.process(req);