Installationsanleitung TFSInBox
HINWEIS Dieses Dokument dient nur zu Informationszwecken. Bei Verwendung des Dokumentes zu anderen Zwecken, lehnt COMPRA GmbH jede Gewährleistung wegen Sach- und Rechtsmängeln ab. COMPRA GmbH lehnt jede Haftung für direkte und indirekte Schäden sei es aus Vertrag oder aus Gesetz ab, die in Verbindung mit der Anwendung und sonstiger Nutzung des Dokumentes entstehen können. Dieses Dokument kann bei Bedarf ohne vorherige Ankündigung von COMPRA GmbH geändert werden. Der Inhalt dieses Dokumentes ist urheberrechtlich geschützt. Ohne schriftliche Erlaubnis von COMPRA GmbH darf das Dokument weder ganz noch teilweise in irgendeiner Form vervielfältigt werden. Die beschriebenen Programme dürfen nur gemäß den Lizenzbedingungen angewendet oder kopiert werden. COPYRIGHTVERMERK Copyright 2012 COMPRA GmbH, Bavenstedter Straße 50, 31135 Hildesheim. Alle Rechte vorbehalten. WARENZEICHEN Die Warenzeichen Microsoft, Windows, Windows NT sind entweder eingetragene Warenzeichen oder Warenzeichen der Microsoft Corporation in den USA und/oder anderen Ländern. Alle nicht ausdrücklich gewährten Rechte sind vorbehalten. Publiziert von COMPRA GmbH. Stand: 26.04.2012 Seite 2 von 8
1. Systemanforderungen Folgende Systemanforderungen müssen mindestens erfüllt sein: Clients Windows XP Windows Server 2003 Windows Vista Windows Server 2008 Windows 7 Windows Server 2008 R2 Visual Studio Team Foundation Server 2010 2. Installation Installieren Sie die TFSInBox einmalig auf einem Server, auf dem auch der Team Foundation Server läuft und auf dem die TFSInBox eingesetzt werden soll. Für die Installation benötigen Sie administrative Rechte auf dem Server. Um TFSInBox auf Ihrem Rechner zu installieren: 1. Starten Sie die Installationsdatei. 2. Wählen Sie unter den Sprachen Deutsch oder Englisch. Seite 3 von 8
3. Starten Sie das Setup. 4. Akzeptieren Sie die Lizenzvereinbarung EULA. 5. Legen Sie den Speicherort fest. Seite 4 von 8
6. Wählen Sie ein Benutzerkonto für die Verwendung des Dienstes aus. Über Durchsuchen lassen sich in der Umgebung vorhandene Benutzerkonten suchen bzw. anzeigen. Achten Sie dabei auf die benötigten administrativen Rechte des Benutzers! Die Benutzer des Dienstes benötigen die Rechte um im TFS Workitems anzulegen! Außerdem lassen sich über Informationen über neuen Benutzer Daten zu einem, während der Installation angelegten Benutzer eingeben. Seite 5 von 8
7. Installieren. 8. Die TFSInBox wurde erfolgreich installiert. Seite 6 von 8
3. Workitems über email-client erstellen Im folgenden Abschnitt wird beschrieben, wie man durch Versenden einer formatierten email ein Workitem im Team Foundation Server erstellen kann. 3.1. Beispiel-Konfiguration Nach der Erst-Installation ist eine Neue Konfiguration erforderlich. Sie können beliebig viele Konfigurationen erstellen. Dafür wird Folgendes benötigt: POP Verbindungsdetails o POP Server o POP Port o SSL o Login o Passwort o Intervall (Intervall, in dem die emails abgeholt und Workitems angelegt werden) o Adress-Filter (email-filter für gültige Absenderadressen, es sind Wildcards erlaubt, um Absender einer Domäne zuzulassen) Team Foundation Server Informationen Einstellungen zur Workitem-Erstellung Seite 7 von 8
3.2. Beispiel-eMail Beim Versenden der folgenden email wird der email-betreff zum Workitem-Titel, der email-body zur Workitem-Beschreibung und eventuelle email-anhänge und Bilder werden mühelos und unkompliziert in ihr TFS-Workitem übertragen. 4. Workitems über Softwareschnittstelle erstellen Woher die emails ursprünglich stammen, die an das TFSInBox Postfach versendet werden, ist für die Verarbeitung irrelevant. Wenn man Software so konfiguriert, dass sie eine email versendet sobald diese z.b. eine Fehlermeldung anzeigt, lässt sich automatisch ein Workitem erstellen. Diese Softwarefunktion ersetzt quasi die Beispiel- email aus Punkt 3.2. Beispielszenario: Tritt ein bestimmtes Event (bspw. eine Fehlermeldung) beim Kunden auf, welcher via TFSInBox mit dem Hersteller verbunden ist, wird dem Hersteller diese Fehlermeldung automatisch als Workitem im TFS zugestellt. Seite 8 von 8