The Configuration Wizard

The configuration wizard guides users through creation of an app from the template. Users make selections that determine how the app they create from your template modifies the original. Most Analytics templates developed by Salesforce include wizards. It’s likely that every customer creates a slightly or significantly different version of an app from the template. But every customer starts with the same app template.

A wizard can include questions about the data used to populate app dashboards. For example, it can ask about which Saleforce objects are used, and which fields are used to store specific elements, such as user IDs, geographic location, product information, revenue, and so on. It can also ask about how to display data in the app and whether the user wants to include or exclude dashboards. Additionally, it can let users set elements of the UI, such as labels to identify KPIs or dashboard colors.

Wizards can also include conditional questions. For example, one question can ask if a user wants to display customer satisfaction key performance indicators about service agents. If the user answers “yes,” the wizard can then display additional questions asking about how dashboards should consume and display customer service data.

Further, the wizard can contain an org data check. App datasets and dashboards usually depend on the Salesforce org where it’s created to contain specific data— certain objects, or fields in objects—to render effective visualizations. The data check reviews the org for the required data. If it’s in the org, app creation continues. If not, the wizard can display a message telling the user what needs to be fixed.

To create the configuration wizard, you modify the template JSON files that contain the instructions the Analytics platform uses to create the app. When a user creates an app from a template, Analytics looks at the template JSON files’ contents, including your wizard selections. It follows instructions in the JSON to create the app.