DOCSP-1389 - Integrating Compass into projection tutorial

source/includes/driver-example-query-42.rst

@@ -20,6 +20,22 @@
 
             .. include:: /includes/fact-mws.rst
 
+     - id: compass
+       content: |
+         .. code-block:: javascript
+
+            [
+              { item: "journal", status: "A", size: { h: 14, w: 21, uom: "cm" }, instock: [ { warehouse: "A", qty: 5 } ] },
+              { item: "notebook", status: "A",  size: { h: 8.5, w: 11, uom: "in" }, instock: [ { warehouse: "C", qty: 5 } ] },
+              { item: "paper", status: "D", size: { h: 8.5, w: 11, uom: "in" }, instock: [ { warehouse: "A", qty: 60 } ] },
+              { item: "planner", status: "D", size: { h: 22.85, w: 30, uom: "cm" }, instock: [ { warehouse: "A", qty: 40 } ] },
+              { item: "postcard", status: "A", size: { h: 10, w: 15.25, uom: "cm" }, instock: [ { warehouse: "B", qty: 15 }, { warehouse: "C", qty: 35 } ] }
+            ]
+
+         For instructions on inserting documents in MongoDB Compass,
+         see :doc:`Insert Documents </tutorial/insert-documents>`.
+
+
      - id: python
        content: |
          .. class:: copyable-code

source/includes/driver-example-query-43.rst

@@ -8,6 +8,19 @@
 
             db.inventory.find( { status: "A" } )
 
+     - id: compass
+       content: |
+         Copy the following expression into the :guilabel:`Filter` bar
+         and click :guilabel:`Find`:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { status: "A" }
+
+
+         .. figure:: /images/compass-project-all-fields.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/includes/driver-example-query-44.rst

@@ -8,6 +8,27 @@
 
             db.inventory.find( { status: "A" }, { item: 1, status: 1 } )
 
+     - id: compass
+       content: |
+         Copy the following expression into the :guilabel:`Filter` bar:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { status: "A" }
+
+         Copy the following expression into the :guilabel:`Project`
+         bar:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { item: 1, status: 1 }
+
+         Click :guilabel:`Find`.
+
+         .. figure:: /images/compass-project-specified-plus-id.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/includes/driver-example-query-45.rst

@@ -8,6 +8,27 @@
 
             db.inventory.find( { status: "A" }, { item: 1, status: 1, _id: 0 } )
 
+     - id: compass
+       content: |
+         Copy the following expression into the :guilabel:`Filter` bar:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { status: "A" }
+
+         Copy the following expression into the :guilabel:`Project`
+         bar:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { item: 1, status: 1, _id: 0 }
+
+         Click :guilabel:`Find`.
+
+         .. figure:: /images/compass-project-suppress-id.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/includes/driver-example-query-46.rst

@@ -8,6 +8,27 @@
 
             db.inventory.find( { status: "A" }, { status: 0, instock: 0 } )
 
+     - id: compass
+       content: |
+         Copy the following expression into the :guilabel:`Filter` bar:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { status: "A" }
+
+         Copy the following expression into the :guilabel:`Project`
+         bar:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { status: 0, instock: 0 }
+
+         Click :guilabel:`Find`.
+
+         .. figure:: /images/compass-project-exclude-fields.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/includes/driver-example-query-47.rst

@@ -11,6 +11,27 @@
                { item: 1, status: 1, "size.uom": 1 }
             )
 
+     - id: compass
+       content: |
+         Copy the following expression into the :guilabel:`Filter` bar:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { status: "A" }
+
+         Copy the following expression into the :guilabel:`Project`
+         bar:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { item: 1, status: 1, "size.uom": 1 }
+
+         Click :guilabel:`Find`.
+
+         .. figure:: /images/compass-project-embedded-fields.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/includes/driver-example-query-48.rst

@@ -11,6 +11,27 @@
                { "size.uom": 0 }
             )
 
+     - id: compass
+       content: |
+         Copy the following expression into the :guilabel:`Filter` bar:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { status: "A" }
+
+         Copy the following expression into the :guilabel:`Project`
+         bar:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { "size.uom": 0 }
+
+         Click :guilabel:`Find`.
+
+         .. figure:: /images/compass-project-suppress-embedded-field.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/includes/driver-example-query-49.rst

@@ -8,6 +8,27 @@
 
             db.inventory.find( { status: "A" }, { item: 1, status: 1, "instock.qty": 1 } )
 
+     - id: compass
+       content: |
+         Copy the following expression into the :guilabel:`Filter` bar:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { status: "A" }
+
+         Copy the following expression into the :guilabel:`Project`
+         bar:
+
+         .. class:: copyable-code
+         .. code-block:: javascript
+
+            { item: 1, status: 1, "instock.qty": 1 }
+
+         Click :guilabel:`Find`.
+
+         .. figure:: /images/compass-project-embedded-array-docs.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/includes/driver-example-query-50.rst

@@ -6,7 +6,7 @@
          .. class:: copyable-code
          .. code-block:: javascript
 
-            db.inventory.find( { status: "A" }, { name: 1, status: 1, instock: { $slice: -1 } } )
+            db.inventory.find( { status: "A" }, { item: 1, status: 1, instock: { $slice: -1 } } )
 
      - id: python
        content: |

source/includes/driver-example-query-intro.rst

@@ -9,6 +9,13 @@
          ``inventory`` collection. To populate the ``inventory``
          collection, run the following:
 
+     - id: compass
+       content: |
+         This page provides examples of |query_operations| in
+         :ref:`MongoDB Compass <compass-index>`. The examples on this
+         page use the ``inventory`` collection. Populate the
+         ``inventory`` collection with the following documents:
+
      - id: python
        content: |
          This page provides examples of |query_operations| using the

source/includes/fact-projection-ops.rst

@@ -0,0 +1,3 @@
+For fields that contain arrays, MongoDB provides the following
+projection operators for manipulating arrays: :projection:`$elemMatch`,
+:projection:`$slice`, and :projection:`$`.

source/includes/fact-projection-slice-example.rst

@@ -0,0 +1,2 @@
+The following example uses the :projection:`$slice` projection operator
+to return the last element in the ``instock`` array: