Skip to content

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.

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)

  • 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).
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

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 „–“).

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

None.

  • 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.

Guides › Close a project · Guides › Prepare a quarterly review