Reference & Data Model
Key takeaway (key_takeaway)
A key takeaway is a recorded lesson with category and type that becomes visible upwards from the project level.
Purpose
Section titled “Purpose”Key takeaways („Takeaways“, lessons learned) collect what a project, program or portfolio has learned. They are organized via two selection lists: category and, below it, type. Key takeaways flow upwards: the program sees those of its projects, the portfolio those of its programs and direct projects. (Data type: knowledge data, manual)
Where in the app
Section titled “Where in the app”- Project › „Projekt-Insights“ › „Erkenntnisse“ (Key takeaways); Program › „Programm-Insights“ › „Erkenntnisse“; Portfolio › „Portfolio-Insights“ › „Erkenntnisse“ – Guides › Project insights, Guides › Program insights, Guides › Portfolio insights
- Create: „Erkenntnis hinzufügen“. Open: double-click or „Details“ leads to its own page /takeaways/‹id› with title, category, type, date, files and context (directly editable there).
- Columns: „Titel“, „Erstellt am“, „Kontext“, „Kategorie“, „Typ“ (program/portfolio additionally „Ursprung“ and carrier object).
Fields
Section titled “Fields”| Field | Technical | Type | Required | Meaning | Notes |
|---|---|---|---|---|---|
| Title | title |
Text | yes | Short version of the takeaway | saved on the detail page when leaving the field |
| Context | context |
Text (Markdown) | yes | Description, background | Dialog requires title and context |
| Category | takeaway_category_id |
Reference | no | Generic term from category_of_takeaway |
„Kategorie auswählen“; new category can be created via „Neue Erkenntnis-Kategorie“ |
| Type | takeaway_type_id |
Reference | no | Subdivision from type_of_takeaway, filtered to the chosen category |
selectable only after category; „Neuer Erkenntnis-Typ“ can be created |
| Created on | created_at |
Date | yes | Time of creation | System |
| Origin / „Takeaway von“ | – (derived) | Display | – | Level and name of the carrier object | System |
| Files | – | Reference | no | attached files (sheet „Dateien“) | see File link |
Category and type
Section titled “Category and type”Small auxiliary entities, organization-wide:
| Entity | Field | Meaning |
|---|---|---|
Takeaway category (category_of_takeaway) |
„Bezeichnung“ (title, required) |
Generic term, e.g. „Steuerung“ |
Takeaway type (type_of_takeaway) |
„Bezeichnung“ (title, required), category (required) |
Subdivision of a category, e.g. „Abweichung“ |
Deleting a category deletes its types along with it; key takeaways only lose the reference (displayed as „–“).
Relations
Section titled “Relations”| Related to | Kind | Required | On archive | On delete |
|---|---|---|---|---|
| Project / Program / Portfolio | belongs to | one of three | archived along | deleted along |
| Takeaway category | belongs to | no | – | reference cleared |
| Takeaway type | belongs to | no | – | reference cleared |
| File | n:m via file_link (entity_kind = takeaway) |
no | – | link removed, file kept |
States
Section titled “States”None.
Rules & automation
Section titled “Rules & automation”- Level fixed on creation (tab in which „Erkenntnis hinzufügen“ was pressed).
- Upward visibility (system): program insights show own + project takeaways; portfolio insights show own + takeaways of the programs + of the directly assigned projects. Projects that hang in the portfolio via a program do not appear in the portfolio (only their program).
- Inherited entries cannot be deleted: only entries of the own level offer „Löschen“; foreign ones can be opened. Deletion is final.
- Type selection is restricted to the chosen category; changing the category invalidates the type – select it again.
None.
See also
Section titled “See also”Guides › Close a project · Guides › Prepare a quarterly review