Experte. I-CH-118 Strukturiert implementieren

Transkript

1 Autor des Dokuments Valmir Selmani Erstellt / Aktualisiert am / Teilnehmer des Projekts: Valmir Selmani, Moritz Kündig, Tobias Künzi Seitenanzahl 13 MTV (Moritz Tobias Valmir) 2011

2 Autor: Valmir Selmani Teilnehmer des Projekts: Valmir Selmani Moritz Kündig Tobias Künzi Copyright Valmir Selmani All rights reserved. Alle Rechte vorbehalten. Kein Teil des Werkes darf ohne ausdrückliche Genehmigung in irgendeiner Form (Druck, Fotokopie, Mikrofilm oder einem anderen Verfahren) reproduziert oder unter Verwendung elektronischer Systeme vervielfältigt oder verarbeitet werden. Diese Unterlagen wurden mit grosser Sorgfalt erstellt und geprüft. Trotzdem können Fehler nicht vollkommen ausgeschlossen werden. Der Autor kann für fehlerhafte Angaben und deren Folgen weder eine juristische Verantwortung noch irgendeine Haftung übernehmen.

3 Inhaltsverzeichnis 1 CSV Datei einlesen Anforderung analysieren, Funktionen zerlegen Datenstrukturen und Algorithmen Struktogramm Entwurf realisieren Testfälle festlegen und Tests durchführen FTP Client Anforderung analysieren Datenstrukturen und Algorithmen Struktogramm Entwurf realisieren Testfälle festlegen und Tests durchführen Notenberechnung Anforderung analysieren, Funktionen zerlegen Datenstrukturen und Algorithmen Struktogramm Entwurf realisieren Testfälle festlegen und Tests durchführen Experte.doc 28. Juni 2011 Seite 3 von 13

4 Experte 1 CSV Datei einlesen Die Funktion "CSV Datei einlesen" ist Teil eines Barcodeleseprogramms in der Siemens, die wir im Rahmen eines Moduls entwickelt haben. Abbildung 1: GUI des CSV-Einleseprogramms Es soll eine Funktion geschrieben werden, das eine CSV Datei in eine Tabelle einliest, wie Excel sozusagen. 1.1 Anforderung analysieren, Funktionen zerlegen Was ist eine CSV Datei? Eine CSV Datei ist eine Datei die Werte enthält, die mit einem bestimmten Sonderzeichen getrennt sind. Solche Dateien brauchen zum Beispiel Tabellenkalkulationsprogramme, die diese Werte anschliessend in eine Tabelle füllen. Was soll das Programm können? Das zu realisierende Programm soll Werte aus einer CSV Datei einlesen und in eine Tabelle(StringGrid) einfüllen, dabei können selber die Werte in der Tabelle verändert werden und anschliessend abgespeichert werden können. Funktionen Datei öffnen CSV Datei einlesen Datei speichern Programm beenden 1.2 Datenstrukturen und Algorithmen Algorithmus 1. Datei öffnen 2. Versuchen Datei zu lesen 3. evtl. Fehlermeldung bei Fehler 4. Datei einlesen 5. Werte in Tabelle einfüllen Variabeln bzw. Objekte Name Bedeutung strgriddata Das Objekt strgriddata ist eine Tabelle, in der Werte eingefüllt werden können. original Stringliste mit den Werten CSV Stringliste mit getrennten Werten (ohne Trennzeichen) charcsvsepar Die Variable charcsvsepar enthält das Trennzeichen der Strings in der Datei charcsvstr Die Variable charcsvstr enthält das Anfangs- und Endzeichen der Strings. szfilename Die Variable enthält den Pfad der Datei Experte.doc 28. Juni 2011 Seite 4 von 13

5 1.3 Struktogramm 1.4 Entwurf realisieren Programmiersprache: C++ Entwicklerumgebung: Embarcadero C++ Builder 2010 Experte.doc 28. Juni 2011 Seite 5 von 13

6 1.5 Testfälle festlegen und Tests durchführen Testfall Erwartung Ist Kann das Programm das CSV File lesen? Übernimmt das Programm die Rohdaten richtig? Werden die Werte in einzelne Felder eingefügt, wobei das Trennzeichen ein Semikolon ist? Wird das Anführungszeichen im String abgeschnitten? Ist das Programm handlich, schön gestaltet? Werden nicht Unicodezeichen richtig dargestellt? Spezialfall Trennzeichen im String mit Anführungszeichen Leere Zeile Abspeicherung der CSV Datei möglich? Wird eine Fehlermeldung angezeigt, wenn die Datei nicht gefunden wird? Ja, das sollte es auf jedenfall können. Ja, es liest das CSV File ein. Es sollte alle Rohdaten richtig einlesen, ob dass passiert werden wir noch sehen. Ja, es sollte die Daten in einzelne Felder einfügen. Wenn im CSV File ein Wert so steht: Hallo ;Welt, dann sollte es so ausgeben Feld1: Hallo, Feld 2: Welt Ich finde dass es schön gestaltet ist, da es schon vorgegeben ist. Eigentlich sollte die Tabelle mit allen Zeichen umgehen können. Es sollte kein neues Feld erzeugen, sondern das Trennzeichen anzeigen. Das Feld in der Tabelle sollte einfach leer sein. Ja, wenn der andere Entwickler nichts falsch gemacht hat, dann sollte es schon funktionieren. Ja, wenn ich das richtig implementiert habe schon. Das Programm liest die Daten richtig ein, ich habe das Ergebnis mit Excel verglichen Ja, das Programm fügt alle Daten in einzelne Felder ein, wie im Excel. Ja, die Anführungszeichen werden abgeschnitten, doch es hat einen Fehler, wenn zwei Anführungszeichen hintereinander sind. Ja, das Programm war gut dargestellt. Nein, das Programm kann mit Kyrillischen und Griechischen Zeichen nicht umgehen, aber mit grossen Zahlen schon. Ja, es wird richtig angezeigt und es wird kein neues Feld erzeugt, doch wenn mehrere Anführungszeichen vorhanden sind, erzeugt es ein neues Feld Ja, es wird richtig angezeigt, das Feld in der Tabelle ist leer. Ja, es funktioniert fehlerfrei! Ja, es funktioniert perfekt. Experte.doc 28. Juni 2011 Seite 6 von 13

7 2 FTP Client Abbildung 2: C++ FTP Client Es soll ein Programm geschrieben werden, dass auf einen FTP Server zugreifen kann. Zudem soll es möglich sein Dateien herunterzuladen bzw. hochzuladen. 2.1 Anforderung analysieren Was ist ein FTP? Im Internet gibt es unendlich viel Software, Bilder, Filme und Musikdateien. Um sich diese Daten auf den eigenen Computer herunter zu laden, benutzt man in der Regel FTP (File Transfer Protocol, dt.: Dateiübertragungsprotokoll). Dessen Stärke und Effizienz liegt im schnellen Datentransport ohne Firlefanz und Multimediageklingel. Auch das Übertragen von Webseiten auf den Webserver (Datei-Upload) wird deshalb meistens per FTP gemacht. Um einen Datei-Up- oder Download per FTP durchzuführen, müssen Sie auf Ihrem Computer einen FTP- Client (ein FTP-Programm) installiert haben (siehe: Wichtige Programme zur Internetnutzung). Mit diesem FTP-Client verbinden Sie sich mit dem entfernten FTP-Server und loggen sich dort ein. Auf vielen anderen Servern müssen Sie als Benutzer registriert sein, um sich mit dem Server verbinden und Daten herauf beziehungsweise herunter laden zu können. Bei öffentlichen FTP-Servern können Sie sich aber in der Regel ohne Registrierung "anonym" einloggen (also ohne einen Login-Namen und ein Passwort zu besitzen). Was soll das Programm können? Funktionen FTP Verbindung FTP Authentifizierung Verzeichnisse abrufen Dateien abrufen Datei hochladen Datei herunterladen Verzeichnis erstellen Experte.doc 28. Juni 2011 Seite 7 von 13

8 2.2 Datenstrukturen und Algorithmen Algorithmus FTP Verbindung herstellen Authentifizierung, wenn nötig Abrufen der Dateien und Ordner Name FHost FUsername FPassword FPassive FDirectory FFiles Bedeutung enthält den FTP Hostnamen enthält den Benutzernamen des FTP Hosts enthält das Passwort des Benuterkontos Information "Passive Verbindung oder nicht" enhält alle Verzeichnisse des Hosts enthält alle Dateien eines Verzeichnisses 2.3 Struktogramm showcontent Stringliste definierten Der Stringliste Inhalt des FTP Servers zuweisen Liste der Verzeichnisse leeren Liste der Dateien leeren solange i=0; i kleiner als Anzahl Einträge im FTP Server; vergrössere i um 1 wenn Eintrag = Verzeichnis J Eintrag in die Liste der Verzeichnisse hinzufügen solange i=0; i kleiner als Anzahl Einträge im FTP Server; vergrössere i um 1 wenn Eintrag = Datei J Eintrag in die Liste der Dateien hinzufügen Stringliste löschen N N 2.4 Entwurf realisieren Programmiersprache: C++ Entwicklerumgebung: Embarcadero C++ Builder 2010 Experte.doc 28. Juni 2011 Seite 8 von 13

9 Experte.doc 28. Juni 2011 Seite 9 von 13

10 2.5 Testfälle festlegen und Tests durchführen Testfall Erwartung Ist Kann das Programm eine Verbindung aufbauen? Werden alle Dateien und Verzeichnisse korrekt angezeigt? Kann eine beliebige Datei hochgeladen werden? Kann eine Datei heruntergeladen werden? Funktioniert der Knopf "zurück", ein Verzeichnis zurückgehen Ja, das sollte es auf jedenfall können. Es sollen alle Dateien und Verzeichnisse aufgelistet werden. Ja, dies sollte möglich sein. Ja, dies sollte möglich sein. Ja, das sollte es auf jedenfall können. Ja, das kann es! Das Programm listet alle Dateien und Verzeichnisse korrekt auf- Ja, eine Datei kann hochgeladen werden, dies funktionierte perfekt. Ja, unter Windows XP ist das möglich, unter Windows 7 nicht, da dies die Sicherheitseinstellungen nicht erlauben. Es funktioniert problemlos. Experte.doc 28. Juni 2011 Seite 10 von 13

11 3 Notenberechnung Abbildung 3: Notenberechnungsprogramm Es soll ein Programm geschrieben werden, das aus der Punktzahl und der maximalen Punktzahl die Note berechnet. Dabei wird die Formel (Anzahl Punkte / Maximale Punktzahl *5 +1 ) gebraucht. 3.1 Anforderung analysieren, Funktionen zerlegen Funktionen Berechnung Formularüberprüfung während der Eingabe Formularüberprüfung beim klicken des "Berechnen" Buttons Reset Funktion 3.2 Datenstrukturen und Algorithmen Alghoritmus Formel: (Anzahl Punkte / Maximale Punktzahl *5 +1 ) 3.3 Struktogramm Berechnung Variablen punktzahl, maxpunktzahl, resultat definieren den Variablen die Werte der Eingabefelder zuweisen resultat = punktzahl / maxpunktzahl*5+1 Resultat auf 2 Stellen runden Resultat ausgeben wenn resultat < 4 J Bewertung ausgeben wenn resultat grösser gleich 4 J Bewertung ausgeben wenn resultat > 4.75 J Bewertung ausgeben wenn resultat > 5.25 J Bewertung ausgeben N N N N Experte.doc 28. Juni 2011 Seite 11 von 13

12 3.4 Entwurf realisieren Experte.doc 28. Juni 2011 Seite 12 von 13

13 3.5 Testfälle festlegen und Tests durchführen Testfall Erwartung Ist Wird die Note nach der Formel korrekt berechnet? Werden Fehlermeldungen angezeigt, falls ein Buchstabe bzw. Sonderzeichen eingegeben wird? Ist es möglich ein höhere Anzahl an Punkten als die maximale Punktzahl zu haben? Ja, das sollte es auf jedenfall können. Ja, das kann es! Ja, es sollen Fehlermeldungen angezeigt werden und darauf hingewiesen werden. geleert. Nein, dies sollte das Programm nicht akzeptieren. Ja, es werden Fehlermeldungen angezeigt, Felder werden rot markiert und das Feld automatisch Ja, das Programm weist darauf hin, dass die Anzahl der Punkte grösser ist als die Maximale Punktzahl. Funktioniert der Reset Button? Ja, das sollte er. Ja, er funktioniert perfekt. Werden die Bewertung korrekt Ja, das sollten sie. ja, sie werden korrekt angezeigt. angezeigt? Experte.doc 28. Juni 2011 Seite 13 von 13