erweiterbarkeit: satz eingefuegt, qs-dokument: fehlerbeseitigte version vom lutz

This commit is contained in:
murat 2012-03-28 14:39:51 +02:00
parent 786b536fdb
commit 392fa1b74d
3 changed files with 7 additions and 5 deletions

View File

@ -240,7 +240,7 @@ Die aufgef
\subsection{Benutzerstudie}
\label{Anhang:Benutzerstudie}
Die Benutzerstudie wurde von uns nicht wie geplant durchgeführt, da die Erstellung einer neuen Visualisierung nach Rücksprache mit unserem Auftraggeber ausgelassen wurde. Somit sind die folgenden beiden Abschnitte (4.1.1 und 4.1.2) nicht mehr relevant. Die Gründe hierfür waren unter anderem die sich ändernden Anforderungen im agilen Softwareprozess. So mussten wir die uns gegebene Datenbank massiv überarbeiten. Es fehlten sämtliche Fremdschlüssel, welche vom verwendeten \gls{ORM} \gls{Propel} zum Joinen der einzelnen Tabellen benötigt werden. Zudem wurden bei der Erstellung der neuen Datenbank notwendige Tabellenspalten nicht hinzugefügt. Ein weiterer Grund weshalb die neue Visualisierung ausgelassen wurde waren die unvorhersehbaren Probleme bei der Nutzung von \gls{Propel}. So eignet es sich vor allem für statische Datenbankabfragen, nicht aber für Dynamische, welche bei der Erstellung der neuen \gls{API} notwendig waren. Die gegebene Dokumentation von \gls{Propel} ist sehr kurz gefasst und beschreibt meist nur einfache SQL-Abfragen. Aus diesem Grund standen wir im ständigen Kontakt mit dem Entwicklern, welche glücklicherweise einen gut betreuten Support-Chat anbieten. Die einzelnen Tabellennamen der Datenbank enthielten zu Beginn Unterstriche. \gls{Propel} kann mit dieser festgelegten Namenskonvention jedoch nicht umgehen, weshalb alle Tabellennamen neu vergeben werden mussten. Hierbei haben wir uns an die aus Java bekannte CamelCase Konvention gehalten.
Die Benutzerstudie wurde von uns nicht wie geplant durchgeführt, da die Erstellung einer neuen Visualisierung nach Rücksprache mit unserem Auftraggeber ausgelassen wurde. Somit sind die folgenden beiden Abschnitte (4.1.1 und 4.1.2) nicht mehr relevant. Die Gründe hierfür waren unter anderem die sich ändernden Anforderungen im agilen Softwareprozess. So mussten wir die uns gegebene Datenbank massiv überarbeiten. Es fehlten sämtliche Fremdschlüssel, welche vom verwendeten \gls{ORM} \gls{Propel} zum Joinen der einzelnen Tabellen benötigt werden. Zudem wurden bei der Erstellung der neuen Datenbank notwendige Tabellenspalten nicht hinzugefügt. Ein weiterer Grund weshalb die neue Visualisierung ausgelassen wurde waren die unvorhersehbaren Probleme bei der Nutzung von \gls{Propel}. So eignet es sich vor allem für statische Datenbankabfragen, nicht aber für dynamische, welche bei der Erstellung der neuen \gls{API} notwendig waren. Die gegebene Dokumentation von \gls{Propel} ist sehr kurz gefasst und beschreibt meist nur einfache SQL-Abfragen. Aus diesem Grund standen wir in ständigem Kontakt mit den Entwicklern, welche glücklicherweise einen gut betreuten Support-Chat anbieten. Die einzelnen Tabellennamen der Datenbank enthielten zu Beginn Unterstriche. \gls{Propel} kann mit dieser festgelegten Namenskonvention jedoch nicht umgehen, weshalb alle Tabellennamen neu vergeben werden mussten. Hierbei haben wir uns an die aus Java bekannte CamelCase Konvention gehalten.
@ -333,7 +333,7 @@ Fehlerbehandlung:
\item Eingabedaten, welche nicht dem JSON Format entsprechen, führen zu einer JSONException.
\item Eingabedaten, welche nicht dem festgelegten Format entsprechen, führen zu einer DataFormatException.
\end{itemize}
Um die Konsistenz der Datenbank zu gewährleisten, haben wir uns dazu entschieden die Fremdschlüssel in der Datenbank \glqq restrict'' zu deglarieren. Somit verhindert die Datenbank beispielsweise selbstständig, dass Werte eines Sensors eingetragen werden, der in der Datenbank nicht existiert. \\ \\
Um die Konsistenz der Datenbank zu gewährleisten, haben wir uns dazu entschieden die Fremdschlüssel in der Datenbank \glqq restrict'' zu deklarieren. Somit wird verhindert, dass inkonsistente oder nicht vollständige Datensätze in der Datenbank gespeichert werden können. \\ \\
\textbf{Format zum Ändern der Sensorinformationen (im Folgenden als Format 1 bezeichnet):}\\
Dieses Format wird beim Start, Login oder der Änderung von Optionen der einzelnen Sensoren gesendet. \\ \\
HTTP-Post-Parameter: flag=deviceinfo\&json=JSON-Daten \\ \\
@ -386,7 +386,7 @@ Das vereinbarte JSON Format sieht wie folgt aus:
\end{tabbing}
\newpage
\noindent
Auf den folgenden Seiten sind die verschiedenen Testprotokolle der eizelnen Tests zu finden. Zu jedem Test wird innerhalb dieses Dokuments eine eigene Tabelle geführt.
Auf den folgenden Seiten sind die verschiedenen Testprotokolle der einzelnen Tests zu finden. Zu jedem Test wird innerhalb dieses Dokuments eine eigene Tabelle geführt.
\paragraph{Test: MissingParameterException I}
@ -709,4 +709,4 @@ F
\end{document}
\end{document}

View File

@ -1,4 +1,6 @@
\paragraph{Teaminterner Codereview 21.11.2011}
Auf den folgenden Seiten sind die einzelnen teaminternen Codereviews aufgelistet. Jedes einzelne Treffen wird in einer eigenen Tabelle gef"uhrt.
\paragraph{Teaminterner Codereview 21.11.2011}
\vspace{1cm}
\begin{tabbing}
\begin{tabular}{||p{5.4cm}||p{11cm}||}