Der Zugriff auf den Team Foundation Server 2008 mit Authentifizierung und über eine SSL Verbindung ist fast identisch zu dem Vorgehen mit der Version 2005. Leider hat sich aber auch nichts verbessert. Es ist die gleiche, fehleranfällige Bastelei: Walkthrough: Setting up Team Foundation Server with Secure Sockets Layer (SSL) and an ISAPI Filter

Dieser Artikel ist fast identisch zur vorherigen Version. Bei den Unterschieden ist der Artikel aber noch inkonsistent. Zum Beispiel ist der neue ISAPI FIlter AuthenticationFilter.dll im Tools Verzeichnis. An einigen Stellen nennt der Walkthrough aber noch fälschlich das TF Setup Verzeichnis. Amüsanterweise gibt es genau dazu noch eine Important Note ohne echte Aussage:

Do not change the directory of either the AuthenticationFilter.ini file or the AuthenticationFilter.dll file. Doing so increases the likelihood that you will have problems upgrading from Team Foundation SP1 to Team Foundation SP1.

Wenn man der Anleitung gründlich folgt, klappt es Ende tatsächlich und der externe Zugriff ist möglich.

Ich empfehle, dabei wirklich sorgfältig zu sein. Ich habe an einer Stelle den TFS Application Server und das SharePoint Portal vertauscht. Irgendwann sehen die Port Adressen alle so ähnlich aus. Die resultierenden Fehlermeldungen haben mich leider eine Zeit beschäftigt.

Zusätzlich sollte man auch alle ursprünglichen Einstellungen und die vorgenommen Änderungen dokumentieren. Es ist damit zu rechnen, dass auch das nächste Update nur eingespielt werden kann, wenn das System wieder im Ausgangszustand ist. Zumindest erging es mir bei diesem Update so.

In allen Blogs ist es zu lesen: Visual Studio 2008 ist fertig. MSDN Abonnenten können die RTM Version downloaden. Zusammen mit dem Visual Studio gibt es auch einen neuen Team Foundation Server (TFS).

Nach meinen Erfahrungen beim Service Pack 1 für die Version 2005, habe ich vor dem Upgrade ein Image der Serverplatte angelegt. Und natürlich kam beim Setup eine Fehlermeldung:

TF220064: An error occurred while the Setup program was querying the settings from the server that is running SQL Server Reporting Services. This error is most likely caused by your account not having the required administrative permissions on the server that is running Reporting Services. Click Next to try again. For more information about this error, see the installation logs. For more information about the installation logs, see “Troubleshooting Installation for Team Foundation” in the Team Foundation Installation Guide.

Der Setup kann nicht mit den SQL Server Reporting Services reden. Die Konfiguration der Schnittstelle zu den Reporting Services findet sich in der TfsIntegration Datenbank in der Tabelle tbl_service_interface. Die Einstellungen hatte ich aber geändert. Mein TFS war so konfiguriert, dass er auch externe Verbindungen zulässt. Der Setup kann offensichtlich nicht über eine https-Verbindung mit Authentifizierung kommunizieren. Das nehme ich ihm nicht übel und habe wieder die unverschlüsselten, lokalen http-Endpunkte eingetragen.

Vorher:

3    BaseReportsUrl    https://team.cptec.org:589/Reports
3    DataSourceServer    https://team.cptec.org:589/ReportServer
3    ReportsService    https://team.cptec.org:589/ReportServer/ReportService.asmx
4    BaseServerUrl    https://team.cptec.org:589
4    BaseSiteUrl    https://team.cptec.org:589/sites
4    WssAdminService    https://team.cptec.org:590/_vti_adm/admin.asmx

Nacher:

3    BaseReportsUrl    http://r8/Reports
3    DataSourceServer    http://r8/ReportServer
3    ReportsService    http://r8/ReportServer/ReportService.asmx
4    BaseServerUrl    http://r8
4    BaseSiteUrl    http://r8/sites
4    WssAdminService    http://r8:17012/_vti_adm/admin.asmx

Praktischerweise hatte der Fehler Dialog einen Retry Button. Man kann also schnell im offenen Herzen operieren und es noch mal probieren. Damit lief der Setup dann auch wieder einige Zeit weiter.

Error 28925.TFServerStatusValidator: The tool could not call the Team Foundation Server ServerStatus Web service. Verify that your network is configured to allow communication between the Team Foundation application tier and the Team Foundation data tier. For more information, see the setup log.

Jetzt können die einzelnen Schichten vom TFS nicht miteinander reden. Bestimmt auch wegen den nachträglich konfigurierten externen Verbindungen. Und richtig, diesmal war es der zusätzliche ISAPI Filter AuthenticationFilter.dll. Nachdem der Filter im IIS Manager wieder entfernt war, ging auch an dieser Stelle wieder der Retry. Diesmal ohne weitere Fehler und der interne Zugriff mit Visual Studio 2008 funktioniert.

Man sollte alle Änderungen am TFS 2005, die im Walkthrough: Setting up Team Foundation Server with Secure Sockets Layer (SSL) and an ISAPI Filter durchgeführt werden vor dem Upgrade rückgängig machen.

Jetzt kommt der nächste Schritt: Auch TFS 2008 möchte ich von Heimarbeitsplatz erreichen. Die externe Verbindung muss also wieder eingerichtet werden...

Natürlich ist es bereits aufgefallen: Wir hatten einen sehr gut gestalteten Stand bei der Tekom Messe :).

Von einer technischen Redaktion oder gar einem Software Entwickler wird man keinerlei künstlerische Ambitionen erwarten. Die haben wir auch nicht. Dabei hilft uns Angelika Schopper von Anschi Illus.

Bei Ihren News gibt es die Erklärung zum Konzept und weitere Bilder von der Messe.

Ich beobachte seit einigen Monaten den Microsoft Windows Live Custom Domain Dienst. Grundsätzlich funktioniert das Angebot, aber insbesondere bei der Administration gibt es einige Schwachstellen. Inzwischen ist meine Begeisterung ein bisschen verebbt, weshalb ich noch nicht zu einem Posting über die Defizite bei der Administration gekommen bin.

Um so neugieriger war ich, als im Custom Domains Blog zu lesen war, dass es eine neue Version 3.0 gibt. Dabei hat sich der Name geändert WLCD heißt jetzt WLAC, oder ausgeschrieben Windows Live Admin Center. Bei einem Admin Center erwarte ich natürlich eine verbesserte Administration. Was ist jetzt neu?

We're excited to introduce the ability for you to customize services like Windows Live Hotmail® with your own logo.

Wow, ein eigenes Logo! Darauf hatte ich jetzt nicht gerade gewartet. E-Mail Weiterleitung, Kalender Synchronisierung, Verteilerlisten oder die Möglichkeit, Sicherheitseinstellungen für Benutzer vorzugeben, hätten mich interessiert.

Inzwischen gibt es bei Google Gmail mit IMAP Support. Da wird sich das Live Team anstrengen müssen.

Wir haben es tatsächlich geschafft unseren Stand aufzubauen. Er sieht natürlich toll aus. Wenn nicht das viele Herumgestehe wäre, würde so eine Messe wirklich Spaß machen.

Falls uns jemand besuchen möchte, so sieht der Stand aus:

Mein armer Chef! Er nimmt auch Spenden!

Ich finde es ist wichtig, für jede Aufgabe das geeignete Tool einzusetzen. In der Technischen Dokumentation arbeitet der Redakteur häufig in MS Word oder in Adobe FrameMaker. Beide ermöglichen das Erstellen der entsprechenden Inhalte. Ohne weitere Unterstützung liegen diese Inhalte dann als Dokumente in Verzeichnissen des Dateisystems. Die Verzeichnisstruktur wird typischerweise die Projekte, Sprachen und Versionen wiederspiegeln. Die Dokumente selbst stellen meist große Informationseinheiten dar: Kapitel oder vielleicht sogar die komplette Dokumentation.

Ein kleines Team, gut organisierter Redakteure, kann bei dieser Vorgehensweise effizient arbeiten. Es gibt kaum Verwaltungsaufwand. In vielen Fällen müssen die Informationseinheiten aber besser verwaltet werden. Größere Teams, viele Übersetzungen, viele Varianten und unterschiedliche Ausgabeformate sind Gründe für eine umfassendere Lösung.

Man braucht also ein Inhaltsverwaltungssystem oder Englisch Content-Management-System (CMS). Offensichtlich denken bei dem Begriff CMS inzwischen zu viele an die weborientierte WCMS Variante. Für Systeme die nicht nur Webseiten, sondern auch Druck und andere Ausgabeformate unterstützen verwendet man deshalb auch den Begriff Redaktionssystem.

Wir haben uns näher mit SCHEMA ST4 befasst, einem sehr mächtigen Vertreter unter den Redaktionssystemen. Dabei haben wir uns soweit eingearbeitet, dass wir SCHEMA Certified Partner wurden. Wir betreiben eine Testinstallation und eine Kollege und ich waren bei SCHEMA zu einer mehrtägigen Konfigurationsschulung.

Eine SCHEMA Konfiguration hat sehr viel mit XML/XSL Programmierung zu tun. Das System ist sehr offen und modifizierbar. Es ist wirklich sehr viel möglich, man darf aber keine Angst vor spitzen Klammern haben.

Ansonsten gefällt mir als .NET Entwickler natürlich der Technologie-Stack: Als Datenbank kommt standardmäßig ein SQL Server 2005 zum Einsatz, darüber kommt ein .NET basierter Applikationsserver auf den wiederum .NET Clients zugreifen. Alle Daten treten als XML in Erscheinung und werden über XSL formatiert. Selbst die in der Benutzeroberfläche dargestellten Elemente werden über XPath gesteuert.

Nach einer kleinen Einleitung, möchte ich nun einen Überblick geben, wie unsere 3D Ersatzteilkatalog-Lösung interaktive PDFs mit 3D Objekten erzeugt. SPCat3D selbst besteht aus mehreren Komponenten, die wiederum mit externen Programmen zusammenarbeiten:

Auf der linken, oberen Seite sehen wir unsere klassische Katalog-Software SPCat. Dieser Ersatzteilkatalog bietet uns sehr viele Möglichkeiten hierarchische Teilelisten zu importieren und zu bearbeiten. Wir verwenden diese erprobte Technologie als Stücklisten-Datenbasis weiter.

SPCat3D PDF Creator greift bei der PDF Produktion auf die SPCat Datenbank zu. Die Schnittstelle ist aber so ausgelegt, dass auch andere Datenquellen möglich sind. Unser eigener SPCat ist nur die nächstliegende und einfachste Anbindung. Andere Katalog-Systeme oder direkter Zugriff auf ERP Daten (SAP) sind auch denkbar.

Parallel müssen die 3D-CAD Daten aufbereitet werden. Wir verwenden dazu von Right Hemisphere die Deep Exploration CAD Edition. Mit diesem Tool können wir alle relevanten CAD Formate öffnen und bearbeiten. Unter anderem können wir damit die CAD Daten reduzieren und mit einer animierten Explosionsdarstellung versehen.

Der nächste Schritt ist die Zuordnung der Stückliste zu den CAD Grafiken und den einzelnen Objekten innerhalb einer Grafik. Dabei hilft es, dass Deep Exploration die Metadaten aus den meisten CAD Formaten übernehmen kann. Die genaue Vorgehensweise in dieser Stelle hängt sehr stark von den Ausgangsdaten ab.

Deep Exploration enthält ein PDF Publishing Module das es ermöglicht 3D Illustrationen in eine PDF Vorlage (Template) einzufügen. Von Right Hemisphere gibt es bereits einige fertige Templates die interaktive PDFs ermöglichen. Wir benötigen aber eine sehr viel weitergehende Funktionalität. Deswegen arbeiten wir mit unseren eigenen SPCat Templates.

Die Ausgabe des PDF Publishing Modules sind PDF Dateien mit eingebetteten 3D Objekten in unserem Template. Aber noch ohne die Möglichkeit zur Interaktion, denn dafür wir benötigen wir die Informationen aus der Stückliste.

Das ist dann die eigentlich Aufgabe unseres SPCat3D PDF Creators. Dieses Tool führt alle Informationen und Dateien zusammen. In die vorher erzeugten, statischen PDF Dateien wird die Stücklisten Information eingebettet. Es werden zusätzliche PDF Dateien erzeugt, die den Zusammenhang der einzelnen Baugruppen darstellen und die entsprechenden PDF Dateien miteinander verknüpfen.

Im Ergebnis erhält man ein Verzeichnis mit PDF Dateien, die die komplette Stückliste wiedergeben und die einzelnen 3D Illustrationen hierarchisch korrekt miteinander verbinden. Zusätzlich gibt es einen PDF Datei die einem Bestellformular entspricht und wie ein Warenkorb interaktiv aus den anderen PDF Dateien heraus gefüllt werden kann.

Wir bieten seit langem einen elektronischen Ersatzteilkatalog an, unseren Spare Part Catalog SPCat. Diese Software kommt sehr gut mit Stücklisten und 2D Zeichnungen klar. Bei 3D CAD Daten hatten wir bisher keine Lösung. Genau diese Funktionalität wird aber immer häufiger nachgefragt.

Die Visualisierung dreidimensionaler CAD Objekte ist aber ein Problem, das eine kleine Entwicklergruppe nicht mal eben lösen kann. Man muss zum einen die Dateien aus verschiedensten CAD Programmen verarbeiten können. Zum anderen braucht es einen Viewer, der die erstellten 3D Illustrationen darstellen kann sich gut in die restliche Ersatzteilkatalog-Software integrieren lässt.

Alle mir bekannten Anbieter von elektronischen Ersatzteilkatalogen haben sich entschlossen, dieses Know-How einzukaufen. Die meisten verwenden die Produkte von Lattice3D und binden deren freien XVL Player in Ihre Kataloge ein.

Es gibt auch eine interne SPCat Demo Version mit XVL Player die ganz gut funktioniert. Aber irgendwie fand ich es langweilig, wenn am Ende alle Kataloge den gleichen 3D Viewer verwenden und habe weiter gesucht. Dabei bin ich auf die Firma Right Hemisphere gestoßen. Auch von diesem Anbieter gibt es einen Betrachter (Deep View) der sich in eigene Anwendungen einbinden lässt. Deren Produkte können über 80 CAD Formate importieren und alle von uns getesteten Dateien wurden problemlos eingelesen.

Besonders spannend wurde es aber, als ich die Zusammenarbeit von Adobe und Right Hemisphere verstanden hatte: Right Hemisphere ist der Anbieter, der die Ausschreibung von Adobe gewonnen hatte, das PDF Format um einen 3D Viewer zu erweitern. Entsprechend gut ist in deren Produkten die Erzeugung von PDF Dateien mit eingebetteten 3D Objekten realisiert.

Bisher hatten wir in Richtung einer Software mit integrierten Viewer gedacht, jetzt gibt es eine weitere Möglichkeit: Die 3D Illustrationen werden in PDF Dateien eingebetteten und die Verknüpfung zur Stückliste und die Interaktion mit dem Anwender erfolgt komplett innerhalb das Acrobat Readers. Das bedeutet die Auslieferung des fertigen Katalogs vereinfacht sich enorm. Man muss lediglich einige PDF Dateien verteilen. Der Endanwender benötigt lediglich einen installierten Acrobat Reader 8.1. Die weite Verbreitung des Readers führt dazu, dass in aller Regel gar keine Vorbereitungen oder Installationen beim Endanwender nötig sind. Er öffnet nur eine PDF Datei.

Aktuell gibt es den Acrobat Reader in der Version 8.1 für folgende Betriebssysteme: Windows, Mac, Linux und Solaris. Das heißt ein SPCat 3D PDF-Ersatzteilkatalog funktioniert plattformübergreifend.

Zum Beispiel ein Pumpstand, dargestellt mit Linux Ubuntu 6.1 und dem Acrobat Reader 8.1.1 für Linux:

Der Testrechner ist nach heutigen Maßstäben wirklich langsam mit seinem Athlon 900. Ich habe eine nackte Ubuntu Installation verwendet, lediglich den Acrobat Reader 8.1.1 habe ich installiert. Es war von Seiten der Grafikkarte keinerlei 3D Unterstützung vorhanden. Trotzdem wurde das PDF mit dem 3D Objekt problemlos dargestellt und alle Interaktionen haben funktioniert. Lediglich bei Veränderung der 3D Ansicht kam das System ins Stocken und fiel auf eine Drahtgitter-Darstellung zurück.

Bei der eigentlichen Darstellung von 3D Illustrationen hat uns Adobe eine Menge Arbeit abgenommen. Wir können uns also ganz auf die Interaktivität und die Integration mit den Stücklisten und Ersatzteilinformationen konzentrieren.

Weiter geht es mit einem kleinen Überblick.

Bisher hatten wir einen FTP Server um größere Datenmengen mit unseren Kunden und Übersetzern auszutauschen. Aber FTP ist nicht mehr zeitgemäß: FTP muss sterben. Deswegen betreiben wir jetzt einen WebDAV Server der nur über eine sichere https-Verbindung zu erreichen ist.

Zu einem neuen Protokoll braucht es auch einen neuen Client um darauf zuzugreifen. Ich habe einige ausprobiert und am Ende sind zwei sinnvolle Möglichkeiten übrig geblieben:

Internet Explorer

Der Internet Explorer hat den Vorteil, dass er bereits installiert ist und der Zugriff sehr einfach zu konfigurieren ist. Man muss lediglich darauf achten, dass man die Adresse nicht direkt in Adresszeile tippt, sondern einen Web Folder öffnet.

Dazu wählt man Datei - Öffnen... (File - Open...) im Menü aus. Tippt dort die Adresse ein und setzt das passend Häkchen:

Danach kann man per Copy & Paste Dateien und Verzeichnisse übertragen. Über die rechte Maustaste erhält man ein Kontext-Menü für weitere Aktionen.

Ein Nachteil vom Internet Explorer als WebDAV Client ist, dass er keinen sinnvollen Übertragungsstatus anzeigt und sich während der Übertragung tot stellt. Man hat das Gefühl, IE oder die Verbindung "klemmt". Wir hatten schon den Fall, dass dabei dann per Task Manager iexplorer.exe und damit die Übertragung beendet wurde.

Außerdem kann man im IE über das Ziel hinaus navigieren. Wir haben für jeden Kunden einen eigenen Unterordner angelegt. Nur CPTec Mitarbeiter dürfen auf den ganzen Server zugreifen. Jeder Kunde hat nur Zugriff auf seinen Ordner. Dennoch erlaubt es der Internet Explorer eine Ebene nach oben zu navigieren. Dort gilt das Kunden Passwort natürlich nicht mehr, also frägt der Internet Explorer nach einem Passwort. Der Kunde gibt natürlich wieder sein Passwort ein. Das gilt für diese Ebene aber trotzdem nicht.

Das führt leider sehr schnell zu einer Support-Anfrage. Deswegen empfehle ich den Total Commander. Der erkennt, mit welcher URL die Verbindung gestartet wurde.

Total Commander + WebDAV Plug-in

Der beliebt Dateimanager Total Commander hat bereits einen sehr guten, integrierten FTP Client. Für den WebDAV Zugriff ist ein kostenloses WebDAV Plug-in nötig.

Die heruntergeladene Zip-Datei mit dem Plug-in einfach in Total Commander öffnen. Das Programm erkennt das Plug-in und bietet die Installation an:

Weniger intuitiv ist dann die Aktivierung des Plug-ins. Man muss über die Laufwerksauswahl die Netzwerkumgebung (Network Neighborhood) auswählen:

Bei den Netzwerklaufwerken taucht der zusätzliche Eintrag WebDAV auf. Den wählt man aus und gelangt zu den WebDAV Verbindungen:

Über F7 kann eine neue Verbindung angelegt werden. Obwohl der dabei auftauchende Dialog von einen neuen Verzeichnis spricht, wird trotzdem eine WebDAV Verbindung angelegt!

Wenn man einen Namen für die Verbindung vergeben hat, erscheint der Optionen Dialog:

Praktischerweise steht unser Server-Typ als Standardeinstellung zur Verfügung: Microsoft IIS (Secure). Damit werden die unteren Parameter automatisch richtig konfiguriert. Es muss hier nur noch die URL zum Server, der Benutzername und das Passwort konfiguriert werden. Die Proxy Einstellung vom Internet Explorer (im Dialog unten) sollte in den allermeisten Fällen stimmen.

Danach kann die neue Verbindung ausgewählt werden. Mit den üblichen Befehlen von Total Commander können Dateien in beide Richtungen übertragen und gelöscht werden.

Die Eigenschaften einer bestehenden Verbindung stehen über das Kontext-Menü oder Alt+Enter zur Verfügung.

Falls man die Verbindung häufiger benutzt, kann man diese wie ein normales Verzeichnis zur Directory Hotlist hinzufügen (CTRL+D). Der Verbindungsaufbau ist dann nur eine Frage von ganz wenigen Tasten.

Update:

Unser erster Kunde hat tatsächlich versucht, nach dieser Anleitung den Total Commander zu konfigurieren. Dabei sind zwei Dinge aufgefallen:

1. Die Auswahl-Liste mit den Server Einstellungen setzt bei einer Auswahl nur die Checkboxen weiter unten. Die Einstellung der Liste selbst wird nicht gespeichert. Das heißt beim nächsten Aufruf der Optionen steht dort wieder: <Choose new server type from list>. Das verwirrt, aber die Einstellung unten sollten trotzdem stimmen.
2. Das Plug-in kommt mit bestimmten Sonderzeichen als Passwort nicht zurecht. In unserem Fall hatten wir das Zeichen § im Passwort. Das führte dazu, dass das Passwort nicht gespeichert wurde. Nachdem wir ein anderes Zeichen verwendet haben, funktioniert auch das.

Im Rahmen der tekom-Jahrestagung 2007 vom 07. bis 09. November findet eine Messe mit Ausstellern aus dem Bereich der Technischen Dokumentation statt. Da darf die CPTec GmbH natürlich nicht fehlen. Dr. Kurt Schopper und ich werden den Stand bewachen und versuchen jeden Besucher für unsere Konzepte zu interessieren.

Ich denke wir werden unsere Kompetenz in der Technischen Dokumentation und bei elektronischen Ersatzteilkatalogen überzeugend darstellen können. Ein paar Informationen gibt es bereits auf unserer Webseite. Weitere Details, insbesondere zu unseren 3D Ambitionen, folgen hier in Kürze.