{"id":25403,"date":"2019-03-20T10:07:33","date_gmt":"2019-03-20T09:07:33","guid":{"rendered":"https:\/\/pitss.org\/de\/?p=25403"},"modified":"2019-03-20T16:34:43","modified_gmt":"2019-03-20T15:34:43","slug":"nachtraegliche-automatisierte-softwaredokumentation","status":"publish","type":"post","link":"https:\/\/pitss.org\/de\/nachtraegliche-automatisierte-softwaredokumentation\/","title":{"rendered":"Automatisierte Softwaredokumentation als Entscheidungshilfe f\u00fcr das Management"},"content":{"rendered":"

[et_pb_section bb_built=“1″ fullwidth=“on“ _builder_version=“3.2.2″ background_image=“https:\/\/pitss.org\/de\/wp-content\/uploads\/sites\/9\/2017\/08\/blog-1-header-v2-min.jpg“ next_background_color=“#ffffff“][et_pb_fullwidth_header title=“Projekt Digital“ subhead=“Der Blog f\u00fcr digitale Business Leader“ text_orientation=“center“ background_overlay_color=“rgba(0,0,0,0.53)“ _builder_version=“3.17.6″ title_font_size=“36px“ subhead_font_size=“22px“ max_width_tablet=“50px“ title_font=“|700|||||||“ title_level=“h2″ background_color=“rgba(255, 255, 255, 0)“ button_one_text_size__hover_enabled=“off“ button_one_text_size__hover=“null“ button_two_text_size__hover_enabled=“off“ button_two_text_size__hover=“null“ button_one_text_color__hover_enabled=“off“ button_one_text_color__hover=“null“ button_two_text_color__hover_enabled=“off“ button_two_text_color__hover=“null“ button_one_border_width__hover_enabled=“off“ button_one_border_width__hover=“null“ button_two_border_width__hover_enabled=“off“ button_two_border_width__hover=“null“ button_one_border_color__hover_enabled=“off“ button_one_border_color__hover=“null“ button_two_border_color__hover_enabled=“off“ button_two_border_color__hover=“null“ button_one_border_radius__hover_enabled=“off“ button_one_border_radius__hover=“null“ button_two_border_radius__hover_enabled=“off“ button_two_border_radius__hover=“null“ button_one_letter_spacing__hover_enabled=“off“ button_one_letter_spacing__hover=“null“ button_two_letter_spacing__hover_enabled=“off“ button_two_letter_spacing__hover=“null“ button_one_bg_color__hover_enabled=“off“ button_one_bg_color__hover=“null“ button_two_bg_color__hover_enabled=“off“ button_two_bg_color__hover=“null“ \/][\/et_pb_section][et_pb_section bb_built=“1″ specialty=“on“ background_position_1=“top_left“ background_position_2=“top_left“ background_repeat_1=“no-repeat“ background_repeat_2=“no-repeat“ _builder_version=“3.0.69″ prev_background_color=“#000000″ next_background_color=“#000000″][et_pb_column type=“3_4″ specialty_columns=“3″][et_pb_row_inner admin_label=“Row“ _builder_version=“3.12.2″][et_pb_column_inner type=“4_4″ saved_specialty_column_type=“3_4″][et_pb_text _builder_version=“3.21″ module_alignment=“left“ header_3_font_size=“20px“]<\/p>\n

Automatisierte Softwaredokumentation als Entscheidungshilfe f\u00fcr das Management<\/h1>\n

Welche Vorteile hat sie und wie gelingt sie am besten?<\/strong><\/h4>\n

 <\/p>\n

Bereits seit Jahren oder gar Jahrzehnten im Einsatz und mittlerweile so unverst\u00e4ndlich, dass sie nur noch Kopfschmerzen bereitet: Vielleicht erkennt der Eine oder Andere in dieser Beschreibung seine Unternehmensanwendung wieder. Schade nur, dass man nicht von Beginn an eine Softwaredokumentation betrieben hat. Wie viel einfacher w\u00e4re es jetzt f\u00fcr die neuen Mitarbeiter, die Anwendung zu verstehen und f\u00fcr den IT-Verantwortlichen die richtigen strategischen Entscheidungen zu treffen!<\/b><\/p>\n

Um Unternehmen zu unterst\u00fctzen, die sich in einer \u00e4hnlichen Situation befinden, arbeitet PITSS an einer neuartigen L\u00f6sung zur <\/span>nachtr\u00e4glichen, automatisierten und visuellen <\/span><\/i>Softwaredokumentation. Dabei sollen Daten sowohl aus den jeweiligen Programmquelldateien, als auch f\u00fcr die grafische Aufbereitung von Prozessen und deren Detailschritten erfasst werden. Ziel ist es, bestehende Anwendungssysteme erheblich und sinnvoll zu verbessern, damit neue oder externe Mitarbeiter, Architekten und Manager weit schneller an eine Anwendung herangef\u00fchrt werden k\u00f6nnen bzw. diese insgesamt einfacher wartbar wird.<\/span><\/p>\n

\"\"<\/p>\n

 <\/p>\n

Bisher bekannte Verfahren zur Dokumentation im \u00dcberblick<\/strong><\/h2>\n

1. Softwaredokumentation<\/strong><\/h3>\n

Es gibt L\u00f6sungen, die Entwickler bei der Dokumentation unterst\u00fctzen \u2013 beispielhaft sei an dieser Stelle der \u201eSAP ABAP Documentation Generator\u201c der Firma PIKON<\/a> genannt. Diese Werkzeuge setzen jedoch bei der eigentlichen Softwareprogrammierung bzw. -entwicklung an und sind zudem meist auf lediglich eine Programmiersprache oder eine F\u00e4higkeit begrenzt. Softwarel\u00f6sungen, die eine automatisierte und vor allem nachtr\u00e4gliche Dokumentation von bestehenden Softwareanwendungen erm\u00f6glichen, sind jedoch nicht bekannt.<\/span><\/p>\n

2. Data Lineage<\/strong><\/h3>\n

Data Lineage erm\u00f6glicht es, zu einem bestimmten Datum diejenigen Daten in den Quellen ausfindig zu machen, aus denen das zu analysierende Datum abgeleitet wurde. Hierzu erfolgt die Ermittlung aller \u00c4nderungen, Anpassungen und Entwicklungen an bestimmten Datenteilen und f\u00f6rdert ein Verst\u00e4ndnis der kompletten Datenfl\u00fcsse und den sich daraus ergebenden Metadaten. <\/span><\/p>\n

Tools wie bspw. <\/span>MANTA<\/span><\/a> nutzen hierf\u00fcr im Wesentlichen strukturierte Daten aus SAP, Oracle, MSSQL, IBM DB2, PostgreSQL und anderen Datenbank- bzw. Data-Warehouse-Systemen (DWH). Die Nutzung von Softwareanwendungen selbst als Datenbasis f\u00fcr Data Lineage ist nicht bekannt.<\/span><\/p>\n

3. Process Mining<\/strong><\/h3>\n

Beim Process Mining werden vorhandene (strukturierte) Prozessdaten \u2013 z. B. Log Files oder Transaktionsdaten aus einem DWH oder einem ERP-System \u2013 erfasst, analysiert und daraus der zugrundeliegende Prozess modelliert. F\u00fchrende Anbieter sind u.a. die Celonis SE und die Process Analytics Factory GmbH. Doch bei Individualsoftware und vor allem bei Legacy-Systemen sto\u00dfen die aktuellen Process-Mining-Ans\u00e4tze an ihre Grenzen. Alt-Applikationen verf\u00fcgen nur selten \u00fcber eine Workflow-Engine, von der die <\/span>notwendigen strukturierten Prozessdaten abgegriffen werden k\u00f6nnen.<\/p>\n

4. Automatische Codeanalyse<\/strong><\/h3>\n

Die PITSS entwickelt bereits seit Gr\u00fcndung 1999 Softwarewerkzeuge zur Analyse von Source Code von Anwendungen. Diese Tools finden vor allem bei der Code-Modernisierungen beliebig gro\u00dfer und komplexer Software Anwendung und lassen sich auch ohne umfassendes fachliches wie technisches Wissen anwenden. Ausgehend von diesen Werkzeugen ist die PITSS in der Lage, in au\u00dferordentlich kurzer Zeit zuverl\u00e4ssige Aussagen \u00fcber Entwicklungsvorhaben zu t\u00e4tigen und diese auch auszuf\u00fchren. Mit den bisherigen statischen Analysen wird jedoch die Durchg\u00e4ngigkeit von Prozess, Architektur und Programmierung \u00fcber alle technischen Ebenen hinweg nicht ausreichend gew\u00e4hrleistet. Ein System zur Softwaredokumentation zu entwickeln, das sich sowohl auf die automatische Software-Analyse als auch -Dokumentation und -Visualisierung versteht, ist unser aktuelles Vorhaben.<\/span><\/p>\n

Das kann mit einer automatisierten Softwaredokumentation erreicht werden<\/strong><\/h2>\n

Mitwirkung bei IT-Projekten<\/strong><\/h3>\n

\"\"Eine Einbindung der Fachabteilungen in Vorhaben zur Softwaremodernisierung bereits in den fr\u00fchen Phasen erm\u00f6glichen? Das w\u00fcrde den aktuell noch verbreiteten und teilweise problematischen Selbstzweck einer IT-Abteilung gegen\u00fcber den eigentlichen Softwarenutzern beseitigen. Mithilfe einer automatisierten Dokumentation wird das Herrschaftswissen in den K\u00f6pfen der Entwickler bzw. der IT-Abteilung visuell in Form einer interaktiven, elektronischen Dokumentation transportiert. IT-Projekte erfreuen sich dadurch einer breiteren Akzeptanz und genie\u00dfen im Allgemeinen mehr Erfolg. <\/span><\/p>\n

St\u00e4rken und Schw\u00e4chen der Software aufgrund des Nutzungsverhaltens ermitteln<\/strong><\/h3>\n

\"\"Ein automatisiertes Softwarewerkzeug kann Informationen w\u00e4hrend der Nutzung der Applikation durch die Anwender erheben und diese dem statischen Programmcode in seinen Abh\u00e4ngigkeiten gegen\u00fcberstellen. Die so ermittelten Informationen zeigen nicht nur das Nutzungsverhalten der Applikation \u2013 sie machen auch St\u00e4rken und Schw\u00e4chen innerhalb der Prozesse ausfindig. Werden die Erkenntnisse aus der automatisierten Dokumentation auch noch in einer visuellen Form dargestellt, wird ein direkter, zielorientierter Dialog mit den Anwendern erm\u00f6glicht.<\/span><\/p>\n

Verschiedene Aufzeichnungsmodalit\u00e4ten unterst\u00fctzen die Modernisierung<\/strong><\/h3>\n

\"\"Ist die Verbindung zwischen Business-Prozessen und Software-Artefakten einmal geschaffen, bieten sich bei der Modernisierung von Legacy-Applikationen v\u00f6llig neue M\u00f6glichkeiten: Es werden verschiedene Aufzeichnungsmodalit\u00e4ten erm\u00f6glicht. Zum einen zeichnen sie den dedizierten Gesch\u00e4ftsprozess auf, zum anderen k\u00f6nnen sie innerhalb der kontinuierlichen Beobachtung des Produktionssystems Muster wiedererkennen, die eindeutig den aufgezeichneten Prozessen zugeordnet werden k\u00f6nnen.<\/span><\/p>\n

Prozessdokumentation<\/strong><\/h3>\n

\"\"Im Falle einer Modernisierung sind meist die Prozesse das einzig Konstante, daher ist es wichtig den Blick auf die Prozesse zu werfen. Neben der architekturellen Sicht auf die Legacy-Applikation l\u00e4sst sich dank der automatisierten Softwaredokumentation auch die viel wertvollere Prozessmodellierungssicht retrograd ermitteln. Dabei kann man sich das Heranziehen veralteter Dokumentationen, aufw\u00e4ndiger und fehleranf\u00e4lliger Interviews oder umfangreicher Recherche im Source Code sparen. Zudem erm\u00f6glicht dieses Verfahren, oft genutzte, sehr kompliziert umgesetzte, oder v\u00f6llig vergessene Prozesse unmittelbar sichtbar zu machen. Etwas, was kein Pflichtenheft gew\u00e4hrleisten kann, zumal Pflichtenhefte in der Code-Dokumentation mittlerweile ausgedient haben.<\/span><\/p>\n

Weitere Vorteile der automatisierten und visuellen Software-Dokumentation<\/strong><\/h3>\n