---
title: "Diagram Tile Refresh on Selection Bus"
slug: "diagram-tile-refresh-on-selection-bus"
description: "This document shows users how to configure Diagram Tiles to refresh on Selection Bus. This allows the Diagram Tile to change based upon which item is selected in a Report. "
updated: 2024-10-29T20:36:14Z
published: 2024-10-29T20:36:14Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Diagram Tile Refresh on Selection Bus

## Overview

**Diagram Tiles** are a way to capture data and present it in an attractive manner using infographics. Charts, Shapes, Steps, Labels, and more options are available to customize **Diagram Tiles** to display data in a relevant manner. Configuring **Diagram Tiles** to refresh on Selection Bus allows the **Diagram Tile** to change when selecting different items in a report.

For more information on Diagram Tiles, please navigate to [Diagram Tiles](https://documentation.decisions.com/docs/diagram-tiles).

## Example

This tutorial will create a **Page** that houses a **Report** and **Diagram Tile**. The **Diagram Tile** will show the Decisions objects owned by the **Account** selected on the **Report**.

1. To begin, navigate to a Designer Folder and select CREATE REPORT from the Global Action Bar.
2. In the **Create Report** window, select and name the default Report [**Account Report**]. Click CREATE.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h25_32.png)
3. In the Report Designer, under **Data Sources** add**Common > Account Data Source**.
4. In the **Data Fields** column add **First Name**, **Email Address**, **Created On Date**, and **Can Use Portal**.
5. Select the **Email Address Data Field**. In the **Properties**panel > **SETTINGS,** navigate to the **Send Data As Filter Change Source**boolean to and change it to **True.**
  1. Notice the new text box labeled **Filter Change Source Name, i**nput "**Email**" in the text box.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h27_28.png)
6. Save and Close the Report Designer.
7. In the Designer Folder, navigate to **All > Manage > Page/Dashboard > Add Page/Dashboard** from the Global Action Bar.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h29_46.png)
8. In the resulting **Add Page/Dashboard** window, click PICK PAGE.
9. In the**Create or Pick Page**window, select CREATE to create a new Page.
10. In the next **Create or Pick Page > Create New** window, select and name the default Page [**Diagram Tile Refresh**]. Click CREATE to enter the Page Designer.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-21_09h08_07.png)
11. In the Page Designer, navigate to the **Toolbox > FAVORITES** section and drag and drop a **Report Viewer** component to the workspace.
12. In the Properties panel of the **Report Viewer**component, navigate to REPORT SETUP and select PICK DEFAULT REPORT.
13. In the resulting **Create or Pick Report**window, select PICK to pick an existing Report. Navigate to the Report [**Accounts Report**] made in this tutorial.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h31_28.png)
14. Next, navigate to the **Toolbox > TILES** section and drag and drop a**Diagram Tile** component to the workspace.
15. In the **Properties**pane**l > DIAGRAM TILE**, select PICK DIAGRAM TILE FLOW. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h32_37.png)
16. In the resulting **Create or Pick Flow** window, select CREATE.
17. Then, in the **Create or Pick Flow > Create New**window, select and name the **Diagram Tile** Flow [**Selection Bus Refresh**]. Click CREATE to open the Flow Designer.
18. In the Flow Designer, navigate to the**Toolbox > ANNOTATION** section and drag an **Image, Label - Small,**and **Label - Medium** component to the workspace.
19. Arrange the components so that the**Label - Small**is above the **Image** component and the **Label - Medium** component is within the **Image**.
20. In the **Properties**panel of the **Label - Small** component, navigate to **CONFIGURATION DEFAULTS > Text** and input "**Number of Owned Entities"** in the value field.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h36_30.png)
21. In the **Properties**panel of the **Label - Medium** component, navigate to CONFIGURATION RULES and check the**Label From Data** boolean. This will cause the **PROPERTIES > INPUTS** section to appear.
22. In the**INPUTS > Text**value field, change the input mapping to**Select From Flow** and click **ADD INPUT**. Input **"Number of Owned Entities**" and click ADD.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h38_20.png)
23. **Save**and **Close**the Flow Designer.
24. In the Page Designer, with the **Diagram Tile** component selected, navigate to the**Properties panel > DIAGRAM TILE** section and click EDIT INPUT FLOW NAME.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h39_36.png)
25. In the Flow Designer, navigate to the**Toolbox > DASHBOARDS**section and drag and drop a **Get Page Variable** step to the workspace.
26. With the**Get Page Variable**step selected, navigate to the **Properties** panel**> PAGE CONTEXT > Data Type**, select **PageVariable**from the drop down list.
  1. In the **PAGE CONTEXT > Variable Name** value field, input **Email**.
  2. From the **PAGE CONTEXT > Expected Type** drop down list, select **String [Text]**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h40_55.png)
27. From the**Toolbox > FAVORITE STEPS**section, drag a **Fetch Entities** step to the workspace and connect it to the **Done**outcome of the **Get Page Variable** step.
28. In the **Properties**panel of the **Fetch Entities** step, navigate to **ENTITY FETCH DEFINITION > Type Name**and search for and select **Element Registration** from the drop down list.
29. Next, navigate to **ENTITY FETCH DEFINITION > Fetch Criteria** and click ADD.
30. In the**Add Fetch Criteria** window, select **ownerEmail** from the**Field Name** drop down list and leave the **Query Match Type** as**Equals**. Click OK to close.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h42_40.png)
31. From the **Toolbox > FAVORITE STEPS**section, drag and connect a **Create Data**step to the **Results** outcome of the **Fetch Entities** step.
32. With the **Create Data** step selected, navigate to the **Properties** panel **> DATA > Data to Create**selector and click SHOW EDITOR.
33. In the**Data Definitions**window, **Name**the**Data to Create** "**Count**" with a **String [Text**] **Type**.
34. For the **Input**, select**EntityResults**, then drill down to **Count**. CLOSE the window.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h45_16.png)
35. From the **Toolbox > FAVORITE STEPS** section, add another**Create Data** step to the workspace and connect it to the**No Results** outcome of the**Fetch Entities** step.
36. With the second**Create Data**step selected, navigate to the **Properties** panel **> DATA > Data to Create** selector and click SHOW EDITOR.
37. In the **Data Definitions** window, input **Count**as the **Name** and the**Type** is **String [Text****]**, with an **Input**of **0**. CLOSE the window.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h47_19.png)
38. Connect both **Create Data** steps to the **End**step.
39. With the **End**step selected, navigate to the **Properties** panel **> INPUTS > Number of Owned Entities** value field and change the input mapping to **Select From Flow** and select **Count**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h50_01.png)
40. **Save**and **Close**the Flow and Page Designers.
41. In the **Add Page/Dashboard**window, click SAVE.
42. In the Designer Folder, notice the appearance of the new **Page**[**Diagram Tile Refresh**] above the Global Action Bar.
43. After selecting the **Page [Diagram Tile Refresh]**, notice the number within the**Diagram Tile** changes when different accounts****are selected within the Report.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_14h51_55.png)