Ich mache einige Flussdiagramme und frage mich, ob ich mich dem richtig nähere. Im Wesentlichen habe ich mehrere Methodenaufrufe und ich führe jeweils ein Flussdiagramm separat durch. Einige dieser Methoden rufen jedoch einige Informationen auf und fahren dann fort. Siehe dieses Beispiel:
Ich habe 3 andere Methoden, die ebenfalls GetQueue () aufrufen, und ich frage mich, ob ich dies richtig darstelle. Der AddQueue () -Fluss sieht visuell so aus, als wäre er unterbrochen.
HINWEIS: In meinem Flussdiagramm vorgenommene Änderungen:
Antworten:
Verwenden Sie ein Unterprogramm-Symbol für den Methodenaufruf (vordefinierter Prozess).
quelle
Ich habe kürzlich einige Flussdiagramme erstellt und hatte mit dem gleichen Problem zu kämpfen, wie Subroutinenaufrufe oder vielleicht Methoden- und Funktionsaufrufe, wie Sie sie heutzutage nennen könnten, dargestellt werden.
Ich habe mich für eine Konvention entschieden, bei der ich das Unterprogramm CALLS von dem Unterprogramm REFERENCES trenne. Für das erstere verwende ich ein gewöhnliches Rechteck, das den Aufruf mit Argumenten zeigt, wobei alle Variablen verwendet werden, die zu diesem Zeitpunkt in der Programmausführung wirksam sind.
Ich verwende das doppelseitige Rechteck "vordefinierter Prozess" einfach als Referenz auf ein anderes Flussdiagramm, das die Definition dieser Funktion oder Unterroutine enthält. Das Unterroutinenrechteck muss nicht die Argumente der Unterroutine anzeigen, da dies Teil des definierenden Flussdiagramms der betreffenden Unterroutine ist. Es kann jedoch hilfreich sein, sie bereits in die Referenz aufzunehmen, damit jeder, der sie liest, sie lesen kann Sehen Sie sich die Bedeutung der tatsächlichen Argumente an, die in einem Aufruf verwendet werden.
Dies erhöht die Anzahl der Rechtecke, macht jedoch klarer, dass diese anderen Flussdiagramme vorhanden sind, um die Definition einiger der aufgerufenen Funktionen nachzuschlagen. Wenn eine Funktion einfach ist, erstelle ich oft kein separates Diagramm dafür, sondern dokumentiere es nur mündlich.
Ich benutze auch das "Dokument" -Symbol, um zu sagen, dass Details aus der Codeliste nachgeschlagen werden sollten.
Der Sinn eines Flussdiagramms besteht für mich nicht darin, ein Programm zu erstellen, sondern anderen das Verständnis eines Programms zu erleichtern. Ich denke, die Hilfe aus der Vogelperspektive und deren Zweck sollte im Auge behalten werden. Sie dienen nicht zur visuellen Beschreibung JEDES Details Ihres Programms. Details sind bei Bedarf im Code sichtbar. Das Flussdiagramm ist nur ein Bild Ihres Programms aus der Sicht der übergeordneten Ebene.
Wenn Flussdiagramme auf einem hohen Niveau gehalten werden, müssen sie auch weniger auf dem neuesten Stand gehalten werden, wenn der Code geändert wird.
Sie sind Bilder. Wie bei jeder guten Story-Software sollte auch die Dokumentation Bilder enthalten, die einen alternativen Blickwinkel auf den Code bieten.
quelle