Bereitstellen von Anpassungen auf Dokumentebene (2003 System)
Aktualisiert: November 2007
Betrifft |
|---|
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekttyp
Microsoft Office-Version
Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp. |
Bei der Bereitstellung einer Anpassung auf Dokumentebene für Microsoft Office Word 2003 oder Microsoft Office Excel 2003 müssen vier Dateien berücksichtigt werden:
Die Word- bzw. Excel-Datei (Vorlage, Dokument oder Arbeitsmappe), mit der der Endbenutzer arbeitet.
Die Assembly, die den kompilierten benutzerdefinierten Code enthält, und sämtliche abhängigen Assemblys, z. B. Ressourcen, Satelliten und Hilfsbibliotheken.
Das Bereitstellungsmanifest (falls zutreffend).
Das Anwendungsmanifest (falls zutreffend).
Beachten Sie beim Bereitstellen der Projektmappe die folgenden grundlegenden Richtlinien:
Die Benutzer müssen .NET Framework installiert haben. Weitere Informationen finden Sie unter Verteilung von .NET Framework und Arbeiten mit mehreren Versionen von .NET Framework.
Die Benutzer müssen Visual Studio Tools for Office-Laufzeit installiert haben. Weitere Informationen hierzu finden Sie unter Gewusst wie: Vorbereiten von Endbenutzercomputern für die Ausführung von Office-Projektmappen (2003 System).
Alle Endbenutzer müssen mindestens über Lesezugriff auf das Office-Dokument und die Assembly verfügen.
Sowohl das Dokument als auch die Assembly müssen volle Vertrauenswürdigkeit besitzen, damit die Word- oder Excel-Lösung funktioniert. Wenn das Dokument auf dem Computer des Benutzers gespeichert ist, verfügt normalerweise das Dokument selbst automatisch über die volle Vertrauenswürdigkeit. Allerdings erhält eine Assembly auf dem Computer des Benutzers nicht automatisch volle Vertrauenswürdigkeit. Weitere Informationen hierzu finden Sie unter Sicherheit in Office-Projektmappen (2003 System).
Zur Bereitstellung der Projektmappe kopieren Sie das Dokument und die Assembly sowie optional das Anwendungs- und das Bereitstellungsmanifest an die Bereitstellungsadresse. Weitere Informationen über Bereitstellungstypen finden Sie unter Bereitstellungsmodelle (2003 System).
Visual Studio Tools for Office enthält den Webpublishing-Assistenten, der das Anwendungs- und das Bereitstellungsmanifest erstellt und alle Dateien an den Bereitstellungsspeicherort kopiert. Sie können diese Schritte jedoch auch manuell ausführen. Weitere Informationen finden Sie unter Gewusst wie: Bereitstellen von Office-Projektmappen (2003 System) und unter Gewusst wie: Bereitstellen von Projektmappendateien mit dem Webpublishing-Assistenten (2003 System).
Webpublishing-Assistent
Sie können den Webpublishing-Assistenten starten, indem Sie im Projektmappen-Explorer im Kontextmenü des Projekts den Befehl Veröffentlichen auswählen. Wenn Sie den Speicherort des Ordners angeben, in dem Sie die Projektmappe veröffentlichen möchten, kopiert der Assistent das Dokument und das Bereitstellungsmanifest in diesen Ordner. Weitere Informationen hierzu finden Sie unter Gewusst wie: Bereitstellen von Projektmappendateien mit dem Webpublishing-Assistenten (2003 System).
Außerdem kopiert der Assistent die Assemblys und ein aktualisiertes Anwendungsmanifest in einen Unterordner des Hauptbereitstellungsordners. Der Name des Unterordners enthält eine Versionsnummer. Wenn Sie im Projekt-Designer im Bereich Veröffentlichen die Option Revisionsnummer automatisch mit jeder Veröffentlichung erhöhen auswählen, wird bei jeder Veröffentlichung der Projektmappe ein neuer Unterordner erstellt. Ältere Versionen bleiben weiterhin verfügbar. Durch das Anwendungs- und das Bereitstellungsmanifest wird sichergestellt, dass die Projektmappe immer die aktuelle Assembly verwendet. Weitere Informationen finden Sie unter Anwendungs- und Bereitstellungsmanifeste in Office-Projektmappen, Gewusst wie: Bereitstellen von Projektmappendateien mit dem Webpublishing-Assistenten (2003 System), Seite "Veröffentlichen", Projekt-Designer (2003 System) und unter Webpublishing-Assistent (2003 System).
Aktualisieren bereitgestellter Assemblys (Versionsverwaltung)
Wenn Sie eine Projektmappe mit dem Namen ExcelWorkbook1 im Ordner C:\DeployFolder bereitstellen, ergibt sich folgende Dateistruktur:
C:\DeployFolder
Dieser Ordner enthält die folgenden zwei Dateien und den folgenden Unterordner:
Die Arbeitsmappe (ExcelWorkbook1.xls).
Das Bereitstellungsmanifest (ExcelWorkbook1.application).
C:\DeployFolder\ExcelApplication1_1.0.0.0
Dieser Ordner enthält die folgenden Dateien:
Die Assemblys.
Das Anwendungsmanifest (ExcelWorkbook1.dll.manifest).
Eine Kopie der Arbeitsmappe.
Eine Kopie des Bereitstellungsmanifests.
Wenn Sie die Assembly aktualisieren und die Projektmappe erneut veröffentlichen, ergibt sich folgende Verzeichnisstruktur:
C:\DeployFolder
Dieser Ordner enthält die folgenden zwei Dateien und Unterordner:
Die Arbeitsmappe (mit einem aktualisierten eingebetteten Anwendungsmanifest).
Das Bereitstellungsmanifest (aktualisiert, sodass es auf das Anwendungsmanifest in C:\DeployFolder\ExcelWorkbook1_1.0.0.1 zeigt).
C:\DeployFolder\ExcelWorkbook1_1.0.0.0
Dieser Ordner enthält die folgenden Dateien:
Die ursprünglichen Assemblys.
Das ursprüngliche Anwendungsmanifest.
Die ursprüngliche Arbeitsmappe.
Das ursprüngliche Bereitstellungsmanifest.
C:\DeployFolder\ExcelWorkbook1_1.0.0.1
Dieser Ordner enthält die folgenden Dateien:
Die aktualisierten Assemblys.
Das aktualisierte Anwendungsmanifest.
Eine Kopie der aktualisierten Arbeitsmappe.
Eine Kopie des aktualisierten Bereitstellungsmanifests.
Diese Struktur wird bei jeder Aktualisierung der Assembly erneut verwendet. Wenn Sie das Dokument oder die Arbeitsmappe aktualisieren, sodass sie nicht mehr mit der vorhandenen Assembly kompatibel sind, sollten Sie die Projektmappe in einem neuen Bereitstellungsordner bereitstellen.
Verwenden von MSBuild an einer Eingabeaufforderung
Sie können zur Veröffentlichung der Projektmappe auch MSBuild an einer Eingabeaufforderung verwenden. Wenn Sie MSBuild an einer Eingabeaufforderung verwenden, können Sie die Projektmappendateien an einem Speicherort veröffentlichen und gleichzeitig das in der Arbeitsmappe bzw. dem Dokument eingebettete Anwendungsmanifest so modifizieren, dass es auf ein Bereitstellungsmanifest an einem anderen Speicherort zeigt. Um zur Veröffentlichung einer Projektmappe MSBuild an einer Eingabeaufforderung auszuführen, verwenden Sie folgende Syntax.
msbuild.exe /target:Publish /property:UpdateUrl=<update location> /property:PublishDir=<publish location> <project file>
Wenn Sie beispielsweise ein C#-Projekt mit dem Namen ExcelWorkbook1 im Ordner \\PublishServer\PublishFolder veröffentlichen möchten, jedoch für später planen, das Bereitstellungsmanifest, das externe Anwendungsmanifest und die Assembly in den freigegebenen Ordner \\DeploymentServer\DeploymentFolder zu verschieben, führen Sie folgenden Befehl aus.
msbuild.exe /target:Publish /property:PublishDir=\\PublishServer\PublishFolder\ /property:UpdateUrl=\\DeploymentServer\DeploymentFolder\ C:\ExcelWorkbook1\ExcelWorkbook1.csproj
Weitere Informationen zur Verwendung von MSBuild an einer Eingabeaufforderung finden Sie unter Erstellen von ClickOnce-Anwendungen über die Befehlszeile.
Anwendungs- und Bereitstellungsmanifest
Mit dem Anwendungs- und dem Bereitstellungsmanifest kann ein Dokument mit den Daten für die neueste Assembly aktualisiert werden. Weitere Informationen hierzu finden Sie unter Anwendungs- und Bereitstellungsmanifeste in Office-Projektmappen.
Aktualisieren von Bereitstellungsmanifesten
Unter Umständen ändern Sie im Laufe der Lebensdauer einer Projektmappe mehrfach das Bereitstellungsmanifest für die Projektmappe. Es gibt zwei Hauptgründe, das Bereitstellungsmanifest zu aktualisieren:
Sie stellen eine neue Version der Projektmappenassembly bereit. Weitere Informationen hierzu finden Sie unter Gewusst wie: Aktualisieren von bereitgestellten Assemblydateien (2003 System).
Sie ändern den Speicherort der Projektmappenassembly. Weitere Informationen hierzu finden Sie unter Gewusst wie: Ändern des Speicherorts von Anpassungen auf Dokumentebene (2003 System).
Aktualisieren von Anwendungsmanifesten
Möglicherweise müssen Sie ein vorhandenes Anwendungsmanifest, das in einer Projektmappe in Gebrauch ist, niemals direkt aktualisieren. I. d. R. erstellen Sie ein neues Anwendungsmanifest und verwenden das Bereitstellungsmanifest, um das neue Anwendungsmanifest in die Projektmappe zu laden. Es gibt jedoch zwei Hauptgründe, ein Anwendungsmanifest direkt in einem Dokument zu aktualisieren:
Das Bereitstellungsmanifest und die Assemblys wurden auf einen neuen Server verschoben, da der ursprüngliche Server stillgelegt wurde. In diesem Fall müssen Sie im Anwendungsmanifest die Pfade für diese Elemente ändern. Weitere Informationen hierzu finden Sie unter Gewusst wie: Ändern des Speicherorts von Anpassungen auf Dokumentebene (2003 System).
Sie möchten das Anwendungsmanifest aus dem Dokument entfernen. Möglicherweise möchten Sie das Dokument archivieren und dabei verhindern, dass es sich durch das Ausführen von Code ändert, oder Sie möchten das fertige Dokument ohne jeglichen Verweis auf den Code nach außerhalb der Arbeitsgruppe versenden. Weitere Informationen hierzu finden Sie unter Gewusst wie: Entfernen verwalteter Codeerweiterungen aus Dokumenten (2003 System).
Bereitstellen von lokalisierten Microsoft Office-Projektmappen
Das Bereitstellen lokalisierter Versionen von Visual Studio Tools for Office-Projektmappen unterscheidet sich nur in wenigen Aspekten vom Bereitstellen anderer Projektmappen mithilfe von Visual Studio. Allerdings sind beim Erstellen und Verteilen lokalisierter Versionen von Visual Studio Tools for Office-Projektmappen einige zusätzliche Punkte zu beachten. Weitere Informationen finden Sie unter Globalisierung und Lokalisierung von Office-Projektmappen, Gewusst wie: Lokalisieren von Excel-Projektmappen und Bereitstellung und Lokalisierung.
Siehe auch
Aufgaben
Gewusst wie: Bereitstellen von Office-Projektmappen (2003 System)
Konzepte
Bereitstellen von Office-Projektmappen (2003 System)
Bereitstellen von Add-Ins auf Anwendungsebene (2003 System)
Bereitstellungsmodelle (2003 System)
Offlinemodell für Office-Projektmappen (2003 System)
Sichere Bereitstellung (2003 System)