# Editing within an App

{% hint style="info" %}
Our visualisations are always built through the Home or the Stories.

Whenever you create or edit one of these Layouts, you'll always have the same editing experience.
{% endhint %}

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-04325a10335654e2cb1718174f55e9d73f42310a%2Fnew-editor.png?alt=media" alt=""><figcaption><p>Edition experience</p></figcaption></figure>

It's composed on 3 main parts:

### Layout part

This is the main space in your edition. You can see the framework of your Layout, each element is composed of and configure them, in-situ like **Narratives** or that opens the configuration tab like for **Charts**.

For more information, dive in:

* [The Home](https://docs-v3.toucantoco.com/visualizations-and-layouts/apps/home)
* [Stories](https://docs-v3.toucantoco.com/visualizations-and-layouts/apps/stories)
* [Filters](https://docs-v3.toucantoco.com/visualizations-and-layouts/apps/filters)

### Configuration part

This is the left sidebar. It includes 2 tabs:

* **Datasets:** In which you can select datasets that you will use for this layout.
* **Configuration:** In which you can configure your charts, filters and KPI

#### **Focus on Visualisations' configuration**

Let's focus on the configuration of Charts, Tiles and HKPIs.

They are the heart of your data storytelling and are represented by:

* **Dimensions** *(observation axes of indicators):* In Toucan, dimensions are often filled in "label", "x axis" but also "groups", "packs", etc...
* **Measures** *(numerical attributes):* In Toucan, measures are often filled in "value", "y axis" but also "variation", "additional values", etc...

And, most of the time, you don't want to just describe your datasets (or then do a [Tablechart](https://docs-v3.toucantoco.com/visualizations-and-layouts/creating-visualizations/viz-gallery/new-viz-designs/tablechart)) but you want to give a meaning to your data by aggregating or compute statistics over your data.

And that's what we introduce in our experience, the possibility to simply aggregate data when you configure your visualisation, in order to keep relatively high-level that can serves several questions, several stories.

Aggregations that you can apply to create a metric depends on the type of you data's column.

**For integer and float**

* **sum**: returns the addition of the values in the column
* **average:** returns the addition of the values in the column and divided by the number of rows
* **minimum:** returns the smallest value in the column
* **maximum:** returns the highest value in the column
* **first:** returns the first value in the column (based on the order of rows)
* **last:** returns the last value in the column (based on the order of rows)
* **count:** returns the number of rows
* **count distinct:** returns the number of times we have a unique value in a column

**For the other types**

* count
* count distinct

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-f4863d39e4452ac5ad0c37b8749dc1a9b795df1b%2Fzoom-agg.png?alt=media" alt=""><figcaption><p>Zoom on main dimension and measure</p></figcaption></figure>

These measures are computed by aggregating the column chosen within the value field grouped by the column chosen within the label field

{% hint style="info" %}
**Info**

If you're configuring other options that are considered as dimensions (groups, packs, etc...), those columns will be also used to aggregate your values.
{% endhint %}

### Toolbar part

Finally, the toolbar will allow you to manage your edition. It's composed of, from left to right:

* **Clear changes**: Resets your entire layout to last saved version. Useful when you perform changes on a Layout and don't want to save.
* **"Saved as draft":** Layouts are saved at each changes, so even when you close your tab, you will retrieve all your work! On hover, you can see when was the last time we save your changes in the draft.
* **Finish Later:** Allows you to leave edition without pushing your changes for other App Builders. When you'll be back on the edition of this Layout, your last changes will still be there.
* **Save changes:** Saves you work and share this for all App Builders in the staging version.

{% hint style="info" %}
**Information**

In order to share your app to all your end-users, you need to **publish in production**. More information [here](https://docs-v3.toucantoco.com/visualizations-and-layouts/apps/managing-apps/publishing-apps).
{% endhint %}


---

# 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-v3.toucantoco.com/visualizations-and-layouts/apps/managing-apps/editing-within-an-app.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.
