Bereitstellen von Office-Projektmappen

Artikel
08/10/2011

Sie können Office-Lösungen mit ClickOnce oder Windows Installer (MSI)-Bereitstellungstechnologien bereitstellen. Office-Projektmappen verwenden die in der Visual Studio Tools for Office-Laufzeit und .NET Framework 3.5 implementierte ClickOnce-Funktion. Diese unterscheidet sich geringfügig von der in Windows Forms-Anwendungen verfügbaren Funktion, bei der nur Funktionen in .NET Framework verwendet werden. ClickOnce vereinfacht die Bereitstellung und Wartung von Projektmappen, da ClickOnce-Projektmappen mit Benutzerrechten installiert werden.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und Anwendungsebene für Microsoft Office 2010 und 2007 Microsoft Office System. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Wenn Sie die Dateien mit Windows Installer verteilen, müssen Sie dennoch die Sicherheitsanforderungen von Visual Studio Tools for Office-Laufzeit und ClickOnce einhalten, damit Benutzer die Microsoft Office-Lösungen ausführen können. Weitere Informationen zum Sicherheitsmodell für Office-Lösungen finden Sie unter Sichern von Office-Projektmappen.

Der wichtigste Vorteil von Windows Installer besteht darin, dass Office-Projektmappen nicht nur für den aktuellen Benutzer bereitgestellt werden, sondern für alle Benutzer. Weitere Informationen über das Bereitstellen von Office-Lösungen mit Windows Installer finden Sie unter Bereitstellen einer Office-Lösung mithilfe von Windows Installer.

Allgemeine Informationen zu ClickOnce finden Sie unter ClickOnce-Sicherheit und Bereitstellung.

Der Bereitstellungsprozess schließt die folgenden Überlegungen ein:

Anforderungen für Office-Projektmappen
Bereitstellen einer Office-Projektmappe
Installieren einer Office-Projektmappe
Aktualisieren einer Office-Projektmappe
Bereitstellung während der Entwicklung.
ClickOnce-Cache

Anforderungen für Office-Projektmappen

Bevor die Microsoft Office-Lösungen ausgeführt werden können, müssen einige Komponenten auf dem Computer installiert werden, z. B. .NET Framework 3.5 und Visual Studio Tools for Office-Laufzeit. Sie können diese Komponenten häufig zusammen mit der Projektmappe bereitstellen. Eine Liste der erforderlichen Komponenten finden Sie unter Erforderliche Komponenten für Office-Projektmappen für die Bereitstellung und unter Vorgehensweise: Installieren von erforderlichen Komponenten auf Endbenutzercomputern für die Ausführung von Office-Projektmappen.

Außerdem müssen Sie sich Gedanken über die Vertrauenswürdigkeit von Projektmappen machen. Informationen über Sicherheitsfragen finden Sie unter Sichern von Office-Projektmappen.

Bereitstellen einer Office-Projektmappe

Wenn Sie eine Office-Projektmappe bereitstellen, können Sie mit dem Webpublishing-Assistenten bzw. der Eigenschaftenseite Veröffentlichen folgende Bereitstellungseinstellungen konfigurieren:

Versionsnummer.
Erforderliche Komponenten.
Updateintervalle.

Nachdem Sie diese Bereitstellungseinstellungen konfiguriert haben, veröffentlicht Visual Studio die Projektmappendateien am Veröffentlichungsspeicherort.

Wenn Sie die Bereitstellung mithilfe einer CD oder eines Wechsellaufwerks ausführen, geben Sie als Installationsort nichts ein und legen Updates auf "Nie" fest. Weitere Informationen finden Sie unter Gewusst wie: Bereitstellen einer Office-Lösung mithilfe von ClickOnce und unter Veröffentlichen von Office-Lösungen.

Installieren einer Office-Projektmappe

Nachdem die Projektmappe an den Installationsort kopiert wurde, können Endbenutzer sie herunterladen und installieren. Projektmappen können auf verschiedene Weise installiert werden: durch Ausführen des Setupprogramms, durch Öffnen des Bereitstellungsmanifests (VSTO-Datei) oder durch Öffnen des Dokuments. Weitere Informationen finden Sie unter Gewusst wie: Installieren einer ClickOnce-Office-Projektmappe und Gewusst wie: Deinstallieren einer ClickOnce-Office-Projektmappe.

Wenn die Benutzer die Projektmappe durch Öffnen des Bereitstellungsmanifests installieren, müssen Sie möglicherweise den IIS-Server konfigurieren, damit der MIME-Typ VSTO erkannt wird. Weitere Informationen finden Sie unter Gewusst wie: Vorbereiten von IIS auf die Bereitstellung von Office-Lösungen.

Erweiterte Bereitstellung

Wenn Sie für Ihre Office-Projektmappe ein benutzerdefiniertes Setupprogramm erstellen möchten, können Sie das Installationsprogramm für Office-Projektmappen (VSTOInstaller.exe) direkt ausführen. Weitere Informationen finden Sie unter Anpassen der Installation von Office-Projektmappen.

Alternativ können Sie die Projekte auf Dokumentebene und Anwendungsebene in einem einzelnen Paket bereitstellen, und die kombinierten Lösungen können als Gruppe installiert und deinstalliert werden. Wenn z. B. die Contoso Software Company ein Outlook-Add-In und ein Excel-Arbeitsblatt entwickelt, können Sie diese zusammen als Contoso Office Solutions über Software in Windows XP bzw. über Programme und Funktionen in Windows Vista installieren und deinstallieren. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Bereitstellen mehrerer Office-Lösungen in einem einzigen ClickOnce-Installationsprogramm für .NET Framework 4.

Wenn Sie nach der Installation zusätzliche Aktionen ausführen müssen, können Sie die Installation in einem Vorgang anpassen, der als Aktion nach der Bereitstellung bezeichnet wird. Sie können z. B. Dokumente oder Arbeitsmappen auf den Endbenutzercomputer kopieren, zusätzliche Registrierungsschlüssel erstellen oder eine Konfigurationsdatei ändern. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Kopieren eines Dokuments auf den Computer des Endbenutzers nach einer ClickOnce-Installation.

Aktualisieren einer Office-Projektmappe

Sie können eine Projektmappe so konfigurieren, dass diese in bestimmten Intervallen nach Updates sucht und Updates automatisch installiert. Die Standardeinstellung für automatische Updates beträgt alle sieben Tage. Nach Festlegung dieses Intervalls und Installation der Projektmappe kann das Intervall nur bei Installation eines Updates geändert werden. Wenn die Benutzer ein Update außerhalb der normalen Updateintervalle erzwingen möchten, kann die Office-Projektmappe manuell aktualisiert werden.

Sie können Updates mithilfe des Webpublishing-Assistenten bereitstellen. Der Webpublishing-Assistent generiert ein neues Anwendungsmanifest und kopiert die Projektmappendateien an denselben Veröffentlichungsort wie die frühere Version. Updates sind optional, und Benutzer können während der Downloadphase jedes Lösungsupdate abbrechen und dennoch das Add-In ausführen.

Durch die Veröffentlichung wird auch das Bereitstellungsmanifest aktualisiert, damit es auf den Speicherort der neuen Projektmappenversion zeigt. Wenn die installierte Projektmappe des Endbenutzers in den angegebenen Intervallen nach Updates sucht, wird die zuletzt bereitgestellte Version heruntergeladen und installiert. Sie können Versionen einer Projektmappe aktualisieren, indem Sie die Manifeste und die Projektmappendateien am Bereitstellungsspeicherort aktualisieren. Weitere Informationen finden Sie unter Gewusst wie: Aktualisieren von bereitgestellten Office-Lösungen.

Informationen zum Zurücksetzen auf eine vorherige Version einer Office-Projektmappe finden Sie unter Gewusst wie: Ausführen eines Rollbacks für eine ClickOnce-Office-Lösung auf eine frühere Version.

Wenn sich der Veröffentlichungsspeicherort geändert hat, kann der Pfad im Setupprogramm geändert werden, ohne wieder zu Visual Studio zu wechseln und den Webpublishing-Assistenten bzw. die Seite Veröffentlichen des Projekt-Designers zu verwenden. Weitere Informationen finden Sie unter Gewusst wie: Ändern des Installationspfads einer Office-Projektmappe.

Anwendungs- und Bereitstellungsmanifeste in Office-Lösungen können manuell bearbeitet werden. Anwendungs- und Bereitstellungsmanifeste müssen mit dem Tool zum Generieren und Bearbeiten von Manifesten (mage.exe) nach dem Bearbeiten der Manifeste erneut signiert werden. Weitere Informationen finden Sie unter Gewusst wie: Ändern von Bereitstellungseigenschaften.

Bereitstellung während der Entwicklung

Wenn Sie das Add-In auf Anwendungsebene durch Veröffentlichen und Installieren der Projektmappe auf dem Entwicklungscomputer testen, deinstallieren Sie die Projektmappe, bevor Sie sie erneut veröffentlichen oder weitere Codeänderungen vornehmen und sie durch Drücken von F5 erneut testen. Wenn Sie eine veröffentlichte Projektmappe installieren, wird die Assembly für das Add-In im ClickOnce-Cache installiert. Das Setupprogramm erstellt außerdem Registrierungsschlüssel, damit die Office-Anwendung die Assembly suchen und laden kann. Da mit einer erneuten Erstellung der Projektmappe die Registrierungsschlüssel aktualisiert werden, ist es notwendig, die erste Version zu deinstallieren, bevor die zweite Version veröffentlicht oder ausgeführt wird.

Um die Entwicklung auf Ihrem Entwicklungscomputer testen zu können, erstellen Sie zum Installieren und Testen des Add-Ins für die Anwendungsebene ein weiteres Benutzerkonto.

Wenn Sie mehrere Office-Lösungen entwickeln, werden alle Office-Add-Ins ausgeführt, da ein Build als Installation gilt. Bevor Sie eine Projektmappe schließen, sollten Sie den Befehl Projektmappe bereinigen im Menü Erstellen ausführen.

ClickOnce-Cache

ClickOnce-Office-Projektmappen werden im ClickOnce-Anwendungscache oder im globalen Assemblycache (GAC) installiert. Beim ClickOnce-Cache handelt es sich um eine Familie ausgeblendeter Verzeichnisse, die alle Dateien der Projektmappe enthalten, einschließlich der Assemblys, Konfigurationsdateien, Anwendungs- und Benutzereinstellungen und Datenverzeichnisse. ClickOnce-Office-Projektmappen verwenden den gleichen Cache wie ClickOnce-Windows Forms-Anwendungen. Bei der Verwendung des ClickOnce-Cache können Links zu anderen Internet- oder Netzwerkspeicherorten geöffnet werden, und die zwischengespeicherte Projektmappe kann auch im Offlinemodus verwendet werden. Bei Anpassungen auf Dokumentebene wird das Dokument nicht im ClickOnce-Cache installiert, sondern auf dem Computer eines Benutzers oder einer Netzwerkdateifreigabe. Weitere Informationen über den ClickOnce-Cache finden Sie unter Übersicht über den ClickOnce-Cache.

Sie können auch Assemblys im GAC speichern. Wenn für die Office-Lösungen eine Aktion nach der Bereitstellung nach jeder Installation ausgeführt wird, können Sie diese Aktion im GAC speichern. Beispielsweise können Aktionen nach der Bereitstellung, die nach der Installation jeder Visio-Vorlage ausgeführt werden müssen, im GAC gespeichert werden.

Datenmigration beim Aktualisieren von Projektmappen

Office-Lösungen migrieren während eines Updates lokale zwischengespeicherte Daten von einer Version zur nächsten.

Wenn Sie eine Instanz einer vorherigen Version einer Projektmappe während eines Updates ausführen, werden alle Änderungen, die Sie an den zwischengespeicherten Daten der Instanz vorgenommen haben, die während des Updates ausgeführt wird, nicht vorwärts migriert. Um sicherzustellen, dass die Daten ordnungsgemäß migriert werden, schließen Sie alle Instanzen einer Projektmappe, bevor Sie sie aktualisieren.

Datendateien

Dateien mit den Erweiterungen .xml, .mdb und .mdf werden automatisch in das Anwendungsdatenverzeichnis kopiert. Diese Datendateien können nicht mit dem Dialogfeld Anwendungsdateien konfiguriert werden. Verwenden Sie die DataDirectory-Eigenschaft, um das Datenverzeichnis zu suchen. Weitere Informationen finden Sie unter Zugreifen auf lokale und Remotedaten in einer ClickOnce-Anwendung.

Rufen Sie die GetExecutingAssembly-Methode auf, und verwenden Sie dann die CodeBase-Eigenschaft oder die EscapedCodeBase-Eigenschaft, um den Verzeichnispfad abzurufen und die Dateien in einem anderen Verzeichnis durch Reflektion zu suchen. Sie können dann die Dateien mithilfe des vollqualifizierten Pfads suchen.