Ohm-Management - Projektarbeit B-ME
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Gruppenbericht_2.0.tex 92KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177
  1. % !TeX spellcheck = de_DE
  2. % ---
  3. % Preamble
  4. % ---
  5. \documentclass[12pt]{report}
  6. \usepackage{defaultPreamble}
  7. \bibfilename{Gruppenbericht.bib}
  8. %
  9. % ---
  10. % Document Body
  11. % ---
  12. \begin{document}
  13. \pagenumbering{arabic}
  14. %
  15. % Deckblatt
  16. \setcounter{page}{0} % setze seitenzähler auf 0 -> alle Seitenzahlen <1 werden nicht angezeigt
  17. {\centering
  18. \clear % Select ClearSans for the title page
  19. \vspace*{2\baselineskip}
  20. %
  21. {\large Technische Hochschule}\\
  22. \vspace{0.3ex}
  23. {\large Georg-Simon Ohm Nürnberg}\\
  24. \vspace{0.3ex}
  25. {\large Fakultät Elektrotechnik Feinwerktechnik Informationstechnik}\\
  26. \vspace{2.5ex}
  27. %
  28. {\large Projekt OHM News}\\
  29. \vspace{3.5ex}
  30. %
  31. {\Large\b{Projektstudienarbeit}}\\
  32. \vspace{0.3ex}
  33. {\Large\b{B-ME 5}}\\
  34. \vspace{4.5ex}
  35. {\Large\b{OHM News - See only what matters}}\\
  36. \vspace{3.5ex}
  37. %
  38. {\large Wintersemester 2018/2019}\\
  39. \vspace{10\baselineskip}
  40. %
  41. \begin{table}[h]
  42. \centering \large
  43. \begin{tabular}{rl}
  44. \rule{0pt}{14pt}\b{Senta Mandutz} & \b{Edwina Barbalan} \\
  45. Matrikel-Nr.: 3022812 & Matrikel-Nr.: 3064088 \\
  46. \rule{0pt}{14pt}\b{Vivianne Pham} & \b{Xenia Gr\"unzinger} \\
  47. Matrikel-Nr.: 2928261 & Matrikel-Nr.: 3046080 \\
  48. \rule{0pt}{14pt}\b{Erik R\"ommelt} & \\
  49. Matrikel-Nr.: 2843345 & \\
  50. \end{tabular}
  51. \end{table}
  52. } % Need 1 empty line above for centering
  53. %
  54. \newpage % Seitenumbruch nach Titelblatt
  55. \paragraph{\Large Projekt-Roadmap}$~~$\\
  56. %
  57. \begin{table}[h]
  58. \centering%\small
  59. \begin{tabularx}{\textwidth}{|X|X|X|}
  60. \hline
  61. \rule{0pt}{14pt}\b{Tätigkeit} & \b{Dokument} & \b{Beteiligung} \\
  62. \hline
  63. \rule{0pt}{14pt}Entwicklung & Modaldialog für Login & Xenia, Erik \\
  64. Entwicklung & Einbindung zu Buefy & Xenia, Edwina \\
  65. Entwicklung & Autocompleted Taginput & Xenia, Senta \\
  66. Entwicklung & Frontend Suche & Xenia\\
  67. Entwicklung & Router Komponente & Edwina \\
  68. Entwicklung & Frontend Bookmarks & Edwina \\
  69. Entwicklung & Desktopansicht & Edwina \\
  70. Design und Ausformulierung & Video & Vivianne, Edwina \\
  71. Design und Ausformulierung & PowerPoint Präsentation & Edwina \\
  72. Entwicklung & Frontend Abonnieren (nur Darstellung)& Xenia\\
  73. Gestaltung & Erstellung von Plakaten & Xenia \\
  74. Organisation und Leitung & Projekt Ohm News & Alle \\
  75. Formulierung & Pflichtenheft & Alle \\
  76. Konzeption & Rollengruppen & Alle \\
  77. Dokumentation RESTful API & Digital mit Swagger.io & Erik \\
  78. Entwicklung & RESTful API mit JavaScript & Erik, Senta \\
  79. Entwicklung & Überarbeitung Server-Skripte & Erik \\
  80. Entwicklung & Überarbeitung DB-Skripte & Erik, Senta \\
  81. Entwicklung & Login-Logik mit JavaScript & Erik \\
  82. Entwicklung & Rollenkonzept & Erik \\
  83. Entwicklung & Frontend mit Vue.js, Buefy & Erik, Senta, Xenia, Edwina\\
  84. \rule{0pt}{14pt}Entwicklung & Datenbank mit MongoDB & Senta, Erik \\
  85. \hline
  86. \end{tabularx}
  87. \caption{Projekt-Roadmap Tabelle}
  88. \end{table}
  89. %
  90. % Inhaltsverzeichnis
  91. \newpage
  92. \tableofcontents
  93. %
  94. % Bericht
  95. \newpage % Seitenumbruch nach Titelblatt
  96. \section*{1. Einleitung}
  97. \phantomsection\addcontentsline{toc}{section}{1. Einleitung}
  98. In der heutigten Zeit werden die meisten Menschen tagtäglich mit einer Vielzahl an Reizen und Informationen überflutet. Dabei ist es nicht immer einfach den Blick auf das Wesentliche zu halten. Häufig werden wir durch Werbung, irrelevante Mails, Social Media Beiträge und weiteres schnell abgelenkt. So geht es auch vielen Studierenden und Angehörigen der Technischen Hochschule Nürnberg.\\
  99. Für uns war das Anlass genug. Es sollte doch eine Möglichkeit zur qualitativen Verbesserung der Informationsflut im Studienalltag geben. Auf der einen Seite müssen die Hochschulangehörigen entlastet werden, damit die Konzentration für die relevanten Themen gesteigert werden kann und auf der anderen Seite sollte genügend Freiraum für die individuellen Interessen bestehen.\\
  100. Im Folgenden wird die Entwicklung einer Idee zur Lösung dieser Problematik, über deren Ausarbeitung in Form eines Konzeptes bis hin zur praktischen Entwicklung eines lauffähigen Prototypen detailliert beschrieben.
  101. %
  102. \section*{2. Vorwort zur Projektidee}
  103. \phantomsection\addcontentsline{toc}{section}{2. Vorwort zur Projektidee}
  104. Die erste Konzeptversion zu der Projektidee von dem Projekt ''Ohm Management App'', dass im Verlauf der ersten Projektphase in ''OHM-News - See only what matters'' umbenannt wurde, wurde von Erik Römmelt erstellt. Nach gemeinsamer Überarbeitung durch Prof.Dr. Matthias Hopf, dem zukünftig betreuenden Professor und Erik Römmelt wurde die zu Projektbeginn gegebene Version des Projektkonzeptes ausformuliert.
  105. %
  106. \section*{3. Projektidee}
  107. \phantomsection\addcontentsline{toc}{section}{3. Projektidee}
  108. Die Projektidee basiert darauf, dass eine plattformunabhängige App für Studierende an der TH Nürnberg entwickelt werden soll, die Kurznachrichten filtert und in einem Nachrichtenfeed anzeigt. Das Filtern funktioniert durch Tags. Es können beim Nachrichten erstellen mehrere, jedoch mindestens eine eingegeben werden. Diese werden bei einer Überschneidung bei der Suche durch eine logische UND-Verknüpfung eingeschränkt. Angezeigt werden die Nachrichten abhängig von ihrer Priorität und Aktualität. \\
  109. Dazu können in einer Dateiablage von Professoren und Befugten wichtige Links oder andere Dateien gesammelt werden oder als Referenz darauf verwiesen werden. Damit es den Status ''Befugte'' gibt, muss es zudem eine Rollenverteilung geben, wem welche Rechte zu stehen oder beispielsweise wer nur Nachrichten empfangen kann.
  110. Zudem ist eine Speicherung einzelner Nachrichten aus dem Feed möglich, welche im Nachhinein in den Bookmarks oder auch Lesezeichen einsehbar sind.\\
  111. Des Weiteren können Push-Benachrichtigungen angezeigt werden, sodass das Risiko, wichtige Nachrichten zu übersehen, minimiert wird.
  112. Zuletzt gibt es noch ein Nutzerprofil. Hier können Daten zur Person eingetragen und angezeigt werden wie zum Beispiel das Profilbild, deren Status an der technischen Hochschule oder die Matrikelnummer.
  113. Für den Optimalfall einer Übernahme der App von der Hochschule soll modulorientiert und wartungsaufwandsarm gearbeitet werden, um die spätere Verwaltung zu erleichtern. Auch wird Wert gelegt auf eine nutzerfreundliche und möglichst intuitive Bedienoberfläche.
  114. %
  115. \subsection*{3.1. Technische Umsetzung}
  116. \phantomsection\addcontentsline{toc}{subsection}{3.1. Technische Umsetzung}
  117. Zur Umsetzung des Projektes fiel die Zielsetzung auf die Entwicklung einer progressiven Web-App. Aufgrund ihrer Plattformunabhängigkeit und Kompatibilität mit den TH-Servern (VPN und Eduroam) und laut Erfahrungen von Professor Dr. Hopf stellt dies eine gute Lösung und sichere Wahl dar. Ebenfalls, was die Datenschutzvorkehrungen der Hochschule betrifft. \\
  118. Es werden die Codesprachen HTML, CSS und JavaScript verwendet und als Frameworks Vue.js, Bootstrap und node.js. \\
  119. Als Datenbank dient MongoDB und das zugehörige Framework mongoose.
  120. %
  121. \section*{4. Projektorganisation}
  122. \phantomsection\addcontentsline{toc}{section}{4. Projektorganisation}
  123. Wöchentlich fand ein Treffen, zum Austausch und zur Besprechung zurückliegender und anstehender Aufgaben, statt. An diesem Treffen nahmen in der Regel alle Mitglieder dieser Projektgruppe und der Projektbetreuer Prof.Dr. Matthias Hopf teil. Konnten Teammitglieder, gleich welcher Gründe, an einem Treffen nicht teilnehmen, so haben alle sich unverzüglich über Absprachen und den neu anstehenden Aufgaben selbstständig erkundigt.
  124. %
  125. \subsection*{4.1. Trello}
  126. \phantomsection\addcontentsline{toc}{subsection}{4.1. Trello}
  127. Zu Beginn des Projekts wurde entschieden, dass zur Verbesserung des Arbeitsablaufs ein Organisationstool hilfreich wäre. So fiel ist Trello in Gespräch gekommen.\\
  128. Trello ist ein graphisch sehr gut aufbereitetes Projektmanagement-Tool in Form von Kanban-Boards. In der kostenfreien Version, ist es möglich ''unbegrenzt [viele] Boards, Listen, Karten, Mitglieder, Checklisten und Anhänge'' hinzuzufügen und zu nutzen\cite{trello:price}. Zur typografischen Gestaltung der Karten, um zum Beispiel eine Liste einzufügen ist die Nutzung von einigen Markdown-Markup Elementen möglich.\\
  129. Dem Projekt zugute kommend ist die sehr einfache Bedienbarkeit, Plattform unabhängige Verfügbarkeit, sowie die gute Übersichtlichkeit der Boards. Nachteilig ist, dass es nur sehr eingeschränkt die Zeitkomponente abbilden kann. Dies ist nur über die sogenannten ''Plugins'' möglich, wobei in der kostenfreien Version nur ein Plugin je Board zugleich genutzt werden kann. So kann einem Board entweder die Funktion ''Gantt-Diagramme nutzen'' oder ''Storypoints den Karten hinzufügen'' verwendet werden.\\
  130. Diese Einschränkung führte zur der Entscheidung gegen die Nutzung von Trello im Team.
  131. %
  132. \subsection*{4.2. Bitrix24}
  133. \phantomsection\addcontentsline{toc}{subsection}{4.2. Bitrix24}
  134. Nach dem Ausschluss von Trello begann die Umsicht nach einem anderen Tool, dass kostenfrei mit einer Gruppe von fünf Personen genutzt werden kann. Und es sollte die Funktionen Gantt-Diagramme erstellen, Aufgaben an Mitglieder verteilen und den Gewichtungs-Punkte oder ''Storypoints'' an Aufgaben zuweisen erfüllen.\\
  135. Bitrix24 hat diese Anforderungen erfüllt, war jedoch bereits auf den ersten Blick deutlich unübersichtlicher und komplexer in der Handhabung. Da es sich bei Bitrix24 in erster Linie um ein umfangreiches CRM-System handelt, mit vielen weiteren Funktionen wie ''Aufgabenverwaltung für Gruppen'', ''Projektplanung und -management'' und ''Team-Chat''\cite{bitrix:feature}.\\
  136. Auch nach der Deaktivierung und Ausblendung sämtlicher Funktionen, die die Nutzung von Bitrix24 komplizierter machten, blieb die Benutzeroberfläche noch unübersichtlich. Was die Umsetzung der Aufgaben als Kanban-Karten mit Gewichtungs-Punkten und der zeitlichen Darstellung der Aufgaben in einem Gantt-Diagramm betrifft, so war dies sehr angenehm und vollends zufriedenstellend möglich.\\
  137. So wurden zahlreiche organisatorische Fristen, sowie Aufgaben organisatorischer und entwicklungs-technischer Natur in Bitrix24 erfasst und anschließend in einem wöchentlichen Treffen vorgestellt. Im Weiteren wurde die Nutzung und Pflege des Tools an alle Mitglieder übertragen.\\
  138. Es stellte sich am Ende des ersten Projektabschnittes heraus, dass das Tool Bitrix24 aufgrund der komplexen und unübersichtliche Benutzeroberfläche kaum genutzt wurde.
  139. %
  140. \section*{5. Entwicklerblog}
  141. \phantomsection\addcontentsline{toc}{section}{5. Entwicklerblog}
  142. Die Wiki Blogeinträge in dem hochschulinternen github Repository dienen dazu, die Projektfortschritte transparent zu gestalten und eine kurze prägnante Zusammenfassung für Professoren und Studierende zu gewährleisten. Einzusehen sind die Beiträge auf der git efi Seite \cite{gitefi}.
  143. %
  144. \subsection*{5.1. Protokollierung}
  145. \phantomsection\addcontentsline{toc}{subsection}{5.1. Protokollierung}
  146. Für die Protokollierung wurden in regelmäßigen Intervallen Dokumentationen über die Tätigkeiten aller Teammitglieder geführt und diese folglich in Schrift festgehalten. Enthalten sind die Aufgabenaufteilung und die bisherige Umsetzung aller Projektteilnehmer in einer bestimmten Zeit, welche anschließend gebündelt zusammengefasst wurden.
  147. %
  148. \subsection*{5.2. Blogentwurf}
  149. \phantomsection\addcontentsline{toc}{subsection}{5.2. Blogentwurf}
  150. Da das git efi nicht nur für Professoren sondern auch Studierenden der Fakultät efi zugänglich ist, werden die Vorgänge des Projekts in kurzen Sätzen und möglichst verständlich wiedergegeben. So können sich auch Studierende außerhalb des Fachgebietes ein ungefähres Bild von dem Fortschritt der OHM News-App machen. Nach dem Umformulieren und Reduzieren auf die Kernaussagen wurden Einträge in kontinuierlichen Abständen auf dem Hochschul github\cite{gitefi} zum Abrufen hochgeladen. Diese berufen sich auf etwa ein Monats-Abstände oder kürzer. Bei neuen Einträgen wird Professor Dr. Hopf informiert, sodass er stets den Verlauf des Projektes nachvollziehen kann. In zeitlich chronologischer Reihenfolge aufgelistet, vereinfacht dies den Überblick. Insgesamt wurden im Laufe des OHM News-App Projektes sechs Wiki Blogeinträge erstellt.
  151. %
  152. \section*{6. Pflichtenheft}
  153. \phantomsection\addcontentsline{toc}{section}{6. Pflichtenheft}
  154. Das Pflichtenheft hat die Gruppe gemeinsam zusammengestellt. Dabei sollte der Datenzugriff per MongoDB erzeugt werden, alternativ könnte auch eine Schnittstelle zur Verfügung gestellt werden. Die Grafische UI der PWA sollte einen Login, ein Menü, eine Suche, ein Profil, einen Filter nach Hashtags, ein Dashboard, Einstellungen, das Nachrichtfeld und ein Formular zum Verfassen von Nachrichten umfassen. Ein Abhängigkeitsdiagramm soll erstellt werden. Die Anwendungslogik sollte im Bereich des Routings, der Darstellung und Speicherung von Nachrichten und dem LDAP-Login umgesetzt werden. Codetests sollten durchgeführt werden und das Rollenkonzept der Nutzer sollte festgelegt werden.\\
  155. Des Weiteren sollte ein Anwendungsname gefunden und ein Logo erstellt werden. Ein UX Konzept sollte aufgestellt werden. Wenn es zeitlich noch möglich wäre, hätte man die Funktionen umsetzen sollen um die Datenbankabrufe zu filtern und Kanälen zu folgen. Ebenso hätte man die Anzeigekriterien festlegen können.
  156. %
  157. \section*{7. Konzepterstellung}
  158. \phantomsection\addcontentsline{toc}{section}{7. Konzepterstellung}
  159. Der erste Schritt zur Definition eines Layoutentwurfs war die Erstellung von Scribbles. Unter einem Scribble versteht man einen groben ersten Entwurf, der zur Ideenfindung beitragen soll. Nach Festlegung der grundsätzlichen Projektidee, zeichnete jedes unserer Teammitglieder Scribbles für verschiedene Seiten der App, die wir im Anschluss zusammen diskutierten. Wichtig war uns hierbei, dass jedes Teammitglied erst eigene Ideen entwickelte, um so viele verschiedene Aspekte zu sammeln.\cite{scrib} \\
  160. Wir versuchten alle Ideen zu vereinen und einigten uns auf einen Layoutentwurf, welcher im Anschluss in einem detaillierten Screendesign umgesetzt wurde. In Abbildung \ref{layout} ist das Screendesign für die Startseite zu sehen. Wir legten vor allem den Fokus auf die Startseite, da diese der erste Baustein der App werden sollte. Die Navigation auf die anderen Seiten erfolgt über eine Leiste am unteren Displayrand. Die weiteren Seiten legten wir zu Beginn fest, arbeiteten diese allerdings erst mit der Zeit detaillierter aus. Ein genauer Aufbau der App wird unter 9.1. beschrieben. \\
  161. \begin{figure}[H]
  162. \centering
  163. \includegraphics[width=4.5cm]{../grafiken/Layout}
  164. \caption{Layoutentwurf der Startseite}
  165. \label{layout}
  166. \end{figure}
  167. Bevorstehende Implementierungen von Funktionalitäten sollten, wenn bereits im Vorfeld möglich, ebenfalls in den Layoutentwürfen berücksichtigt werden. Änderungen sind natürlich auch zu einem späteren Zeitpunkt möglich, erhöhen allerdings den Aufwand. Deswegen wurde versucht, möglichst viele Funktionalitäten bereits in die Layoutentwürfe miteinzubeziehen.\\\\
  168. Wir einigten uns im Projektteam darauf die App gemäß den Material Design Richtlinien von Google zu gestalten. Material Design ist eine von Google entwickelte Designvorgabe, die auf materienartigen Flächen basiert und dadurch zu einem sehr minimalistischen \mbox{Design} führt. Ziel dieser Designsprache ist unter anderem eine intuitive Benutzeroberfläche. Die Richtlinien wurden bei der Erstellung des Screendesigns berücksichtigt. \cite{md,md2}
  169. %
  170. \section*{8. Namensfindung}
  171. \phantomsection\addcontentsline{toc}{section}{8. Namensfindung}
  172. Zu Anfang haben wir uns für den Titel OHM-Management entschieden, mit dem Wissen, dass es höchstwahrscheinlich nicht dabei bleibt, da das Wort Management mit unserer angestrebten Funktionalität der App nur einschränkend passte.
  173. Die Verwendung des Wortstammes Kommunikation war für unsere Benennung auch nicht zutreffend, insofern der Austausch von Information nur in eine Richtung erfolgt.
  174. Zusätzlich gestaltete sich die Namensfindung etwas schwierig, da wir sozusagen eine App für die TH-Nürnberg entwickelten, die man auch in Verbindung mit dem OHM-Zeichen kennt. Diesbezüglich wollten wir uns bei der Benennung auch an dieses anlehnen. Um dies tun zu können, mussten wir uns erst einmal informieren, ob es ähnliche Namen bereits gibt die man aus diesem Grund dementsprechend nicht verwenden kann.
  175. %
  176. \subsection*{8.1. Recherche}
  177. \phantomsection\addcontentsline{toc}{subsection}{8.1. Recherche}
  178. Bevor also der erste Schritt in Richtung Namensfindung gemacht werden konnte, recherchierten wir über bereits vorhandene Namen, die von der TH-Nürnberg genutzt werden. Neben Namen wie InfoTHek, OHMdoc und OHM-Shop, welche für unser Thema eher irrelevant wirkten, fanden wir auch den Titel OHM-News. Dies war ein Online Journal, welches jedoch, wie sich später rausgestellt hatte, eingestellt wurde.
  179. %
  180. \subsection*{8.2. Brainstorming}
  181. \phantomsection\addcontentsline{toc}{subsection}{8.2. Brainstorming}
  182. In der Zwischenzeit setzten wir jedoch die Ideensammlung weiter fort und präsentierten in der Gruppe einzelne Namensvorschläge. Hieraus entstand eine Liste an kreativen Gedanken. Unsere Favoriten :
  183. \begin{itemize}
  184. \item \b{ON AIR}
  185. \begin{itemize}
  186. \item \b{O}HM \b{N}ews \b{A}pp for \b{I}nformation and \b{R}ediscovery/\b{R}ecommendations
  187. \item \b{O}HM \b{N}ews Stream for \b{A}ctivities, \b{I}nformation and \b{R}ecommendations
  188. \end{itemize}
  189. %
  190. \item \b{ON STREAM}
  191. %
  192. \begin{itemize}
  193. \item \b{O}HM \b{N}ews \b{Stream}
  194. \end{itemize}
  195. %
  196. \item \b{OHM News}
  197. %
  198. \item \b{TH i s}
  199. %
  200. \item \b{INFOhm}
  201. \end{itemize}
  202. Alle Vorschläge waren sehr durchdacht und kreativ. Jedoch hatten einige nicht ganz die Wirkung die wir uns erhofften, denn wir waren der Meinung, dass man das Wort On Air eher mit einem Radiosender verbindet. Ebenfalls der Nachteil bei der Idee On Stream war es, dass man stark an Streaming Dienste wie zum Beispiel Netflix erinnert wird.
  203. %
  204. \subsection*{8.3. Ergebnis}
  205. \phantomsection\addcontentsline{toc}{subsection}{8.3. Ergebnis}
  206. Nach langem Überlegen kamen wir auf den Namen OHM News zurück und dieser überzeugte uns im Endeffekt alle. Dieser Titel war recht kurz, er ist leicht zu verstehen ohne viel nachzudenken, man verbindet ihn auf Anhieb mit der TH-Nürnberg auf Grund des Wortes OHM und er verweist auf die Funktionalität die unsere App bereitstellt, die da wären Neuigkeiten, sprich News, für die Studenten der Hochschule bereitzustellen.
  207. %
  208. \subsection*{8.4. Claim}
  209. \phantomsection\addcontentsline{toc}{subsection}{8.4. Claim}
  210. Parallel zur Namensfindung, befassten wir uns auch mit dem Claim unseres Produktes. Da ein Claim die Funktion unserer App auf den Punkt bringen soll, und dabei kurz, leicht zu merken und aussagekräftig sein sollte, entschieden wir uns für eine Formulierung der Art ''nur relevante Themen werden angezeigt''. Nach einer kurzen Denkphase kamen wir auf den Claim ''See only what matters'', beziehungsweise ''Only see what matters'' vor. Dies kam bei uns allen sehr gut an, jedoch wussten wir nicht, welche von den beiden Optionen die erhoffte Bedeutung am besten hervorbringt. Sie haben zwar die selbe Bedeutung, trotz alle dem empfanden wir, dass die Betonung des Wortes „Only“ auf zwei verschiedene Faktoren des Satzes liegt. Nach reichlicher Überlegung entschieden wir uns also für die Formulierung ''See only what matters'' als Claim für unsere App.
  211. %
  212. \section*{9. Corporate Design}
  213. \phantomsection\addcontentsline{toc}{section}{9. Corporate Design}
  214. Um das ganze Konzept stimmig zu gestalten, wurde ein Corporate Design erstellt.
  215. Wichtigste Grundlage hierfür ist das Farbkonzept. Da die App im Hochschulrahmen verwendet werden soll, wurde für die Grundfarbe der Blauton des Hochschullogos gewählt, umso eine Zugehörigkeit zu symbolisieren. Ergänzend zu diesem Blauton werden noch zwei dezente Grautöne verwendet, wie in Abbildung \ref{farbschema} zu sehen ist. \\
  216. %
  217. \begin{figure}[H]
  218. \centering
  219. \includegraphics[width=12cm]{../grafiken/Farbschema_CD}
  220. \caption{Farbkonzept}
  221. \label{farbschema}
  222. \end{figure}
  223. \noindent
  224. Auch ein Logo ist wichtig, um einen gewissen wiedererkennungswert für die App zu schaffen. Da wir uns in der Gruppe für den App-Namen ''Ohm-News'' entschieden haben, war der erster Gedanke eine Zeitung für das Logo herzunehmen (siehe Abbildung \ref{logo1}). Die Grafik war allerdings schwierig in das Produkt einzubinden, weil sie sehr detailreich ist. \\
  225. %
  226. \begin{figure}[H]
  227. \centering
  228. \includegraphics[width=4cm]{../grafiken/Logo1_CD}
  229. \caption{Erster Logoentwurf}
  230. \label{logo1}
  231. \end{figure}
  232. \noindent Ein zweiter etwas minimalistischer Entwurf ist in Abbildung \ref{logo2} zu sehen, für welchen sich das Projektteam schlussendlich auch entschied. Es zeigt ein Globussymbol mit dem Hochschullogo im Zentrum, um auch hier wieder die Verbindung zur Hochschule schaffen. \\
  233. %
  234. \begin{figure}[H]
  235. \centering
  236. \includegraphics[width=4cm]{../grafiken/Logo2_CD}
  237. \caption{Finales Logo}
  238. \label{logo2}
  239. \end{figure}
  240. %
  241. \noindent Das Logo wurde dann auch zu einem App Icon erweitert. In Abbildung \ref{icons} ist das Icon für Android sowie IOS Geräte zu sehen. Das Android Icon wurde analog den Material-Design Richtlinien gestaltet und besitzt deshalb einen leichten Schatten. Bei dem IOS Icon wurde das Logo lediglich auf einen einfarbigen Hintergrund gesetzt. \\
  242. %
  243. \begin{figure}[H]
  244. \centering
  245. \includegraphics[width=10cm]{../grafiken/Icons_CD}
  246. \caption{App Icons}
  247. \label{icons}
  248. \end{figure}
  249. %
  250. \section*{10. Erstellung der Mockups}
  251. \phantomsection\addcontentsline{toc}{section}{10. Erstellung der Mockups}
  252. Auf Basis des Screendesigns wurden erste Mockups erstellt, welche mittels HTML und CSS umgesetzt wurden. Um die Elemente entsprechend den Material-Design Richtlinien zu gestalten, wurde das CSS-Framework Bootstrap mit eingebunden, das eine Auswahl an vordefinierten Gestaltungselementen und Stilen in Form von CSS-Stylesheets bereitstellt. Dazu gehören Elemente wie Buttons, Formulare, Navigationszeilen und viele mehr. Wir verwendeten Bootstrap Dateien, die auf Material Design abgestimmt sind. So wird ein einheitliches Design gewährleistet und die Styles müssen nicht selbst erstellt werden. Ein weitere Vorteil von Bootstrap, ist, dass es ein responsives Webdesign unterstützt und man deshalb plattformunabhängig entwickeln kann. Dafür sorgt ein Grid-Layout, welches den Benutzerbildschirm in 12 Spalten teilt und die Elemente, je nach verfügbarer Auflösung, anzeigt. Im ersten Projektabschnitt legten wir den Fokus besonders auf eine mobile Ansicht. Eine Desktopansicht wird ebenfalls unterstüzt, kann allerdings noch stark optimiert werden. \cite{bootstrap} \\
  253. Durch die Ergänzung von eigenen CSS-Dateien konnten Änderungen an den vordefinierten Stilen vorgenommen werden. Sowohl unsere als auch die von Bootstrap bereitgestellten Dateien, wurden auf Grundlage von Less-Stylesheets erstellt. Dabei wird auf effiziente Weise CSS generiert. Variablen sowie Funktionen sind möglich und Vererbung wird durch \mbox{verschachtelte} Selektoren dargestellt. \cite{less} \\
  254. Wir habe für jeden Menüpunkt eine HTML-Seite erstellt, welche im Unterpunkt genauer beschrieben werden.
  255. \subsection{Buefy}
  256. Bei der Gestaltung von Weboberflächen verwendet man in der Regel ein CSS-Framework. Im ersten Projektabschnitt haben wir uns für das Framework Bootstrap entschieden, \mbox{das} eine Umsetzung entsprechend der Material Design Richtlinien ermöglicht. Es stellt auch JavaScript-Erweiterungen, wie z.B. Modale,
  257. bereit, welche allerdings nicht konkret auf das, in der App verwendete, JavaScript-Framework Vue.js abgestimmt sind. Deswegen \mbox{entschieden} wir uns ein alternatives, konkret für Vue.js konzipierte, Css-Framework zu verwenden. Der Vorteil darin besteht, dass es neben vordefinierten Styles ebenfalls Oberflächen Komponenten für Vue bereitstellt.
  258. Die Wahl fiel auf Buefy, das auf dem Framework Bulma \mbox{basiert}.\\
  259. Die Einbindung von Buefy erforderte zunächst eine Anpassung aller bereits bestehenden Komponenten, da Bootstrap und Buefy zum Teil gleiche Klassennamen verwenden und somit nicht zusammen genutzt werden können. In diesem Zug habe wir uns von Material-Design losgelöst und dessen Richtlinien in der Gestaltung nur noch zum Teil berücksichtigt.
  260. In den weiteren Gliederungspunkten werden einige Komponenten von Buefy näher \mbox{erläutert}.
  261. Um unseren Code einfacher und kompakter zu halten, standen wir vorerst vor der Entscheidung welches Open-Source-Tool wir verwenden wollen. Anfangs war unsere Aufmerksamkeit auf das Material-Framework „Vuetify“ gerichtet. Das Ziel dessen ist es, den Nutzern alles zur Verfügung zu stellen, was zum Aufbau umfangreicher und ansprechender Webanwendungen erforderlich ist mit der Verwendung von Material Design-Spezifikationen und Vue \textsuperscript{1}. Letztendlich entschieden wir uns jedoch dazu Buefy zu verwenden. Die Vorteile liegen hierbei darin, dass man es vollständig oder als einzelne Komponenten auf einer normalen Webseite importieren und Vue.js als Ersatz für jQuery verwenden kann \textsuperscript{2}.
  262. %
  263. \section*{10.1. Aufbau der App}
  264. \phantomsection\addcontentsline{toc}{subsection}{10.1. Aufbau der App}
  265. %
  266. \begin{figure}[H]
  267. \begin{minipage}[t]{5cm}
  268. \vspace{0pt}
  269. \centering
  270. \includegraphics[width=4cm]{../grafiken/Homescreen_MU}
  271. \caption{Startseite}
  272. \label{abbildung_homescreen}
  273. \end{minipage}
  274. \hfill
  275. \begin{minipage}[t]{11cm}
  276. \vspace{0pt}
  277. Auf der Startseite der App gelangt der Nutzer als erstes auf einen Newsfeed. Der Newsfeed besteht aus einzelnen Nachrichten in Form von Karten und soll für jeden Nutzer nur \mbox{relevante} Nachrichten anzeigen. Jede Nachricht besitzt einen oder \mbox{mehrere} Tags. Eine Nachricht wird für einen Nutzer als relevant eingestuft, wenn dieser mindestens einen Tag aus der Nachricht abonniert hat. Somit erhält jeder Nutzer eine individuelle Startseite. Zusätzlich befindet sich auf der Nachrichtenkarte oben rechts ein Icon, welches die Nachricht zu einer Fakultät zuordnet. Unten rechts kann das Lesezeichen-Icon geklickt werden, um eine Nachricht zu speichern. Auf diese Weise können die Studierenden wichtige Informationen schnell wiederfinden.\\\\
  278. Im Header ist die Suche zu finden, in der Tags explizit gefiltert werden können. Der \mbox{Header} ist von jeder Seite aus zugängig. Im Footer befindet sich die Navigationszeile, von wo aus der Nutzer auf die weiteren Seiten gelangt.
  279. \end{minipage}
  280. \end{figure}
  281. %
  282. \begin{figure}[H]
  283. \begin{minipage}[t]{5cm}
  284. \vspace{0pt}
  285. \centering
  286. \includegraphics[width=5cm]{../grafiken/Links_MU}
  287. \caption{Infoseite}
  288. \label{abbildung_infoseite}
  289. \end{minipage}
  290. \hfill
  291. \begin{minipage}[t]{11cm}
  292. \vspace{0pt}
  293. Der zweiten Menüpunkt, der durch ein Globus-Icon dargestellt wird, soll eine Informationsseite beinhalten. Das Konzept hierfür ist allerdings noch nicht konkret ausgearbeitet, da wir uns zuerst auf die Mitteilungsfunktionen konzentrieren wollten. Aktuell wird ein Empty State angezeigt.\\
  294. Dieser Menüpunkt wurde im zweiten Projektabschnitt zu einer erweiterten Suche.
  295. \end{minipage}
  296. \end{figure}
  297. %
  298. \medskip
  299. \begin{figure}[H]
  300. \begin{minipage}[t]{5cm}
  301. \vspace{0pt}
  302. \centering
  303. \includegraphics[width=5cm]{../grafiken/CreateMessage_MU}
  304. \caption{Formular}
  305. \label{abbildung_createmsg}
  306. \end{minipage}
  307. \hfill
  308. \begin{minipage}[t]{10cm}
  309. \vspace{0pt}
  310. Über das Plus-Icon, in der Mitte der Navigationszeile, gelangt man zu einem Formular. Hier können neue Nachrichten erstellt werden. Nachrichten sollen nur von ausgewählten Nutzergruppen, wie Fakultäten, Studienbüro und ähnlichen gesendet werden können.
  311. Für eine Nachricht wird ein Betreff, mindestens ein Tag und der Nachrichteninhalt benötigt. Es soll eine Auswahl an vordefinierten Tags geben, damit am Ende nicht jeder Verfasser wahllos Tags setzten kann und \mbox{Duplikate} vermieden werden. Dieser Menüpunkt ist der einzige in dem keine Navigationszeile angezeigt wird. Nach Absenden einer Nachricht, gelangt man zurück auf die Startseite. Über den Button 'Abbrechen' wird man auf den vorherigen Menüpunkt zurückgeleitet.
  312. \end{minipage}
  313. \end{figure}
  314. %
  315. \begin{figure}[H]
  316. \begin{minipage}[t]{5cm}
  317. \vspace{0pt}
  318. \centering
  319. \includegraphics[width=5cm]{../grafiken/Gespeicherte_MU}
  320. \caption{Gespeicherte}
  321. \label{abbildung_gespeichert}
  322. \end{minipage}
  323. \hfill
  324. \begin{minipage}[t]{11cm}
  325. \vspace{0pt}
  326. Der nächste Menüpunkt wird über das Lesezeichen-Icon erreicht und zeigt die gespeicherten Nachrichten an. Diese Seite ist ähnlich aufgebaut wie der Newsfeed der Startseite, beinhaltet allerdings nur die vom Nutzer gespeicherten Nachrichten.
  327. \end{minipage}
  328. \end{figure}
  329. %
  330. \medskip
  331. \begin{figure}[H]
  332. \begin{minipage}[t]{5cm}
  333. \vspace{0pt}
  334. \centering
  335. \includegraphics[width=5cm]{../grafiken/Profil_MU}
  336. \caption{Profil}
  337. \label{abbildung_profil}
  338. \end{minipage}
  339. \hfill
  340. \begin{minipage}[t]{11cm}
  341. \vspace{0pt}
  342. Der letzte Menüpunkt ist das Profil. \\
  343. Oben sieht man zuerst das Profilbild, hier verwendeten wir die runde Form anstatt der üblichen Quadratischen. Darunter sieht man dann die im Vorfeld angegebene Information des Benutzers. Am Ende der sogenannten Karte befinden sich zwei Knöpfe, die Anzeigen wie vielen Kanälen man folgt und wie viele Beiträge man bis jetzt gespeichert hat. Auf der Karte rechts oben im Eck findet man den Bearbeitungs-Knopf, in Form eines kleinen Stiftes, dies ermöglicht dem Benutzer, die Seite gemäß seinen Wünschen anzupassen.\\
  344. Die Profilkarte an sich blieb relativ gleich, was sich im zweiten Projektabschnitt geändert hat war das bearbeiten des Modals, welches sich öffnet, wenn man sich die Abonnierten Kanäle anzeigen lassen will. Dazu klickt man hierfür auf einen „b-button“ welches daraufhin ein „b-modal“ öffnet. Dort werden alle abonnierten Elemente aufgelistet. Sobald man auf den „Gespeichert“-Button klickt, wird man mittels router.push auf die Bookmark-Seite geleitet, auf der man alle gespeicherten Nachrichten findet.
  345. \end{minipage}
  346. \end{figure}
  347. %
  348. \section*{11. Single-Page Entwicklung}
  349. \phantomsection\addcontentsline{toc}{section}{11. Single-Page Entwicklung}
  350. Neben klassischen Webanwendungen gibt es ebenfalls Single-Page Webanwendungen. Bei klassischen Webapplikationen gibt es mehrere untereinander verlinkte HTML-Dokumente, die dann gemeinsam eine komplette Anwendung ausmachen. Der Nachteil hierbei ist, dass die Seite beim Wechsel durch die erneute Kommunikation mit dem Server neu heruntergeladen werden muss. SPA’s jedoch bestehen nur aus einer HTML-Datei. Dies bewirkt, dass neue oder veränderte Daten dynamisch geladen werden und somit die Kommunikation zwischen Server und Client verringert wird. Es ermöglicht dem Benutzer, nach dem einmaligen laden der Seite, diese auch weiterhin im offline Modus zu steuern. Sollte also die Interaktion mit dem Server unterbrochen werden, werden die zwischengespeicherten Daten einfach aus dem Webbrowser verwendet.\cite{spa:1}\cite{spa:2}
  351. %
  352. \subsection*{11.1. Warum Vue.js?}
  353. \phantomsection\addcontentsline{toc}{subsection}{11.1. Warum Vue.js?}
  354. Neben dem Vue.js Framework gibt es noch weitere wie zum Beispiel react.js, angular.js, meteor.js und viele mehr. Warum wir uns jedoch für das Vue.js Framework entschieden haben, werden wir Ihnen nun erläutern. Vue.js das jüngste von den drei größten Frameworks, es hat jedoch den Vorteil, dass es aus den Fehlern der Vorgänger lernen konnte und diese schon im Vorfeld überdenken und ausmerzen konnte. Da es auf Sprachen wie HTML, CSS und JavaScript aufbaut, lässt es sich problemlos in schon bestehende Projekte einbauen.
  355. Die Syntax ist hierbei, im Vergleich zu anderen, besser lesbar. Hierfür werden nämlich sogenannte ''Single File Components'' verwendet.\cite{vue:warum} Sogenannte Komponenten sind wiederverwendbare Vue-Instanzen mit einem Namen, die als benutzerdefiniertes Element in einer Vue-Stamminstanz verwendet werden. Wie so eine erstellte Komponente aussieht, werden wir Ihnen im folgenden erörtern.
  356. %
  357. \subsection*{11.2. Vue.js in vorhandene Mockups einbinden}
  358. \phantomsection\addcontentsline{toc}{subsection}{11.2. Vue.js in vorhandene Mockups einbinden}
  359. Nach reichlicher Recherche und dem einlesen in das uns vorher unbekannte Framework, war es an der Zeit unsere HTML-Seiten in Vue-Komponenten umzuwandern. Wir setzten uns erstmal zusammen und erstellten die Startseite.
  360. Im Folgenden wird der Aufbau der Home-Komponente näher erläutert. In Listing 1 ist der dazugehörige Quellcode zu sehen. Nicht enthalten sind zur Komponente zugehörige Methoden. Die Home-Komponente wird in unserem Projekt als HomeRouter betitelt.
  361. %
  362. \begin{center}
  363. \begin{lstlisting}[caption={HomeRouter-Komponente},captionpos=b]
  364. const HomeRouter = {
  365. template: `
  366. <div id="om-msg-cards">
  367. <MsgCard
  368. v-for="id in messagelist.slice().reverse()"
  369. :key="id"
  370. :msg="messages[id] || {}"
  371. ></MsgCard>
  372. </div>`,
  373. //Restliche Komponente
  374. ...
  375. \end{lstlisting}
  376. \end{center}
  377. %
  378. Im Newsfeed, welcher der Hauptbestand der Startseite ist, wird eine Liste von Nachrichten dynamisch generiert, sodass jeder Nutzer später einmal eine individuelle Ansicht erhält, abhängig von den Tags, die dieser abonniert. \\
  379. Jede Komponente besitzt ein Template in Form eines Strings, welcher HTML-Code \mbox{beinhaltet}. Die Komponente HomeRouter ist verschachtelt und enthält die Komponente MsgCard. Der Quellcode für diese Komponete ist in Listing 2 zu sehen.
  380. %
  381. \begin{center}
  382. \begin{lstlisting}[caption={MsgCard-Komponente},captionpos=b]
  383. Vue.component('MsgCard', {
  384. template: `<div class="om-card card">
  385. <h6 class="msg-head">
  386. <b>{{ msg.subject }}</b>
  387. <img src="favicon.ico" width=20px height=20px>
  388. </h6>
  389. {{ msg.message }}<br><br>
  390. <a href="#">{{ msg.tag }}</a></p>
  391. <div class="om-card-footer"> <div class="om-user-line">
  392. <i class="material-icons">account_circle</i>
  393. Erstellt von {{ msg.user }}</div>
  394. <i class="material-icons">bookmark_border</i>
  395. </div></div>`,
  396. props: ['msg']
  397. });
  398. \end{lstlisting}
  399. \end{center}
  400. %
  401. Eine MsgCard stellt eine einzelne Nachricht in Form einer Karte dar. In der HomeRouter-Komponete geht eine For-Schleife alle vorhandenen Nachrichten-Ids durch. Dabei werden der MsgCard-Komponente alle relevanten Informationen übergeben, die für eine Darstellung benötig wird. Am Ende stellt die App eine fortlaufende Liste mit allen Nachrichten dar.\\\\
  402. Da wir nun ein bisschen geübter im Umgang mit Vue waren, teilten wir uns die restlichen Seiten auf. Dabei gingen wir ähnlich vor, wie bei der Home-Komponente.
  403. %
  404. \subsection*{11.3. Routing}
  405. \phantomsection\addcontentsline{toc}{subsection}{11.3. Routing}
  406. Vue.js bietet eine Reihe von Funktionen, mit denen Sie wiederverwendbare Webkomponenten erstellen können. Routing ist eine dieser Methoden. Der Benutzer kann somit zwischen den Seiten wechseln, ohne diese erneut zu aktualisieren. Dies ermöglicht dem Benutzer eine einfache und dynamische Navigation durch die Webanwendung. Wir werden Ihnen nun, anhand unseres Codes erklären, wie ein Vue.js-Router funktioniert.\cite{vue:router} \\
  407. Zunächst richten wir hierfür die Navigation über die Navigationsbar ein, die wir mittels einem Router-Link-Element erstellt haben. Dieser gibt an, auf welche der angegebenen JS-Datei zugegriffen wird sobald man auf das ausgewählte Item klickt.
  408. %
  409. \begin{center}
  410. \begin{lstlisting}[caption={Navbar},captionpos=b]
  411. <nav class="nav nav-tabs nav-justified om-nav" v-if="$route.path !=='/createMessage' ">
  412. <router-link to="/home" class="nav-item nav-link">
  413. <i class="material-icons">home</i></router-link>
  414. <router-link to="/files" class="nav-item nav-link">
  415. <i class="material-icons">language</i></router-link>
  416. <router-link to="/createMessage" class="nav-item nav-link outlined">
  417. <i class="material-icons">add_circle</i></router-link>
  418. <router-link to="/bookmark" class="nav-item nav-link">
  419. <i class="material-icons">bookmark</i></router-link>
  420. <router-link to="/profil" class="nav-item nav-link">
  421. <i class="material-icons">person</i></router-link>
  422. </nav>
  423. \end{lstlisting}
  424. \end{center}
  425. %
  426. Im Folgenden werden Komponenten definiert und dann in ein neues Array von Objekten, so genannte Routen, eingefügt. Zu beachten ist die Zuordnung eines URL-Pfads zu der dazugehörigen Komponente. Daraufhin wird ein Vue-Router definiert, der an ein neues Vue-Objekt übergeben wird. Wenn nun beispielsweise ''/home'' geladen ist, wird die Home-Komponente in der Router-Ansicht gerendert und aufgerufen. Die erste Zeile mit dem ''/'' steht für die Startseite, auf die man gelangt, sobald man die App öffnet.\cite{vue:router3} \\
  427. %
  428. \begin{center}
  429. \begin{lstlisting}[caption={Routing},captionpos=b]
  430. const routes = [
  431. { path: "/", component: HomeRouter },
  432. { path: "/home", component: HomeRouter },
  433. { path: "/files", component: FileRouter },
  434. { path: "/createMessage", component: CreateMsgRouter },
  435. { path: "/bookmark", component: BookmarkRouter },
  436. { path: "/profil", component: ProfilRouter },
  437. ];
  438. const router = new VueRouter({
  439. routes
  440. });
  441. var app = new Vue({
  442. router,
  443. el: '#api',
  444. methods: {
  445. ...
  446. },
  447. });
  448. \end{lstlisting}
  449. \end{center}
  450. Zu Anfang entschieden wir uns dafür, das Routing auf die index.html Seite zu setzen. Nun jedoch waren wir der Meinung, dass es besser wäre diese in eine eigene Komponente einzubinden.
  451. Komponenten sind wiederverwendbare Vue-Instanzen mit einem Namen, in diesem Fall „nav-router“. Wir können diese Komponente nun als benutzerdefiniertes Element in einer mit new Vue erstellten Root-Vue-Instanz verwenden, welches auf der index.html Seite liegt.
  452. \begin{center}
  453. \begin{figure}[H]
  454. \centering
  455. \includegraphics[width=8cm] {../grafiken/Navbar_2.png}
  456. \caption{Navigationsbar}
  457. \label{abbildung_2}
  458. \end{figure}
  459. \end{center}
  460. Nun konnten wir die Navigationsleiste einfacher bearbeiten. Die erste Herausforderung war es, den aktiven Router-Link dementsprechend hervorzuheben. Hierfür gibt es die buefy.css Datei, in der man derartige Änderungen vornehmen kann. Es wird nun beim Verwenden der App geschaut, welcher Link momentan aktiv ist. Dieser wird dann in einer etwas dunkleren Farbe und mit einer Kante am unteren Rand der Navigationsleiste markiert.
  461. %
  462. \section*{12. Service Worker}
  463. \phantomsection\addcontentsline{toc}{section}{12. Service Worker}
  464. Der ServiceWorker ist eine JavaScript Datei, die üblicherweise im root-Verzeichnis der Webanwendung liegt. Für die Funktionsweise ist die Namensgebung der Datei nicht maßgebend. Damit der ServiceWorker überhaupt funktionieren kann, wird eine SSL-Verbindung benötigt. Ist eine sicher Verbindung gegeben, kann der ServiceWorker (im Weiteren auch mit ''SW'' abgekürzt) nach erfolgreichem Laden der Webseite im Browser des Clients registriert werden. Nachdem der SW zeitlich unabhängig, also asynchron im Browser läuft, muss bei der Entwicklung und Umsetzung des ServiceWorker-Codes darauf geachtet werden, dass in Promises geschrieben wird. Da Promises ein wenig schwieriger nachzuvollziehen sind und insbesondere das Problem der sogenannten Callback-Hell nicht lösen, bietet es dich an den SW in Async/Await Struktur zu schreiben. Diese basiert auf dem asynchronen Prinzip der Promises und lässt sich dennoch lesen wie synchrone Funktionen.\\
  465. Zunächst wird der ServiceWorker, nach dem vollständigen Laden der Webanwendung, versuchen sich im Browser des Clients zu registrieren. Schlägt die Registrierung fehl, ist dies ein Anzeichen dafür, dass der genutzte Browser keine ServiceWorker unterstützt. Es folgen zwei Code Umsetzungen, beide dienen der Registrierung:\\
  466. %
  467. \begin{center}
  468. \begin{lstlisting}[caption={Register, Promise/Then-Codestruktur},captionpos=b]
  469. /* Promise / Then */
  470. if ('serviceWorker' in navigator) {
  471. window.addEventListener('load', function() {
  472. navigator.serviceWorker.register('/serviceWorker.js').then(function(registration) {
  473. // Registration was successful
  474. }, function(err) {
  475. // registration failed
  476. });
  477. });
  478. }
  479. \end{lstlisting}
  480. \end{center}
  481. %
  482. \begin{center}
  483. \begin{lstlisting}[caption={Register, Async/Await-Codestruktur},captionpos=b]
  484. /* Async / Await */
  485. const registerServiceWorker = async () => {
  486. try {
  487. const registration = await navigator.serviceWorker.register('/serviceWorker.js', {scope: '/'});
  488. // Registration successful
  489. } catch (err) {
  490. // Registration failed
  491. }
  492. return;
  493. }
  494. if ('serviceWorker' in navigator) {
  495. window.addEventListener('load', registerServiceWorker());
  496. }
  497. \end{lstlisting}
  498. \end{center}
  499. %
  500. Einmal in der Promise.then Schreibweise und einmal in der Async/Await Schreibweise.\\
  501. Nach erfolgreicher Registrierung, folgt das ServiceWorker Event Installation. Dabei wird eine neue ServiceWorker Version im Browser angelegt und ein Abbild der festgelegten Dateien, hier als Beispiel nur die ''index.html'' (siehe filesToCache), im sogenannten ''Local Storage'' mittels Cache-Managements (auch Cache API genannt) gespeichert. Diese beiden Code Blöcke zeigen den Install-Vorgang:
  502. %
  503. \begin{center}
  504. \begin{lstlisting}[caption={Install, Promise/Then-Codestruktur},captionpos=b]
  505. /* Promise / Then */
  506. const cacheName = 'appname-v1-0';
  507. const filesToCache = [ '/index.html' ];
  508. self.addEventListener('install', function(event) {
  509. console.log('[ServiceWorker] Install');
  510. event.waitUntil(
  511. caches.open(cacheName).then(function(cache) {
  512. console.log('[ServiceWorker] Caching app shell');
  513. return cache.addAll(filesToCache);
  514. })
  515. );
  516. });
  517. \end{lstlisting}
  518. \end{center}
  519. %
  520. \begin{center}
  521. \begin{lstlisting}[caption={Install, Async/Await-Codestruktur},captionpos=b]
  522. /* Async / Await */
  523. const installNewCache = async (event) => {
  524. const cacheName = 'appname-v1-0';
  525. const filesToCache = [ '/index.html' ];
  526. const cacheStatic = await caches.open(cacheName);
  527. cacheStatic.addAll(filesToCache);
  528. console.log('[ServiceWorker] Cache static files.');
  529. return;
  530. }
  531. self.addEventListener('install', event => {
  532. // don't wait
  533. self.skipWaiting();
  534. // cache static files
  535. event.waitUntil(installNewCache());
  536. console.log('[ServiceWorker] Install');
  537. });
  538. \end{lstlisting}
  539. \end{center}
  540. %
  541. Anschließend folgt die Aktivierung. Hier wird aufgeräumt und zwar die alten ServiceWorker Versionen. Es sollte immer nur eine ServiceWorker Version je Webanwendung im Browser registriert und installiert sein.
  542. %
  543. \begin{center}
  544. \begin{lstlisting}[caption={Activate, Promise/Then-Codestruktur},captionpos=b]
  545. /* Promise / Then */
  546. self.addEventListener('activate', function(event) {
  547. // ServiceWorker activated
  548. event.waitUntil(
  549. caches.keys().then(function(cacheKeyList) {
  550. return Promise.all(
  551. cacheKeyList.map(function(cacheKeyList) {
  552. if (cacheWhitelist.indexOf(cacheKeyList) === -1) {
  553. // Old Cache removed
  554. return caches.delete(cacheKeyList);
  555. }
  556. })
  557. );
  558. })
  559. );
  560. return self.clients.claim();
  561. });
  562. \end{lstlisting}
  563. \end{center}
  564. %
  565. \begin{center}
  566. \begin{lstlisting}[caption={Activate, Async/Await-Codestruktur},captionpos=b]
  567. /* Async / Await */
  568. const cacheCleanUp = async () => {
  569. const cacheKeyList = await caches.keys();
  570. const deletions = cacheKeyList
  571. .filter(key => key.startsWith(appPrefix) && !cacheKeyList.includes(key))
  572. .map(key => {
  573. caches.delete(key)
  574. // Old Cache removed
  575. });
  576. for (const success of deletions) {
  577. await success;
  578. }
  579. return;
  580. }
  581. self.addEventListener('activate', event => {
  582. event.waitUntil(cacheCleanUp());
  583. clients.claim();
  584. // ServiceWorker activated
  585. });
  586. \end{lstlisting}
  587. \end{center}
  588. %
  589. Als letzter Schritt bleibt nur noch der 'fetch'. Das ist jenes Event in dem der ServiceWorker neue, aktuelle Dateien aus dem Netzwerk bezieht und die Dateiversionen im Cache, lokalen Speicher aktualisiert. Hier gibt es verschiedene Vorgehensweisen. Wir haben uns entschieden, das der ServiceWorker nur jene API GET-Anfragen speichern soll. Dies dient der Vermeidung doppelter und korrupter Datensätze. Im Weiteren soll überprüft werden, ob die angefragten Dateien mit den gespeicherten Dateien übereinstimmt. Falls nicht, gibt es keine gespeicherten Daten und eine Netzwerkanfrage wird zwingend benötigt. Andernfalls zeige die gespeicherten Daten an und tätige anschließend eine Anfrage ans Netzwerk. Wenn aktuellere Daten aus dem Netzwerk empfangen werden, so aktualisiere die gespeicherten Dateien und zeige die aktuelleren Daten an. Zusätzlich wird noch ein wenig der Ursprung der Anfrage überprüft.
  590. %
  591. \begin{center}
  592. \begin{lstlisting}[caption={Fetch, Promise/Then-Codestruktur},captionpos=b]
  593. /* Promise / Then */
  594. self.addEventListener('fetch', function(event) {
  595. /* We should only cache GET requests */
  596. if (event.request.method !== 'GET') {
  597. /* If we don't block the event as shown below,
  598. then the request will go to the network as usual. */
  599. console.log('[ServiceWorker] Fetch event ignored.',
  600. event.request.method, event.request.url);
  601. return;
  602. }
  603. event.respondWith(
  604. caches.match(event.request)
  605. .then(function(response) {
  606. return fetch(event.request)
  607. .then(function(response) {
  608. // Check if response is valid, status is 200, response type is basic
  609. // (indicates request is from origin, means that requests to third party
  610. // assets aren't cached as well.
  611. if(!response || response.status !== 200 || response.type !== 'basic') {
  612. return response;
  613. }
  614. caches.open(CACHE_NAME)
  615. .then(function(cache) {
  616. // We have to clone the response here because request bodies can only
  617. // be read once. Placing a response in the cache counts as a read.
  618. cache.put(event.request, response.clone());
  619. });
  620. // Cache hit - return response
  621. if (response) return response;
  622. return response;
  623. });
  624. })
  625. .catch(function(err) {
  626. // Report a lack of connectivity to the user.
  627. });
  628. });
  629. \end{lstlisting}
  630. \end{center}
  631. %
  632. \begin{center}
  633. \begin{lstlisting}[caption={Fetch, Async/Await-Codestruktur},captionpos=b]
  634. /* Async / Await */
  635. self.addEventListener('fetch', event => {
  636. /* We should only cache GET requests */
  637. if (event.request.method !== 'GET') {
  638. /* If we don't block the event as shown below,
  639. then the request will go to the network as usual. */
  640. console.log('[ServiceWorker] Fetch event ignored.',
  641. event.request.method, event.request.url);
  642. return;
  643. }
  644. event.respondWith(async function update() {
  645. try {
  646. var requestURL = new URL(event.request.url);
  647. // Start the network request as soon as possible.
  648. const networkPromise = fetch(requestURL);
  649. const cachedResponse = await caches.match(event.request);
  650. const networkResponse = await networkPromise;
  651. // Check if response is valid, status is 200, response type is basic
  652. // (indicates request is from origin, means that requests to third party
  653. // assets aren't cached as well.
  654. if (!networkResponse || networkResponse.status !== 200
  655. || networkResponse.type !== 'basic') return networkResponse;
  656. const cache = await caches.open(staticCacheKey);
  657. // We have to clone the response here because request bodies can only
  658. // be read once. Placing a response in the cache counts as a read.
  659. cache.put(event.request, networkResponse.clone());
  660. if (cachedResponse) return cachedResponse;
  661. // ServiceWorker fetch
  662. return networkResponse;
  663. } catch (err) {
  664. // Report a lack of connectivity to the user.
  665. }
  666. }());
  667. });
  668. \end{lstlisting}
  669. \end{center}
  670. %
  671. Die Bildausschnitte mit dem Code wurden teils von mir erstellt, teils stammen diese von dieser Internetseite\cite{dev:codeSource}\cite{sw:cacheThenNetwork}.
  672. %
  673. \pagebreak
  674. \section*{13. ''Add-To-Homescreen''-Funktion}
  675. \phantomsection\addcontentsline{toc}{section}{13. ''Add-To-Homescreen''-Funktion}
  676. Für die Implementierung der ''Add-to-Homescreen''-Funktionalität sind für Android, iOS und die diversen Browser unterschiedliche Schritte nötig.\\
  677. Bei Android genügt es eine manifest.json Datei im root-Verzeichnis der App abzulegen. Diese Manifest-Datei enthält Meta-Informationen von App-Icon, über App-Name, über die Start-URL bis hin zu der Theme-Farbe für den Hintergrund des App-Icons oder dem Navigationsmenü im Browser. Wenn ein Nutzer im Abstand von 5 Minuten (Standard-Einstellung) die Webseite zweimalig aufruft, so wird dieser gefragt, ob er die App zum Homescreen hinzufügen möchte. Ab da kann er diese über das App-Icon als auch über den Browser starten.\\
  678. Für iOS müssen die Meta-Informationen im Bereich des Head-Elements, der index.html eingefügt werden. So wird dort das Aussehen von mehreren App-Icon Versionen definiert. Dies wird benötigt, da die meisten Apple-Geräte unterschiedliche Density (Pixel per Inch) haben. Des Weiteren werden Konfigurationseinstellungen aktiviert oder deaktiviert, als auch das Aussehen des Ladescreens für iOS Geräte festgelegt.\\
  679. Auch die Windows-Mobilgeräte muss in der index.html Datei im Head-Bereich mittels Meta-Informationen mitgeteilt werden, wie der Ladebildschirm oder das Appicon aussehen soll (vgl.\cite{dev:homescreen}).
  680. %
  681. \section{Desktopansicht}
  682. Da unsere Anwendung eine Progressive Web App ist, ist ein Aspekt davon, dass man diese sowohl auf dem Smartphone und Tablett als auch am Computer oder Laptop mit dem Internetbrowser verwenden kann. Da es jedoch nicht üblich ist die App Ansicht im Browser zu benutzen, musste die Anwendung überarbeitet werden. Demzufolge wurde je nach verwendetem Gerät und Größe die Ansicht angepasst und dementsprechend verändert.
  683. \subsection{Bulma Elemente}
  684. Um dies umsetzen zu können, wurden Elemente von Bulma verwendet. Bulma ist ein freies und Open-Source Frontend-CSS-Framework, welches auf Flexbox basiert \textsuperscript{3}. HTML und CSS basierende, gestalterische Vorlagen werden hierfür benutzt um zum Beispiel Formulare, Buttons, Navigations- und andere Oberflächengestaltungselemente zu erzeugen.
  685. Um nun die Desktopansicht anzupassen, werden dem notwendigen Inhalt der verschiedenen Seiten Klassen gegeben, sogenannte „Column Sizes“ (Spaltengrößen). Sobald die Fenstergröße ein bestimmtes Maß erreicht hat, wird entschieden welche Ansicht angezeigt wird. \\
  686. \lstset{
  687. basicstyle=\ttfamily,
  688. columns=fullflexible,
  689. frame=single,
  690. breaklines=true,
  691. postbreak=\mbox{\textcolor{red}{$\hookrightarrow$}\space},
  692. }
  693. \begin{lstlisting}
  694. const ProfilRouter = {
  695. template: `
  696. <div>
  697. <div class="column pull-right-sm is-four-fifths-desktop">
  698. ...
  699. </div>
  700. \end{lstlisting}
  701. Es wird also veranlasst, dass der Inhalt ab der Mindestgröße des Desktops nur noch auf vier Fünftel der Browserbreite angezeigt wird und zusätzlich auf die rechte Seite geschoben wird. Solange die Breite unter dem Mindestmaß bleibt, also alles bis zur Desktopgröße wie zum Beispiel das Tablet oder Smartphone-Format, wird nichts am Inhalt geändert.
  702. \subsection{Navigationsleiste wird zum Menü}
  703. Die meisten Apps besitzen für gewöhnlich eine Navigationsleiste, die das schnelle und unkomplizierte Erreichen der Seiten ermöglicht. Diese liegt teilweise unten am Bildschirm, da man dort am schnellsten mit dem Finger hinkommt. Deswegen bauten wir unsere App auch dementsprechend auf. Wenn man jedoch nun auf die Desktopversion umsteigt, wirkt diese Variante weder praktisch noch optisch anregend. Aufgrund dessen entschieden wir uns für die Verwendung einer einfachen Auflistung der Navigationselemente in Form eines Menüs auf der linken Seite. Somit hat man immer noch den schnellstmöglichen und direkten Zugriff auf die verschiedenen Seiten und man verläuft sich nicht in lästigen „Sackgassen“.
  704. \begin{center}
  705. \begin{figure}[H]
  706. \centering
  707. \includegraphics[width=17cm] {../grafiken/Desktopansicht.png}
  708. \caption{App-Ansicht vs. Desktopansicht}
  709. \label{abbildung_4}
  710. \end{figure}
  711. \end{center}
  712. Um die Navigationsleiste umzustellen, wurden zum Teil sogenannte „Responsive Helpers“ verwendet. Zunächst wurde der Inhalt der Navigations-Komponente teilweise dupliziert und im Anschluss personalisiert. Dem ersten Element wird die Klasse „is-hidden-desktop“ gegeben und somit wird ausgesagt, dass es während der Appansicht sozusagen versteckt wird. Beim zweiten Element ist es die Klasse „is-hidden-touch“, also alles ab der Tabletgröße abwärts wird nicht auf der Desktopansicht zu sehen sein. Ebenfalls wird aus der „navbar“ ein „menu“ mit einer Liste (menu-list), in der die Router-Links aufgelistet sind. Ein weiteres Extra sind hier die Beschriftungen der jeweiligen Seiten, für die in der Navigationsleiste unten in der Appansicht kein Platz war.
  713. Und so sieht nun die fertige Navigations-Komponente in Form von Code aus: \\
  714. \lstset{
  715. basicstyle=\ttfamily,
  716. columns=fullflexible,
  717. frame=single,
  718. breaklines=true,
  719. postbreak=\mbox{\textcolor{red}{$\hookrightarrow$}\space},
  720. }
  721. \begin{lstlisting}
  722. Vue.component('nav-router', {
  723. template: ` <div>
  724. <nav class="navbar is-fixed-bottom is-expanded is-primary is-hidden-desktop}" role="navigation" aria-label="main navigation">
  725. <div class="navbar-brand is-expanded is-light">
  726. <router-link to="/home" class="navbar-item is-primary is-expanded has-text-centered is-hidden-desktop">
  727. <i class="material-icons">home</i>
  728. </router-link>
  729. ...
  730. </nav>
  731. <div class="is-fullheight">
  732. <div class="column is-sidebar-menu is-hidden-touch">
  733. <aside class="menu is-medium">
  734. <ul class="menu-list">
  735. <li><router-link to="/home">
  736. <i class="material-icons">home</i> Home
  737. </router-link></li>
  738. ...
  739. </ul>
  740. </aside>
  741. </div>
  742. </div>
  743. </div>`,
  744. \end{lstlisting}
  745. \section*{14. Erstellung der API-Schnittstelle}
  746. \phantomsection\addcontentsline{toc}{section}{14. Erstellung der API-Schnittstelle}
  747. Nachdem Server und die Clientseite der PWA funktionsfähig waren, war es noch relevant, dass zwischen diesen beiden kommuniziert werden kann. Dafür verwendet man die API.\cite{api} API steht für ''Application Programming Interface'' und diese Programmierschnittstelle kann wie in diesem Projekt zum Zugriff auf die Datenbank verwendet werden. Dabei handelt es sich in diesem Fall um einen RESTful Webservice.\cite{rest} \\
  748. %
  749. \begin{figure}[H]
  750. \centering
  751. \includegraphics[width=0.3\textwidth]{../grafiken/ajax.png}
  752. \caption{Ajax Modell einer Webanwendung. Quelle: nach Haischt, Daniel; https://de.wikipedia.org/wiki/Ajax\_(Programmierung)\#/media/File:Ajax-vergleich.svg}
  753. \label{ajax}
  754. \end{figure}
  755. %
  756. \noindent Das asynchrone Datenübertragungskonzept AJAX wurde zur Kommunikation zwischen Browser und Server verwendet.\cite{ajax1} \cite{ajax2} \cite{ajax3} Dabei werden wie in Abbildung \ref{ajax} zu sehen ist HTTP Requests von dem Browser an den Server geschickt. Diese werden daraufhin von dem Server verarbeitet und es werden entweder Daten zurückgegeben oder ein HTTP Response mit einer Rückmeldung. Mit der Verwendung von AJAX hat man einige Vorteile, zum Beispiel, dass man die Seite nicht neu laden muss, damit die neuen Inhalte erscheinen und dass der Browser bereits weiter Requests schicken kann, ohne auf die Responses des Servers warten zu müssen. Da die gesamte PWA des Projekts in JavaScript geschrieben ist, ist es zudem vorteilhaft, dass die AJAX-Engine in JavaScript geschrieben wird. Die Daten aus der Datenbank werden im JSON-Format transportiert.\\
  757. \\
  758. Um die Funktionsweise einer derartigen Schnittstelle zu verstehen, wurde der Code einer PWA die Professor Matthias Hopf geschrieben und der Gruppe zur Verfügung gestellt hat, analysiert. Dieser war jedoch etwas zu komplex für einen Einsteiger in das Thema. Deswegen wurde auf simplere Beispiele in Tutorials zurückgegriffen. Diese Beispiele konnten nun auf das eigene Projekt übertragen und getestet werden. Nach einer ausführlichen Erläuterung durch Professor Hopf anhand eines Beispiels im Projektzusammenhang, war ein grundsätzliches Verständnis über die Schnittstelle vorhanden. Nun konnte die konkrete Umsetzung der API beginnen.\\
  759. Die erste Methode die umgesetzt wurde war ''list\_messages''. Diese zeigt nun alle Nachrichten der Datenbank auf der Startseite der PWA an. Dazu musste zuerst vom Server die IDs aller Nachrichten abgefragt werden. Man schreibt eine API Funktion, die ein GET Request an den Server schickt. Dieser sucht nach den IDs per find Anfrage in der Datenbank und antwortet mit einem HTTP Response, der das Array mit den IDs enthält. Auf der Client Seite wird nun für jede ID per GET Request alle Informationen der Nachricht angefragt. Der Server sucht die gefragten Information und schickt diese zurück mit dem dazugehörigen Nachrichtentext an den Browser.\\
  760. %
  761. \begin{center}
  762. \begin{lstlisting}[caption={''list\_messages''-Methode},captionpos=b]
  763. list_messages: function () {
  764. $.ajax({url: "api/ids", method: "GET"})
  765. .done(jd => {
  766. _messagelist.splice(0, _messagelist.length);
  767. _messagelist.push.apply(_messagelist, jd);
  768. console.log("jd: "+jd);
  769. for (var e in jd) {
  770. if (!_messages[jd[e]]) {
  771. get_insert_message(jd[e]);
  772. }
  773. }
  774. }).fail(function (e, f, g) {
  775. console.log("err: " + e + f + g);
  776. });
  777. }
  778. \end{lstlisting}
  779. \end{center}
  780. %
  781. Was für Vorgänge beim Senden einer Nachricht in einer API getätigt werden, ist im Folgenden aufgeführt. Hierfür muss die Mongodb heruntergeladen und angebunden sein.\\
  782. In der Server.js Datei wird durch die ''App.post''-Methode eine Nachricht erstellt. Dabei wird in ''createMsg'' die Funktion aufgerufen, in einen String umgewandelt und die Nachricht anschließend in der Datenbank gespeichert. Mit der POST-Methode können Nachrichten in die Datenbank gespeichert werden und anhand von einer GET-Methode angezeigt werden.\\
  783. Nun müssen in der createMsg.js alle Werte einsetzbar gestaltet werden. Wichtig dabei ist, sich an das vorgegebene Mongo Schema zu halten. Durch die ajax-Methode ''post'' können große Datenmengen an den Server geschickt werden. Zuletzt soll die Konsole auch einen Error anzeigen, falls der Abruf der Funktion erfolglos war. \\
  784. In Abbildung \ref{sys} kann man diese Vorgänge nachverfolgen. Diese beiden Funktionen haben am Ende funktioniert und können zusammen verwendet werden. \\
  785. \begin{figure}[H]
  786. \centering
  787. \includegraphics[width=0.7\textwidth]{../grafiken/system.png}
  788. \caption{Erstellen einer Nachricht und Anzeigen aller Nachrichten}
  789. \label{sys}
  790. \end{figure}
  791. %
  792. \section*{15. Aufsetzung des Servers}
  793. \phantomsection\addcontentsline{toc}{section}{15. Aufsetzung des Servers}
  794. Zunächst muss ein http port eingerichtet werden. Über einen lokalen Server über node.js ist die Ohm News-App abrufbar. Mit der createServer Methode
  795. %
  796. \begin{center}
  797. \begin{lstlisting}[caption={''list\_messages''-Methode},captionpos=b]
  798. http.createServer(app).listen(http_port, function () {
  799. console.log("Express http server listening on port " + http_port);
  800. });
  801. \end{lstlisting}
  802. \end{center}
  803. %
  804. lässt sich ein Server aufsetzen. Hier wird auch der Listener für den Port impliziert und auf der Konsole ausgegeben, wenn die Verbindung erfolgreich war. \\
  805. Um die wichtigsten Fehlermeldungen und Bugs auszugeben, wird für unsere node.js App der Logger ''Morgan'' verwendet. Zusätzlich wird eine try-catch Funktion eingeordnet, da Zertifikat und Schlüssel noch nicht zertifiziert sind (siehe SSL und Keys) und somit vorerst ein Fehler angezeigt wird.
  806. %
  807. \subsection*{15.1. SSL und Keys}
  808. \phantomsection\addcontentsline{toc}{subsection}{15.1. SSL und Keys}
  809. Um die Applikation für die Nutzer sicher zu gestalten und eine Verschlüsselung sensibler Daten zu gewährleisten, sorgt ein SSL(Secure Socket Layer). Dadurch wird ein sicherer Kanal zwischen Web-Server und Client bereitgestellt und aus der http- wird eine https-Verbindung.
  810. \setlength{\parindent}{0cm}
  811. Übergangsweise werden ein selbst verifizierter Schlüssel und Zertifikat erstellt, welche später durch echte ausgetauscht werden. In einem neu erstellten Ordner ''keys'' werden das Zertifikat und der Schlüssel platziert.
  812. %
  813. \section*{16. Datenbankanbindung}
  814. \phantomsection\addcontentsline{toc}{section}{16. Datenbankanbindung}
  815. Für diese Anwendung wird eine Datenbank benötigt, weil die geschriebenen Nachrichten gespeichert werden müssen. Später sollen auch User mit ihren Userinformationen gespeichert werden. Im Falle dieses Projekts wurde sich für eine MongoDB entschieden.\\
  816. MongoDB ist eine dokumentenorientierte NoSQL Datenbank. Diese ist für diese Anwendung sinnvoll, da sie im Vergleich zu SQL Datenbanken flexibler handhabbar ist und somit auch viele Einstellungen noch im Nachhinein geändert werden können.\cite{mongo} \\
  817. Um den Umgang mit MongoDB zu vereinfachen wurde Mongoose, eine Object Data Modeling Bibliothek, verwendet.\cite{mongoose} \\
  818. Da man zu Beginn des Projekts noch nicht mit NoSQL Datenbanken gearbeitet hatte, mussten zuerst Tutorials und Erklärungen gelesen werden. Anhand von Beispieltests mit einer lokalen Datenbank konnte die grundsätzliche Funktionsweise bald verstanden werden. Daraufhin wurde das grobe Schema für eine Nachricht aufgebaut. Eine Nachricht sollte einen Betreff, eine Nachricht, den schreibenden User und die Tags beinhalten wie man in Listing \ref{lst:json} an einer beispielhaften JSON-Datei sehen kann. Die Datenbank musste konfiguriert und gestartet werden.
  819. %
  820. \begin{center}
  821. \lstset{language=xml}
  822. \begin{lstlisting}[caption={Nachricht im JSON-Format},captionpos=b,label=lst:json]
  823. {
  824. "messages": [{
  825. "subject": "Test"
  826. "message": "Hallo Welt!"
  827. "tag": "#OHM_News"
  828. "user": "User1"
  829. }]
  830. }
  831. \end{lstlisting}
  832. \lstsetdefault
  833. \end{center}
  834. %
  835. Die serverseitigen Codeteile zur API und der Code für die Datenbank sind momentan zur Vereinfachung in der server.js Datei. Später sollen diese zur Übersichtbarkeit und Wartbarkeit ausgelagert werden. Das Schema für die Nachricht und die Konfiguration der Datenbank sind zu diesem Zweck bereits in eigenen js-Dateien zu finden.\\
  836. Sobald all das lokal funktioniert hat, wurde die Portierung auf einen Server der Hochschule vorgenommen.\\
  837. In dem zweiten Abschnitt unseres Projekts sollten zusätzliche Funktionen wie das Suchen nach Tags und das Einloggen umgesetzt werden. Dafür musste der bisherige Aufbau der Datenbank erweitert und abgeändert werden. Die dafür benötigten Schemata wurden in der neu erstellten db.js Datei definiert.
  838. Um nach Tags suchen zu können wurde eine Collection in der Datenbank benötigt, die alle verwendbaren Tags beinhaltet. Folglich musste ein Schema für die Daten in dieser Collection erstellt werden. Dieses Schema legt fest, dass jedes gespeicherte Tag zwingend einen Namen benötigt. Da dieser eindeutig also unique ist, sollte das für die Identifikation bei der Suche genügen. \\
  839. Um das Rollenkonzept und die Login-Funktion umsetzen zu können, musste eine weitere Collection in der Datenbank erstellt werden. Jeder Hochschulangehörige soll sich in der Anwendung anmelden können und es sollten die wichtigsten Daten zu dem jeweiligen Benutzer in der User Collection gespeichert oder aktualisiert werden. Dabei wurde vorgesehen, dass eine ID zur Identifikation und als Primärschlüssel erstellt wird. Informationen wie Name, Emailadresse, Typ (Art von Nutzer z.B.: author, admin), Geschlecht, Rollen (Bereiche, die für den Nutzer erlaubt sind), Passwort, sowie Hash und Salt des angemeldeten Nutzers sollten wie in Abbildung \ref{fig:pic2} zu sehen ist in der Datenbank hinterlegt werden. Zusätzlich wurde im User Schema die Session-ID, ein Array an ID von allen vom Nutzer gespeicherten Nachrichten und ein Array an vom Nutzer abonnierten Tags angelegt.
  840. \begin{figure}[h]
  841. \centering
  842. \includegraphics[width=0.85\textwidth]{../grafiken/pr2}
  843. \caption{User im JSON-Format, Quelle: eigene Darstellung}
  844. \label{fig:pic2}
  845. \end{figure}
  846. \subsection{Erstellen der Test-Datenbank}
  847. Um die neuen Funktionen beim Erstellen gut testen zu können, war es aus dem und anderen Gründen (schneller, einfacher, zuverlässiger) eine lokale Test-Datenbank zu erstellen. Damit nicht jedes Gruppenmitglied eine solche Datenbank selbst erstellen und befüllen musste, wurde ein Skript geschrieben, das diese beiden Funktionen übernehmen sollte.\\
  848. Das in mong.js gespeichert Skript wechselt zu der Datenbank namens „omdb“ oder legt, falls sie noch nicht existiert diese an. Als erster Schritt werden nun alle Collections und deren Inhalte aus der Datenbank mit Hilfe der 'deleteMany()'-Funktion gelöscht, damit die Testdaten nicht mehrfach gespeichert werden. Daraufhin werden drei weitere Skripte für die jeweiligen Collections geladen.\\
  849. Das erste Skript namens mong\_msg.js beinhaltet acht Bespielnachrichten, die in Betreff, Nachricht, Nutzer und Tags mit Platzhaltertexten befüllt sind.
  850. In mong\_tag.js werden elf Beispieltags in die Tag-Collection eingefügt. Diese werden später benötigt, um die Autocomplete-Funktion in der Suche und der Nachrichtenerstellung testen zu können.
  851. Als drittes muss nach die User-Collection befüllt werden, um die Login-Funktion testen zu können. Dazu werden zwei Beispielnutzer erstellt. Der Erste bekommt den Namen „Test Author“ und soll einen Nutzer mit Schreiberlaubnis darstellen. Der Zweite mit dem Namen „Test Admin“ soll Administrationsaufgaben übernehmen können. \\
  852. Die Daten werden jeweils mit 'insert()' in die Collections geschrieben, wodurch die Collections falls sie noch nicht existieren erstellt werden. In Abbildung \ref{fig:pic3} ist zu sehen wie eine Nachricht aus der Testdatenbank aussieht.
  853. \begin{figure}[h]
  854. \centering
  855. \includegraphics[width=\textwidth]{../grafiken/pr3}
  856. \caption{Nachricht mit Text aus Testdatenbank, Quelle: eigene Darstellung}
  857. \label{fig:pic3}
  858. \end{figure}
  859. \subsection{Autocomplete-Funktion}
  860. Wenn in der Anwendung eine Nachricht erstellt werden soll, kann der Nutzer Tags zu der Nachricht hinzufügen. Um nicht zu viele oder zu viele ähnliche Tags setzen zu können, war vorgesehen, dass nur eine bestimmte Liste an Tags verwendet werden kann, die von dem Administrator verwaltet werden kann. Diese Tags sind in der Tag-Collection der Datenbank gespeichert. Nun soll bei der Nachrichtenerstellung im Eingabefeld für die Tags eine Autocomplete-Funktion eingefügt werden, die die Tags aus der Datenbank als Auswahl lädt. \\
  861. Dazu muss vorerst das globale Array data mit den Tags befüllt werden. Dafür wird die Methode 'list\_tags()' aufgerufen, die mittels AJAX-Aufruf die IDs aller Tags aus der Datenbank abfragt und als Array zurückschickt. Durch dieses Array wird daraufhin iteriert. Die IDs werden anschließend an die globale Funktion 'get\_insert\_tag(id)' übergeben. Dort holt ein AJAX-Aufruf mit der jeweiligen Tag-ID den Namen aus der Datenbank und lädt (push) diesen auf das data-Array.\\
  862. Wenn nun der Nutzer eine Eingabe in das Tag-Feld tätigt, wird die 'filteredDataArray()'-Methode aufgerufen. Diese durchsucht nun das data-Array mit der 'filter()'-Funktion nach dem eingegebenen Wort und gibt dieses an das Autocomplete-Input-Feld von Buefy [1] zurück. Dort werden die gefilterten Daten aus dem Array wie in Abbildung \ref{fig:pic4} zu sehen ist unter dem Eingabefeld angezeigt.
  863. \begin{figure}[h]
  864. \centering
  865. \includegraphics[width=0.75\textwidth]{../grafiken/pr4}
  866. \caption{Autocomplete-Funktion, Quelle: eigene Darstellung}
  867. \label{fig:pic4}
  868. \end{figure}
  869. \section{Suche}
  870. \subsection{Frontend der Suchfunktion}
  871. Eine der zentralen Funktionen von Ohm-News ist das Suche von Nachrichten. Auf diese Weise ist es für Studierende möglich Informationen schnell zu finden. Eine Möglichkeit der Suche bietet das Suchfeld im Header, welches von jeder Seite aus zugänglich ist. Es handelt sich hierbei um eine Freitextsuche. \
  872. Um die Eingabe zu erleichtern werden Tags über die Autocomplete Komponente von Buefy vorgeschlagen (vgl. Listing 3). Diese Komponente weist gewisse Ähnlichkeiten zu der Taginput Komponente auf und verwendet ebenfalls die Methode filteredDataArray( ) (vgl. S.8, Listing 2). Bei Bestätigung der Sucheingabe wird die Methode search( ) aufgerufen.
  873. \begin{lstlisting}[caption=Template zur search Komponente]
  874. Vue.component('search',{
  875. template: `
  876. <form class="om-searchbar" @submit.prevent="search()">
  877. <b-field>
  878. <b-autocomplete
  879. v-model="searchtext"
  880. :data="filteredDataArray"
  881. @keydown.native.enter="search"
  882. placeholder="suche..."
  883. icon="magnify"
  884. @select="option => selected = option">
  885. </b-autocomplete>
  886. <button class="clearButton" @click="clear">x</button>
  887. </b-field>
  888. </form>`,
  889. \end{lstlisting}
  890. Sobald die Suche gestartet wird, wird die globale Variable ''\_isSearchActive'' auf true gesetzt. Die Suchergebnisse werden auf gleiche Weise wie die Nachrichten auf der Startseite geladen. Der Server schickt eine Liste der Message-Ids zu allen Suchergebnissen. Im Anschluss werden die einzelnen Nachrichten zu den entsprechenden Ids angefordert und in msgCard Komponenten dargestellt. \newpage Die Ergebnisseite unterscheidet sich optisch von der Startseite durch einen Link oben links, der die Suche beendet und zurück zur Startseite navigiert (siehe Abbildung 3)\\
  891. \begin{center}
  892. \begin{figure}[H]
  893. \centering
  894. \includegraphics[width=6cm]{../grafiken/3}
  895. \caption{Darstellung der Suchergebnise}
  896. \label{Abbildung 3}
  897. \end{figure}
  898. \end{center}
  899. Möchte der Nutzer konkret nach einem bestimmten Bestandteil einer Nachricht, wie dem Betreff oder einem Tag filtern, kann die erweiterte Suche verwendet werden (siehe Ab-bildung 4). Diese ist in der Navigationszeile als Menüpunkt zu finden und läuft parallel zu der Suche im Header. In einem Dropdown Menü kann die Art der Suche ausgewählt werden. Daraufhin wird das entsprechende Eingabefeld dargestellt. Die Freie Suche entspricht der Suche im Header und filtert aus allen Bestandteilen der Nachricht. Die Suche nach Betreff, Nachrichtentext, Tags oder User sollte Ergebnisse zu den entsprechenden Nachrichtenfeldern liefern, konnte allerdings aus Zeitgründen nicht mehr im Backend umgesetzt werden. Bei der Suche nach Tags wird wie im Header die Autokomplete-Komponente verwendet. Die Ergebnisse, werden, anders wie bei der Suche im Header, auf der Menüseite unter dem Formular angezeigt.\\
  900. \begin{center}
  901. \begin{figure}[H]
  902. \centering
  903. \includegraphics[width=6cm]{../grafiken/4}
  904. \caption{Erweiterte Suche}
  905. \label{Abbildung 4}
  906. \end{figure}
  907. \end{center}
  908. \subsection{Backend der Suchfunktion}
  909. Im Header der Anwendung befindet sich ein Eingabefeld für Suchanfragen. Die Idee war, dass der Nutzer hier die Nachrichten im Dashboard nach bestimmten Suchbegriffen filtern kann. Dazu sollte sowohl eine freie Suche als auch eine Suche nach den vorgegebenen Tags implementiert werden. Für die Tag-Suche wurde die bereits erklärte Autocomplete-Funktion verwendet.
  910. \subsubsection{Allgemein: Text Index}
  911. Um die Text Suche in der MongoDB verwenden zu können, muss man einen Text Index für die zu durchsuchende Collection erstellen. Eine Collection kann jedoch nur einen Text Index haben. Mit der 'createIndex()'-Funktion kann man eines oder mehrere Felder als Text Index setzen. Wenn man eine Collection, die einen Text Index besitzt, mit dem \$text-Operator durchsucht, bekommt man die gefilterten Datensätze, die den Suchbegriff im Text Index haben. Dabei wird mit einer logischen Oder-Verknüpfung zwischen den durch Leerzeichen und Satzzeichen getrennt Worte des Suchbegriffs gesucht. [2] [3]
  912. \subsubsection{Einfache Suche}
  913. Die Suchfunktion in der Anwendung ist mit dem vorhandenen Eingabefeld im Header verknüpft. In der search.js-Datei befindet sich du dazugehörige Vue-Komponente. In dem Autocomplete-Feld von Buefy wird wie bei der Tageingabe beim Nachrichten erstellen die 'filteredDataArray()'-Methode aufgerufen, um die Tags aus der Datenbank als Vorschläge angezeigt zu bekommen. Zusätzlich soll nun durch den @keydown.native.enter-Event beim Drücken der Eingabe-Taste die Methode 'search()' aufgerufen werden. In dieser Methode wird ein AJAX-Aufruf gestartet, der mittels GET-Methode den Inhalt des Eingabefelds an den Server schickt. Dort wird mit diesem Mongoose-Aufruf die Datenbank durchsucht:\\
  914. \\
  915. model.Messages.find(\{\\
  916. \begingroup
  917. \leftskip4em
  918. \$text: \{\\
  919. \endgroup
  920. \begingroup
  921. \leftskip4em
  922. \$search: \\req.params.phrase\\
  923. \endgroup
  924. \begingroup
  925. \rightskip4em
  926. \}\\
  927. \endgroup
  928. \begingroup
  929. \rightskip4em
  930. \})\\
  931. \endgroup
  932. \\
  933. In der Collection Messages wird nach dem Text Index gesucht der den Suchbegriff („phrase“) beinhaltet, die über AJAX übergeben wurde, also die Sucheingabe ist. Damit bei dieser Datenbankabfrage etwas gefunden werden kann, muss dem Schema der Messages-Collection der passende Text Index angefügt werden. Dafür setzt mit der Wildcard „\$**“ alle Felder der Nachricht als Text Index:\\
  934. \begin{center} messageSchema.index({ "\$**": 'text' });\\ \end{center}
  935. Sobald die Suchergebnisse in der Datenbank gefunden wurden, werden die IDs der jeweiligen Nachrichten zurück an die 'search()'-Methode geschickt. Die gefilterten IDs werden nun wie bei der Erstellung des Dashboards durchiteriert. Für jede ID wird die globale Funktion \\'get\_insert\_message(id)' aufgerufen. Dort wird ein AJAX-Aufruf gestartet, der die gesamte Nachricht zu der jeweiligen ID aus der Datenbank zurückerhält und diese daraufhin im Dashboard anzeigt.
  936. \subsubsection{Erweiterte Suche}
  937. Da die Router-Komponente File nicht wie ursprünglich geplant als Dateiablage umgesetzt wurde, sollte an dieser Stelle dem Nutzer die Möglichkeit gegeben werden eine ausführlichere Suche durchzuführen. Hier befindet sich auf der Benutzeroberfläche wie in Abbildung \ref{fig:pic5} zu sehen ist ein Drop-Down-Menü mit dem der Nutzer zwischen den verschiedenen Suchformen wechseln kann. Dabei kann man zwischen den folgenden Suchoptionen wählen: freie Suche, Suche nach einem bestimmten Betreff, Tags, Nachrichteninhalten oder Autoren. Unter dem Auswahlmenü befindet sich das Eingabefeld für den gesuchten Begriff. Aus zeitlichen Gründen konnte an dieser Stelle nur testweise die Suche nach bestimmten Tags umgesetzt werden. Die Schwierigkeit dabei war, in der Datenbank nur einzelne Felder zu durchsuchen, da der zuvor erklärte Text Index in der Collection Messages auf alle Felder zugewiesen war und somit keine separate Suche umgesetzt werden konnte. Eine Umsetzungsmöglichkeit wäre die Nutzung einer weiteren Suchfunktion. Die bisher implementierte Suche bei den Tags entspricht von der Logik her der einfachen Suche und durchsucht alle Felder der Nachricht. Das Suchergebnis wird daraufhin direkt unter der Suchanfrage angezeigt.
  938. \begin{figure}[h]
  939. \centering
  940. \includegraphics[width=0.5\textwidth]{../grafiken/pr5}
  941. \caption{Benutzeroberfläche für die erweiterte Suche, Quelle: eigene Darstellung}
  942. \label{fig:pic5}
  943. \end{figure}
  944. \section{Nachrichten speichern}
  945. \subsection{Frontend für das Speichern von Nachrichten}
  946. Eines unserer Hauptfeatures ist zum einen das Speichern von Nachrichten. Diese Funktion hat den Vorteil, dass der Nutzer zu jeder Zeit einen Überblick über seine Nachrichten hat und diese auch persönlich ordnen kann, um zu vermeiden, dass man lange nach Nachrichten suchen muss. Um dies zu tun, wird auf das dafür vorgesehene Icon geklickt, welches sich mit dem Klick ändert, und zwar zu einem gefüllten Icon. Und so würde der Switch aussehen.
  947. \begin{figure}[h]
  948. \centering
  949. \includegraphics[width=0.75\textwidth]{../grafiken/Bookmark.png}
  950. \caption{Lesezeichen-Icon (nicht gespeichert/ gespeichert), Quelle: eigene Darstellung}
  951. \label{fig:pic6}
  952. \end{figure}
  953. \begin{lstlisting}
  954. Vue.component('MsgCard', {
  955. template: ` <div class="om-card card">
  956. ...
  957. <i id="bookmark-not-active" class="material-icons" :key="isActive" @click="myFilter(msg._id)" v-if="!isActive">bookmark_border</i>
  958. <i id="bookmark-active" class="material-icons" :key="isActive" @click="myFilter(msg._id)" v-else>bookmark</i>
  959. ...
  960. \end{lstlisting}
  961. \subsection{Backend für das Speichern von Nachrichten}
  962. Der Nutzer sollte wichtige Nachrichten speichern können, um sie zu einem späteren Zeitpunkt schnell und einfach finden zu können. Jede Nachricht im Dashboard hat in der rechten oberen Ecke ein Lesezeichen-Symbol. Beim Klicken auf dieses wird die zugehörige Nachricht gespeichert und kann in der Router-Komponente bookmark aufgerufen werden. \\
  963. In der Vue-Komponente msgCard der Anwendung gibt es ein Lesezeichen-Icon, das unausgefüllt ist und durch Anklicken wie in Abbildung \ref{fig:pic6} dargestellt ausgefüllt wird. Dazu wird mit @click die 'myFilter(Id)'-Methode aufgerufen. In dieser Methode wird über den booleschen Wert 'isActive' abgefragt ob diese Nachricht bereits gespeichert wurde. Falls sie bereits gespeichert ist, wird die ID der Nachricht aus dem globalen Array auth.bookmarks, das alle Lesezeichen des angemeldeten Nutzers aus der Datenbank beinhaltet, gelöscht. Zusätzlich wird der 'isActive'-Wert auf false gesetzt. Wenn die Nachricht noch nicht gespeichert wurde, wird die jeweilige ID in auth.bookmarks gespeichert und 'isActive' auf true gesetzt.\\
  964. \begin{lstlisting}
  965. data: function () {
  966. return {
  967. isActive: false,
  968. };
  969. },
  970. methods: {
  971. myFilter: function() {
  972. this.isActive = !this.isActive;
  973. },
  974. }
  975. });
  976. \end{lstlisting}
  977. In der BookmarkRouter-Komponente sollen nun alle Nachrichten, die von dem Nutzer gespeichert wurde, angezeigt werden. Dazu wird wie in home.js das MsgCard-Template geladen. Beim Laden der Nachrichten wird nun für jede im auth.bookmarks Array befindende ID die \\'get\_insert\_message(id)'-Funktion aufgerufen. Dabei werden per AJAX-Aufruf die IDs an den Server geschickt, um die gesamte Nachricht aus der Datenbank zu erhalten. Diese Nachrichten werden dann auf der Lesezeichen-Seite angezeigt.\\
  978. Damit das Lesezeichen-Icon beim Neuladen einer Seite oder beim Wechseln zwischen den Tabs die richtige Farbe (ausgefüllt/ unausgefüllt) hat, musste beim Laden der Nachrichten überprüft werden, ob die Nachricht bereits gespeichert ist. Dazu wurde das auth.bookmarks Array auf die Nachricht-ID untersucht und, falls vorhanden der Icon ausgefüllt. \\
  979. Aus zeitlichen Gründen konnte das auth.bookmarks Array nicht mit der Datenbank synchronisiert werden. Deshalb wurde beim Neuladen oder wechseln der Tabs auf einen leeren globalen Array zugegriffen, wodurch die IDs nicht abgefragt werden konnten.
  980. \section{Frontend der Abonnierfunktion}
  981. Das Ziel war auf der Startseite, alle Nachrichten anzuzeigen, die abonnierte Tags beinhalten, damit der Nutzer alle für ihn relevante Informationen auf den ersten Blick erfassen kann. Um einen Tag zu abonnieren, kann man zum einen über die Suche gehen. Sobald nach nur einem einzigen Tag gesucht wird erscheint oben rechts ein Button der die Abonnierfunktion anbietet (siehe Abbildung 5).
  982. \begin{center}
  983. \begin{figure}[H]
  984. \centering
  985. \includegraphics[width=6cm]{../grafiken/5}
  986. \caption{Darstellung des Abonnierbuttons}
  987. \label{Abbildung 5}
  988. \end{figure}
  989. \end{center}
  990. In der Suchmethode wird geprüft, ob der Suchbegriff in dem Array der vordefinierten Tags vorhanden ist und der Button wird entsprechend sichtbar (vgl. S.14, Listing 4).
  991. Sobald der Tag abonniert wird ändert sich der Text auf dem Button und es besteht die Möglichkeit den Tag wieder zu deabonnieren. Das Backend hinter diesem Feature konnte allerdings aus Zeitgründen nicht vollständig implementiert werden.
  992. \newpage
  993. \begin{lstlisting}[caption=Abfrage in Suchmehtode]
  994. if(_taglist.indexOf(searchtext.replace(/#/g, '')) > -1){
  995. var btnString = "#" + searchtext.replace(/#/g, '') + " abonnieren";
  996. $("#btn-text").text(btnString);
  997. $("#subscribe-btn").css("visibility", "visible");
  998. }else{
  999. $("#subscribe-btn").css("visibility", "hidden");
  1000. }
  1001. \end{lstlisting}
  1002. Eine weitere Möglichkeit besteht über den Tag-Link in einer Nachricht zu navigieren. Der Nutzer gelangt auf eine Seite, die alle Nachrichten zu diesem bestimmten Tag anzeigt und ebenfalls den Button oben rechts als Option einblendet. Im Hintergrund wird eine Suche nach dem Tag angestoßen, der Mechanismus ist somit derselbe.
  1003. %
  1004. \section*{17. Plakatgestaltung}
  1005. \phantomsection\addcontentsline{toc}{section}{17. Plakatgestaltung}
  1006. \subsection{Plakatgestaltung - Erste Projektabschnitt}
  1007. Zu dem Plakat für die OHM News App wurde eine Ideensammlung in Form von Skizzen angefertigt.
  1008. \begin{figure}[H]
  1009. \centering
  1010. \includegraphics[width=6.5cm, angle=90, scale=1.409]{../grafiken/IMG_Skizze1.jpg}\quad
  1011. \includegraphics[width=6.5cm]{../grafiken/IMG_Skizze2.jpg}
  1012. \includegraphics[width=6.5cm, angle=270, scale=1.409]{../grafiken/IMG_Skizze3.jpg}\quad
  1013. \includegraphics[width=6.5cm, angle=270, scale=1.409]{../grafiken/IMG_Skizze4.jpg}
  1014. \end{figure}
  1015. %
  1016. Die Umsetzung derer folgte in Form von ersten Entwürfen in Illustrator, welche der gesamten Gruppe vorgestellt wurden. \\
  1017. Zu den hier unten aufgeführten Plakatentwürfen wurden jeweils zwei Versionen erstellt. Diese zwei kamen jedoch in die engere Auswahl und sollten noch weiter ausgearbeitet werden.
  1018. \begin{figure}[H]
  1019. \centering
  1020. \includegraphics[width=6.5cm]{../grafiken/PDF_Plakat1.pdf}\quad
  1021. \includegraphics[width=6.5cm]{../grafiken/PDF_Plakat2.pdf}
  1022. \end{figure}
  1023. %
  1024. Bei der nächsten Vorauswahl an fünf OHM News Plakat-Versionen wurde daraufhin auf zwei reduziert, welche hier zu sehen sind.
  1025. \begin{figure}[H]
  1026. \centering
  1027. \includegraphics[width=6.5cm]{../grafiken/PDF_Plakat3.pdf}\quad
  1028. \includegraphics[width=6.5cm]{../grafiken/PDF_Plakat4.pdf}
  1029. \end{figure}
  1030. %
  1031. Diese wurden weiter bearbeitet und Änderungen in Absprache mit der Projektgruppe vor\-genommen. Auch die Meinung von Professor Dr. Hopf beeinflusste die Plakatgestaltung.\\
  1032. Einige Ansätze später und nach etlichem Experimentieren stand die Endauswahl bei diesen nächsten zwei Exemplaren. Besonderen Zeitaufwand nahm die Suche nach einer geeigneten Schrift für die zweite Version in Anspruch. Es gestaltete sich als äußerst schwierig, den künstlerischen leicht verspielten Ausdruck des Plakatlayouts mit der Seriösität des Hochschulcharakters in einer Schrift zu vereinen.
  1033. \begin{figure}[H]
  1034. \centering
  1035. \includegraphics[width=6.5cm]{../grafiken/PDF_Plakat5.pdf}\quad
  1036. \includegraphics[width=6.5cm]{../grafiken/PDF_Plakat6.pdf}
  1037. \end{figure}
  1038. %
  1039. Zuletzt fiel die Wahl auf das linke mit blauem Verlauf versehene Plakat. Denn es vermittelt genau das, was der Slogan des Projektes aussagt. Der Fokus liegt auf der Nachrichtenbox, also das was wichtig ist, und der Rest verschwimmt im Hintergrund. \\
  1040. Bei den wöchentlichen Treffen wurde im Allgemeinen der Fortschritt des Plakatdesigns analysiert und mit konstruktiver Kritik versehen. Dieses Feedback wurde im Rahmen des Möglichen umgesetzt und so kristallisierte sich die finale Version heraus. Nach gründlichem Finetuning und einer Umformatierung von DIN A3 auf DIN A1 wurde die Endfassung per Mail eingeschickt und schließlich ausgedruckt. Im Anhang ist sie in voller Auflösung aufzufinden.\\
  1041. \subsection{Plakatgestaltung - Zweiter Projektabschnitt}
  1042. Im Rahmen der Projektpräsentation wurden zwei Plakate erstellt. Das erste Plakat (siehe Abbildung 6, links) ist ein Werbeplakat und dient dazu den Kern des Projektes widerzuspiegeln, sowie Interesse für die Präsentation zu wecken. In Abbildung 6 (rechts) ist das technische Plakat zu sehen, welches einen groben Überblick über die verschiedenen Technologien der App gibt.
  1043. \begin{center}
  1044. \begin{figure}[H]
  1045. \centering
  1046. \includegraphics[width=16cm]{../grafiken/6}
  1047. \caption{Plakate}
  1048. \label{Abbildung 6}
  1049. \end{figure}
  1050. \end{center}
  1051. %
  1052. \section*{18. PowerPoint Präsentation}
  1053. \phantomsection\addcontentsline{toc}{section}{18. PowerPoint Präsentation}
  1054. Als sich das Projekt für dieses Semester zum Ende hinneigte, war es an der Zeit sich für die Projektpräsentation vorzubereiten. Hierfür erstellte ich für die Gruppe eine PowerPoint Präsentation. Zunächst besprachen wir Gemeinschaftlich, wie diese ungefähr aussehen sollte. Wir waren alle einstimmig der Meinung, dass wir die Präsentation sehr einfach gestalten wollen, ohne zu lange Textpassagen mit einzubinden. Wir wollten es nämlich verhindern, dass das Publikum von zu vielen Faktoren in der Darstellung abgelenkt werden, zum Beispiel durch lesen von langem Fließtext. Durch den Gebrauch von bildlicher Veranschaulichung, versuchten wir es den Zuschauern zu ermöglichen, das Verständnis zu erleichtern.
  1055. Auch hatten wir die Idee, eine fiktive Persona zu erstellen, zu dem der Betrachter einen Bezug finden kann und diese durch das vorgetragene Thema begleitet. Letztes Mal entschieden wir uns für Klaus den Studenten. Dieses Mal erstellten wir neben der Rolle des Studenten-/in auch die Persona des Professors und Admins. Somit konnten wir unsere Rollenverteilung bildlich aufzeigen.
  1056. \section{Video}
  1057. Um unser Projekt vorzustellen, wurde ein kurzes Werbe-Video angefertigt, welches für die kommenden Wochen im Foyer der TH-Nürnberg auf einem Großbildschirm gespielt wird. Dieser diente dazu, den Zuschauern einen kurzen Einblick in unsere App zu verschaffen und Ihr Interesse an unserem Projekt zu wecken. Die Aufgabe, ein Video ohne Audio-Erklärung zu erstellen war zunächst eine echte Herausforderung.
  1058. Was jedoch letztendlich noch gemacht werden musste, war es, das Video abschließend noch stimmiger zu machen und dem Trailer noch den letzten Feinschliff zu verpassen. Dafür wurden lediglich neue Icons verwendet, die von der Form gut zusammenpassen. Außerdem wurden kurze Textausschnitte hinzugefügt um das allgemeine Verständnis unserer App zu erlangen ohne den Zuschauer unnötig mit zu viel Text und Informationen sozusagen zu erschlagen.
  1059. \section{Pressefoto}
  1060. F\"ur die Ank\"undigung der Abschlusspr\"asentationen hat die Gruppe zusätzlich ein Presse-foto erstellt (siehe Abbildung 7).
  1061. \begin{center}
  1062. \begin{figure}[H]
  1063. \centering
  1064. \includegraphics[width=6cm]{../grafiken/7}
  1065. \caption{Pressefoto}
  1066. \label{Abbildung 7}
  1067. \end{figure}
  1068. \end{center}
  1069. %
  1070. \subsection*{18.1. Gestaltungselemente}
  1071. \phantomsection\addcontentsline{toc}{subsection}{18.1. Gestaltungselemente}
  1072. Da man jedoch, aus Urheberrechtlichen Gründen, nicht einfach wahllos Charaktere aus dem Internet benutzen kann, suchte ich nach einer Seite, auf der man solche Animationen erstellen kann. Ich bin auch direkt fündig geworden, trotz alle dem war es erstmal schwer etwas zu finden das man auch Gratis verwenden konnte.
  1073. Dann bin ich auf die Seite www.Powtoon.com gestoßen. Dort fing ich als nächstes an, unseren sogenannten Klaus in all den Stimmungen, die wir für unsere Präsentation brauchten, zu gestalten. \\
  1074. Wir entschieden im Vorfeld als Gruppe, dass sich unser Männchen so wenig wie möglich bewegen soll, aus dem gleichen Grund wie auch oben schon erwähnt und zwar um den Fokus nicht zu sehr darauf zu richten und das Publikum nicht zu sehr abzulenken. Nachdem das erledigt war, war es an der Zeit, die eben erstellten Videos von unserer Persona einzeln so zu kürzen und zu beschneiden, dass man sie gut auf die gewünschte Position einsetzen konnte. Als dieses erledigt wurde, besprach ich weitere Vorgehen einzeln mit den anderen Gruppenmitgliedern. Ich Informierte mich darüber, über welches Thema jeder einzelne vorträgt und wie sie sich ihren Präsentationsteil vorstellen. Diese Wünsche und Vorstellung setzte ich dann dementsprechend in unserer Präsentation um.
  1075. Falls sie an dem Ergebnis interessiert sind, haben sie die Möglichkeit sich dies im Git-Repository im Ordner ''presentation'' anzusehen.
  1076. %
  1077. \section*{19. Weiterverwendung für Infoscreens}
  1078. \phantomsection\addcontentsline{toc}{section}{19. Weiterverwendung für Infoscreens}
  1079. Am Mittwoch, den 24.10.2018 fand das Info-Treffen mit Frau Fabi statt, welches von Prof.Dr. \mbox{Matthias} Hopf organisiert wurde. Dieses Treffen diente der Besprechung und Erörterung zukünftiger Nutzungsmöglichkeiten der Info-Screens, das sind geplante und teils bereits montierte Bildschirme zur Information-Bereitstellung für die Hochschulangehörigen auf dem Campusgelände. Frau Fabi ist Angehörige der Fakultät efi und in ihrer Funktion für die Dokumentenlenkung und Webredaktion an dem ''Tag''-basiertem Nachrichten-System unserer Webanwendung interessiert, welches zukünftig auch auf den Bildschirmen dargestellt werden könnten. Sie ließ auch das Interesse von Herr Pöhlau, dem Dekan der Fakultät efi bekunden.\\
  1080. Außerdem informierte Frau Fabi uns, die Projektmitglieder und unseren Projektbetreuer, dass die Fakultät efi sicher die restlichen Info-Screens montieren werde und derzeit Besprechungen hinsichtlich weiterer Sicherheitsaspekte zu den Montagebereichen am Laufen sind. Ergänzend würden sie sich eine Softwarelösung wünschen, für die Ansteuerung und ''Befüllung'' der Monitore mit den Daten unserer App. Diese wird jedoch nicht mehr im Rahmen unseres Projektes umgesetzt werden. Die Umsetzung einer Softwarelösung wäre als Idee für ein zukünftiges Projekt denkbar, nach Aussage von Prof.Dr. Matthias Hopf.
  1081. %
  1082. \section*{20. Soll/Ist Vergleich auf Basis des Projektplanes}
  1083. \phantomsection\addcontentsline{toc}{section}{20. Soll/Ist Vergleich auf Basis des Projektplanes}
  1084. Zu Beginn des Semesters hat die Gruppe zusammen ein Pflichtenheft für den ersten Abschnitt des Projekts erstellt. Ziel war es den Datenzugriff zu ermöglichen und eine Schnittstelle zur Verfügung zu stellen. Es besteht eine Datenbankanbindung über den Server der Technischen Hochschule Nürnberg. Darüber hinaus sollten die folgenden Ziele im Bereich der grafischen Benutzerschnittstelle erreicht werden.\\
  1085. Die Oberfläche der PWA sollte über eine Login Möglichkeit, eine Menüleiste, eine Suchoption, ein Profil, eine Filterfunktion, ein Dashboard als Hauptseite, ein Einstellungsmenü, Nachrichtenfelder und ein Formular zum Verfassen einer Nachricht verfügen. Die Login Funktion ist noch nicht implementiert und die Filterfunktion soll im nächsten Semester in das Suchfeld und die Profilanzeige eingebaut werden. Die restlichen Funktionen sind in der PWA grafisch umgesetzt worden. Es sollte zusätzlich ein Abhängigkeitsdiagramm erstellt werden. Allerdings war dies aufgrund fehlender komplexer Zusammenhänge noch nicht notwendig. Für die API-Schnittstelle wurde eine Dokumentation erstellt, um den Überblick zu bewahren. Im Bereich der Anwendungslogik wurde das Routing, die Darstellung der Nachrichten, die Speicherung der Nachrichten in der Datenbank und der LDAP-Login besonders behandelt. Das Routing sowie die Erstellung, Speicherung und Darstellung der Nachrichten funktioniert. Die Login Funktion wurde noch nicht näher betrachtet. Codetests wurden bisher noch keine durchgeführt. Das Rollenkonzept der Nutzer wurde bereits besprochen, allerdings noch nicht umgesetzt.\\
  1086. Darüber hinaus gibt noch einige nachrangige Punkte. Dazu gehört die Festlegung des Anwendungsnamens, die Erstellung eines Logos, das UX-Konzept, das Filtern der Datenbankabrufe, das Festlegen der Anzeigekriterien und die Funktion einem Kanal zu folgen. Wie oben bereits erwähnt wird das Filtern der Abrufe im nächsten Semester umgesetzt. Auch die Anzeigekriterien und die Möglichkeit einem Kanal zu folgen wird erst zu einem späteren Zeitpunkt möglich sein.
  1087. %
  1088. \section*{21. Fazit}
  1089. \phantomsection\addcontentsline{toc}{section}{21. Fazit}
  1090. Im ersten Projektabschnitt ist viel Zeit ist in der Konzeptionsphase vergangen, da es ein sehr iterativer Prozess ist und deshalb mehrere Durchläufe bis zum Endentwurf nötig waren. Verschiedene Meinungen mussten mit einbezogen werden. Doch ein gutes Konzept erspart am Ende viel Änderungsarbeit. \\
  1091. Für die weitere Erarbeitung der App haben sich die Projektmitglieder auf die Bereiche Front\-end, Datenbank, Sever und Service-Worker aufgeteilt. Diese Aufgaben\-verteilung hat gut funktioniert. Trotzdem ist unser Team sehr oft ins Stocken geraten, da sich die Aufgaben\-bereiche gerade am Anfang oft überschnitten haben. Hinzukommt, dass wir insgesamt \mbox{wenig} Erfahrung in diesen Bereichen hatten. Wir haben uns deshalb zu Beginn intensiv in die Themen eingearbeitet, was länger dauerte als erwartet. Zusätzlich mussten wir auf \mbox{fachliche} Unterstützung zurückgreifen.\\\\
  1092. Alles in einem kann man trotzdem von einem erfolgreichen Projektabschnitt sprechen. Ein erster funktionierender Prototyp ist fertig und kann im nächsten Zug erweitert werden. Parallele individuelle Arbeiten sind einfacher möglich, da das Grundgerüst steht. Das Team hat sich in die Materie eingearbeitet und kann im zweiten Projektabschnitt schneller durchstarten. Die Idee und das Konzept für die App sind soweit ausgereift, sodass diese nur noch umgesetzt werden müssen. Abläufe innerhalb der Gruppe sind klarer geworden, allerdings gibt es noch einiges strukturelle Abläufe, die im zweiten Projektabschnitt weiter optimiert werden können.
  1093. %
  1094. % Literaturverzeichnis
  1095. \newpage
  1096. \section*{Quellen- und Literaturverzeichnis}
  1097. \phantomsection\addcontentsline{toc}{section}{Quellen- und Literaturverzeichnis}
  1098. \medskip
  1099. %\nocite{*} % Alle Inhalte zur Ausgabe markieren, nicht nur jene die zitiert wurden.
  1100. {\setstretch{1.0}%
  1101. \printbibliography[heading=none]}
  1102. %
  1103. \end{document}