Developer

Limitations of Deep Inserts

A deep insert is an OData POST request to create an entity that also contains the inlined definitions of related entities.

When a deep insert is processed, the top-level entity and all of its related entities are created and linked together as a single operation. The Offline Store supports deep inserts through the OData API on Android, iOS and WinPhone 8 platforms with one important restriction:
  • The navigation property used for the deep insert must refer to at most one entity. Any inlined related entities must be added using a navigation property whose ToRole refers to an association end with cardinality 0..1 or 1. They cannot be added using a navigation property whose ToRole refers to an association end with cardinality *. Navigation properties that refer to a set of entities cannot be used for deep inserts.