# Using apps

> What end users see and can do in an app: filters and URLs, personal settings (language, text size, theme), component and cell menus, cell inspection, read-only cells, comments and editing.

This page describes apps from the end user's side: how a view is selected and shared, what the menus offer, how a cell explains itself, and what happens when a value is entered. The configuration behind each behaviour is linked where relevant.

## The app frame

At the top of an app:

- the **filter row**, with the filters configured for the workspace in their configured order (see [Workspaces and components](components.html#filters));
- **Clear filters** (*Rensa filter*);
- a **workspace** selector;
- a **page** selector, when the workspace uses a multi-page layout;
- an information icon at the top right that opens the app's **description** (*Beskrivning*), usually written as instructions for users.

Actions are shown as vertical tabs along the right edge (see [Actions](actions.html)).

If a required filter has not been set, the affected components show the configured message, for example *"Select a department"*, instead of data.

### The URL carries the view

Filter selections, the workspace, the page or action and the data-type selection are all part of the URL:

```
/plans/{planId}/apps/{appId}/workspaces/{n}?Department=D100&DataTypes=12,Plan
```

Filters appear as query parameters in the form `?<DimensionId>=<code>`, and `DataTypes` lists the selected references by ID together with `Plan`. A view is therefore addressable: copy the URL to share exactly what you are looking at, including filters and data types.

## User settings

The gear icon at the top right opens **Settings** (*Inställningar*). These are personal settings for the signed-in user:

| Setting | Swedish label | Options |
|---|---|---|
| Language | *Språk* | English, Swedish (*Svenska*) |
| Text size | *Textstorlek* | Small (*Liten*), Medium, Large (*Stor*) |
| Theme | *Tema* | Dark mode (*Mörkt läge*), System, Light mode (*Ljust läge*) |

Changes take effect with **Apply** (*Verkställ*). **Logout** (*Logga ut*) is in the same panel.

- **Language** switches all system texts. Names defined in the model — dimensions, value types, apps, workspaces, actions — are shown as they were entered and are not translated.
- **Theme** *System* follows the operating system's light or dark setting. Colours in presentation rules and layouts have separate light and dark values, see [Presentation rules](components.html#presentation-rules).

Next to the gear icon, users with the right privileges see **Act as** (*Agera som*) for viewing the product as another role (see [Security](security.html)), plus notifications, admin tools and the help menu.

## Component menu

Every component has a menu that expands into a row of icon buttons:

| Button | Swedish label | Effect |
|---|---|---|
| Export | *Exportera* | exports the component's data |
| Edit | *Ändra* | the user's own column configuration; only when the component allows user configuration |
| Hide zeros | *Dölj nollor* | hides rows that contain only zeros |
| Reload | *Ladda om* | reloads the component's data |
| Full screen | *Fullskärm* | shows the component in full screen |

## Cell context menu

Right-clicking a table cell opens a context menu. The menu adapts to the cell: *Cut* is missing on read-only cells, and *Evaluate expression* only appears on expression cells.

| Entry | Swedish label | Effect |
|---|---|---|
| Cut, Copy, Paste | *Klipp ut*, *Kopiera*, *Klistra in* | clipboard operations |
| Copy with headers | *Kopiera med rubriker* | copies the selection including row and column headers |
| Copy with grouped headers | *Kopiera med grupperade rubriker* | also includes grouping headers |
| Expand/collapse selected rows | *Expandera/Kollapsa valda rader* | opens or closes groups |
| Auto-size selected columns | *Automatisk storlek på valda kolumner* | fits column widths to content |
| Use as filter | *Använd som filter* | intended to filter on the cell's dimension values, see below |
| Inspect cell | *Inspektera cell* | opens the Inspect panel |
| Write comment | *Skriv kommentar* | opens the comments panel for the cell |
| Evaluate expression | *Utvärdera uttryck* | shows an expression cell's formula and result |

!!! warning "Use as filter (known issue)"
    *Use as filter* is intended to set a filter on the combination of dimension values that forms the cell. It currently has no effect when used on a value cell, and only works when chosen on a dimension value. This is a known issue. The intended behaviour will be documented once it is fixed.

### Evaluate expression

**Evaluate expression** opens the **Evaluate** panel (*Utvärdera*), showing:

- the dimension and code of the expression;
- a link **Edit in app editor** (*Redigera i appeditor*) for administrators;
- the expression in a read-only editor, including the generated `// Context:` block (see [Datasets](datasets.html#kex-lite-and-the-generated-context));
- **Evaluations** (*Utvärderingar*): the actual result for this cell.

End users can thus see the formula behind a number, and its value for the selected cell, without administrator rights.

## Inspect panel

**Inspect cell** opens the side panel **Inspect** (*Inspektera*). It shows, for the selected cell, the configuration concepts that produced it.

### Cell information

| Field | Swedish label | Shows |
|---|---|---|
| Value | *Värde* | the unrounded value, full precision |
| Format | *Format* | the format code |
| Line access | *Linjeåtkomst* | Read or Read/Write (*Läs* / *Läs-Skriva*) |
| Line state | *Linjestatus* | Suggested, Edited, Calculated or Initial values |
| Reference | *Referens* | the data type: `Plan` or a reference |
| Aggregation | *Aggregering* | the value type's aggregation |
| Spread | *Fördelning* | the spread type |
| Display / edit precision | *Visa precision* / *Redigera precision* | decimals shown and decimals accepted |
| Dimension codes | *Dimensionskoder* | the cell's dimension values, each linking to the dimension value |

A placeholder created by [initial values](datasets.html#initial-values) shows line state *Initial values* until someone enters a value.

### Expression or value types

For a cell produced by a dataset expression, the panel shows the **expression**: code, the dimension it creates a value on, the expression text, name, aggregation, format and precision, and, if present, the **writeback expression** with its expression, destination code and spread code. A user can see from this where a typed value will be written.

For a stored cell, the panel shows the **value types** section instead.

### Presentation rules

The panel lists the presentation rules that **matched** the cell:

- the rule's name, with a link to the rule in the app editor;
- **why** it matched, for example *Access type: Read* or a scoped value type;
- the **targets** (*MÅL*) the rule applies to, in plain words, with the matching target highlighted;
- the resulting **CSS**, in one block for light mode and one for dark mode, for example `color: #595959; background-color: #eeeeee;`.

**Show all rows (n)** (*Visa alla rader*) expands the full list of candidate rules. Since later rules override earlier ones, this list explains why a cell looks the way it does. See [Presentation rules](components.html#presentation-rules).

## Why a cell is read-only

A cell that cannot be edited explains why. Hovering or right-clicking shows a tooltip with one of three reasons:

| Tooltip | Reason | What to do |
|---|---|---|
| *This value is read-only (Locked by Locked Values)* (*Låst av Locked Values*) | the cell is covered by the dataset's [locked values](datasets.html#locked-values) | ask the app administrator if the lock should change |
| *This value is read-only (Calculated value)* (*Beräknat värde*) | the value was written by a calculation | change the calculation's source data instead |
| *This value is read-only (The expression has no writeback)* (*Uttrycket saknar writeback*) | the cell comes from an expression without a [writeback](datasets.html#writeback) | enter the value on the underlying value type instead |

Read-only cells have a **grey** background, and cells open for input are **white**. The grey comes from the default presentation rule *Read-only* (*Skrivskyddat*), which matches cells with read access. Apps can restyle this.

Reference data is always read-only in apps.

## Comments

When a table allows comments, **Write comment** opens the **Comments** panel (*Kommentarer*) with the comment list, an input field and the checkbox **All comments** (*Alla kommentarer*).

A posted comment shows the author, the time and a **Cell** chip. Hovering the chip shows the full dimensional address the comment is bound to, for example:

> Department: D100 · Data type: Plan · Value type: Amount · Account: 4010 · Month: Mar 2026

A comment is bound to the **full dimension coordinate**, not to a position in the view. It stays with the data when the view is filtered, pivoted or regrouped. Cells with comments have a small marker in the corner.

Administrators can remove an app's comments with *Delete comments* (*Radera kommentarer*) in the app menu.

## Editing and spreading

Double-click an editable cell to enter a value.

- **Leaf cells** store the value directly on the value type.
- **Aggregated cells** (group rows, totals, pivoted periods above the stored level) spread the entered value to the cells below according to the value type's spread type: proportional, even, set value, or locked. See [Spreading](datasets.html#spreading).
- **Expression cells with writeback** convert the entered value with the writeback expression and write the result to the destination value type.

Dependent expression rows and all totals are recalculated in the view immediately. Calculations that read the changed value type run automatically in the plan; their results are available in the app once they have run. See [Calculations](calculations.html).

Edited cells get line state *Edited*. Display precision and edit precision are separate: a value type can accept more decimals on input than it shows.

### Saving

In v2 plans, an entered value is written to the plan directly, and dependent calculations run as with any other change. There is no separate apply or publish step. That step existed only in legacy (v1) plans.

### Undo

After an edit, **Undo** and **Redo** buttons (*Ångra* / *Gör om*) appear, and Cmd/Ctrl + Z works too. Undo is not in the context menu, and the undo history is lost when the page is reloaded. Each undo or redo is itself written as an edit, so an undone value ends with line state 10 (edited), not its original state.

## Keyboard shortcuts

The Help menu lists the shortcuts under *Kortkommandon*:

| Action | Swedish label | Mac | Windows |
|---|---|---|---|
| New | *Ny…* | Option + Cmd + N | Ctrl + Alt + N |
| Save | *Spara* | Option + Cmd + S | Ctrl + Alt + S |
| Select all rows | *Markera alla rader* | Option + Cmd + A | Ctrl + Alt + A |
| Leave cell | *Avsluta cell* | Esc | Esc |
| Export | *Exportera* | Option + Cmd + E | Ctrl + Alt + E |
| Import | *Importera* | Option + Cmd + I | Ctrl + Alt + I |
| Open the Konstrukt search field | *Öppna konstrukt sökfält* | Option + Cmd + F | Ctrl + Alt + F |
| Open column filter in the grid | *Öppna kolumnfilter i gridden* | Option + Cmd + U | Ctrl + Alt + U |

The Windows combinations follow from the client's shortcut definitions (Ctrl on Windows where Mac uses Cmd, Alt where Mac uses Option). They have not been tested on a Windows machine.

## Related

- [Datasets](datasets.html)
- [Workspaces and components](components.html)
- [Actions](actions.html)
- [Traceability](traceability.html)
- [Apps](apps.html)
