forDeepUpdate

open fun forDeepUpdate(vararg paths: PropertyPath): EntityValue

Set a flag to mark this entity to be copied by a subsequent DataService.makeDraftCopy call, in preparation for a later DataService.activateDraft call that will update the entity. Set {@link com.sap.cloud.mobile.kotlin.odata.EntityValue#cascadePaths EntityValue.cascadePaths} to paths if paths is non-empty, otherwise set {@link com.sap.cloud.mobile.kotlin.odata.EntityValue#cascadePaths EntityValue.cascadePaths} to null. If paths is empty, the subsequent deep update should include composition children (recursively) which are specified with on-delete-cascade.

See Also:

Update Related Entities When Updating an Entity, {@link com.sap.cloud.mobile.kotlin.odata.EntityValue#bindEntity(com.sap.cloud.mobile.kotlin.odata.EntityValue, com.sap.cloud.mobile.kotlin.odata.Property) EntityValue.bindEntity}, {@link com.sap.cloud.mobile.kotlin.odata.EntityValue#unbindEntity(com.sap.cloud.mobile.kotlin.odata.EntityValue?, com.sap.cloud.mobile.kotlin.odata.Property, kotlin.Boolean) EntityValue.unbindEntity}.

Return

This entity instance.

Parameters

paths

List of property paths (usually {@link com.sap.cloud.mobile.kotlin.odata.Property} instances).