# Ärenden, mappar, statusar och taggar i Todomator

> Todomators datamodell: vad ett ärende innehåller, de sex statusarna, vem som kan se ett ärende, mappar för kunder och projekt, taggar, kommentarer, länkar och bilagor.

Framework: todomator
Product: Todomator (todomator@1.7)
Language: sv
Content-SHA256: 5a044866124f8f7effbb4e15d8db5f90033a0bef8bc2ab8ed80d949f3f7f30f4
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: 
Review: not-recorded

Todomators centrum är **ärendet** (tabellen `tbl_ticket`, schemat `Tickets` i `schemas/tickets.js`). Allt annat organiserar ärenden eller hänger på dem.

## Vad ett ärende innehåller

| Fält | Betydelse |
|---|---|
| `name` | titeln (obligatorisk) |
| `statusid` | statusen; ett nytt ärende är `pending` om du inte säger något annat |
| `folderid` | mappen (kund eller projekt) som det tillhör |
| `ownerid`, `userid`, `watcherid` | författaren, de tilldelade och de som bara följer det |
| `ispublic` | synligt för alla; ett publikt ärende har inga tilldelade |
| `ispriority`, `isbillable` | en prioritetsmarkering och en fakturerbar-flagga |
| `markdown`, `html` | innehållet (gränssnittet använder Markdown) |
| `tags` | en lista med taggar |
| `date`, `deadline` | ärendets dag (i dag som standard) och en valfri deadline |
| `estimate`, `worked` | uppskattningen och de redan arbetade minuterna ([tidrapportering](/en/todomator/time-tracking/)) |
| `reference`, `source` | fri text för att koppla ärendet till något utanför |
| `parentid` | det överordnade ärendet, för deluppgifter |
| `attachments` | ärendets filer |
| `attrs` | fria JSON-data |
| `callback` | en adress som får ärendet när det ändras ([API:et](/en/todomator/create-tickets-with-the-api/)) |

## De sex statusarna

Tabellen `cl_status` skapas med: `pending` (Pending), `open` (In progress), `review` (Review), `postponed` (Postponed), `note` (Note) och `closed` (Closed). Namnen översätts till användarens språk.

## Vem som kan se ett ärende

Ett ärende syns för sin ägare, för personerna i `userid`, för personerna i `watcherid` och för alla när `ispublic` är satt. Listan över mappar som en användare ser begränsas på samma sätt: en mapp visas bara om användaren kan se ett ärende i den (användare med `sa` ser alla). Ärendelistan tar `type` (till exempel `pending`, `postponed`, `review`, `assigned`, `note`, `unread` eller `all`), `q` (sökning), `folderid`, `date`, `skip` och `limit` (10 som standard).

## Mappar och taggar

En **mapp** har ett namn, en ikon, en färg, en kund, en e-postadress och ett telefonnummer samt flaggor: `isbillable` (nya ärenden ärver den), `isprivate`, `ispinned`, `isarchived` och `isdisabled`. Bara personer med behörigheten `admin` (eller administratörer) hanterar mappar. En **tagg** har ett namn, en färg och en ikon och kan tillhöra en mapp.

## Runt ärendet

- **Kommentarer** (`Comments|create`, `Comments|update`, `Comments|remove`): Markdown-text som hör till ett ärende.
- **Oläst-markeringar och bokmärken**: varje användare har sitt eget oläst-tillstånd och sina bokmärken för ett ärende.
- **Länkar** mellan ärenden och **kloning** av ett ärende.
- **Historik och loggar** över ett ärendes ändringar.
- **Bilagor**: `POST /upload/` tar upp till 5 MB per begäran. En fils adress är signerad (`/download/<id>-<signature>.<ext>`): bilder, video och PDF öppnas i webbläsaren och de andra typerna laddas ner.
- **Liveuppdateringar**: WebSocketen skickar en `refresh`-händelse bara till de personer som kan se ärendet, och talar om för de andra vem som tittar på ett ärende just nu.
