# Get Started

This section features the steps to get you started with xViz Performance Flow.

xViz Performance Flow is a custom visual in Power BI. The first step to using Performance Flow is to add it to the Power BI canvas before we start working on it.

## Overview of Key Components:

<figure><img src="/files/moM4VKp6zyGB8QJc8qxY" alt="" width="563"><figcaption><p><em>Image 1: Components in xViz Performance Flow</em></p></figcaption></figure>

Here's a breakdown of its key elements:

### Toolbar

1. Map Fields: Show additional details using the Map field.
2. Design
   * Orientation: Ability to change the direction of flow of the visual.
   * Layout: Ability to change the way leaf level nodes are arranged in the hierarchy.
   * Template: A bunch of interesting, predefined templates for the view of the nodes.
   * Display: Provides a range of formatting options to customize the visuals.
   * Autofit: Provides the various options to fit the canvas view optimally.
3. Sparkline: Visualize the trend of the KPIs.
4. KPI/Variance: Provides a KPI value for each node along with its variance compared to a benchmark or reference value.
5. Links: Displays the relationships between nodes with additional connectors.
6. Analyze
   * Conditional Formatting: Highlight nodes using data-driven rules.
   * Notes: Display additional textual notes on nodes for the storytelling.
   * Search: Find specific text values within the hierarchical structure.
   * Filter: Filter the canvas view based on specific condition.
   * Filter Context: Allows to add descriptive notes to specific nodes for specific filter selections.
7. Reset: Reset all settings in the visual to default.

### Levels

1. Levels: Expand or collapse hierarchy levels based on level selection.

### Canvas Controls

1. Zoom: Zoom in and out the canvas view for better readability.
2. Mini Map: Provides an overview of the entire visual for easy navigation.
3. Expand All: Fully expands all hierarchy levels.
4. Fit: Automatically adjusts the visual to fit within the available space.

## Setting Up Performance Flow:

### 1. Add Visual

Click on the Performance Flow icon from the Visualizations pane to add visual to the canvas. Resize it to fit your needs.

<figure><img src="/files/otlBKdUopTffa6E1rjiq" alt="" width="563"><figcaption><p><em>Image 2: Click on the Performance Flow icon.</em></p></figcaption></figure>

### 2. Populate Data

The visual supports two kinds of hierarchical structures. Id & Parent Id Structure and Multiple Category Structure.

1. Hierarchy Field & Parent Field

   * Id & Parent Id Structure: Populate Hierarchy Field with Id column and Parent Field with Parent Id column.

   <figure><img src="/files/pSjRRrnIjcof7NK352PP" alt="" width="180"><figcaption><p><em>Image 3: Hierarchy Field &#x26;</em> <br><em>Parent Id Field</em></p></figcaption></figure>

   * Multiple Category Structure: Populate Hierarchy Field with at least two columns.

   <figure><img src="/files/XwWeD98D3W5yv02cvmo8" alt="" width="181"><figcaption><p><em>Image 4: Hierarchy Field</em></p></figcaption></figure>

2. Sparkline: Populate the Date or Time series column to show the trend.

<figure><img src="/files/4fDjogoRSNRh8rLYRXPC" alt="" width="180"><figcaption><p><em>Image 5: Sparkline Field</em></p></figcaption></figure>

3. Values: Populate Numeric column or DAX Measure to display KPIs.

<figure><img src="/files/JtE0qaZTAbLaKo8mj4qU" alt="" width="181"><figcaption><p><em>Image 6: Values Field</em></p></figcaption></figure>

4. Fields: Populate the multiple columns to for the additional details.

<figure><img src="/files/EeO1x5XWaMG5aLiUs1hC" alt="" width="181"><figcaption><p><em>Image 6: Fields Data Field</em></p></figcaption></figure>

5. Tooltip: Populate additional columns to display information on tooltip.

<figure><img src="/files/pcX2rhv7ohBNX20RwBBi" alt="" width="183"><figcaption><p><em>Image 7: Tooltip Field</em></p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xviz.com/performance-management/performance-flow-introduction/get-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
