# Global Settings

The Settings tab allows you to configure global-level settings for the visual.

To access the Settings menu, go to the **Model** Tab and then click **Settings** on the toolbar at the top.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FwnUuFOSGWvC9pbKjyNw4%2Fimage.png?alt=media&#x26;token=d92b9b68-d7d3-492e-a6d2-ca21069c5263" alt=""><figcaption><p><strong>Click 'Settings'</strong></p></figcaption></figure>

Settings are categorized as General and Display, within which many sections are available. You can also use the search box to jump to the required sub-menu directly.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2F9Wy6sjigtoUk4j6JIkph%2Fimage.png?alt=media&#x26;token=42edb710-3b08-454d-86df-25e60f5cab7d" alt=""><figcaption><p><strong>Settings window</strong></p></figcaption></figure>

## 1. General

### 1.1. About Model

#### **Model Name**

The name of the model can be changed here. This will appear at the bottom right corner of the screen in all the tabs.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FZrZGJpFGCwGdWlAO9F5U%2Fimage.png?alt=media&#x26;token=4e0becfc-a22f-4d0e-bdc9-d77f85de2fe8" alt=""><figcaption><p><strong>Model Name</strong></p></figcaption></figure>

#### **Enable Model tab in Reading view**

By default, the model tab is available only in the editing view in the Power BI service. Toggle this button to use the model tab in the reading view.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FIvHalmI0iY5W27hDyD2h%2Fimage.png?alt=media&#x26;token=f5c14fe1-ab03-4747-bbdb-4f568698f502" alt=""><figcaption><p><strong>Enable Model Tab in Reading View</strong></p></figcaption></figure>

A sample ValQ model looks as shown below before enabling this option.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FW2iLCiwRI2tM37CZhHv4%2Fimage.png?alt=media&#x26;token=ed39ae5d-c22c-4233-a0fc-3b78e231b4b7" alt=""><figcaption><p><strong>Before enabling model tab in the reading view</strong></p></figcaption></figure>

After toggling on this button, the report now has the model tab in read mode.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2Fcc0x5ER2lsHLLy5WJmPp%2Fimage.png?alt=media&#x26;token=c6ba40a0-10e1-4c69-9f18-3881c3659b57" alt=""><figcaption><p><strong>After enabling model tab in the reading view</strong></p></figcaption></figure>

#### **Simulation Settings**

To create multiple initiatives within your simulations, you can enable this toggle button.&#x20;

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FEn2Y7JOjYh1u5ugE6SVI%2F2023-12-22_18h26_13.png?alt=media&#x26;token=4c815f65-9153-4fee-9ba5-c7be723b4fa9" alt=""><figcaption><p><strong>Enable Initiatives</strong></p></figcaption></figure>

By default, this feature is disabled. To know more about initiatives refer to [this section.](https://docs.valq.com/simulate/create-initiatives-in-a-scenario)

#### **Model Settings**

Enabling this button allows different node configurations for open and closed periods. To know more about hybrid period configuration, you can refer [here](https://docs.valq.com/node-settings#hybrid-configuration).

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2Fij9mnijbxVnvEeXADPYt%2Fimage.png?alt=media&#x26;token=c442a86d-202c-4bb9-b190-2327289ac1bb" alt="" width="563"><figcaption><p><strong>Enable Open Period Formula</strong></p></figcaption></figure>

### 1.2. Data Settings

The Data Settings menu helps in transforming the data that is added to the visual in the desired manner before you can start building the model.

#### Split Series by Fiscal Year

You can break down the data series added to the visual, into multiple series using the **Split Series** option.

{% hint style="info" %}
**Note:**

1. The **Split Series** option gets enabled only when the visual is mapped with the data series containing data from **multiple years.**
2. Suppose the time period data you have assigned is not in a hierarchy and has custom time formats like 2023Q1, 23, Jan, 07, etc., you'll need to verify whether the **Time Interval Mapping** is automatically done by ValQ. Otherwise, you'll need to [map it manually](#1.3.-time-interval-mapping) for the visual to identify and map the time periods accordingly before using the **Split Series** option.
   {% endhint %}

A single data series can be split into multiple series where you can define the starting and ending periods for the fiscal year like April to March, Q1 to Q4, and so on. Based on the starting period you assign, ValQ automatically configures the ending period.

In the below example, the visual has a data series assigned, that contain 6 years of data from 2017 to 2022.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2F7gnccdlIyRYOBUISo1P4%2Fimage.png?alt=media&#x26;token=12ec286f-7e66-4fb9-be62-82265509dd12" alt=""><figcaption><p><strong>Before Split Series</strong></p></figcaption></figure>

By clicking the **Split Series** option, a pop-up appears on the screen where you can define the start period of the fiscal year. Since April is chosen as the starting period, ValQ automatically fills the end period as March.

As shown in the below example, the source series is split into six separate data series for each fiscal year from April 2016 to March 2022.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2Fm1k6xMWkk6c8jNbmY5yv%2Fsplit%20series.gif?alt=media&#x26;token=0bfe4595-0f68-48d1-910e-5194b837b38a" alt=""><figcaption><p><strong>After Split Series by year</strong></p></figcaption></figure>

Let us now explore the different columns available here.

**Source:** This refers to the initial data series assigned in the **Values** field before splitting the series.

**Name:** This refers to the multiple series names. They can be renamed by the user in the Split Series pop-up window. By default, the series name starts with the end year followed by the name of the source data series.

**Type:** This column contains details about the source of the data series. 'Native' type refers to the native Power BI series assigned to the visual, while 'Plan' refers to the plan series created by the user.

**\*Forecast Start:** This feature used in the hybrid formula is still under development.

**Previous Series:** The available data series are mapped to their respective previous series (series that comes before logically) by ValQ automatically. Users are allowed to change the previous series if required.

**Excluded Series:** In this column, you can choose to exclude any of the data series that are not required. The last two recent data series cannot be excluded as they become the default baseline and comparison series.&#x20;

{% hint style="info" %}
The excluded series, though excluded in the Plan, Simulate and Report tabs, would still be available for calculations and formula reference.&#x20;
{% endhint %}

After splitting the series, you can compare and simulate any two series as baseline and comparison.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2Fs6LjdljgYoshtgkPG9hA%2Fimage.png?alt=media&#x26;token=47021928-d259-4130-bd72-780cf98d553b" alt=""><figcaption><p><strong>Available Data Series</strong></p></figcaption></figure>

### 1.3. Time Interval Mapping

If the time periods are assigned as individual fields instead of using a time hierarchy, ValQ automatically maps them to the model using the custom formats as shown in the below image.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FFj22YQi0JvVeuA6RXhSk%2Fimage.png?alt=media&#x26;token=671dba75-3221-46d1-8310-6817f5c81db3" alt=""><figcaption><p><strong>Time Interval Mapping</strong></p></figcaption></figure>

In some cases, when mapping is not done automatically you can map the time periods manually as per the time format.&#x20;

In the below example, 'Year' is not mapped.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FRVC02ieyMNyrkPVox1yu%2Fimage.png?alt=media&#x26;token=75f91d08-275d-468e-8d5c-beb75234a937" alt=""><figcaption><p><strong>Time period not mapped</strong></p></figcaption></figure>

Let us see how to map the time periods manually in such cases.

Three columns are listed - Time Period, Type and Format.

**Time Period:** ValQ pre-fills all three time periods in this field (Year, Quarter and Month) based on the data you assigned in the **Time Period** field.&#x20;

**Type:** Depending on the nature of the data select the appropriate time period from the dropdown list like Year, Quarter, Month or Day.

**Format:** Finally, under the **Format** column, key in the pattern, the way the values are available in your data. Type **\[**  or hover over the help icon <img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FclVjdOPQ71oG0xzdVuZE%2Fimage.png?alt=media&#x26;token=f4dcbb7b-4da8-46c2-b292-9204e4776cdb" alt="" data-size="line">to open the list of suggested formats.

E.g. If the time period is of the form 2022 Q2, enter \[YYYY] in the Year field and Q\[Q] in the Quarter field to map it.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FxmN4zTm7jaWEsDewPlZX%2FAll%20Custom%20Formats.png?alt=media&#x26;token=c36e5361-f868-47bd-920c-525c20240fec" alt=""><figcaption><p><strong>Available Custom Time Formats</strong></p></figcaption></figure>

When the green tick is shown verifying that the entered format matches with the available time label, click **Apply Changes**. This ensures that the visual accepts the data in the appropriate time format.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FU8sJ5WTwazEhR6YR40C2%2Ftim_2.png?alt=media&#x26;token=b3011942-5193-4838-9815-fde00bdfea37" alt=""><figcaption><p><strong>Format matched</strong></p></figcaption></figure>

### 1.4. Data Window Size

Using the **Data Window** section, you can load additional columns or periods from the data source into the model. The **Max Columns** is set as 15 by default and can extend up to 60 based on the data you assign, beyond which the visual would display a warning, 'Too many 'Month' values'.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FTQxguh1ZeOBJIO8Ah0u2%2Fimage.png?alt=media&#x26;token=359bffe0-8468-46e6-ae00-233a626a5bf5" alt=""><figcaption><p><strong>Max Columns Reached</strong></p></figcaption></figure>

At this point, go to **Settings->Data Window Size** where you can increase the Max Columns to the required number up to 1000.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2Fw1heTUQaCfVcCEwAgflo%2Fimage.png?alt=media&#x26;token=634b64c5-2550-41f6-9595-bd53696f6ce0" alt=""><figcaption><p><strong>Increase Data Window Size</strong></p></figcaption></figure>

## 2. Display

All the display-related settings are available here.

### 2.1. Nodes

The Nodes menu has a bunch of checkbox options with regard to how the nodes should work. They are explained below.

**Conditional Formatting:** Check this option to apply conditional formatting to the nodes on the Simulate tab based on the node's **simulation impact** instead of variance.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FSretw6p1JZnS9B1WwtfZ%2Fimage.png?alt=media&#x26;token=9d8abd4c-88ae-43f5-8949-34a952bb6858" alt=""><figcaption><p><strong>Conditional Formatting &#x26; Advanced Options</strong></p></figcaption></figure>

**Advanced:** Here, using the first option you can specify the model to use manual values for the nodes whose data source value is empty. The other option is used to disable the editing of nodes in the Plan tab whose **Simulation Method** is set to *None*.

**Node Customization**

Two node presets are available to customize the layout style of the nodes. Preset 1 is the default style.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FpFOq9VIUS0hRpXpSY6h3%2Fimage.png?alt=media&#x26;token=e64edb9f-775b-404f-adff-260c6479fc46" alt=""><figcaption><p><strong>Node Customization</strong></p></figcaption></figure>

### 2.2. Number Formatting

The Number Formatting menu has options to change the suffix of scaling and formatting the display settings of numbers.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FySloyhdXNsHDQSnda3QO%2Fimage.png?alt=media&#x26;token=2563ad30-d808-4c48-9e5a-ed9adbc3be2e" alt=""><figcaption><p><strong>Number Formatting</strong></p></figcaption></figure>

### 2.3. Period Measure

With the Period Measure menu, the labels of time period measures such as Till Period, All Periods and Simulation Period can be renamed.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FAO4V2krAanOePxQtIECz%2Fimage.png?alt=media&#x26;token=b38dd736-e75e-4d36-8ec5-072bb7a8b8e3" alt=""><figcaption><p><strong>Period Measure</strong></p></figcaption></figure>

{% hint style="info" %}
Till Period refers to all the periods leading up to the starting simulation period. The **Exclude Active Period** checkbox can be used to exclude the starting simulation period in the Till Period.
{% endhint %}

### 2.4. Level Name Configuration

The levels are named by the visual based on the categories assigned in the Visualizations pane. Double-click on the text to rename any level except Level 1 which would always be the name of the root node.&#x20;

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FLTpQMKjxbVpRf2gfG8r4%2Fimage.png?alt=media&#x26;token=6e855f7b-5cf3-4218-87fc-860616476395" alt=""><figcaption><p><strong>Level Name Configuration</strong></p></figcaption></figure>

### 2.5. Theme

The Theme menu has options to change the font style, chart theme and logo to be displayed along with the model's name. The ValQ logo is available in the visual as the default logo which can be replaced by any 500\*500px jpeg or png file.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FprbLyHJ8CZcxTzCDkFc6%2Fimage.png?alt=media&#x26;token=775033e3-cd6c-4d50-94ad-0cfb1e892c98" alt=""><figcaption><p><strong>Theme</strong></p></figcaption></figure>

## 3. Export

Export is provided to get the encoded text of the entire visual, which can then be used to import the model into a new visual.&#x20;

To export the model, click the **Export** button at the bottom left corner of the Settings window. A pop-up window with encoded text is displayed which can be downloaded by clicking the **Download** button.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FJqs9QCg60vguwM0M5fej%2Fimage.png?alt=media&#x26;token=2c74ebdc-691c-4c7f-9cd3-a709180a141c" alt=""><figcaption><p><strong>Export Model</strong></p></figcaption></figure>

The text file gets the model saved in your local system. This exported file can be shared and used to create a new model. The steps to create a new model with the exported text can be found [here](https://docs.valq.com/model/create-model/import-a-model).

## 4. Delete

The current model can be deleted using the **Delete** button in the Settings tab. To permanently delete the model, click **Yes** in the **Delete Model** confirmation pop-up.

<figure><img src="https://261229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmXNCTvPRjJZj6UunHBgb%2Fuploads%2FagtzI29EEpTYGNWSOvXL%2Fimage.png?alt=media&#x26;token=8b4b5af0-2c81-469e-90bb-ee1fd863919d" alt=""><figcaption><p><strong>Delete Model</strong></p></figcaption></figure>
