Dashboards and Visualizations
------------------------------


..  |share_dashboard_btn| image:: ../_static/global/share_dashboards_btn.png
    :align: middle
    :height: 26px

Viewing Dashboard
~~~~~~~~~~~~~~~~~~~

1. On the home page, click ``Dashboards`` to open the analytics page.

..  image:: ../_static/nigeria/dashboards/click_dashboards.png
    :class: border spaced-image

2. Select the dashboard that you wish to view.

..  image:: ../_static/nigeria/dashboards/select_dashboard.png
    :class: border spaced-image

3. Your selected dashboard will be opened for you to view.

..  image:: ../_static/nigeria/dashboards/selected_dashboard.png
    :class: border spaced-image

Creating a Dashboard
~~~~~~~~~~~~~~~~~~~~~~

1. On the homepage, click ``Dashboards`` to open the analytics page

..  image:: ../_static/nigeria/dashboards/click_dashboards.png
    :class: border spaced-image

2. Click ``MANAGE``  and select ``+ Create New Dashboard``.

..  image:: ../_static/nigeria/dashboards/click_manage_to_create_dashboard.png
    :class: border spaced-image

3. Click ``Add Visualization``

..  image:: ../_static/nigeria/dashboards/click_add_visualization.png
    :class: border spaced-image

4. Select a data source.

..  image:: ../_static/nigeria/dashboards/select_data_source_to_create_dashboard.png
    :class: border spaced-image

5. From the data source, select a table.

..  image:: ../_static/nigeria/dashboards/select_data_source_table.png
    :class: border spaced-image

6. Select an appropriate visualization top be added as a panel to the dashboard.

..  image:: ../_static/nigeria/dashboards/select_visualization.png
    :class: border spaced-image

7. Perform the neccessary data operations for the selected visualization.

..  image:: ../_static/nigeria/dashboards/data_operations.png
    :class: border spaced-image

.. Note:: 
    You can also write *SQL* code to perform the data operation by switching from ``Builder`` to ``Code``.

    ..  image:: ../_static/nigeria/dashboards/code_mode.png
        :class: border spaced-image
        :width: 90%


8. Click ``Run Query`` to create the visualization.

..  image:: ../_static/nigeria/dashboards/click_run_query.png
    :class: border spaced-image

9. Click ``Save dashboard`` to save the visualization.

..   image:: ../_static/nigeria/dashboards/click_save_dashboard.png
    :class: border spaced-image

..  Note::
    If the ``Save dashboard`` button is not visible, press the ``Esc`` or ``Escape`` button on your keyboard to show more dashboard controls. If you are redirected to a dashboard page, click the ``Esc`` button again, then click the menu button on the current visualization then select ``Edit`` to go back to editting the visualization

    ..  image:: ../_static/nigeria/dashboards/click_edit_panel.png
        :width: 90%
        :class: border spaced-image

10. Provide the details of the dashboard that you are creating and click ``Save``.

..  image:: ../_static/nigeria/dashboards/click_save_on_dashboard_form.png
    :class: border spaced-image

..  Hint::
    A complete dashboard is made up of more than one visualization. To add a visualization, follow this procedure.

    1. On the current visualization, click ``Back to dashboard``.
    
    ..  image:: ../_Static/nigeria/dashboards/click_back_to_dashboard.png
        :class: border spaced-image
        :width: 90%

    ..  Note::
        If the ``Back to dashboard`` button is not visible, press the ``Esc`` or ``Escape`` button on your keyboard to show more dashboard controls.

    2. Click ``Add`` and select ``Visualization``.

    ..  image:: ../_static/nigeria/dashboards/click_add_to_select_visualization.png
        :class: border spaced-image
        :width: 90%

    3. Repeat process *4 to 10*.

    4. You can add as many visualizations as required in the dashboard


Sharing a dashboard
~~~~~~~~~~~~~~~~~~~~~

1. On the home page, click ``Dashboards`` to open the analytics page.

..  image:: ../_static/nigeria/dashboards/click_dashboards.png
    :class: border spaced-image

2. Select the dashboard that you wish to share.

..  image:: ../_static/nigeria/dashboards/select_dashboard.png
    :class: border spaced-image

3. Click the |share_dashboard_btn| to get a shareable link.

..  image:: ../_static/nigeria/dashboards/click_share_dashboard.png
    :class: border spaced-image