Using Power BI Visuals

Open Power BI
Once the Power BI Visual has been created, open a Power BI report to add the visual.
In the Visualizations section, click on the '...' option towards the end of the list of Visualizations. This will open a dialog. On the dialog, select 'Import from file' and navigate to the visual that has been created by the Inovista Compiler. The location of the file will have been indicated by the Compiler as shown on the previous page.

If the visualization loads correctly, the visual's icon will be shown in the Visualizations panel.

Click on the icon to add the visual to the report. A visual with a stock image will be added to the report and the list of variables that were created in the Inovista Animator will be presented below the Visualizations panel. The newly loaded visual will only appear once a data value has been dragged into one of the variables.

Map Data
All visuals created by the Inovista Animator will need at least one mapped data item to make the visual work. Drag the required data items from the 'Fields' section to the variable name that was created in the Animator in the visual.

NOTE not all variables need a field value. Once a single field has been mapped, other variables will use the default value that was defined in the Animator if they are left blank.

Once the required fields have been dragged to the Animator variables and a Slicer or Filter has been created, the animation should run every time the Slicer or Filter is updated.

Suppress Animation
At design-time when developing the report, the animation will run every time the base data change. To stop this, there is a 'Run Animation' option in the 'Format' section. Set 'Allow Animation' to Off to suppress the animation. Don't forget to turn this back on before publishing the report.

Set Property Values
The property values defined in the Animator will also be shown in the 'Format' section. Depending on how these properties were defined in the Animator, they should be available as standard editors such as the Color, Font Size and Family selectors.

Non Data-Driven Animations
Some animations do not require external data, for example an animated logo that fires when clicked by a user. As Power BI requires a visual to have data in order to run, these animations come with a dummy variable. All that is needed to run the animation is to drag any field to the 'Dummy Value' option. The field will be ignored, so it does not really matter which field is used.

Repeating Images
When using repeating images and when the variables have been defined as shown in 'Repeating Images' on the previous page, one single field will populate each variable item. For example, in the image below the 'txt' variable is populated by the values in the 'City' field. The first data item will populate the first variable item, the second data field will populate the second data item and so on.

Also make sure the data are not summarized so that each individual item is shown in sequence.