Office Client

Veröffentlicht: 31. Jan 2006

AdventureWorks Cinema 1.0

Der Office Client besteht aus einem Wizard der sich in Microsoft Office Word 2003 integriert. Mit der Hilfe dieses Wizard kann ein Mitarbeiter von AdventureWorks einen Flyer, ein Datenblatt oder einen Newsletter erstellen.

Auf dieser Seite
Aufbau des SamplesAufbau des Samples
Technologien und KonzepteTechnologien und Konzepte
FunktionalitätenFunktionalitäten
DownloadDownload

Ziel dieser Beispielanwendung ist es zu zeigen, wie man das leistungsstarke Microsoft .NET Framework 2.0 mit dem weitverbreiteten Microsoft Office 2003 (hier speziell Microsoft Office Word 2003) kombinieren kann.

Der Vorteil für den Nutzer dieser Applikation ist, dass er weiter mit dem bekannten Microsoft Office Word 2003 arbeiten kann und sich nicht in eine neue Software einarbeiten muss. Außerdem ist der Office Client so aufgebaut, dass er ähnlich in der Bedienung zu dem Serienbrief-Assistenten von Microsoft Office Word 2003 ist.

Auf diese Weise kann der Nutzer einfach verschiedene Arten von Dokumenten erstellen, die Daten aus der zentralen Datenbank des CinemaServers enthalten.

Der Office Client wurde komplett in Visual Basic .NET programmiert.

Aufbau des Samples

Der Office Client besteht aus einem Wizard, der dem Benutzer das Erstellen eines Flyers, Datenblatts oder Newsletters und dessen Versand erleichtert.

Office Client

Der Wizard kann nur durch vorherige Anmeldung verwendet werden, um sicherzustellen, dass nur Mitarbeiter von AdventureWorks Cinema Zugriff haben.

Hat man sich erfolgreich angemeldet, dann führt der Wizard den Benutzer durch die Schritte bis zur Erstellung des jeweiligen Dokumenttyps. Am Schluss des Wizards kann man das erstellte Dokument speichern oder drucken bzw. den Newsletter versenden.

Technologien und Konzepte

Der AdventureWorks Cinema Office Client ist in eine Microsoft Office Word 2003 Dokumentvorlage integriert. Öffnet man diese Dokumentvorlage, wird automatisch der Code aus der angehängten Assembly geladen. Diese beinhaltet verschiedene Strukturen, die die Steuerung des Office Client übernehmen.

Wie alle anderen Clients dieser Beispielanwendungen besteht auch der Office Client aus drei Schichten.

Die Servicezugriffschicht stellt die Verbindung zu dem CinemaServer her, die gemeinsame Geschäftslogik beinhaltet die Logik, die die passenden Daten an die dritte Schicht liefert, welche die Interaktion mit dem Nutzer und die Darstellung der Ergebnisse enthält.

Diese dritte Schicht besteht aus einem Benutzerinterface in Form eines Wizards und einigen Generatorklassen, die die gesammelten Daten in das Word-Dokument schreiben.

Das Benutzerinterface setzt sich aus WinForms-Steuerelementen zusammen, die in dem Bereich der ActionsPane von Word wie in einer WinForms-Anwendung eingesetzt werden können.

Um eine Struktur in dem Word-Dokument zu definieren, werden nach der Auswahl des zu erstellenden Dokumenttyps mehrere benannte Bookmarks in das Word-Dokument eingefügt. Jedes dieser Bookmarks definiert einen Bereich, in dem die Daten durch die Generatorklassen automatisiert eingefügt werden können.

Diese Vorgehensweise gewährleistet die Trennung zwischen den generierten Daten und den manuellen Veränderungen die der Nutzer im Word-Dokument jederzeit vornehmen kann.

Das Editieren des Word-Dokumentes durch die Generatorklassen erfolgt über das Objektmodell von Microsoft Word. Auf diese Weise lassen sich einerseits Inhalte, wie zum Beispiel Texte, Tabellen und WordArt-Elemente, in das Word-Dokument einfügen und formatieren und andererseits können Funktionen von Word automatisiert angesprochen werden.

Eine dieser Funktionen ist der Seriendruck-Assistent, der für das Versenden des erstellten Newsletters per E-Mail mit Kontaktdaten aus dem CinemaServer versorgt wird. So kann der Newsletter auf Knopfdruck inklusive aller Empfänger an ein vorhandenes E-Mail-Programm, wie zum Beispiel Microsoft Outlook, übergeben werden.

Hierbei kann soweit mit dem Seriendruck-Assistent interagiert werden, dass für jeden Empfänger personalisierte Newsletter verschickt werden können.

Sicherheit

Die Benutzung des Office Clients erfordert eine Anmeldung mit gültigen Authentifizierungsdaten, mit denen aktuelle Informationen von dem CinemaServer bezogen werden können.

Zusätzlich ist eine Authentifizierung als Kinomitarbeiter nötig, um den Newsletter verschicken zu können, da hier auf die vertraulichen E-Mail-Kontaktdaten der Kunden zugegriffen werden muss.

Lokalisierbarkeit

Um die Applikation leicht auf verschiedene Sprachen lokalisieren zu können, sind alle sprachspezifischen Texte in Ressourcen-Dateien ausgelagert. Auf diese Weise lassen sich weitere dieser Sprachdateien ergänzen, ohne den Quellcode der Applikation ändern zu müssen.

Funktionalitäten

Gleich nach dem Start vom OfficeClient muss der Benutzer sich anmelden. Dabei wählt man ebenfalls eine Verbindungsart aus. Entweder verbindet man sich zum CinemaServer (Online-Modus) oder man benutzt statische Beispieldaten (Demo-Modus). Den Verbindungsmodus kann man jederzeit auch wieder wechseln, wobei jedoch das komplette Dokument gelöscht wird, da der Wizard neu gestartet werden muss.

Nach erfolgreicher Anmeldung bekommt der Benutzer sofort den Wizard zu sehen. Dieser ist so aufgebaut, dass man vorwärts und rückwärts zwischen den jeweiligen Schritten navigieren kann.

Nach dem Start des Wizards kann man sich zwischen einem Flyer, einem Datenblatt und einem Newsletter entscheiden. Dabei ist die Vorgehensweise bei allen drei Dokumenttypen sehr ähnlich. Im ersten Schritt gibt man einen Titel für das Dokument und wenn benötigt weitere Eigenschaften ein (wie beim Newsletter: Grußwort, Absender,.). Im zweiten und letzten Schritt von Flyer und Datenblatt wählt man lediglich die Filme aus einer Liste aus, die man eingefügt haben möchte. Beim Newsletter werden im Unterschied zu Flyer und Datenblatt die News, die angezeigt werden sollen, beim zweiten Schritt ausgewählt. Im dritten Schritt kann man dann beim Newsletter die einzufügenden Filme auswählen. Im vierten und letzten Schritt vom Newsletter muss man sich ein zweites Mal anmelden, da hier auf persönliche Daten der registrierten Benutzer zugegriffen werden. Nach Anmeldung werden die Benutzerdaten abgefragt und der Serienbrief-Assistent von Microsoft Office gestartet. Der Serienbrief-Assistent wird dabei auch schon mit den definierten Daten vorbelegt, so dass man den Newsletter sofort durch Klick auf "E-Mail." abschicken kann.

Wenn man einen Newsletter erstellt, muss man darauf achten, dass dieses Dokument nicht gespeichert werden kann. Die persönlichen Daten des Benutzers werden sofort beim Schließen des Word-Dokuments aus datenschutzrechtlichen Gründen gelöscht. Dadurch wäre es bei einem erneuten Öffnen des Dokumentes nicht mehr möglich, den Newsletter erneut zu verschicken.

Download

Voraussetzungen

1.

Installieren Sie eine der folgenden Versionen von Microsoft Office 2003:

Microsoft Office Professional Edition 2003

Microsoft Office Professional Enterprise Edition 2003

Microsoft Office Word 2003

Microsoft Office Professional Edition 2003 Trial

2.

Installieren Sie die primären Interop-Assemblys für Office und VBA während der Officeinstallation. (Weitere Informationen hierzu finden Sie unter http://msdn2.microsoft.com/de-de/library/kh3965hw.aspx)

3.

Installieren Sie Office 2003 Service Pack 1 oder höher.

4.

Installieren Sie Visual Studio 2005 Tools für Office oder Visual Studio 2005 Team System inklusive der Programmiersprache Visual Basic.

Wenn Sie die Installation von Visual Studio nach der Installation von Microsoft Office durchgeführt haben, müssen Sie die "Visual Studio Tools für Office"-Laufzeitumgebung reparieren, indem Sie VSTOR.exe ausführen. (Weitere Informationen hierzu finden Sie unter http://msdn2.microsoft.com/de-de/library/ms178739.aspx)

Zum Verschicken des Newsletters benötigen Sie ein MAPI-kompatibles E-Mail-Programm (z.B. Outlook 2003).

Optional:
Installieren Sie den AdventureWorks CinemaServer.

Installation

1.

Entpacken Sie die Datei "CinemaOfficeApplication.zip".

2.

Öffnen Sie die Solution "CinemaOfficeApplication.sln" in Visual Studio

3.

Starten Sie die Applikation in Visual Studio.

4.

Es öffnet sich ein Microsoft Word Fenster mit dem Cinema Office-Client im Aufgabenbereich Dokumentaktionen.

5.

Auf dem ersten Panel der Applikation, dem Anmeldepanel, tragen Sie die Benutzerkennung "Administrator" und das Passwort "admin" ein. Weitere Benutzerdaten finden Sie hier.

6.

Setzen Sie den Verbindungsmodus auf "Demo-Modus (offline)".

7.

Klicken sie "Anmelden".

Alternativ (Online-Modus):

1.

Installieren Sie den CinemaServer.

2.

Starten Sie den CinemaServer.

3.

Starten Sie den Office Client (Schritte 1.-4.).

Jetzt können Sie den Verbindungsmodus auf "WebService-Modus (online)" setzen. Prüfen Sie die Adresse des CinemaServer.

Wenn der CinemaServer auf dem gleichen System gestartet wurde, dann lautet die vordefinierte Adresse abhängig vom Port http://localhost:1524/CinemaWebService/Service.asmx.

Nun können Sie den Office Client mit den Daten nutzen, die der CinemaServer liefert.

Hier erreichen Sie unser Downloadcenter, um das Sample herunterzuladen.


AdventureWorks Cinema 1.0

Home

Downloads

Die Anwendungen

CinemaServer

Windows Client

Mobile Client

Office Client

Web Client

RSS Service