Reference & Data Model
States and selection values
A state is a selection field with a fixed list of values. The values are technically English, German in the interface, and not every transition is allowed.
How states work
Section titled “How states work”A state describes where a record stands in its workflow. Technically it is a field with a fixed list of values (enum). In the interface you see a label or a selection with a German label. On every entity page this part names both: the technical value in code font and the label in quotation marks. Who sets the state varies: usually you via a selection, sometimes a workflow (approval), sometimes the system.
Other selection fields such as Type or Category work the same way but describe a classification rather than a workflow. They too are listed with their values on the entity pages.
Five examples
Section titled “Five examples”Phase (project_phase) on project and program (programs keep it as a free value):
| Technical | Label | Note |
|---|---|---|
initial |
„Initialisierung“ (Initialization) | Starting phase of every new project and program |
definition |
„Definition“ | |
planning |
„Planung“ (Planning) | last phase in which new planning objects are created |
execution |
„Umsetzung“ (Execution) | Project: reached only by applying an optimization result |
closing |
„Abschluss“ (Closing) |
You set the phase in the „Phase wählen“ (Choose phase) dialog. The rules for it are in Phase rules and Guides › Project lifecycle.
Project status (status) on the project; programs have no status:
| Technical | Label | Note |
|---|---|---|
active |
„Aktiv“ (Active) | Default for new projects; the phase can be changed |
paused |
„Pausiert“ (Paused) | The phase is frozen; planned bookings from today on are released |
succeeded |
„Erfolgreich abgeschlossen“ (Succeeded) | Final state; only from the phase „Umsetzung“ |
failed |
„Fehlgeschlagen“ (Failed) | Final state; from any phase |
You do not set the status in a selection but via the lifecycle actions „Pausieren“ (Pause), „Fortsetzen“ (Resume), „Abschließen“ (Close) and „Wieder öffnen“ (Reopen); „Wieder öffnen“ leads to „Pausiert“. See Project.
Issue state (state) on issue and task:
| Technical | Label |
|---|---|
backlog |
„Entwurf“ (Draft) |
todo |
„ToDo“ |
in_progress |
„In Bearbeitung“ (In progress) |
in_review |
„in Prüfung“ (In review) |
done |
„Erledigt“ (Done) |
cancelled |
„Fehlgeschlagen“ (Failed) |
duplicate |
„Duplikat“ (Duplicate) |
New issues and tasks start as „Entwurf“. Every value can be chosen freely. KPIs count only „Erledigt“ as completed. For issues, „Fehlgeschlagen“ and „Duplikat“ count neither as open nor as completed; for tasks, everything except „Erledigt“ counts as open.
Approval status (state) of a time log:
| Technical | Label | Set by |
|---|---|---|
pending |
„Offen“ (Open) | Default on creation |
approved |
„Genehmigt“ (Approved) | „Genehmigen“ (Approve) button in the approval view |
rejected |
„Abgelehnt“ (Rejected) | „Ablehnen“ (Reject) button |
On the first approval the system books personnel costs. „Genehmigt“ freezes the time log; „Auf Abgelehnt wechseln“ (Switch to rejected) or withdrawing the approval lifts the lock. See Time log.
Gate status (state) of a gate:
| Technical | Label |
|---|---|
open |
„Offen“ (Open) |
passed |
„Bestanden“ (Passed) |
failed |
„Verfehlt“ (Failed) |
A gate with „Verfehlt“ and the deal-breaker flag counts as a knockout in program and project KPIs. An open gate does not technically block the phase change. See Gate.
Complete list
Section titled “Complete list”All states and selection values of all entities with technical value and label are collected in States.