Author Topic: Best UML Diagrams for Requirements Gathering?  (Read 953 times)

Marjohishe

  • EA Novice
  • *
  • Posts: 1
  • Karma: +0/-0
    • View Profile
Best UML Diagrams for Requirements Gathering?
« on: May 16, 2025, 06:51:47 pm »
Hi all,
Which UML diagrams do you find most effective during the requirements phase? I'm currently using use case and activity diagrams—wondering if there's anything else you'd recommend.

Thanks!

Richard Freggi

  • EA User
  • **
  • Posts: 493
  • Karma: +18/-7
    • View Profile
Re: Best UML Diagrams for Requirements Gathering?
« Reply #1 on: May 16, 2025, 08:52:08 pm »
Use case diagrams for sure - but there's an art to structuring them to maximize their value. 
Under each use case, one or more sequence diagram.  The sequence diagram is by far the best way to capture who is using what information, what attribute, how they use it and why.  This is invaluable for data modeling but also system architecture, and also test definition.
Activity diagrams don't add much value beyond maybe user interface design as they just show procedural steps without capturing what information is used, where it comes from, where it goes to.  Personally I avoid them.

My 2c good luck!

jfzouain

  • EA User
  • **
  • Posts: 152
  • Karma: +6/-1
    • View Profile
Re: Best UML Diagrams for Requirements Gathering?
« Reply #2 on: May 19, 2025, 07:45:46 am »
Hi

I wrote an eBook about all this (Rquirement Diagram, Use Case Diagram and Activity Diagram; you can find it at https://leanpub.com/uml-erpworkshop

Happy reading
Best regards

Jose Zouain

PDC

  • EA User
  • **
  • Posts: 109
  • Karma: +4/-0
  • Systems Engineer
    • View Profile
Re: Best UML Diagrams for Requirements Gathering?
« Reply #3 on: May 20, 2025, 05:31:42 pm »
The sequence diagram is by far the best way to capture who is using what information, what attribute, how they use it and why.
...
Activity diagrams don't add much value beyond maybe user interface design as they just show procedural steps without capturing what information is used, where it comes from, where it goes to.  Personally I avoid them.

Interesting take. Have you played around with using Activity Parameters, ObjectFlows supported by a rigorous data model etc?


To answer the original question, Use Case diagrams are a good way to organise requirements. It depends entirely on what format your requirements take though, of course. If your requirements are modelled as UML Requirement Elements in EA then UC diagram works, or a Class diagram if you want to show different requirement types and how they relate to / inherit from each other (and many other ways to manage the requirments structure).
If your requirements are modelled as Activities then naturally a set of Activity Diagrams is what you need (similar for requirements modelled as Sequences, Class structures etc...).
For me, in summary, there are few 'rights and wrongs' because it depends on what you're trying to achieve, and that will be different depending on the design, the system, the requirements management philosophy, the customer....



I wrote an eBook about all this (Rquirement Diagram, Use Case Diagram and Activity Diagram; you can find it at https://leanpub.com/uml-erpworkshop

I'd be interested to read this! :)
Phil