Upgrade von Definitionsdateien
Letzte Änderung: Dienstag, 6. April 2010
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Entscheidung zwischen Upgradedefinitionen in SharePoint Foundation
Anwenden des Websitedefinitionsupgrades
Assemblyverweise
Sprachpakete und Websitedefinitionsupgrade
Durch eine Websiteupgradedefinition können Websites, die in einer früheren Version des SharePoint-Produkts angepasst wurden, so transformiert werden, dass die neuen Features der neuesten Version genutzt werden. In einer Upgradedefinitionsdatei werden die Dateien und Listendaten eines Builds oder einer Version einem nachfolgenden Build oder einer nachfolgenden Version zugeordnet. Außerdem enthält die Datei weitere Elemente, die in aktualisierte Websites aufgenommen werden sollten.
Sie registrieren eine Upgradedefinition für eine Websitedefinition, indem Sie ihr einen eindeutigen, meist mit dem Namen der Websitedefinition beginnenden Dateinamen zuweisen und sie im Ordner %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Config\Upgrade des Setupverzeichnisses platzieren. Websiteupgradedefinitionen werden pro Websitedefinition registriert, für eine Websitedefinition können jedoch mehrere Upgradedefinitionen vorhanden sein. Eine Websiteupgradedefinition enthält zudem Listenupgradevorlagen, die beschreiben, wie den einzelnen Spalten einer Liste Inhaltstypen der neuen Version von SharePoint Foundation 2010 zugeordnet werden.
Zum besseren Verständnis von Upgradedefinitionen empfiehlt sich die Betrachtung der Upgradedefinitionsdateien, die in einer Installation von SharePoint Foundation im Verzeichnis %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Config\Upgrade gespeichert sind. Dieses Verzeichnis enthält zwei Upgradevorlagen: eine für das Upgrade von der früheren Version auf die aktuelle Version und eine für das Upgrade zwischen Builds von SharePoint Foundation und der endgültigen Version.
Entscheidung zwischen Upgradedefinitionen in SharePoint Foundation
Bei der Entscheidung, ob für eine Website ein Upgrade ausgeführt werden kann, wird in SharePoint Foundation ggf. nach folgendem Algorithmus die anwendbare Upgradedefinition aus den verfügbaren ausgewählt:
Wenn die Website nicht der aktuellen Produktversion angehört, wird von SharePoint Foundation eine Upgradedefinition ausgewählt, die ein Upgrade zwischen Produktversionen ausführt und die Website auf die neueste Vorlagenversion aktualisiert. Mit Upgradedefinitionen werden Upgradeaktionen zwischen Versionen oder zwischen Vorlagen ausgeführt, jedoch nicht beides. In einer Definition kann somit nicht sowohl das FromProductVersion-Attribut als auch das BeginFromSchemaVersion/EndFromSchemaVersion-Attribut festgelegt sein. Wenn eine Website nicht der aktuellen Produktversion angehört und keine Upgradedefinition für das Upgrade der Website zwischen Versionen vorhanden ist, kann die Website nicht aktualisiert werden.
Falls #1 nicht zutrifft, wird von SharePoint Foundation eine Upgradedefinition ausgewählt, in der der Wert des ToSchemaVersion-Attributs der aktuellen Vorlagenversion der Websitedefinition am nächsten kommt (ohne sie zu überschreiten) und in der die Vorlagenversion der vorhandenen Websiteinstanz zwischen den Werten BeginFromSchemaVersion und EndFromSchemaVersion liegt.
Erfüllen mehrere Websiteupgradedefinitionen die Kriterien von #2, wird von SharePoint Foundation die Upgradedefinition mit dem höchsten BeginFromSchemaVersion-Wert ausgewählt.
Ist für eine angegebene Websitedefinition sowohl eine generische Sprachvorlage als auch eine spezifische Gebietsschemavorlage vorhanden, wird von SharePoint Foundation die spezifische Gebietsschemavorlage ausgewählt.
Anwenden des Websitedefinitionsupgrades
In SharePoint Foundation wird eine Upgradedefinition verwendet, um konvertierte Websites bereitzustellen. Bei der Anwendung eines Websitedefinitionsupgrades müssen folgende Ersetzungen für Standardelemente vorgenommen werden:
Wenn die Navigationsknoten für eine Websitedefinition nicht geändert wurden, werden die vorhandenen Navigationsknoten einer vorherigen Version entfernt und durch Navigationsknoten aus der Websitedefinition der aktuellen Version ersetzt.
Im Abschnitt <ListTemplates> einer Datei Onet.xml oder Feature.xml werden die Listenvorlagen bestimmt, die auf der Seite Erstellen zur Auswahl stehen. Bei der Anwendung einer Websiteupgradedefinition wird von SharePoint Foundation hierzu die Menge der Listenvorlagen aus der aktuellen Version von Onet.xml oder Feature.xml verwendet und nicht aus den Dateien der vorherigen Version.
Entsprechend wird von SharePoint Foundation nach dem Upgrade der Abschnitt <DocumentTemplates> der neuen Datei Onet.xml herangezogen, um die Menge der verfügbaren freien Dokumentvorlagen zu bestimmen, und nicht die Menge der <DocumentTemplate>-Dateien der vorherigen Version.
.gif "Hinweis")
HinweisEs wird empfohlen, Dokumentvorlagen in der Regel Inhaltstypen zuzuordnen, statt sie frei zu verwenden.
Standardmäßig werden beim Upgrade einer vorhandenen Website durch das Websitedefinitionsupgrade keine Module oder Listeninstanzen der neuen Websitedefinition bereitgestellt. SharePoint Foundation greift auf eine Gruppe von <File>-Elementen zurück, die angeben, wie Dateien einer vorherigen Version der aktuellen Version zuzuordnen sind. In einer Gruppe von Modul- und Listeninstanztags in der Upgradedefinition werden zudem die Unterschiede in Dateien und Listendaten zwischen der vorherigen Version und der aktuellen angegeben.
Mithilfe einer Upgradedefinition kann eine Website einheitlich auf die Verwendung neuer Inhaltstypen, Formulare, Listen und Seiten aktualisiert werden. Ist keine Upgradedefinition verfügbar, werden Websites in SharePoint Foundation basierend auf der vorherigen Produktversion aktualisiert, wobei weitgehend die Migration von Daten und Zusammenarbeitsfeatures im Vordergrund steht, auch wenn dabei möglicherweise Features der aktuellen Version (wie Inhaltstypen) für Benutzer verfügbar gemacht werden. Dies ist der standardmäßige Status aller Websites nach der Bereitstellung von Versionsupgradevorgängen (z. B. Datenbanktransformationen).
Assemblyverweise
Die Datei web.config enthält Richtlinienumleitungen, durch die früheren Versionen von Produktassemblys (wie Microsoft.SharePoint.dll-Assemblys in Windows SharePoint Services 3.0) ihre Entsprechungen in der aktuellen (neuesten) Produktversion zugeordnet werden.
Sprachpakete und Websitedefinitionsupgrade
Wenn bei einem Versionsupgrade ein Sprachpaket einer früheren Version installiert ist, aber das entsprechende Sprachpaket der aktuellen Version nicht vor dem Upgrade installiert wird, werden Fehler im Upgradeprotokoll verzeichnet. Der Upgradevorgang wird jedoch dennoch abgeschlossen.
Siehe auch
Konzepte
Architekturbasierte Methoden zum Aktualisieren einer Websitedefinition
Durchführen eines Upgrades für eine benutzerdefinierte Websitedefinition