Creating dynamic dimensions and measures

Applies to: Kyvos Enterprise   Kyvos Cloud (Managed Services on AWS)     Kyvos Azure Marketplace

Kyvos AWS Marketplace   Kyvos Single Node Installation (Kyvos SNI)     Kyvos Free ( Limited offering for AWS)

Use parameters to create dynamic dimensions and measures. Parameters allow you to quickly change among chosen dimensions or measures using the filter pane.

You can use parameters with a worksheet or dashboard. When you share a worksheet or dashboard, the recipient can choose from the parameters you provide to visualize the data differently easily. 

When you use a parameter, a filter is automatically created. Then you can use the filter to visualize your data dynamically.

Each group of parameters is of the same type. If you want both dynamic dimensions and measures, create two different parameter groups.

From Kyvos 2023.3 onwards, you now have the option to create custom parameters in your workbook. By using these custom parameters in filters, highlight conditions, cohort filter conditions, and calculated measures, users can make conditions dynamic.

Creating a list of parameters 

To create a list of parameters of the same type, perform the following steps: 

1. From the Toolbox, select  Workbooks , then select a workbook.
2. Click the Actions menu (...) to the upper right of the pane and click Parameters.
   
3. Enter a Name and optional Description for the parameter.
4. Use the Caption field to provide a display name for the parameter. While browsing the worksheet, this caption is shown instead of the parameter name on the shelf and filter card .
5. Choose whether it's a Dimension or a Measure
6. Click Add from Semantic model fields and specify the semantic model if needed.
7. Navigate to and select a level or attribute value or use Search to quickly find it
8. Use the Display As an option to provide a custom value for showing on the visualization.
   For example, you can choose the value CustomerName and set the Display as value to Customer Name.
9. Click the Is Default checkbox to choose the default value. This is the value first shown in the workbook or dashboard.
10. Click Add from Semantic model fields again to provide additional values of the same type.
11. You can rearrange the order of the values by dragging a value name in the list to a new position using the control next to the checkboxes. 
12. Click the Plus button to add more values and the Minus button to remove a value. 
13. Click Apply. 
    

Adding a group of parameters

To add another group of parameters, perform the following steps: 

1. From the Toolbox, select  Workbooks , then select a workbook.
2. Click the Actions menu (...) to the upper right of the pane and choose Parameters.
3. Click the Plus button at the top of the Parameters list
4. Enter a name and optional description for the parameter.
5. Select whether it's a dimension or measure.
6. Click Add from Semantic model fields and add values.
7. Click Apply.

Editing list of parameters

To edit a list of parameters, perform the following steps: 

1. From the Toolbox, select  Workbooks , then select a workbook.
2. Click the Actions menu (...) to the upper right of the pane and click Parameters.
3. Select the parameter group to edit. 
4. Make changes.
5. Click Apply.

Adding and using parameters in the worksheet

To add and use parameters in the worksheet, perform the following steps: 

1. The parameters are displayed in the Dimension and the Measures panels in the design view.
   Drag them to the X or Y axis as you create worksheets.
2. In the Filter pane, you'll see the parameter name.
3. Select from the values you created earlier to see different data quickly.

Using parameters in the dashboard

To use parameters in the dashboard, perform the following steps: 

1. Add a filter card to the dashboard.
2. Select a parameter list name in the field column.
3. Select values from the values in the parameter list you created.

Custom parameters

From Kyvos 2023.3 onwards, you now have the option to create custom parameters in your workbook. These parameters can be of the number, character, or date type and can be applied across all worksheets and dashboards within the workbook. By utilizing these custom parameters in filters, highlight conditions, cohort filter conditions, and calculated measures, users can make conditions dynamic. These parameters act as placeholders for values and can be modified by the user in the parameter section of the filter card on the sheet or dashboard.

For example, if you have set a condition as 'Country is in top 10 by Sum Sales,' you can use parameters to replace ‘Country’ and ‘Sum Sales’ making it dynamic by changing field from the filter card. Previously, there was no way to make the value '10' dynamic. With custom parameters, you can now dynamically modify the numerical value '10' since custom parameters support number, character, and date type parameters within workbooks. 

To create a custom parameter, perform the following steps.

1. From the Toolbox, select  Workbooks , then select a workbook.
2. Click the Actions menu (...) to the upper right of the pane and click Parameters.
   
3. Enter a Name and optional Description for the parameter.
4. Use the Display as field to provide a display name for the parameter. While browsing the worksheet, this display name is shown instead of the parameter name on the shelf and filter card .
5. Select the type as Custom that will be used as a placeholder for character, number, or date type of values.  
6. Select data types as Character, Number or Date.
7. Select the input control type from the Show as list which will be available to change this parameter value. 
   1. For character, select one of the following: 
      • Text Input: Use this option to display text type input box. 
      • Single Select List: Use this option to display list of text values in which one value can be selected at a time. 
      • Multi Select List: Use this option to display list of text values in which multiple values can be selected at a time.  
   2. For number, select one of the following: 
      • Number Input: Use this option to display number type input box. 
      • Single Select List: Use this option to display list of number values in which one value can be selected at a time. 
      • Multi Select List: Use this option to display list of number values in which multiple values can be selected at a time.  
      • Range Selector: Use this option to display range slider to set a valid number which will respect its range and step size.  
        • Type minimum and maximum value for the range parameter. The step size and default parameter value are automatically calculated and displayed in their respective fields. You can also modify these default values as needed. 
          NOTE: The intervals for that range must not be more than 1000. 
   3. For date, select one of the following: 
      • Date Input: Use this option to display date type input box. 
      • Single Select List: Use this option to display list of date values in which one value can be selected at a time. 
      • Multi Select List: Use this option to display list of number values in which multiple values can be selected at a time. 
8. Specify blank value if you want to add it to display in the worksheet. 
   NOTE: For a parameter, providing a default value is mandatory.
9. For a parameter with single select list or multi select list, do the following:  
   1. Specify the custom value and use the Display As an option to provide a custom value for showing on the visualization.
      For example, you can set the custom value as CustomerName and set the Display as value to Customer Name.
   2. Click the Is Default checkbox to choose the default value. This is the value first shown in the workbook or dashboard.
   3. Optionally, if you want to include a blank value, then select Include Blank Value checkbox to include a blank value with the list of values.
   4. For a parameter with single select list or multi select list, if you want to provide multiple values at once instead of entering them separately, then click the Bulk List Generator link.
       
      1. Click Generate. The list is populated automatically under the 'list of values' section. You can click the Plus button to add more values and the Minus button to remove a value. 
10. Click Apply. The custom parameter is created. 

Using custom parameters in the worksheet or dashboard

Using custom parameters for the cohort filter

Using custom parameters in highlighting conditions 

Using a custom parameter value in the calculated measure expression and use it in the worksheet

To do this, you must first open the Calculated Measures dialog box, and specify the expression that contains a custom parameter.

Following is the sample expression: 

[Measure].[sales] * <%= Parameter 1&>

Filtering custom parameters 

After creating calculated measure, drag the calculated measure into the View type section and drop it. In the Parameters section, you can view and change the custom parameter value anytime as needed in the worksheet. 

After defining a calculated expression using dynamic values, it will allow you to change the parameter value dynamically in the worksheet without opening the calculated measures dialog box.

Adding a Dynamic Measure Title