Learn about our newest features and enhancements!
Reports & Analytics: An introduction to custom dashboards within CharityEngine
Authored by:
on 2/28/2024 1:29:00 PM

Introduction

CharityEngine offers functionality to customize and create dashboards to assist your organization in tracking various elements across your database. This tool is a great way to create executive summaries, track performance, and to increase your ability to act on data. CharityEngine Dashboards allow you and your users with at-a-glance visibility, save time and resources, improve your decision making, provide easy performance checks and balances, and up-to-date progress evaluation. 



    Prerequisites

    To use gift totals from the main, out of box, dashboard, the user will need to set Current Period Goals within the Configuration App.

    This value can be set by accessing the Configuration App > General > Goals > Current Period

    Creation of reports and queries will be used within the dashboard feature. You can also leverage pre-existing dashboard widgets located through the out-of-the-box reporting. To learn more about using our reporting elements please read:

    Reports & Analytics: An introduction to reporting within CharityEngine
    Reports & Analytics: How to Use the Report Builder Tool
    Automation & Workflow: An Introduction to Queries

    Overview

    Your organization can access out-of-the-box and custom dashboards. The standard default will include a view of your organization's Dashboard. To change the dashboard view, navigate to the top right and click on the Widget icon to expose a drop down. Your out-of-the-box dashboards also include a Campaign dashboard. Any custom dashboards can also be accessed here.  

    You can also Edit Dashboard or create a New Dashboard. These options are also available by navigating to the Reports & Analytics > General > Dashboards.


    Instructions: Creating a Dashboard

    To get started, please ensure you have created all available reporting through the report builder or query features. 

    Step 1: Navigate to the Reports & Analytics App > General > Dashboard > Create New.

    Step 2: On the General tab, create a Name (required) for the dashboard, determine if the dashboard should be the default and primary view when users log in, if all user roles can access the dashboard, and the Default Period of time for your dashboard elements. Click SAVE to expose additional configuration options.

    Step 3: Once you click SAVE, the Roles and Pages tabs will appear for  further configurations. On the Roles tab, select from the dropdown what type of user will be able to access this dashboard and click Add.

    Step 4: Once added the role type will be displayed below and other types of roles can be added.

    Step 5: On the Pages tab, use the dropdown to select what pages in CharityEngine the dashboard will be available on. Adding Organizations & People will add the dashboard to the Contact App

    Step 6: Navigate to the Advanced tab for access to advanced developer tools. 

    Step 7: Click SAVE to secure your changes. 


    Instructions: Editing the Dashboard

    Once the dashboard has been configured, you can begin to build and or edit your dashboard.

    Step 1: If you have completed your configuration from the above steps, navigate to SAVE > drop down arrow > Editor or click on Go to Builder link

    Note: if you are accessing the listing screen, navigate to the Reports & Analytics App > General > Dashboard > locate your dashboard > ACTIONS > Editor


    Step 2: The dashboard will be initiated with one row to begin your design. 


    Instructions: Managing Rows & Panels

    Once the dashboard has been configured, you can begin to build and or edit your dashboard. The Dashboard feature allows the user to add, delete, reorder rows and panels.

    1. Add rows by Drag Widget or Click to Add Row
    2. Within a row, add panels by clicking the plus icon
    3. Use the Up and Down arrow to move row positions
    4. Use the Left and Right arrow to move panels
    5. Use the Trashcan icon to delete a row
    6. Use the Pencil icon to create a row label or panel label


    Instructions: Creating a New Dashboard Widget

    Once a row has been created, begin to add dashboard widgets by clicking on Click here to set me up within the panel. Or within a panel click on the Plus icon to add a widget.


    Overview: Dashboard Widgets

    This section provides an overview of the configurable widgets available to include within a dashboard. 

    KPI Widget

    This widget can be used for key performance indicators. 
    Select KPI
      1. Label: Header for widget
      2. Color: widget background color
      3. Format: of value
      4. Data Set 1: use the Pencil icon to select your data source

    Chart Widget

    This widget can be used for visual trending performance. 

    Leverage the graph legends by hovering over each dot within the chart to view the details for the specific data point.



    Select Chart
      1. Type: select from available options
        1. Note: Use of Geo Map and Google Map for map integration requires setup of the organization's Google Map API Key. Learn more here on how to set up the API integration.  
        2. Format: adjust default if needed

        3. Data Set 1: use the Pencil icon to select your data source - add additional data sets as needed
        • In this data set example, the y-axis will represent the total transaction sum (Transactions.Amount (signed) [Sum] from the query). The x-axis represents the transaction month (Transactions.Date Created [Month Name]). Note, in the query, the Month Name is achieved by configuring the sort within the query. 

    Data Table Widget

    This widget can be used for visual trending performance. 
    Select Data Table
      1. Data Set: Use the Pencil icon to select your data set
      2. Layout: select default or large

    Analytics Widget

    This widget can be used to leverage existing reporting widgets located within the Reports & Analytics app and depending upon the data element selected, provides various visual outputs including graphs and tables. 
    Select Analytics
      1. Type: From the drop down, select from a list of out-of-the-box analytics
      2. Mode: select visualization or data set (where available)
      3. Default Interval: select from available frequency
      4. Default Period: select from available time periods

    Template Widget

    This widget can be used to leverage existing dashboard reporting widgets located within the Reports & Analytics app. Depending upon the data element selected, provides various visual outputs. 
    Select Template
      1. Type: From the drop down, select from a list of out-of-the-box dashboard analytics widgets
      2. Default Dates: select from available time periods

    URL Widget

    This widget leverages an identified URL to present to within the dashboard.  
    In this example, linking the existing CharityEngine LYBUNT Report for quick access for the end user. 
    Select URL
      1. URL: add url
      2. Scroll: toggle to yes as needed
      3. Style: toggle to none as needed

    Other Configuration Widgets

      
      1. HTML: leverage for custom development 
      2. Other Settings: Add dashboard title for row
      3. Javascript: leverage for custom development
      4. Css: leverage for custom development

    Duplicating Dashboard

    When creating a dashboard, you may want to use a dashboard that has already been created, however change a few small things. Instead of creating a whole new dashboard, you can duplicate an existing dashboard and then make the changes to the reports displayed.

    Step 1: Navigate to Reports & Analytics > General > Dashboard > locate your dashboard > ACTIONS > Clone


    Returning to a Dashboard

    To return to the home page from any location, click on the CharityEngine® logo found in the top left corner of the screen. To change the dashboard, click on the Gear and select your <Organization Name> Dashboard.


    FAQs & Additional Reading

    Q. I'd like to learn more about CharityEngine reporting options.
    A. Learn about our various reporting capabilities by visiting Reports & Analytics: An introduction to reporting within CharityEngine

    Q. Why are my giving totals not populating on my main dashboard? Why don't we have a Goal set?
    A. Values for gift history is driven by the presence of an organizational goal. This value can be set by accessing the Configuration App > General > Goals > Current Period

    Q.How are the values determined in the out of box dashboard used for the main dashboard?
    A. Values are updated hourly in the top portion of the main dashboard. Donations totals related to total in online gifts vs. total in gifts from other changes are allocated based upon Media Channel and Response Channel configuration. If you would like to review current settings or modify, please navigate to the Configuration App > Campaign > Media Channels (and Response Channels) > ACTIONS > Manage > Type: Traditional or Online. Note, changes take 24 hours to reflect on changes from the dashboard.  



    Related Articles

    Powered by Powered By CharityEngine