diff --git a/source/sdk/crud/create.txt b/source/sdk/crud/create.txt index b5fb8137cb..444109eb7f 100644 --- a/source/sdk/crud/create.txt +++ b/source/sdk/crud/create.txt @@ -36,9 +36,10 @@ synced database using Atlas Device SDK. To learn more about object models and how to define them, refer to :ref:`sdks-object-models`. You can create objects whose object type is managed by the database instance. -For more information, refer to -:ref:`sdks-configure-and-open-database` or -:ref:`sdks-configure-and-open-synced-database`. +For more information, refer to: + +- With Sync: :ref:`sdks-configure-and-open-synced-database` +- Without Sync: :ref:`sdks-configure-and-open-database` .. note:: Write to a Synced Database @@ -384,6 +385,14 @@ you do so inside a write transaction. Create Objects from JSON ~~~~~~~~~~~~~~~~~~~~~~~~ +Working with JSON returned from an API is a common development use case. Most +of the supported SDK languages do not directly support creating objects from +JSON. However, you may use language or platform-idiomatic APIs to transform +JSON to a structure that matches your object schema, and create a matching +object. Or you may :ref:`model unstructured data ` +to work with **unstructured data** that is highly variable or whose structure +is unknown at runtime. + .. tabs-drivers:: .. tab:: diff --git a/source/sdk/crud/create/create-property-types.txt b/source/sdk/crud/create/create-property-types.txt index 8de11cf3f4..4229f7e3b4 100644 --- a/source/sdk/crud/create/create-property-types.txt +++ b/source/sdk/crud/create/create-property-types.txt @@ -474,7 +474,8 @@ Create Set Properties ~~~~~~~~~~~~~~~~~~~~~ Like their native counterparts, the SDK's set data type stores unique values. -These values may be of any supported type except another collection. +These values may be a Realm object or one of the supported data types. +It cannot be another collection, an embedded object, or an asymmetric object. The SDK uses the Set container type to define to-many relationships. A **to-many** relationship means that an object is related in a specific diff --git a/source/sdk/model-data/object-models.txt b/source/sdk/model-data/object-models.txt index 729b0dc07a..9cb67efbdc 100644 --- a/source/sdk/model-data/object-models.txt +++ b/source/sdk/model-data/object-models.txt @@ -67,3 +67,7 @@ Define a Primary Key Placeholder for .NET nullability info, and any other SDKs with similar APIs/requirements +.. _sdks-model-unstructured-data: + +Model Unstructured Data +~~~~~~~~~~~~~~~~~~~~~~~