redash_guide.html

<article class="docs-article">
    <section class="docs-section" id="redash">
        <div>


            <ul>
                <h1 id="forms-flow-analytics-usage-documentation">Formsflow Analytics Usage
                    Documentation</h1>
                <hr>
                <p>The process of how to use Redash is <a href="https://redash.io/help/">well
                        documented in official docs</a>. Some of the basic steps for working with
                    Redash are:</p>
                <ol>
                    <li>
                        <em>Add Data sources</em>
                        <p>You can connect with about 30+ supported data sources mentioned in docs from the
                            browser itself.
                            <img src="https://user-images.githubusercontent.com/70306694/125465830-2b6d3985-4dc8-423c-9947-5ae3d689cab0.png"
                                alt="image"><br>
                        </p>
                        </li>
                    <li>
                        <em>Write Queries</em>
                        <p>
                            Once data is connected we can write queries. It’s always ideal to create
                            individual queries for the necessary visualizations. Writing queries is
                            a data preparation step to process data for visualization.</p>
                        <p><img src="https://user-images.githubusercontent.com/70306694/125465939-cf68ce67-c589-49d1-9110-067d0e896054.png"
                                alt="image"></p>
                    </li>
                    <li>
                        <em>Create Visualizations</em>
                        <p>There are a variety of visualizations supported in Redash. Ten different
                    categories of visualization can be created with just drag and select features to
                    visualize from the queried data. Redash supports visualization types like
                    BoxPlot, Counter, BarCharts, Sunburst, Sankey, Word clouds, line charts and Area
                    charts. To learn how to create visualizations checkout Redash visualization
                    docs.</p>
                <p><img src="https://user-images.githubusercontent.com/70306694/125466037-7b66530f-235b-4198-8c6f-46d556726963.png"
                        alt="image"></p>
                    </li>
                    <li>
                        <em>Create Dashboards</em>
                        <p>You can create interactive dashboards that can be embedded anywhere and shared
                            with colleagues easily. The queries can be refreshed periodically as more data
                            comes in.</p>
                        <p><img src="https://user-images.githubusercontent.com/70306694/125466079-02a24f12-58ed-40e4-a669-b88dbb456645.png"
                                alt="image"></p>
                    </li>
                <li><em>Share Dashboad for public access</em>
                <p>Share the Dashboard and enable <code>Allow public access</code> if you wish to share the dashboard outside of formsflow.ai solution.</p>
                <p><img src="https://user-images.githubusercontent.com/70306694/135583411-a7e7ce1d-6792-4884-a133-b9dcd5446cb1.png"
                        alt="image"></p><br>
                </li>
                </ol>
                <div>
                    <h2 id="dashboard">Adding Dashboards on Admin Page</h2>
                    <hr><br>
                    <p>
                        To enable dashboards, and provide authorization the following changes are required
                        in
                        existing installations:
                    <ol>
                        <li>Create a new main group called formsflow-analytics, and create as many subgroups
                            as you
                            want to associate various dashboards from Admin UI (in Designer)</li><br>
                        <img src="./assets/images/Screenshot 2022-05-16 123429.png" alt="image" height="300"
                            width="350"><br><br>
                        <li>Create a new mapper under forms-flow-web client in Keycloak by following the steps below:
                          
                        </li>
                        <img src="./assets/images/Screenshot 2022-05-16 130800.png" alt="image" height="500"
                            width="500"><br>
                        <li>Corresponding to each user, add the dashboard-groups you want to enable for
                            dashboard
                            authorization. Any user in a group given permission by the Admin to view a dashboard will then have access to that dashboard.</li><br>
                        <img src="./assets/images/Screenshot 2022-05-16 131123.png" alt="image" width="1000"
                            height="500"><br>
                        <li>The dashboards added in the above step will be displayed in the Insights tab
                        </li><br>
                        <img src="./assets/images/Screenshot 2022-05-16 131548.png" alt="image" width="1000"
                            height="500"><br><br>
                        <strong>Note:</strong>-Users who don’t belong to any group added in Keycloak will not see an Insights tab option.

                    </ol>
                    </p>
                </div>

            </ul>
        </div>