Das Dokumentieren von Anforderungen Eine Haupttätigkeit im Requirements Engineering

Manage­ment-Zusam­men­fas­sung zu die­sem Bei­trag:
Das Doku­men­tie­ren (engl. Docu­men­ting) von Anfor­de­run­gen ist eine der Haupt­tä­tig­kei­ten im → Requi­re­ments Engi­nee­ring.
In die­sem Bei­trag wird das Doku­men­tie­ren mit sei­nen Pro­zes­sen, Werk­zeu­gen und Metho­den beschrieben.

In die­sem Bei­trag wird das Requi­re­ments Engi­nee­ring in die Berei­che Anfor­de­rungs­ent­wick­lung (Requi­re­ments Deve­lo­p­ment) und Anfor­de­rungs­ver­wal­tung (→ Requi­re­ments Manage­ment) unter­teilt, wobei die­se wie­der­um in die vier Haupt­tä­tig­kei­ten (auch Hauptaktivitäten) …

  • Ermit­teln (Eli­ci­ting),
  • Doku­men­tie­ren (Docu­men­ting),
  • Vali­die­ren (Vali­da­ting) und
  • Ver­wal­ten (Mana­ging)

unter­glie­dert wer­den kön­nen (Abbil­dung 0.1). Im Fokus die­ses Bei­trags steht das Doku­men­tie­ren der Anforderungen.

Die Unterteilung des Requirements Engineerings - Fokus Dokumentieren, (C) Peterjohann Consulting, 2021-2022

Abbil­dung 0.1: Die Unter­tei­lung des Requi­re­ments Engi­nee­rings — Fokus “Doku­men­tie­ren”

Die Pro­zess­sicht auf das Doku­men­tie­ren von Anfor­de­run­gen ist in Abbil­dung 0.2 dargestellt.

Prozesse im Requirements Engineerings nach IREB - Fokus Dokumentieren, (C) Peterjohann Consulting, 2021-2022

Abbil­dung 0.2: Pro­zes­se im Requi­re­ments Engi­nee­rings nach → IREB — Fokus “Doku­men­tie­ren”

Ach­tung:
Doku­men­tie­ren ist nicht der Doku­men­ta­ti­on gleich­zu­set­zen: Das Doku­men­tie­ren beschreibt eine → Tätig­keit und die Doku­men­ta­ti­on eine (schrift­li­che) Beschrei­bung der Anfor­de­run­gen. Also ist die Anfor­de­rungs­do­ku­men­tie­rung nicht der Anfor­de­rungs­do­ku­men­ta­ti­on gleichzusetzen.

1. Einleitung und Grundlagen

1.1 Definitionen

Das Doku­men­tie­ren von Anfor­de­run­gen beschäf­tigt sich mit zwei Aspekten:

  1. Zum einen mit Einzelanforderungen
  2. Zum ande­ren mit dem Zusam­men­stel­len von (Einzel-)Anforderungen in einem Dokument
Aspekte des Dokumentierens, (C) Peterjohann Consulting, 2018-2022

Abbil­dung 1.1: Aspek­te des Dokumentierens

2. Das Dokumentieren von Einzelanforderungen

Ein­zel­an­for­de­run­gen kön­nen entweder …

  • natür­lich­sprach­lich,
  • modell­ba­siert oder
  • als Misch­form beschrie­ben werden.
Die Dokumentationsformen nach IREB, (C) Peterjohann Consulting, 2021-2022

Abbil­dung 2.1: Die Doku­men­ta­ti­ons­for­men (nach IREB /IREB21/)

In der Pra­xis wer­den alle For­men eingesetzt.

2.1 Die Satzschablone

→ Satz­scha­blo­nen die­nen der Erfas­sung von Ein­zel­an­for­de­run­gen: Durch Vor­ga­ben einer for­ma­len (syn­tak­ti­schen) Struk­tur wer­den ein­zel­ne Anfor­de­run­gen in vor­ge­ge­be­ner Art und Wei­se in jeweils einem Satz beschrieben.

Bei Rupp /Rupp14/ wird die Satz- oder Anfor­de­rungs­scha­blo­ne wie folgt defi­niert:
“Eine Anfor­de­rungs­scha­blo­ne ist ein Bau­plan, der die Struk­tur eines ein­zel­nen Anfor­de­rungs­sat­zes festlegt.”

Die Satzschablone, (C) Peterjohann Consulting, 2018-2022

Abbil­dung 2.2: Die Satzschablone

Wenn Satz­scha­blo­nen kon­se­quent und rich­tig ein­ge­setzt wer­den, redu­ziert sich der Inter­pre­ta­ti­ons­spiel­raum erheb­lich — die Anfor­de­run­gen wer­den eindeutiger.

3. Das Zusammenstellen von (Einzel-)Anforderungen in einem Dokument

Nach IREB kann das Ergeb­nis der Doku­men­ta­ti­on eine Samm­lung von Ein­zel­an­for­de­rung sein, die als Anfor­de­rungs­spe­zi­fi­ka­ti­on bezeich­net wer­den kann. Im → Glos­sar wird dazu defi­niert /#IREB-Glossar-22/: “Anfor­de­rungs­spe­zi­fi­ka­ti­on: Requi­re­ments spe­ci­fi­ca­ti­on: A sys­te­ma­ti­cal­ly repre­sen­ted collec­tion of requi­re­ments, typi­cal­ly for a sys­tem, that satis­fies given cri­te­ria.”
(Eige­ne Über­set­zung: “Anfor­de­rungs­spe­zi­fi­ka­ti­on: Eine sys­te­ma­tisch dar­ge­stell­te Samm­lung von Anfor­de­run­gen, typi­scher­wei­se für ein Sys­tem, das bestimm­te Kri­te­ri­en erfüllt.”)

In der Anfor­de­rungs­spe­zi­fi­ka­ti­on somit wer­den die ermit­tel­ten Anfor­de­run­gen in eine Form gebracht, die es erlaubt, sowohl mit den Kun­den / Sta­ke­hol­dern wie auch mit den Ent­wick­lern ein Gesamt­bild des zu erstel­len­den Pro­dukts zu gene­rie­ren. Hier­zu kön­nen Glie­de­rungs­vor­la­gen für Doku­men­te ein­ge­setzt wer­den — in der Pra­xis wer­den (im deutsch­spra­chi­gen Raum) häu­fig verwendet:

  • Das Vole­re-Tem­pla­te von Suzan­ne und James Robert­son /VOLERE/
  • Die Struk­tur für Soft­ware Requi­re­ments Spe­ci­fi­ca­ti­on (SRS) nach IEEE 830‑1998
  • Die Doku­men­ten­struk­tur nach dem → V‑Modell XT /V‑­Mo­dell-XT/

Im deutsch­spra­chi­gen Raum wer­den Anfor­de­rungs­do­ku­men­te häu­fig auch als → Las­ten­heft und Pflich­ten­heft bezeich­net — Eine Beschrei­bung die­ser Begrif­fe fin­den Sie in dem Bei­trag “→ Las­ten­heft und Pflich­ten­heft”.

4. Häufige Fragen und Antworten zum Dokumentieren von Anforderungen

Eini­ge Fra­gen zum Doku­men­tie­ren von Anfor­de­run­gen wer­den häu­fig gestellt – die­se wer­den hier wie­der­ge­ge­ben und beantwortet.

  • F: Muss der → Requi­re­ments Engi­neer eine spe­zi­fi­sche Aus­bil­dung für das Doku­men­tie­ren haben?
    A: Ja. Beim Doku­men­tie­ren von Anfor­de­run­gen soll­ten Hilfs­mit­tel wie Satz­scha­blo­nen oder Model­le (typi­scher­wei­se unter Ver­wen­dungg der → UML) zum Ein­satz kom­men. Die­se müs­sen trai­niert werden.
  • F: Wie groß ist typi­scher­wei­se der → Auf­wand zum Doku­men­tie­ren von Anfor­de­run­gen in einem → Vor­ha­ben?
    A: Als “gro­be Richt­schnur” kann etwa 20 bis 60 % des Gesamt­auf­wands für ein RE-Vor­ha­ben für das Doku­men­tie­ren ein­kal­ku­liert wer­den. Häu­fig geht das Doku­men­tie­ren mit den Doku­men­ta­ti­ons­ar­te­fak­ten in das Pro­dukt­ma­nage­ment / in die Pro­dukt­pfle­ge über, so dass hier lang­fris­ti­ger Pfle­ge­auf­wand ent­steht, der jedoch nicht mehr zum Ursprungs-RE-Vor­ha­ben gehört.

Haben Sie noch wei­te­re Fra­gen oder möch­ten Sie Ergän­zun­gen an der FAQ vor­neh­men? Am bes­ten schrei­ben Sie mir hier­zu eine E‑Mail an: kontakt@peterjohann-consulting.de.

A. Präsentationen, Literatur und Weblinks

A.1 Meine öffentliche Präsentation zum Dokumentieren von Anforderungen

Das Doku­men­tie­ren von Anfor­de­run­gen wird in der Prä­sen­ta­ti­on zum Requi­re­ments Engi­nee­ring beschrieben.

Inhalt Typ
Requi­re­ments Engi­nee­ring (und Busi­ness Ana­ly­sis) – Eine Ein­füh­rung (RE-Basis­prä­sen­ta­ti­on)

pdf

A.2 Literatur

  1. /BBG15/ → IIBA: A Gui­de to the Busi­ness Ana­ly­sis Body of Know­ledge (BABOK Gui­de), Inter­na­tio­nal Insti­tu­te of Busi­ness Ana­ly­sis, Mari­et­ta, Geor­gia 3rd Edi­ti­on 2015, ISBN 978–1‑927584–02‑6
  2. /BBG17‑d/ IIBA: BABOK v3: Leit­fa­den zur Busi­ness-Ana­ly­se BABOK Gui­de 3.0, Dr. Götz Schmidt, Wet­ten­berg 2017, ISBN 978–3‑945997–03‑1
  3. /Ebert19/ Chris­tof Ebert: Sys­te­ma­ti­sches Requi­re­ments Engi­nee­ring. Anfor­de­run­gen ermit­teln, doku­men­tie­ren, ana­ly­sie­ren und ver­wal­ten, dpunkt, Hei­del­berg 6. Auf­la­ge 2019, ISBN 978–3‑86490–562‑9
  4. /Ebert22/ Chris­tof Ebert: Sys­te­ma­ti­sches Requi­re­ments Engi­nee­ring. Anfor­de­run­gen ermit­teln, doku­men­tie­ren, ana­ly­sie­ren und ver­wal­ten, dpunkt, Hei­del­berg 7. Auf­la­ge 2022, ISBN 978–3‑86490–919‑1
  5. /Hruschka19/ Peter Hrusch­ka: Busi­ness Ana­ly­sis und Requi­re­ments Engi­nee­ring: Pro­zes­se und Pro­duk­te nach­hal­tig ver­bes­sern, Han­ser, Mün­chen 2. Auf­la­ge 2019, ISBN 978–3‑446–45589‑4
  6. /Naumann18/ Axel-Bru­no Nau­mann: Busi­ness-Ana­ly­se – Sys­te­ma­ti­sches Anfor­de­rungs­ma­nage­ment für nut­zer­ori­en­tier­te Lösun­gen, Dr. Götz Schmidt, Wet­ten­berg 2018, ISBN 978–3‑945997–11‑6
  7. /IREB21/ sie­he /Pohl21/
  8. /PMG-BA17/ Pro­ject Manage­ment Insti­tu­te: The → PMI Gui­de to Busi­ness Ana­ly­sis, Pro­ject Manage­ment Insti­tu­te, Phil­adel­phia, Penn­syl­va­nia 2017, ISBN 978–1‑62825–198‑2
  9. /Pohl21/ auch /IREB21/ Klaus Pohl, Chris Rupp: Basis­wis­sen Requi­re­ments Engi­nee­ring: Aus- und Wei­ter­bil­dung nach IREB-Stan­dard zum Cer­ti­fied Pro­fes­sio­nal for Requi­re­ments Engi­nee­ring Foun­da­ti­on Level, dpunkt, Hei­del­berg 5. Auf­la­ge 2021, ISBN 978–3‑86490–814‑9
  10. /Robertson12/ Suzan­ne Robert­son, James Robert­son: Mas­te­ring the Requi­re­ments Pro­cess, Addi­son-Wes­ley Pro­fes­sio­nal, Bos­ton, Mas­sa­chu­setts 3rd Edi­ti­on 2012, ISBN 978–0‑321–81574‑3
  11. /Rupp14/ Chris Rupp: Requi­re­ments-Engi­nee­ring und ‑Manage­ment. Aus der Pra­xis von klas­sisch bis agil, Han­ser, Mün­chen 6. Auf­la­ge 2014, ISBN 978–3‑446–43893‑4
  12. /Rupp20/ Chris Rupp: Requi­re­ments-Engi­nee­ring und ‑Manage­ment. Das Hand­buch für Anfor­de­run­gen in jeder Situa­ti­on, Han­ser, Mün­chen 7. Auf­la­ge 2020, ISBN 978–3‑446–45587‑0
  13. /Wiegers13/ Karl E. Wie­gers, Joy Beat­ty: Soft­ware Requi­re­ments, Micro­soft Press, Red­mond, Washing­ton 3rd Edi­ti­on 2013, ISBN 978–0‑7356–7966‑5

Legen­de zu den Weblinks
/ / Ver­weis auf eine Web­site (gene­rell)
/*/ Ver­weis auf eine Web­site, die als Buch-Ergän­zung dient
/#/ Ver­weis auf ein­zel­nes The­ma auf einer Website
/#V/ Ver­weis auf ein Video auf einer Website