Merge pull request #102 from ianf-mongodb/DOCSP-34504

DOCSP-34504 Add Atlas Login

Author: jason-price-mongodb

source/code-generation/query-converter/enable-query-converter.txt

@@ -12,8 +12,14 @@ Enable Query Converter
 
 You can use the query converter to convert SQL statements, views, and 
 stored procedures to MongoDB syntax. The query converter considers the 
-mapping rules and schema transformations defined in your project when converting
-your SQL code.
+mapping rules and schema transformations defined in your project when 
+converting your SQL code.
+
+Before You Begin
+----------------
+
+Before you can use the query converter, you must sign in to your Atlas
+account in Relational Migrator. For details, see :ref:`rm-atlas-log-in`.
 
 Steps
 -----
@@ -47,4 +53,4 @@ Next Steps
 
 - :ref:`rm-convert-queries`
 - :ref:`rm-convert-views`
-- :ref:`rm-convert-stored-procedures`
+- :ref:`rm-convert-stored-procedures`

source/code-generation/query-converter/refresh-database-objects.txt

@@ -53,7 +53,8 @@ Steps
       #. Click the :icon-fa5:`chevron-right` icon next to your schema.
 
       #. Click the :icon-fa5:`chevron-right` icon next to
-         :guilabel:`Stored Procedures` or :guilabel:`Views`.
+         :guilabel:`Stored Procedures`, :guilabel:`Triggers`, or 
+         :guilabel:`Views`.
 
    .. step:: Select the new database objects
 

source/getting-started.txt

@@ -81,3 +81,5 @@ Steps
 
    /getting-started/supported-databases
    /getting-started/migration-scenarios
+   /getting-started/overview
+   /getting-started/atlas-log-in

source/code-generation/query-converter/atlas-log-in.txt renamed to source/getting-started/atlas-log-in.txt

@@ -10,16 +10,16 @@ Log In with Atlas
    :depth: 1
    :class: singlecol
 
-You can sign in to your Atlas account inside Relational Migrator. When 
-you log in with your Atlas account in Relational Migrator, you can 
-access the :ref:`Query Converter <rm-query-converter>` feature.
+You can optionally sign in to your Atlas account inside Relational 
+Migrator. If you log in, you can access the 
+:ref:`Query Converter <rm-query-converter>` feature and you can choose 
+destination clusters from a list when creating sync jobs.
 
 Before you Begin
 ----------------
 
 To log in with Atlas, you must have an existing :atlas:`Atlas account 
-</tutorial/create-atlas-account>` and a 
-:atlas:`deployment </create-connect-deployments>`. 
+</tutorial/create-atlas-account>`. 
 
 About this Task
 ---------------
@@ -31,20 +31,38 @@ About this Task
   - ``8080``
   - ``443``
 
-- If you run Relational Migrator on ports not listed above, 
-  the sign-in process fails.
+- If you run Relational Migrator on any ports numbers other than the 
+  ones listed above or if your accessing Relational Migrator from a 
+  remote client, you will not be able to sign in to Atlas.
 
-- You might need to reauthenticate when your session token expires. To 
+- You must reauthenticate when your session token expires. To 
   reauthenticate to your Atlas account, follow the same log in procedure 
   below.
 
+- Depending on your Atlas login status the top-right profile section of 
+  the Relational Migrator UI can change:
+
+  .. list-table::
+      :header-rows: 1
+
+      * - Login Status
+        - Profile Section UI 
+      * - Signed Out 
+        - Section shows a :guilabel:`Log In` button.
+      * - Logged In 
+        - The section shows a button with the first letter of the 
+          user's name.
+      * - Session expired
+        - The section shows a button with the first letter of the 
+          user's name with a :icon-fa5:`exclamation`.
+
 Steps
 -----
 
 .. procedure::
    :style: normal
 
-   .. step:: Select log in option
+   .. step:: Select a login option
 
       On the top right of the Relational Migrator home screen, click 
       the profile icon or the :guilabel:`Log in` button. The account 
@@ -78,4 +96,4 @@ Next Steps
 Learn More
 ----------
 
-- :atlas:`Create an Atlas Cluster </create-database-deployment/#clusters>`
+- :atlas:`Create an Atlas Cluster </create-database-deployment/#clusters>`

source/projects/overview.txt renamed to source/getting-started/overview.txt

@@ -49,6 +49,6 @@ UI Elements
      - View, edit, delete, and add mapping rules. Select and rename fields 
        included in a mapping rule. Add and remove table filters.
 
-   * - Get Help Menu
+   * - Get Help Menu / Atlas Login 
      -  .. include:: /includes/fact-get-help-menu.rst
 

source/img/projects/project-overview.png

@@ -1,4 +1,5 @@
 View links for documentation, support, community forums, and
 product feedback. The menu also includes a 
 :guilabel:`Replay Product Tour` button to view the onscreen 
-tutorial of the user interface.
+tutorial of the user interface. Use the :guilabel:`Login` button to 
+set the credentials used to connect to your Atlas account.

source/includes/fact-get-help-menu.rst

@@ -37,8 +37,8 @@ Steps
 
 1. Open a project.
 
-#. In the left :guilabel:`Schema model` pane, click on a collection under the 
-   :guilabel:`MongoDB` header. 
+#. In the left :guilabel:`Schema model` pane, click on a collection under 
+   the :guilabel:`Relational` header. 
 
    This prompts the :guilabel:`Mappings` pane to open on the right of the screen.
 

source/mapping-rules/new-rules-from-relational.txt

@@ -43,7 +43,6 @@ There are multiple options for you to create a project:
    /projects/create-project-live-connection
    /projects/create-project-loading-schema-files
    /projects/create-project-sample-schema
-   /projects/overview
    /projects/configure-settings
    /projects/manage-relational-connection
    /projects/import-project