DOCSP-23996 Add enableUtf8Validation Connectionstring Option (#576)

* DOCSP-23996 Add enableUtf8Validation Connectionstring Option

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* *

* Apply suggestions from code review

Co-authored-by: Sarah Olson <[email protected]>

* *

---------

Co-authored-by: Sarah Olson <[email protected]>

Author: ianf-mongodb

source/includes/fact-non-utf8-data.rst

@@ -0,0 +1,30 @@
+If you attempt to query or export data with invalid UTF8 characters
+the following error message displays: 
+
+.. code-block:: none
+   :copyable: false
+
+   Invalid UTF-8 string in BSON document. 
+
+To query or export this data, disable UTF8 validation by setting 
+the ``enableUtf8Validation`` URI option to ``false``. 
+
+.. warning::
+
+   **Editing data** with ``enableUtf8Validation=false`` can result in 
+   loss of data. This approach is a temporary workaround to 
+   query or export data only.
+
+The following URI disables UTF8 validation:
+
+.. code-block:: javascript
+
+      mongodb://localhost:27017/?enableUtf8Validation=false
+
+
+.. note::
+
+   You can also disable this option in the 
+   :ref:`Advanced Connection Options <advanced-connection-tab>` by 
+   selecting :guilabel:`enableUtf8Validation` and entering 
+   ``false``.

source/query/filter.txt

@@ -375,6 +375,13 @@ Clear the Query
 
 .. include:: /includes/clear-query.rst
 
+.. _compass-query-invalid-utf8-data:
+
+Query Collections with Invalid UTF8 Data
+----------------------------------------
+
+.. include:: /includes/fact-non-utf8-data.rst
+
 How Does the Compass Query Compare to MongoDB and SQL Queries?
 --------------------------------------------------------------