Wie haben Sie eine State Machine für nicht-technische Geschäftsanwender dokumentiert?

Question

Wir haben eine Zustandsmaschine, mit der wir einen Workflow implementieren. Ein State-Machine-Diagramm entspricht unseren Bedürfnissen für ein technisches Publikum, aber ich suche nach der besten Möglichkeit, die Zustandsmaschine den Geschäftseinheiten in einem Diagramm des geschriebenen Formats zu präsentieren. Was haben Sie in der Vergangenheit unternommen, um den Geschäftsprozess zu kommunizieren, ohne die Leute mit einem komplizierten Diagramm zu verwechseln?

Answer 1

Es hängt davon ab, wie kompliziert Ihre Zustandsmaschine ist. Wenn es sich bei einer Statusmaschine um einen Workflow handelt, beschreiben Sie den Workflow als einfaches Flussdiagramm. Wenn Ihre Statusmaschine komplex ist, zeigen Sie mehrere Workflows an, die Anwendungsfälle beschreiben, die Ihre Statusmaschine implementieren möchte. Beschreiben Sie kurz das Problem, das die Zustandsmaschine zu lösen versucht, anstatt zu erklären, wie Sie es lösen.

Answer 2

Ich habe ein Visio-Flussdiagramm verwendet. Flussdiagramme sind ähnlich genug, um Zustandsautomaten zu übersetzen. Wenn Ihre Zustandsmaschine jedoch komplex ist, wird sie immer noch ziemlich hässlich aussehen.

Answer 3

Ich hasse es zu sagen, aber die UML2 Zustandsdiagramme

shown here

ziemlich vernünftig aussehen. Wenn Sie dies in einer Präsentation getan haben, können Sie verschiedene Übergangselemente maskieren und hervorheben und über sie sprechen, indem Sie nur das große Diagramm anzeigen, um die gesamte Maschine anzuzeigen.

Answer 4

Ich habe auch Visio verwendet. Können Sie Teile Ihrer Zustandsmaschine in Blöcke abstrahieren, die die Komplexität des Diagramms reduzieren würden? Wenn Sie beispielsweise eine Routine haben, die von einer SD-Karte liest, können Sie alle mit dieser Operation assoziierten Zustände (initialisieren, lesen/schreiben usw.) einfach mit "SD-Karte lesen/schreiben" ersetzen. Sie könnten dann ein separates Diagramm für diese Staaten an anderer Stelle bereitstellen.

Answer 5

Sie könnten versuchen BPMN.

Answer 6

Es gibt eine Möglichkeit, mit hässlichen Flussdiagrammen umzugehen. Geh groß. Lot von Papier Immobilien. Variable Schriftgröße mit den wichtigsten Zuständen in riesige Buchstaben und Details in etwas kleiner. So kann sich der Leser entweder auf das große Bild oder auf Details in einem Bereich konzentrieren.