Pflichtenheft (light)

Transkript

1 Pflichtenheft (light) NB: Das Pflichtenheft dient als Grundlage eines Vertrags und in ihm werden genau die Funktionalitäten spezifiziert, die in das endgültige Produkt einfließen. Ist eine Funktionalität hier nicht genannt, ist sie im Grunde im Rahmen dieses Produktes nicht vorhanden. Deswegen sollte mit entsprechender Genauigkeit vorgegangen werden und so viele Anforderungen wie möglich genauestens darzustellen. Das Pflichtenheft ist weiterhin Grundlage für das Design des Produktes und sollte es ermöglichen, auch an der Erstellung Unbeteiligten klare Handlungsanweisung zur Umsetzung des Pflichtenhefts in das Endprodukt zu geben. Ist das Lastenheft bereits sehr spezifisch, können im Pflichtenheft viele Texte wieder verwendet werden, indem sie übernommen und ausgebaut werden. * Produktübersicht Das hier beschriebene Produkt ist ein Modul, das in ein bestehendes Plugin eingebettet wird, um einen bestimmten Scaffold nach der Theorie der Selbstregulation anzubieten. Der Scaffold soll Alternativvorschläge zu der benutzten Suchmaschine geben, da andere Suchmaschinen in der Regel auch andere und unterschiedlich priorisierte Suchergebnisse zurückgeben. Dies erhöht die Chance, relevante Informationen zu finden. Vor allem stark spezialisierte Suchmaschinen können hier bessere Suchergebnisse ermöglichen. Anhand einer bestehenden Datenbasis können in manchen Fällen auch die geeignetsten Suchmaschinen vorgeschlagen werden. * Zielbestimmung Das potentielle Lernproblem lässt sich nach Boekaerts (1999) in das kognitive System einordnen. [ ] Embedded Scaffolds werden dem Lerner während er mit dem Programm arbeitet auf jeden Fall dargeboten, er kann sie also nicht umgehen. Non-embedded Scaffolds werden hingegen nur auf Anfrage des Nutzers bereitgestellt. Nach genauer Analyse der Anforderungen haben wir uns für einen embedded Scaffold entschieden, weil wir glauben dass ein Großteil der Lerner von dieser Unterstützung profitieren wird. [...] Indirekte Scaffolds übermitteln dem Lerner Informationen, die eine Regulation des Lernprozesses implizieren. Sie sind immer dann sinnvoll, wenn der Lerner schon über ein gewisses Maß an Selbstregulationskompetenz verfügt. Er ist dann in der Lage mit den dargebotenen Informationen umzugehen. Direkte Scaffolds fordern den Lerner zu einer Handlung auf, sie werden implementiert, wenn ein Lerner explizite Instruktionen benötigt. [ ] Wir haben uns für eine Kombination aus einem indirekten und einem direkten Scaffold entschieden. Zunächst werden Informationen bereitgestellt, die es dem Lerner ermöglichen seinen Lernprozess zu regulieren (indirekter Scaffold). Wenn diese Informationen nicht genutzt werden, so erfolgt eine konkrete Arbeitsanweisung (direkter Scaffold). Auf diese Weise ersparen wir uns eine Diagnose der Selbstregulationskompetenz des Lerners. Grundsätzlich wird bei jedem Anbrowsen einer Suchmaschinenseite in der Seitenleiste ein Überblick über alle anderen Suchmaschinen gegeben. Dies ist ein embedded Scaffold, weil die Seitenleiste immer angezeigt wird. Die Dargebotenen Informationen stellen einen indirekten Scaffold da, weil der Lerner selbst wählen kann, ob er die Informationen nutzt, also ob er eine andere Suchmaschine anwählt. [...] Wurden keine anderen Suchmaschinen herangezogen und keine relevanten Informationen gefunden, so ist davon auszugehen, dass der Lerner nicht in der Lage war, den indirekten Scaffold zu verarbeiten. In diesem Fall erfolgt in der Seitenspalte der Suchmaschine die Darstellung der Aufforderung: wie Kein Erfolg? Probieren Sie doch eine der untenstehenden Suchmaschinen! Dies ist ein embedded Scaffold, weil er für den Lerner unumgänglich ist. Allerdings unterbricht die Darstellung nicht den Arbeitsprozess, wie es beispielsweise bei einem Popup-Fenster der Fall wäre. Außerdem handelt es sich um einen direkten Scaffold. [...] Musskriterien MK01 - Insofern das Plugin mit dem integrierten Modul aktiviert ist, soll bei jeder Suche mit einer en Suchmaschine in der Seitenleiste eine Ansicht alternativer Vorschläge dargestellt werden.

2 MK02 - Dazu muss erkannt werden, ob der Benutzer gerade auf einer Seite einer Suchmaschine eine Suchanfrage eingibt. Das Produkt muss erfassen, wie oft und mit welcher Frequenz welche Suchmaschine verwendet wird. MK03 - Grundsätzlich wird bei jedem Anbrowsen einer Suchmaschinenseite in der Seitenleiste ein Überblick über alle anderen Suchmaschinen dargestellt. MK04 - Wird ein Suchvorgang durchgeführt kann durch einen Klick auf eine alternative Suchmaschine in der Seitenspalte dieselbe Suchanfrage auf der betreffenden Suchmaschine durchgeführt werden. Die relevantesten bzw. geeignetsten Suchmaschinen (wird anhand der Datensammlung der Fachgebiete und Schlüsselwörter errechnet) werden am Anfang der Liste angezeigt. MK05 - Wiederholen sich Suchanfragen in kürzerem Abstand, ohne dass von der Suchmaschinenseite andere Seiten geöffnet werden, sehen wir dies als einen vergeblichen Versuch. Dann sollte das Produkt in der Seitenspalte über den Suchmaschinen einen Text einblenden wie Kein Erfolg? Probieren Sie doch eine der untenstehenden Suchmaschinen!. Aufmerksamkeit auf diese Einblendung erfolgt durch eine kurze Animation, in der der Hintergrund des Textes in der Seitenspalte von der Farbe gelb nach weiß fadet. MK06 - Bei einem Mouse-Over über eine alternative Suchmaschine erscheint in einem ToolTip eine kurze der Suchmaschine (ist zu erarbeiten) und eine Angabe zu ihrer Eignung in speziellen Fachgebieten oder Medien. MK07 - Gesammelte Daten müssen über das Internet zur Auswertung an einen zentralen Server übergeben werden können. MK08 - Es muss aus Datenschutzgründen möglich sein, die Funktionalität dieses Produktes spezifisch ausschalten zu können, wofür allerdings nur eine Programmierschnittstelle zur Verfügung zu stellen ist. Wunschkriterien Wie nach Vergabe des Lastenhefts nochmals mündlich abgesprochen, ist folgendes Wunschkriterium nicht Teil des Vertrages. Bei der Entwicklung sollte allerdings Rücksicht auf Erweiterbarkeit genommen werden, um dieses Feature nachträglich noch implementieren zu können. WK01 - Wünschenswert wäre eine History -Sicht speziell für Suchanfragen, in der die getätigten Suchanfragen der letzten 14 Tage dargestellt werden, die bei Bedarf erneut ausgeführt werden können (aufgrund Einsicht der gespeicherten Daten). Abgrenzungskriterien AK01 - Eine automatische Zuordnung von Suchbegriffen zu den optimalen Suchmaschinen soll nicht erreicht werden, da dies die Komplexität des Produktes unermesslich anheben würde. AK02 - Die Speicherung der Daten (Name der Suchmaschine und Zeitpunkt des Zugriffes auf eine Suchmaschine, gestellte Suchanfrage, hat der Benutzer das Angebot einer alternativen Suchmaschine über das Produkt angenommen) erfolgt auf einem zentralen Server. Speicherung und Abruf dieser Daten erfolgt über eine Schnittstelle. Die direkte Verwaltung bzw. Speicherung dieser Daten ist nicht notwendig, sie muss lediglich angestoßen werden. * Produkteinsatz NB: ist vom Lastenheft übernommen und speziell für das geforderte Produkt angepasst worden Anwendungsbereiche Da in der heutigen Wissensgesellschaft eine große Zahl der Wissensakquisen über das Internet stattfinden, weil dort im Zweifelsfalle die aktuellsten und umfassendsten Informationen über viele Themen (v.a. Forschungsergebnisse + Studien) zu finden sind, werden Suchmaschinen immer wichtiger, um die richtigen und relevanten Informationen aufzufinden. Besonders in rechercheintensiven Aufgaben kann das Produkt helfen, indem es dem Benutzer durch einen rein visuellen Scaffold die Möglichkeiten der Anpassung seiner Suchstrategie durch Wechsel der

3 Suchmaschine aufzeigt. Dabei konzentriert sich das Produkt lediglich auf einzelne Suchanfragen, analysiert aber auch das Suchmaschinennutzungsverhalten des Benutzers über einige Zeit hinweg. Zielgruppen Die Zielgruppe dieses Produktes sind vor allem junge Akademiker, die in ihren Rechercheprozessen noch nicht statisch arbeiten und die für sie angemessenen Suchstrategien noch nicht vollständig beherrschen. Weiterhin ist das Produkt für Wissensarbeiter gedacht, die sich in kurzer Zeit in bestimmte, breit gefächerte Themenfelder einarbeiten müssen und aus diesem Grunde häufig sehr spezielle Suchanfragen in Suchmaschinen stellen müssen. Betriebsbedingungen Da die Pluginumgebung in den Open-Source-Browser Firefox eingebunden ist, baut das hier zu entwickelnde Produkt ebenfalls auf dieser Plattform auf. Dabei ist es bei aktiviertem Plugin ständig aktiv und überwacht sämtliche Suchanfragen des Benutzers. * Produktfunktionen NB: Bei einem Vergleich mit den Zielkriterien fällt auf, dass die hier angegebenen Funktionen Bausteine zu deren Erreichung sind. Die Spezifizierung hier sollte bereits etwas technischer ausfallen, da die hier genannten Funktionalitäten bereits direkt in Programmcode umsetzbar sind. Normalerweise wird hier sehr viel granularer spezifiziert, aber das ist ja nicht die Aufgabe dieses Seminars. Die folgenden Funktionen sind im Produkt zu implementieren: PF01 PF02 PF03 PF04 Darstellung der Suchmaschinenliste in der Seitenleiste (MK01, MK03, MK04, MK06) Seitenleiste ist sichtbar, eine Suche wurde durchgeführt Daten aus PD01 werden dargestellt Erkennung, ob der Benutzer gerade eine Suchanfrage stellt (MK02) Suchmaschinen sind, das Suchfeld innerhalb des HTMLs ist Es ist, ob eine Suche durchgeführt wird und die exakte Suchanfrage ist Nutzungsbedingungen ermitteln und Entscheidung fällen, ob ein Scaffold gegeben werden soll (MK04, MK05). Eine Suche wird durchgeführt. Datengrundlage sind PD03, PD04. Entweder wird Scaffold gegeben oder nicht Plugin Wenn ein Scaffold gegeben werden soll, muss entscheiden werden, welcher im Moment der zutreffende ist (MK04, MK05) PF03 ergibt, dass Scaffold gegeben werden soll. Es wurde eine Suche durchgeführt, wenn in zeitlich kurzer Abfolge Suchanfragen gestellt wurden ohne neue Browserseiten zu öffnen, gilt sie als vergeblich. Entscheidung zwischen Fällen MK04, MK05

4 PF05 PF06 PF07 PF08 Wird Scaffold aus MK04 gegeben, wird die Relevanz der betreffenden Suchmaschinen auf Basis der Liste PD03 ermittelt und die Liste der Suchmaschine in der Seitenleiste dementsprechend sortiert. PF04 ergibt Scaffold aus MK04. Suche wurde durchgeführt, Suchmaschine ist In Seitenleiste sind alternative Suchmaschinen entsprechend ihrer Relevanz zur aktuell durchgeführten Suchanfrage sortiert aufgelistet Plugin, Suchmaschine Wird Scaffold aus MK05 gegeben, muss ein visueller Hinweis in der Seitenleiste angezeigt werden. PF04 ergibt Scaffold aus MK05. Suche wurde durchgeführt, Suchmaschine ist In Seitenleiste sind alternative Suchmaschinen entsprechend ihrer Relevanz zur aktuell durchgeführten Suchanfrage sortiert aufgelistet Plugin, Suchmaschine wird eine Suchanfrage gestellt (PF02) werden die in PD04 genannten Daten über eine Schnittstelle gespeichert (MK07) PF02 ermittelt durchgeführte Suche. Suchmaschine ist. Die in PD04 genannten Daten sind in der Datenhaltung vorhanden. Plugin, Datenhaltung Bei MouseOver auf ein Element der Suchmaschinenliste (MK06) werden Daten PD02 in einem ToolTip dargestellt. Suchmaschinenliste ist in der Seitenleiste dargestellt, Benutzer bewegt den Mauszeiger auf einen dort dargestellten Suchmaschineneintrag. Ein Tooltip mit den in PD02 enthaltenen Daten wird dargestellt Plugin, Benutzer * Produktdaten Die Daten, die zur vollständigen Unterstützung der angestrebten Funktionalität notwendig sind, sind vor allem Nutzungsdaten der Suchmaschinen und der Browserumgebung. Insbesondere folgende Daten müssen dauerhaft gespeichert werden: PD01 - Eine Liste von unterstützten Suchmaschinen sowie deren URLs (z.b. Google EN Notwendig für MK01 bis MK06. PD02 - Zu jeder Suchmaschine ist eine Kurzbeschreibung zu ihrem Anwendungsfeld beigefügt (z.b. Google Scholar Eine akademische Suchmaschine, mit der vor allem wissenschaftliche Publikationen und Patente gefunden werden ). Notwendig für MK06. PD03 - Zu jeder Suchmaschine sind häufige Suchwörter gespeichert (z.b. Liedtexte, lyrics,...). Notwendig für ML04. PD04 - In einer Liste werden die durchgeführten Suchen mit Zeitstempel und Suchanfrage gespeichert (z.b. Google :32:23, pflichtenheft +aufbau ). Auf Basis dieser Daten kann die Nutzung errechnet werden (z.b. x Anfragen in den letzten 5 Minuten). Weiterhin kann das Wunschkriterium mit diesen Daten erfüllt werden. Notwendig für MK02, MK05, MK07 und WK01. Siehe auch AK01.

5 * Produktleistungen Die in MK01 - MK08 genannten Anforderungen müssen so zeitnah wie möglich erfolgen. Das Plugin muss so schnell auf alle dort genannten Aktionen reagieren, dass dem Benutzer keine Wartezeiten auferlegt werden. Eine Reaktion sollte schneller als 0.1s erfolgen. * Qualitätsanforderungen NB: Hierbei ist wichtig zu beschreiben, was Qualität im Sinne des Produktes beschreibt. Qualität im Sinne dieses Produktes kann in zwei Kriterien ausgedrückt werden: 1. Inwiefern das Produkt gemäß der unterliegenden Theorie angemessen entworfen wurde (theoretische Qualität). War es möglich alle Implikationen der Theorie im Programm umzusetzen? Wenn nicht, was wurde nicht umgesetzt und aus welchen Gründen? Außerdem können Evaluationen zur Überprüfung der unterliegenden Theorien durchgeführt werden. 2. Ob das Produkt alle funktionalen Anforderungen des Lastenhefts voll erfüllt (technische Qualität). Die Implementierung dieser Anforderungen wird durch umfassende Testfälle belegt. * Benutzungsoberfläche NB: Hier sollten einige Screenshots oder Zeichnungen abgebildet werden, die einen Einblick geben, wie das Produkt aussieht und sich bei der Nutzung anfühlt. Sämtliche Mockups sind im Anhang zu finden. Hier lediglich eine Übersicht: Mockup 1 zeigt die Eingabe einer Suche Mockup 2 zeigt die Seitenspalte bei einem Vorschlag alternativer Suchmaschinen Mockup 3 zeigt einen angewählten und hervorgehobenen Vorschlag sowie zusätzliche Informationen über die gewählte Suchmaschine. Nichtfunktionale Anforderungen Die Sammlung der hier beschriebenen Daten ist im datenschutzrechtlichen Sinne nicht gänzlich unkritisch zu sehen. Aus diesem Grund sind folgende Anforderungen zu erfüllen: NFA01 Da die Daten zentral auf einem Server gespeichert werden, ist unter allen Umständen darauf zu achten, dass Unbefugten keinen Zugriff auf diese Daten erhalten (betrifft MK07). NFA02 Die Daten müssen vor einer Speicherung anonymisiert werden, um keine Rückschlüsse auf den Benutzer zu erlauben. Dabei ist für Forschungszwecke jedoch die Zuordnung der Nutzungsdaten zu einer anonymisierten Person gewährleisten (betrifft PD04). NFA03 Der Benutzer muss darüber aufgeklärt werden, welche Daten zu welchem Zweck gesammelt werden und er muss die Möglichkeit haben, die Installation des Plugins abzubrechen bzw. das Plugin gezielt zu deaktivieren (siehe MK08). Technische Produktumgebung Es existiert das Browserplugin mitsamt seinen Schnittstellen zum Browser und zu einem zentralen Server. Da für das Produkt nur die bestehenden Schnittstellen benutzt werden, wird auf eine tiefergehende Erörterung verzichtet. Spezielle Anforderungen an die Entwicklungs-Umgebung Da der Auftraggeber im Anhang aufgelistete Entwicklungswerkzeuge benutzt, wird zur Erstellung dieses Produktes Wert darauf gelegt, soweit möglich diesen Entwicklungsvorgaben zu folgen. Weiterhin werden Code-Standards des Auftraggebers befolgt. Gliederung in Teilprodukte Entfällt hier, da lediglich ein Modul entwickelt wird. Ein Klassendiagramm ist im Anhang angefügt. Ergänzungen Für die Erstellung dieses Pflichtenhefts mussten keine Ozelots leiden oder sterben.