(DOCSP-37582): Document disconnecting/reconnecting databases in Charts (#650)

* document disconnecting/reconnecting databases

* fix small bug related to org sharing

Author: davidhou17

source/manage-data-sources.txt

@@ -20,7 +20,7 @@ On the :guilabel:`Data Sources` page, an |service|
 :authrole:`Project Owner` can:
 
 - :ref:`Connect a data source <connect-data-source>` to |charts|.
-- :ref:`Disconnect a data source <disconnect-data-source>` from 
+- :ref:`Disconnect a data source or database <disconnect-data-source>` from 
   |charts|.
 - Modify :ref:`data source settings <access-data-source-settings-page>`.
 
@@ -57,6 +57,11 @@ To connect a data source to |charts-short|:
       connect. The database's data sources display, including 
       :ref:`charts views <charts-views>`.
 
+      If the database is disconnected:
+      
+      a. Click the :guilabel:`Connect` button next to the database.
+      b. In the :guilabel:`Reconnect Database` dialog box, click :guilabel:`Reconnect`.
+
       |charts-short| displays the following information about the data source:
 
       .. list-table::
@@ -72,8 +77,7 @@ To connect a data source to |charts-short|:
 
          * - :guilabel:`Organization`
            - Label that indicates whether you've enabled 
-             :ref:`organization-wide sharing <org-sharing-data-source>` 
-             at the deployment level.
+             :ref:`organization-wide sharing <org-sharing-data-source>`.
 
          * - :guilabel:`External Users`
            - Label that indicates whether: 
@@ -131,10 +135,10 @@ To connect a data source to |charts-short|:
 
 .. _disconnect-data-source:
 
-Disconnect a Data Source from |charts|
---------------------------------------
+Disconnect a Data Source or Database from |charts|
+--------------------------------------------------
 
-Disconnect a data source from |charts-short| to remove its data from
+Disconnect a data source or database from |charts-short| to remove its data from
 your charts. If you disconnect a data source:
 
 - Any charts you built that use the data source no longer
@@ -143,49 +147,77 @@ your charts. If you disconnect a data source:
   source no longer render and display an error.
 - You can't use the data source to build new charts.
 
+If you disconnect a database, |charts-short| disconnects 
+all of the data sources in the database. You can :ref:`reconnect
+<connect-data-source>` a data source or database later to 
+resume rendering charts that use its data.
+
 You can also :ref:`disconnect a deployment <disconnect-deployment>`.
 To delete a charts view, see :ref:`charts-views`.
 
-If you disconnect a data source, you can :ref:`reconnect
-<connect-data-source>` it later to resume rendering charts that 
-use its data.
-
 .. note::
 
    .. include:: /includes/sample-data-source-description.rst
 
-To disconnect a data source from |charts-short|:
+To disconnect a data source or database from |charts-short|:
 
-.. procedure::
-   :style: normal
+.. tabs::
 
-   .. include:: /includes/steps-access-deployment.rst
+   .. tab:: Disconnect Data Source
+      :tabid: disconnect-data-source
 
-   .. step:: In the :guilabel:`Data Access` section, select the database that contains the data source.
+      .. procedure::
+         :style: normal
 
-      Select the database that contains the data source you want to
-      disconnect. The database's data sources display.
+         .. include:: /includes/steps-access-deployment.rst
 
-   .. step:: Click :guilabel:`Manage` next to the data source's information.
+         .. step:: In the :guilabel:`Data Access` section, select the database that contains the data source.
 
-      The data source's details page displays.
+            Select the database that contains the data source you want to
+            disconnect. The database's data sources display.
 
-   .. step:: Check the connection status and disconnect the data source.
+         .. step:: Click :guilabel:`Manage` next to the data source's information.
 
-      If the data source connection status is :guilabel:`Disconnected`,
-      the data source is already disconnected from |charts|.
-      
-      If the data source connection status is :guilabel:`Connected`:
-     
-      a. Click the disconnect icon :icon-fa5:`unlink` next to the data
-         source connection
-         status. The :guilabel:`Disconnect Data Source` modal appears.
-      #. Click :guilabel:`Check for connected charts` to
-         learn whether any charts use the
-         data source.
-      #. Click :guilabel:`Disconnect`.
-     
-      The data source disconnects from |charts-short|.
+            The data source's details page displays.
+
+         .. step:: Check the connection status and disconnect the data source.
+
+            If the data source connection status is :guilabel:`Disconnected`,
+            the data source is already disconnected from |charts|.
+            
+            If the data source connection status is :guilabel:`Connected`:
+         
+            a. Click the disconnect icon :icon-fa5:`unlink` next to the data
+               source connection
+               status. The :guilabel:`Disconnect Data Source` modal appears.
+            #. Click :guilabel:`Check for connected charts` to
+               learn whether any charts use the
+               data source.
+            #. Click :guilabel:`Disconnect`.
+         
+            The data source disconnects from |charts-short|.
+
+   .. tab:: Disconnect Database
+      :tabid: disconnect-database
+
+      .. procedure::
+         :style: normal
+
+         .. include:: /includes/steps-access-deployment.rst
+
+         .. step:: In the :guilabel:`Data Access` section, select the database that you want to disconnect.
+
+            The database's data sources display.
+
+         .. step:: Disconnect the database.
+
+            To disconnect the database and all of its data sources:
+
+            a. Click the :guilabel:`Disconnect` button for the selected database.
+            #. In the dialog box, click :guilabel:`Check for connected charts`.
+               |charts-short| displays the number of charts that use the data sources
+               in the database.
+            #. Click :guilabel:`Disconnect` to confirm your selection.
 
 .. _access-data-source-settings-page: