HcmEmployment::findByTimeState Method

Finds a record in the HcmEmployment table by using the specified RecId value.

Syntax

client server public static HcmEmployment findByTimeState(
    HcmEmploymentRecId _recId, 
   [utcdatetime _validFrom, 
    utcdatetime _validTo, 
    boolean _forUpdate, 
    ConcurrencyModel _concurrencyModel])

Run On

Called

Parameters

• _recId
  Type: HcmEmploymentRecId Extended Data Type
  The value of the record ID to find.

• _validFrom
  Type: utcdatetime
  A ValidFrom field value.

• _validTo
  Type: utcdatetime
  A ValidTo field value.

• _forUpdate
  Type: boolean
  A Boolean value that indicates whether to read the record for update; optional.

• _concurrencyModel
  Type: ConcurrencyModel Enumeration
  The concurrency model option to use when the record is read; optional.

Return Value

Type: HcmEmployment Table
A record in the HcmEmployment table; otherwise, an empty record.

Remarks

Values for the _validFrom and _validTo values limit the table selection in the following way:

1. If no values are supplied for both the parameters, they use now. Therefore, the method searches for only active records and returns either an empty record or a valid record.

2. If only the first parameter value is supplied, the second parameter uses the value of the first parameter. The method searches for active records as of the supplied date and time value and returns either an empty record or a valid record.

3. If both parameters are supplied with values, the method searches for records whose validFrom and ValidTo values fall in that interval. The method returns either an empty record or a valid record.

See Also

Reference

HcmEmployment Table