Communication Gateway

Transkript

1 Communication Gateway Name Kürzel Aufgabe adresse Michael Sutter MS Author Sepp Mügeli SM Betreuer BEGASOFT AG BS Auftraggeber Max Kleiner MK Experte Versionsmanagement Datum Version Beschreibung Person Review BEGASOFT AG MS Review Experte MS Abgegeben MS Überarbeitet MS Dokument- und Quellverzeichnis Typ Software Ort.pdf OpenOffice 3.2 D:\Michael\Documents\SWS\Diplomarbeit\Dokumente

2 Inhaltsverzeichnis 1.Allgemeines Zweck des Dokuments Zielgruppe des Dokuments Umfang der Master Thesis Umfeld Glossar Abkürzungen und Akronyme Definitionen Gesammtübersicht Produktumfeld UseCases UseCase SMS versenden Actor Betroffene und Interessierte Vorbedingungen Funktionsbeschreibung Systemzustand nach erfolgreichem Ablauf Systemzustand nach fehlerhaftem Ablauf Spezielle nicht funktionelle Bedingungen Häufigkeit der Nutzung Verschiedenes UseCase: Fax versenden Actor Betroffene und Interessierte Vorbedingungen Funktionsbeschreibung Systemzustand nach erfolgreichem Ablauf Systemzustand nach fehlerhaftem Ablauf Spezielle nicht funktionelle Bedingungen Häufigkeit der Nutzung Verschiedenes UseCase: SMS Versand prüfen Actor Betroffene und Interessierte Vorbedingungen Funktionsbeschreibung Systemzustand nach erfolgreichem Ablauf Systemzustand nach fehlerhaftem Ablauf Spezielle nicht funktionelle Bedingungen Häufigkeit der Nutzung Verschiedenes UseCase: Fax Versand prüfen Actor Betroffene und Interessierte Vorbedingungen Funktionsbeschreibung Systemzustand nach erfolgreichem Ablauf...13 Seite 2 von 27

3 3.4.6.Systemzustand nach fehlerhaftem Ablauf Spezielle nicht funktionelle Bedingungen Häufigkeit der Nutzung Verschiedenes UseCase: Daten an Applikationen senden (optional) Actor Betroffene und Interessierte Vorbedingungen Funktionsbeschreibung Systemzustand nach erfolgreichem Ablauf Systemzustand nach fehlerhaftem Ablauf Spezielle nicht funktionelle Bedingungen Häufigkeit der Nutzung Verschiedenes UseCase: Benutzerdaten verwalten Actor Betroffene und Interessierte Vorbedingungen Funktionsbeschreibung Systemzustand nach erfolgreichem Ablauf Systemzustand nach fehlerhaftem Ablauf Spezielle nicht funktionelle Bedingungen Häufigkeit der Nutzung Verschiedenes Anforderungen Konventionen Vorlage Name Version V Priorität P Typ UseCase UC SMS versenden Fax versenden Daten an Applikationen senden Benutzerverwaltung Nichtfunktionale Anforderungen Abgrenzung Verrechnungssystem Backup Fehlerbehandlung Konventionen Vorlage Name Aktion Version V Priorität P UseCase UC SMS versenden Fax versenden...22 Seite 3 von 27

4 6.4.Daten an Applikation senden Zeitplan Tasks Gantt-Diagramm Anhang Wirtschaftlichkeitsbetrachtung Referenzen...26 Seite 4 von 27

5 1. Allgemeines 1.1. Zweck des Dokuments Der Communcation Gateway muss einerseits die hier definierten Funktionen ausführen können, wie auch den Anforderungen einer Master Thesis entsprechen. Das vorliegende dient desshalb nicht nur als Leistungsvereinbarung zwischen dem Auftraggeber Stephan Berger, Geschäftsführer der Firma BEGASOFT AG und dem Auftragnehmer Michael Sutter, sondern auch zwischen dem Vertreter der Berner Fachhochschule Max Kleiner und dem Diplomanden Michael Sutter. Das beschreibt möglichst einfach und präzis die Aufgabenstellung, die Anforderungen und das Umfeld des Communcation Gateway mit Hilfe von Diagrammen und Prosa. Zudem werden die Anforderungen priorisiert und mögliche Erweiterungen beschrieben Zielgruppe des Dokuments Dieses Dokument richtet sich primär an den Experten der Berner Fachhochschule, den Betreuer, den Auftraggeber und den Diplomanden Umfang der Master Thesis Diese Arbeit bildet den Abschluss des Master of Advanced Studies in Information Technology. Sie umfasst 12 ECTS Punkte oder 360 Arbeitsstunden, was einem Semester entspricht und sechs Monate dauert. Lieferobjekte Prototyp (Source Code, Applikation) Dokumentation (Bericht) 1.4. Umfeld Die Firma BEGASOFT mit Sitz in Bern - Weissenbühl ist 1998 aus der RadioSchweiz hervorgegangen. Bereits Anfang der Achtzigerjahre betrieb die RadioSchweiz das erste kommerzielle -System der Schweiz sowie Europas führenden Online-Informationsdienst für Wirtschaft und Wissenschaft. Vor diesem Hintergrund gelang es der Firma BEGASOFT nach dem Spin-off rasch, sich im Bereich der Informationstechnologie zu etablieren. BEGASOFT stützt sich auf 3 Standbeine: Internetapplikationen Webkonzeption und -design Rechenzentrum Dank dieser 3 Standbeine ist die Firma BEGASOFT in der Lage dem Kunden ganzheitliche Lösungen anzubieten, von der Konzeption über die Entwicklung bis hin zum Betrieb. Seite 5 von 27

6 1.5. Glossar 1.6. Abkürzungen und Akronyme CG Log-Datei GSM Log-Datei SOAP Communication Gateway Logdaten betreffend Fax Versand, als Textdatei oder in SQL Tabelle gespeichert. Global System for Mobile Communications. Ist ein Standard für digitale Mobilfunknetze. Logdaten betreffend SMS Versand, als Textdatei oder in SQL Tabelle gespeichert. Simple Object Access Protocol um Daten zwischen Systemen aus zu tauschen oder um Remote Procedure Calls auszuführen Definitionen Administrator der BEGASOFT Bekannter, berechtigter Kunde Mitarbeiter der Firma BEGASOFT. Benuternname, Passwort, adresse und Telefonnummer des Kunden sind in der Benutzerverwaltung gespeichert. Bekannte, berechtigte Applikation, Software Demon Fax-System Falcom Wireless Communications GMBH GSM-Modem HylaFax Metadaten Die Applikation (Producer) ist vom CG eindeutig identifizierbar und ist berechtigt der gewünschten Applikation (Consumer) Daten zu übermitteln. Zudem ist der Consumer mittels Konfigurationsfiles im CG definiert. Dieser ist dadurch in der Lage von der SMS- Software erhaltene Daten zu verarbeiten und an den Consumer weiterzugeben. Demon welcher periodisch Verzeichnisse überprüft und deren Inhalt gegebenenfalls interpretiert und verarbeitet. Fax-Software wie z.b. HylaFax. Software welche als Middleware zwischen CG und Fax- Modem verwendet wird. Siehe Modell Falcom-Twist der Falcom Wireless Communications GMBH, genauere Angaben unter OpenSource Fax-Server, genauere Angaben unter SMS Server Tools SMS Server Tools überwacht periodisch diverse Spool-Verzeichnisse. Wird im entsprechenden Verzeichnis (z.b. Incoming Folder) eine Text-Datei abgelegt, wird diese als SMS verschickt. Genauere Angaben unter SMS-System SMS-Software wie z.b. SMS-Server Tools. Software welche als Middleware zwischen CG und SMS-Modem verwendet wird. Seite 6 von 27

7 Microsoft SQL Server 2007 Umfangreiche Software zur Erstellung und Bearbeitung von SQL-Datenbanken. Seite 7 von 27

8 2. Gesammtübersicht 2.1. Produktumfeld WebService Web Client Server Data HylaFAX Client Communicaton Gateway Fax- Modem SMS Server Tools FTP-Client SMS-Log File FAX-Log File Andere SMS Software SMS- Modem Verschiedene SMS Dienste Abbildung 1: Grobe Gesammtübersicht inkl. optionale Erweiterungen (Blau). Der Communication Gateway besitzt 3 Schnittstellen über welche er SMS- oder Faxnachrichten entgegennehmen kann. Die Kommunikation mit dem SMS- bzw. Faxmodem erfolgt jeweils über die Schnittstellen der Opensource Software HylaFax, bzw. SMS Server Tools. Benutzerdaten werden in einer SQL-Datenbank abgelegt. Zu den optionalen Erweiterungen gehören die Anbindung anderer SMS-Software und das nutzen von SMS-Diensten Dritter. Die Logdaten werden in einer separaten Datei oder in einer SQL-Datenbank abgelegt. Seite 8 von 27

9 3. UseCases Fax / SMS Gateway Kunde (Producer) Fax versenden <<include>> Faxversand überprüfen Job <<include>> SMS versenden Kunden - system (Producer ) <<include>> <<include>> SMS-Versand überprüfen Kunde (Consumer) Daten an Applikationen senden Kundensystem (Consumer ) <<include>> Administrator Benutzerdaten verwalten Abbildung 2: UseCase Übersicht. Der Actor Kunde(Producer) ist eine Person welche berechtigt ist den CG zu verwenden. Der Actor Kunde (Consumer) ist eine beliebige Person. Der Actor Kundensystem ist ein Applikation welche durch BEGASOFT oder einem anderen Anbieter betrieben wird und berechtigt ist den CG zu verwenden. Die UseCases sind aus Sicht der Producer benannt. Seite 9 von 27

10 3.1. UseCase SMS versenden Actor Ein der BEGASOFT bekannter Kunde oder bekannte Applikation Betroffene und Interessierte SMS-System, welches für den Versand des SMS zuständig ist. Kundenverwaltung, welche die ausgeführte Aktivität in eine Log-Datei schreiben muss Vorbedingungen Der Actor ist bei der BEGASOFT bekannt. Die SMS-Software ist auf dem selben Host wie der CG installiert und gestartet. Das SMS-Modem ist am System angeschlossen und GSM-Verbindung ist erstellt. Auf dem Host muss ein Daemon gestartet sein, welcher die eingehenden s in der dafür vorgesehenen Mailbox liest, den Inhalt interpretiert und die Angaben in der definierten Form (siehe Detailspezifikation 1 ) ablegt Funktionsbeschreibung Via WebService Der Actor erstellt automatisch eine SOAP-Nachricht welche dem CG direkt zugesandt wird. Der CG überprüft die Benutzerdaten. Bei erfolgreicher Authentifizierung wandelt der CG den SMS-Auftrag um und übergibt die nötigen Daten an die SMS-Software, damit diese über das Modem versendet werden können. Die Rohdaten werden im Filesystem in ein definiertes Verzeichnis verschoben, so kann einfach überprüft werden dass diese Daten in Bearbeitung sind. Optional Der Actor erstellt via WebClient eine SMS Nachricht anhand eines Formulars und sendet dieses direkt dem CG. Via Der Actor sendet eine mit dem spezifischen Inhalt an eine definierte -Adresse (siehe Detailspezifikation). Der Inhalt der wird durch einen Daemon gelesen, interpretiert und in Form verschiedener Dateien (siehe Detailspezifikation) im Filesystem abgelegt. Der CG liest in regelmässigen Abständen die Angaben welche der Deamon gespeichert hat. Er überprüft, ob der Absender der berechtigt ist, den Communication Gateway zu benutzen. Wenn diese Prüfung erfolgreich ist, so werden die nötigen Angaben an die SMS-Software weitergegeben, damit diese über das Modem versendet werden können. Die Rohdaten werden im Filesystem in ein definiertes Verzeichnis verschoben, so kann einfach überprüft werden dass diese Daten in Bearbeitung sind. Optional: Diverse SMS-Programme stehen zur verfügung Der CG erweitert seinen Funktionsumfang durch verwenden mehrerer SMS-Programme diverser Anbieter. 1 Detailspezifikation folgt noch Seite 10 von 27

11 Optional: Externer SMS-Dienst wird verwendet Der Actor kann mindestens zwischen dem SMS-Dienst der BEGASOFT und einem externen SMS-Dienst wählen. So kann das Angebot der BEGASOFT ergänzt werden. Der Actor kann auf seinem BEGASOFT Konto den gewünschten Dienst auswählen Systemzustand nach erfolgreichem Ablauf Die ist gelöscht. Die Daten für den Versand liegen bereit für die SMS- Software. Die Auftragsdaten sind gespeichert Systemzustand nach fehlerhaftem Ablauf Wenn die Telefonnummer in der -Adresse nicht als gültige Nummer erkannt wurde, so werden die Angaben des Auftrages gelöscht. Der Absender erhält eine mit einem entsprechenden Fehlerhinweis. Logeintrag wird erstellt. Wenn der Absender der bei der BEGASOFT nicht als SMS-Kunde registriert ist, werden die Daten des Auftrages gelöschen. Der Absender erhält eine mit einem entsprechenden Fehlerhinweis und den Angaben, wie er sich als Kunde bei der BEGASOFT anmelden kann. Logeintrag wird erstellt. Text im ist länger als 160 Zeichen und SMS-Spliting ist nicht aktiviert. Der Absender erhält eine mit einem entsprechenden Fehlerhinweis. Angaben des Auftrags werden gelöscht. Logeintrag wird erstellt Spezielle nicht funktionelle Bedingungen Der Text im darf nicht länger als 160 Zeichen sein. Grössere Nachrichten lösen einen Fehler aus und werden nicht versendet. Optional: SMS-Spliting Für grössere Nachrichten muss der Benutzer SMS-Spliting aktivieren. Grössere Texte werden so in mehrerer Teile gesplittet und entsprechend in mehreren SMS gesendet Häufigkeit der Nutzung Für jede zu versende SMS 1 mal verwendet Verschiedenes Definition der Schnittstelle SMS Daemon-CG siehe Kapitel (siehe Detailspezifikation). Definition der -Adresse siehe Kapitel (siehe Detailspezifikation) UseCase: Fax versenden Actor Ein der BEGASOFT bekannter Kunde oder bekannte Applikation Betroffene und Interessierte Fax-System, welches für das Rendering und den Versand der Dokumente zuständig ist. Kundenverwaltung, welche die ausgeführte Aktivität in eine Log-Datei schreiben muss. Seite 11 von 27

12 Vorbedingungen Der Kunde ist bei der BEGASOFT bekannt. Die Faxsoftware ist auf dem selben Host installiert und gestartet. Das Faxmodem ist am System angeschlossen und die Verbindung zum Telefonanschluss ist erstellt. Auf dem Host muss ein Daemon gestartet sein, welcher die eingehenden s in der dafür vorgesehenen Mailbox liest, den Inhalt interpretiert und die Angaben in der definierten Form (siehe Detailspezifikation) ablegt Funktionsbeschreibung Via WebService Der Actor erstellt automatisch eine SOAP-Nachricht welche dem CG direkt zugesandt wird. Der CG überprüft die Benutzerdaten. Bei erfolgreicher Authentifizierung wandelt der CG den Fax-Auftrag um und übergibt die nötigen Daten an die Fax-Software, damit diese über das Modem versendet werden können. Die Rohdaten werden im Filesystem in ein definiertes Verzeichnis verschoben, so kann einfach überprüft werden dass diese Daten in Bearbeitung sind. Optional Der Actor erstellt via WebClient eine Fax Nachricht anhand eines Formulars und sendet dieses direkt dem CG. Via Der Actor sendet eine mit dem spezifischen Inhalt an eine definierte - Adresse (siehe Detailspezifikation). Der Inhalt der wird durch einen Daemon gelesen, interpretiert und in Form verschiedener Dateien (siehe Detailspezifikation) im Filesystem abgelegt. Der CG liest in regelmässigen Abständen die Angaben welche der Deamon gespeichert hat. Er überprüft, ob der Absender der berechtigt ist, den CG zu benutzen. Wenn diese Prüfung erfolgreich ist, so werden die nötigen Angaben an die Fax-Software weitergegeben, damit diese über das Modem versendet werden können. Die Rohdaten werden im Filesystem in ein definiertes Verzeichnis verschoben, so kann einfach überprüft werden dass diese Daten in Bearbeitung sind Systemzustand nach erfolgreichem Ablauf Die ist gelöscht. Die Daten für den Versand liegen bereit für die Fax- Software. Die Rohdaten sind gespeichert Systemzustand nach fehlerhaftem Ablauf Wenn die Telefonnummer in der -Adresse nicht als gültige Nummer erkannt wurde, so werden die Angaben des Auftrages gelöscht. Der Absender erhält eine mit einem entsprechenden Fehlerhinweis. Logeintrag wird erstellt. Wenn im Auftrag eine Datei enthalten ist, welche nicht durch die Fax-Software bearbeitet werden kann (Datei-Typ) so wird der ganze Auftrag als ungültig angesehen. Es werden alle Angaben gelöscht. Der Absender erhält eine mit einem entsprechenden Fehlerhinweis. Logeintrag wird erstellt. Wenn der Absender der bei der BEGASOFT nicht als Fax-Kunde registriert ist, werden die Daten des Auftrages gelöschen. Der Absender erhält eine mit einem entsprechenden Fehlerhinweis und den Angaben, wie er sich als Kunde bei der BEGASOFT anmelden kann. Logeintrag wird erstellt. Seite 12 von 27

13 Attachement-Files mit Länge 0 Bytes werden nicht an die Fax-Software weitergeleitet. Der Absender erhält eine mit einem entsprechenden Fehlerhinweis. Logeintrag wird erstellt. Wenn keine Daten, also insgesamt 0 Bytes zu versenden sind, so wird der ganze Auftrag nicht weiterverarbeitet. Der Absender erhält eine mit einem entsprechenden Fehlerhinweis. Logeintrag wird erstellt Spezielle nicht funktionelle Bedingungen In der SOAP-Nachricht / können nur Attachements enthalten sein, deren Dateityp durch die eingesetzte Fax- Software erkannt und mit einem entsprechenden Renderer interpretiert werden kann Häufigkeit der Nutzung Für jeden zu versenden Fax 1 mal verwendet Verschiedenes Definition der Schnittstelle FaxDaemon CG siehe Kapitel (siehe Detailspezifikation). Definition der -Adresse siehe Kapitel (siehe Detailspezifikation) UseCase: SMS Versand prüfen Actor Timer (Job) des Systems welcher den Prozess in regelmässigen Abständen startet Betroffene und Interessierte Kunde, welcher eine Versandbestätigung erwartet. Kundenverwaltung, welche die ausgeführte Aktivität in eine Log-Datei schreiben muss Vorbedingungen Keine Funktionsbeschreibung Alle Versandaufträge welche als in Bearbeitung markiert sind, werden gelesen und in der SMS-Software geprüft, ob eine Erledigungsmeldung für den Auftrag vorliegt Systemzustand nach erfolgreichem Ablauf Wenn für einen Auftrag eine Erledingungsmeldung von der SMS-Software vorhanden ist, so wird der gesammte Auftrag archiviert, d.h. im Filesystem in ein definiertes Verzeichnis verschoben. Der Kunde erhält eine Bestätigungsmeldung, falls dies von ihm gewünscht wurde. Alle relevanten Daten (siehe Detailspezifikation) des SMS-Versands werden in die Log-Datei geschrieben Systemzustand nach fehlerhaftem Ablauf Wenn die SMS-Software eine fehlerhafte Übermittlung zurückgemeldet hat, so wird der gesammte Auftrag im Filesystem in ein definiertes Verzeichnis verschoben. Der Kunde erhält eine Fehlermeldung per . Alle relevanten Daten (siehe Detailspezifikation) des SMS-Versands werden in die Log-Datei-Datei geschrieben. Falls der SMS-Auftrag aus irgend einem Grund durch die SMS-Software nicht abgeschlossen werden kann, so werden Seite 13 von 27

14 die Daten nicht weiter verschoben. Sie bleiben im Verzeichnis liegen. Dieser Fehler muss durch einen manuellen Eingriff gelöst werden Spezielle nicht funktionelle Bedingungen Keine Häufigkeit der Nutzung Wird in regelmässigen Abständen gestartet, ca. alle 20 Sekunden Verschiedenes Während dieses Prozesses werden verschiedene Metadaten in einer Datei gespeichert. Dies sind Angaben, welche in der Rückmeldung der SMS-Software enthalten sind UseCase: Fax Versand prüfen Actor Timer (Job) des Systems welcher den Prozess in regelmässigen Abständen startet Betroffene und Interessierte Kunde, welcher eine Versandbestätigung erwartet. Kundenverwaltung, welche die ausgeführte Aktivität in eine Log-Datei schreiben muss Vorbedingungen Keine Funktionsbeschreibung Alle Versandaufträge welche als in Bearbeitung markiert sind, werden gelesen und in der Fax-Software geprüft, ob eine Erledingungsmeldung für den Auftrag vorliegt Systemzustand nach erfolgreichem Ablauf Wenn für einen Auftrag eine Erledingungsmeldung von der Fax-Software vorhanden ist, so wird der gesammte Auftrag archiviert, d.h. im Filesystem in ein definiertes Verzeichnis verschoben. Der Kunde erhält eine Bestätigungsmeldung, falls dies von ihm gewünscht wurde. Alle relevanten Daten (siehe Detailspezifikation) des Fax-Versands werden in die Log-Datei-Datei geschrieben Systemzustand nach fehlerhaftem Ablauf Wenn die Fax-Software eine fehlerhafte Übermittlung zurückgemeldet hat, so wird der gesammte Auftrag im Filesystem in ein definiertes Verzeichnis verschoben. Alle relevanten Daten (siehe Detailspezifikation) des Fax-Versands werden in die Log-Datei geschrieben. Falls der Fax-Auftrag aus irgend einem Grund durch die Fax-Software nicht abgeschlossen werden kann, so werden die Daten nicht weiter verschoben. Sie bleiben im Verzeichnis liegen. Dieser Fehler muss durch einen manuellen Eingriff gelöst werden. Seite 14 von 27

15 Spezielle nicht funktionelle Bedingungen Keine Häufigkeit der Nutzung Wird in regelmässigen Abständen gestartet, ca. alle 20 Sekunden Verschiedenes Während dieses Prozesses werden verschiedene Metadaten in einer Datei gespeichert. Dies sind Angaben, welche in der Rückmeldung der Fax-Software enthalten sind UseCase: Daten an Applikationen senden (optional) Actor Eine beliebige Person oder Applikation welches eine SMS an das SMS-Modem sendet welches vom CG benutzt wird Betroffene und Interessierte Benutzerverwaltung, welche die Berechtigung für die erhaltene SMS prüft und welche die ausgeführte Aktivität in ein Log-Datei schreiben muss Vorbedingungen Die SMS-Software ist auf dem selben Host installiert und gestartet Das SMS-Modem ist am System angeschlossen und GSM-Verbindung ist erstellt Funktionsbeschreibung Der Inhalt der empfangenen SMS wird interpretiert und in die verschiedenen Bestandteile zerlegt. Der Meldungstyp wird anhand des ersten Wortes in der SMS (siehe Detailspezifikation) bestimmt, die Berechtigung geprüft und je nach Konfiguration ein HTTP- Request an eine konfigurierte Adresse abgesetzt Systemzustand nach erfolgreichem Ablauf Der gesammte Auftrag ist archiviert, d.h. im Filesystem in ein definiertes Verzeichnis verschoben worden. Die konfigurierte HTTP-URL wurde aufgerufen. Der Absender erhält eine Bestätigungs- SMS falls dies gewünscht ist. Alle relevanten Daten (siehe Detailspezifikation) des SMS-Empfangs werden in die Log-Datei geschrieben Systemzustand nach fehlerhaftem Ablauf Wenn der Server, welcher durch die URL aufgerufen wird, nicht antwortet, so wird nach einer gewissen Zeit automatisch wieder versucht, die URL zu starten. Dies wird fortgeführt, bis die URL gestartet werden konnte oder der Zustand durch einen manuellen Eingriff des Administrators behoben wird. Wenn der Inhalt der SMS nicht interpretiert werden kann, wird der gesammte Auftrag im Filesystem in ein definiertes Verzeichnis verschoben. Der Kunde erhält eine Fehlermeldung per . Alle relevanten Daten (siehe Detailspezifikation) des SMS-Empfangs werden in die Log-Datei geschrieben. Wenn der Absender nicht ermächtigt ist, die entsprechende Funktion per SMS zu starten, wird der gesammte Auftrag in ein definiertes Verzeichnis verschoben. Ein konfigurierbarer Empfänger erhält eine Fehlermeldung per . Alle Seite 15 von 27

16 relevanten Daten (siehe Detailspezifikation) des SMS-Empfangs werden in die Log-Datei geschrieben. Wenn eine SMS nicht die Anzahl verlangter Parameter enthält, wird der gesammte Auftrag im Filesystem in ein definiertes Verzeichnis verschoben. Der Kunde erhält eine Fehlermeldung per . Alle relevanten Daten (siehe Detailspezifikation) des SMS-Empfangs werden in die Log-Datei-Datei geschrieben. In allen Fehlerfällen wird die URL nicht gestartet und keine Bestätigungs-SMS versendet Spezielle nicht funktionelle Bedingungen Keine Häufigkeit der Nutzung Für jede empfangene SMS Verschiedenes Interpretation des Inhaltes der SMS siehe Kapitel (siehe Detailspezifikation) Die SMS-Software kann nicht selbstständig gesplittete SMS wieder zusammenfügen. Aus diesem Grund kann der CG nur SMS empfangen und verarbeiten, deren Inhalt die maximale Anzahl von 160 Zeichen nicht überschreiten UseCase: Benutzerdaten verwalten Actor Administrator der BEGASOFT Betroffene und Interessierte Der CG ist von diesem UseCase nicht betroffen. SQL-Datenbank. Microsoft SQL Server Vorbedingungen Microsoft SQL Server 2007 ist auf dem selben Host installiert und gestartet. Der Microsoft SQL Server 2007 hat zugriff auf die SQL-Datenbank Funktionsbeschreibung Der Administrator bearbeitet die Kundendaten mit Microsoft SQL Server Systemzustand nach erfolgreichem Ablauf Kundendaten sind erfasst, geändert, gelöscht Systemzustand nach fehlerhaftem Ablauf Keine Angabe möglich da der Administrator mit einer Software arbeitet welche sehr viele Möglichkeiten hat. Von keiner Änderung bis zur Unbrauchbarkeit der gesammten Datenbank ist alles möglich. Seite 16 von 27

17 Spezielle nicht funktionelle Bedingungen Keine Häufigkeit der Nutzung Für jede Änderung der gespeicherten Kundendaten des CG Verschiedenes Der Administrator in der Lage sein SQL-Queries zu erstellen welche Kundendaten finden, modifizieren, erstellen oder löschen. Seite 17 von 27

18 4. Anforderungen 4.1. Konventionen Vorlage Name Beschreibung V P Typ UC Name Notation [x].[y] Beschreibung [x] Zähler für den Anforderungstyp [y] Zähler für die Anforderung Version V Notation Beschreibung <1 In Bearbeitung mit dem Auftraggeber und dem Experten der Berner Fachhochschule 1.0 Abgegeben 1.x Nachträgliche Änderungen Priorität P Notation Beschreibung 1 Höchste Priorität oder alle Muss -Anforderungen 2 2. Prioritätsstufe oder Sollte -Anforderungen 3 3. Prioritätsstufe oder Eventuell -Anforderungen Typ Notation M O Beschreibung Muss -Anforderung Optionale Anforderung Wenn eine Folgeanforderung einer Optionalen Anforderung vom Typ Muss ist, muss die Folgeanforderung nur dann implementiert werden, wenn die Optionale Anforderung implementiert wurde. Z.B. die Implementation der Anforderung 2.5 für Anforderung 2.2 ist nur dann zwingend, wenn Anforderung 2.2 implementiert wurde UseCase UC Notation Beschreibung 3.5 Anforderung bezieht sich auf UseCase 3.5 Seite 18 von 27

19 4.2. SMS versenden Nummer Beschreibung V P Typ UC 2.1 Der CG nimmt Aufträge zum verschicken von SMS via WebService entgegen und führt diese aus. 2.2 Der CG nimmt Aufträge zum verschicken von SMS via entgegen und führt diese aus. 2.3 Der CG nimmt Aufträge zum verschicken von SMS via FTP-Client entgegen und führt diese aus. 2.4 Der CG gibt eine Meldung über Erfolg oder Misserfolg des SMS versendens via WebService und zurück an den Absender, bei Verwendung des BEGASOFT internen SMS-Dienstes M O O M Anforderungen 2.1 bis 2.4 werden vom CG in einer Log-Datei verfolgt M Der CG überprüft die Berechtigung der empfangenen Daten M Alle zu einem Auftrag gehörenden Dateien werden bei Erfolg, wie auch bei Misserfolg in entspechenden Verzeichnissen im Filesystem archiviert (siehe Detailspezifikation). Einzige Ausnahme, Fehler der SMS-Software, hier bleiben die Dateien im definierten Verzeichnis hängen M Der CG kann Textnachrichten bis zu einer Länge von 160 Zeichen verschicken M Der CG beherrscht das SMS-Spliting und teilt Textnachrichten welche Länger als 160 Zeichen sind auf mehrere SMS auf Fax versenden O 3.1 Nummer Beschreibung V P Typ UC 3.1 Der CG nimmt Aufträge zum verschicken von Fax-Nachrichten via WebService entgegen und führt diese aus. 3.2 Der CG nimmt Aufträge zum verschicken von Fax-Nachrichten via entgegen und führt diese aus. 3.3 Der CG nimmt Aufträge zum verschicken von Fax-Nachrichten via FTP-Client entgegen und führt diese aus M O O Anforderungen 3.1 bis 3.3 werden vom CG in einer Log-Datei verfolgt M Alle zu einem Auftrag gehörenden Dateien werden bei Erfolg, wie auch bei Misserfolg in entspechenden Verzeichnissen im Filesystem archiviert (siehe Detailspezifikation). Einzige Ausnahme, Fehler der Fax-Software, hier bleiben die Dateien im definierten Verzeichnis hängen M Der CG überprüft die Berechtigung der empfangenen Daten M 3.2 Seite 19 von 27

20 4.4. Daten an Applikationen senden Nummer Beschreibung V P Typ UC 4.1 Der CG kann via SMS-Modem SMS empfangen und die darin enthaltenen Informationen an eine Applikation weitergeben Meldungstypen werden in der Detailspezifikation definiert O Anforderung 4.1 wird vom CG in einer Log-Datei verfolgt M Der CG überprüft die Berechtigung der empfangenen Daten M Benutzerverwaltung Nummer Beschreibung V P Typ UC 5.1 Benutzerdaten sind in einer SQL-Tabelle gespeichert und werden direkt via Microsoft SQL Server 2007 bearbeitet M Benutzerdaten können in einem rudimentären GUI bearbeitet werden O Nichtfunktionale Anforderungen Nummer Beschreibung V P Typ UC 6.1 Der WebService ist Sprachunabhängig M X 6.2 Der WebService ist Plattformunabhängig M X 6.3 Der CG wird in der Programmiersprache Java geschrieben M X 6.4 Der CG, sowie die SMS- und Faxsoftware und das SMS-/Fax-Modem sind auf dem selben Server installiert M X 6.5 Verfügbarkeit > 90% M X 6.6 Gewichtung der Verfügbarkeit ist wichtig (Absteigend: systemkritisch, kritisch, wichtig) 6.7 Notfallszenario: Hotline Nummer BEGASOFT Reparatur im Fehlerfall, nach Aufwand 6.8 Systemsicherheit: Authentifizierung: Ja Vertraulichkeit durch Verschlüsselung: Nein Redundantes System: Nein Backup der Daten: Ja M X M X M X Seite 20 von 27

21 5. Abgrenzung 5.1. Verrechnungssystem Es ist kein Verrechnungssystem vorgesehen Backup Das Backup der anfallenden Daten übernimmt die Software eines Drittanbieters und ist nicht Teil des CG. Seite 21 von 27

22 6. Fehlerbehandlung 6.1. Konventionen Vorlage Nummer Beschreibung Aktion V P UC Name Notation [x].[y] Beschreibung [x] Zähler für den Fehlertyp [y] Zähler für die Fehlerbehandlung Aktion Notation Beliebig Beschreibung Kurzbeschreibung was der CG in diesem Fall tun soll Version V Notation Beschreibung <1 In Bearbeitung mit dem Auftraggeber und dem Experten der Berner Fachhochschule 1.0 Angenommen 1.x Nachträgliche Änderungen Priorität P Notation Beschreibung 1 Höchste Priorität oder alle Muss -Fehlerbehandlung 2 2. Prioritätsstufe oder Sollte -Fehlerbehandlung 3 3. Prioritätsstufe oder Eventuell -Fehlerbehandlung UseCase UC Notation Beschreibung 3.5 Anforderung bezieht sich auf UseCase 3.5 Seite 22 von 27

23 6.2. SMS versenden Nummer Beschreibung Aktion V P UC 2.1 Telefonnummer ist ungültig Auftragsdaten löschen Fehlermeldung zurückgeben oder Fehlerbenachrichtigung via an Absender 2.2 Unbekannter Kunde Nichts versenden Auftragsdaten löschen Fehlermeldung zurückgeben oder Fehlerbenachrichtigung via an Absender mit Hinweis wie bei BEGASOFT anmelden 2.3 Textnachricht zuviele Zeichen Nichts versenden Auftragsdaten löschen Fehlermeldung zurückgeben oder Fehlerbenachrichtigung via an Absender 2.4 Modemfehler Auftragsdaten in definiertes Verzeichnis verschieben Fehlermeldung zurückgeben oder Fehlermeldung zurückgeben oder Fehlerbenachrichtigung via an Absender 2.5 Textnachricht ist leer Auftragsdaten löschen Fehlermeldung zurückgeben oder Fehlerbenachrichtigung via an Absender 2.6 Auftragsdaten bleiben im definierten Verzeichnis liegen 6.3. Fax versenden Bei jedem Zyklus versucht der CG erneut den Auftrag auszuführen. Auftragsdaten müssen manuell gelöscht oder editiert werden Nummer Beschreibung Aktion V P UC 3.1 Telefonnummer ist ungültig Auftragsdaten löschen Fehlermeldung zurückgeben oder Fehlerbenachrichtigung via an Absender 3.2 Unbekannter Kunde Nichts versenden Auftragsdaten löschen Fehlermeldung zurückgeben oder Fehlerbenachrichtigung via an Absender mit Hinweis wie bei BEGASOFT anmelden Seite 23 von 27

24 Nummer Beschreibung Aktion V P UC 3.3 Ungültiger Attachment-Typ Nichts versenden Auftragsdaten löschen Fehlermeldung zurückgeben oder Fehlerbenachrichtigung via an Absender 3.4 Modemfehler Auftragsdaten in definiertes Verzeichnis verschieben Fehlermeldung zurückgeben oder Fehlerbenachrichtigung via an Absender 3.5 Auftragsdaten bleiben im definierten Verzeichnis liegen Bei jedem Zyklus versucht der CG erneut den Auftrag auszuführen. Auftragsdaten müssen manuell gelöscht oder editiert werden 3.6 Ungültiger Attachment-Typ Nichts versenden Auftragsdaten löschen Fehlermeldung zurückgeben oder Fehlerbenachrichtigung via an Absender 6.4. Daten an Applikation senden Nummer Beschreibung Aktion V P UC 4.1 SMS bleibt im definierten Verzeichnis liegen Bei jedem Zyklus versucht der CG erneut den Auftrag auszuführen. Auftragsdaten müssen manuell gelöscht oder editiert werden 4.2 Unbekannter Empfänger Auftragsdaten in definiertes Verzeichnis verschieben 4.3 URL ist nicht erreichbar Bei jedem Zyklus versucht der CG erneut den Auftrag auszuführen. Auftragsdaten müssen manuell gelöscht oder editiert werden 4.4 Auftrag versendenede Telefonnummer hat keine Berechtigung für die gewählte Applikation 4.5 Anzahl Parameter in SMS stimmt nicht mit den in der URL geforderten Anzahl überein Alarm- an in Properties-File konfigurierte E- Mailadresse Auftragsdaten in definiertes Verzeichnis verschieben URL nicht ansteuern Auftragsdaten in definiertes Verzeichnis verschieben Eintrag im Log-Datei Seite 24 von 27

25 7. Zeitplan 7.1. Tasks 7.2. Gantt-Diagramm Seite 25 von 27

26 Seite 26 von 27

27 8. Anhang 8.1. Wirtschaftlichkeitsbetrachtung Da schon ein älterer CG besteht, welcher dasselbe GSM-Modem und fast dieselbe Infrastruktur verwendet wie der neue CG, findet die Break-Even Formel hier keine Anwendung. Die Fixkosten sind beim älteren CG höher, die variablen Kosten verhalten sich jedoch in etwa identisch. Ein Schnittpunkt, welcher eine Gewinnschwelle markiert, kann also nicht berechnet werden. Da die BEGASOFT AG in näherer Zukunft vermehrt mit WebServices zu tun haben wird, diese Technologie jedoch noch nie verwendet hat, liegt der Gewinn in der Aneignung von Wissen. Hier stehen also primär nicht monetäre Überlegungen im Vordergrund, sondern die Erweiterung der Fachkenntnisse der BEGASOFT AG Referenzen Ian Sommerville, Software Engineering, 8. aktualisierte Auflage, Pearson Studium, ISBN Chris Rupp & die SOPHISTen, Requirements-Engineering und Management, 4. Auflage, Hanser 2007, ISBN: Bernd Oestreich, Analyse und Design mit UML 2.1 Objektorientierte Softwareentwicklung, 8. aktualisierte Auflage, Oldenbourg Verlag, ISBN: Seite 27 von 27