DOCSP-30634 Mapping Rule Options Drawer (#21)

* DOCSP-30634 Mapping Rule Options Drawer

Author: ianf-mongodb

source/diagrams/understand-diagrams.txt

@@ -197,7 +197,7 @@ MongoDB's embedded data model:
 
 
 - The ``Order`` collection contains a rule that maps ``OrderLines`` as
-  an :ref:`Embedded array <mapping-rule-embedded-array>`. The
+  an :ref:`Embedded array <rm-embedded-array>`. The
   ``OrderLine`` table from the relational schema is mapped as an array
   of objects inside the ``Order`` documents, using the foreign key
   relationship from the relational schema.
@@ -208,7 +208,7 @@ MongoDB's embedded data model:
 
 
 - The ``Customer`` collection contains a rule which maps ``Orders`` as
-  an :ref:`Embedded array <mapping-rule-embedded-array>`. The ``Order``
+  an :ref:`Embedded array <rm-embedded-array>`. The ``Order``
   table from the relational schema is mapped as an array of objects
   inside the ``Customer`` documents, using the foreign key relationship
   from the relational schema.

source/img/mapping-options/mapping-options-new-documents-example.png

@@ -0,0 +1,6 @@
+The blue dotted box in the MongoDB diagram pane is a visual preview of how each 
+rule and option affect your destination data model. Using this feature, 
+you can preview your destination data model before you run a sync job.
+
+.. image:: /img/mapping-options/mappings-options-embedded-documents-preview.png
+   :alt: Preview Mapping Options

source/includes/mapping-options-preview.rst

@@ -1,5 +1,122 @@
-.. _mapping-rule-embedded-array:
+.. _rm-embedded-array:
 
 ==============
 Embedded Array
 ==============
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+The :guilabel:`Embedded array` mapping rule is an advanced mapping rule option. 
+It must be explicitly added to a mapping model.
+
+About this Task
+---------------
+
+The :guilabel:`Embedded array` mapping rule is available if the relational
+table it is mapping from is on the many side of the foreign key relationship. 
+
+The table containing the primary key must also be mapped to a 
+collection in the MongoDB model.
+
+Behavior
+--------
+
+Use the :guilabel:`Embedded array` mapping rule to insert the 
+values of the child table as array elements under documents in
+the collection mapped to the parent table.
+
+Example
+-------
+
+This section demonstrates the relational input and
+the MongoDB output of the :guilabel:`Embedded array` mapping rule.
+
+Embedded array
+~~~~~~~~~~~~~~
+
+In this example:
+
+- An :guilabel:`Embedded Array` mapping rule is applied to the :guilabel:`Customer` table.
+- The :guilabel:`Source table` is set to :guilabel:`Order`.
+- The :guilabel:`Prefix` is set to :guilabel:`(root)`.
+- The :guilabel:`Field Name` is set to :guilabel:`orders`.
+
+
+Click the tabs below to see the input and output for this example:
+
+.. tabs::
+
+   .. tab:: Relational Input
+      :tabid: Embedded-array-in
+
+      ``Customer`` table:
+
+      .. list-table::
+         :header-rows: 1
+
+         * - Id
+           - Name
+           - Address1
+           - Address2
+           - Address3
+         * - 1
+           - Joelynn Fawthrop
+           - 86 Dwight Pass
+           - Carregal
+           - 3800-854
+
+      ``Orders`` table:
+
+      .. list-table::
+         :header-rows: 1
+
+         * - OrderID
+           - CustomerID
+           - TotalAmount
+           - OrderStatusID
+         * - 1
+           - 1
+           - 50.00
+           - 1
+         * - 4
+           - 1
+           - 500.00
+           - 3
+
+   .. tab:: MongoDB Output
+      :tabid: Embedded-array-out
+
+      The document in the ``Customer`` collection now has the ``Order`` details
+      embedded as an array of objects field called ``Orders``.
+
+      All of the customers orders are now visible in the ``Customer`` collection
+      as an array of nested documents.
+
+      .. code-block:: javascript
+         :copyable: false
+         :emphasize-lines: 7-19
+
+         {  
+         "_id": {    "CustomerID": 1  },
+         "Name": "Joelynn Fawthrop",
+         "Address1": "86 Dwight Pass",
+         "Address2": "Carregal",
+         "Address3": "3800-854",
+         "Orders": 
+            [    
+               {  "OrderID": 1,
+                  "CustomerID": 1,
+                  "TotalAmount": 50,
+                  "OrderStatusID": 1
+               },    
+               {  "OrderID": 4, 
+                  "CustomerID": 1, 
+                  "TotalAmount": 500,
+                  "OrderStatusID": 1    
+               }  
+            ]
+         }