DATACMNS-342 - Open up id property selection API in BasicPersistentEntity.

To support more advanced id property selection mechanisms we introduced a callback method returnPropertyIfBetterIdPropertyCandidate(…).

Pull request: #30.