How to :: create a view/report selector

Tip

💡 Did you know? This is optional, you can chose to not have any custom view available for your users.

view home

view home

What is a view?

A view is a way for the user to choose which figures will be displayed on the home. Based on what the user will select, the home will be specific to the selection made.

You’ll be able to customize the KPI the user will see, as well has the number and type of viz you want to display on the home.

For example :

  • I’d like to customize the home for each country where I’m selling my products
  • I’d like to have a view for each of my agents, their manager and the country manager
  • I’d like to have some indicators for the Marketing team, and others for the Finance team
  • I’d like a global overview of my sales, then a global overview for each of my brands

This view selector will be available from the home and from the stories.

Which means you can adapt both your home and your stories from this view/report selector.

view stories

You can also create a specific navigation for each view. Some chapters or stories can be only visible from some views and not others.

This is what we call visibility.

Add a view selector

Warning

Granularity/hierarchy is not yet available, please refer to advanced tutorials to switch to the old home and configure these options.

It’s very important to understand your users’ needs before starting.

Ask yourself the good questions to understand who are your users:

  • What are my categories of users?
  • What are the main points of view of the data I need to display?
  • What level of detail do my user need access?

Write down your users stories and validate them with your team.

As [this user] I need to see …

This is the skeleton of your small-app, it will define the whole navigation for your user.

Select the dataset containing your list of views and configure the view selector.

📝 In this example, we want to have a Global overview of our sales, and focus on countries. So I want a dropdown menu where I can select “Global” or “France” or “UK”.
view selector

view selector

Use the view selector in your application

The view/report selector creates a variable that can be used almost anywhere in the app with the parameter <%= appRequesters.report %>.

📖 Learn more on how to use this variable with the templating tutorial