Verwenden des Inhaltsmigrations-Objektmodells

Letzte Änderung: Freitag, 2. Oktober 2009

Gilt für: SharePoint Foundation 2010

Normalerweise können die Szenarien für die Inhaltsmigration in die folgenden Kategorien unterteilt werden:

• Verschieben des Inhalts einer Websitesammlung von einem Speicherort in einen anderen

• Migrieren nur ausgewählter Inhaltsdateien von einer Website zu einer anderen basierend auf angegebenen Kriterien

• Exportieren des Inhalts, um einen Prozess für den Inhalt auszuführen und diesen dann erneut zu importieren

• Synchronisieren von Servern

Ungeachtet des Szenarios sind die grundlegenden Schritte jedoch gleich. Im folgenden Abschnitt finden Sie allgemeinen Schritte, die bei einem typischen Migrationsvorgang ausgeführt werden, sowie Links zu weiteren Informationen zu den zugehörigen Objektmodellmembern.

Im ersten Schritt entscheiden Sie, welche Inhalte exportiert werden sollen. Sie verwenden die SPExportSettings-Klasse, um diese Werte für den Exportvorgang zu definieren.

1. Bestimmen Sie, welche Objekte migriert werden sollen.

   Sie können mithilfe des Inhaltsmigrations-Objektmodells eine Websitesammlung, eine Liste, eine Bibliothek, einen Ordner, eine Datei oder ein Listenelement exportieren.

   Weitere Informationen finden Sie im Artikel zur SPExportObjectCollection-Klasse.

2. Entscheiden Sie, wie viele der Daten eines Objekts exportiert werden sollen. Sie können alle Daten eines Objekts sowie dessen Abhängigkeiten exportieren, oder Sie können nur inkrementelle Änderungen exportieren.

   Wenn Sie inkrementelle Änderungen exportieren möchten, müssen Sie entscheiden, ob die Daten basierend auf den folgenden Kriterien exportiert werden sollen:

   • Ein bestimmtes Datum

   • Änderungen, die seit dem letzten Export an einer Datei vorgenommen wurden (mithilfe des SharePoint Foundation-Änderungsprotokolls)

   Weitere Informationen finden Sie im Artikel zur ExportMethod-Eigenschaft.

3. Identifizieren Sie einen Speicherort für die Ausgabedatei (die CMP-Datei, die auch als content migration package bezeichnet wird).

   Weitere Informationen finden Sie in den Artikeln zu den Eigenschaften BaseFileName und FileLocation.

4. Bestimmen Sie, welche Metadaten Sie beim Exportieren der Daten einschließen möchten. Welche Versionsinformationen sollen beispielsweise exportiert werden (standardmäßig wird die letzte Hauptversion exportiert)? Möchten Sie Benutzer- und Gruppeninformationen exportieren (standardmäßig sind Benutzer- und Gruppeninformationen nicht eingeschlossen)?

   Weitere Informationen finden Sie in den Artikeln zu den Eigenschaften IncludeVersions und IncludeSecurity.

5. Legen Sie gegebenenfalls Limits für die Größe der Dateien des Inhaltsmigrationspakets (CMP) fest. Wenn die Inhaltsdateien bei einem Migrationsvorgang das angegebene Größenlimit überschreiten, werden nach Bedarf automatisch zusätzliche CMP-Dateien erstellt.

   Weitere Informationen finden Sie im Artikel zur FileMaxSize-Eigenschaft.

6. Geben Sie an, wie Warnungen und Fehler beim Exportvorgang behandelt werden sollen (standardmäßig wird der Exportvorgang nicht beendet, wenn eine Warnung oder ein nicht schwerwiegender Fehler auftritt).

   Weitere Informationen finden Sie in den Artikeln zu den Eigenschaften HaltOnNonfatalError und HaltOnWarning.

7. Wenn Sie diese Entscheidungen getroffen und die Werte in der SPExportSettings-Klasse festgelegt haben, übergeben Sie die Klasse als Parameter an SPExport, und führen Sie dann den Exportauftrag aus.

Nach Abschluss des Exports wird in dem Speicherort, den Sie in SPExportSettings definiert haben, ein Inhaltsmigrationspaket erstellt. Diese Datei besteht aus einem Satz von Dateien mit den im Exportvorgang eingeschlossenen Inhalten und Metadaten, in denen die Struktur des Inhalts beschrieben wird.

Genau wie die Einstellungen für den Export im SPExportSettings-Objekt definieren Sie nun im SPImportSettings-Objekt Werte für den Import.

1. Bestimmen Sie, welche Metadaten Sie beim Importieren der Daten einschließen möchten. Beispiel:

   • Wie sollen die Versionsinformationen angezeigt werden (standardmäßig werden die Versionen den Dateien im Zielspeicherort angefügt)?

     Weitere Informationen finden Sie im Artikel zur UpdateVersions-Eigenschaft.

   • Soll die ursprüngliche GUID der Objekte beibehalten werden? (Standardmäßig wird die Objektidentität nicht beibehalten.)

     Weitere Informationen finden Sie im Artikel zur RetainObjectIdentity-Eigenschaft.

     Wichtig

     Verwenden Sie diese Eigenschaft mit Vorsicht - doppelte GUIDs sind in Datenbanken nicht zulässig. Diese Eigenschaft wird meist verwendet, wenn zwei Websites vorhanden sind, die Spiegelbilder voneinander darstellen, oder um in einem Veröffentlichungsszenario anzugeben, ob eine Datei auf einem Computer mit der Datei auf einem anderen Computer identisch ist. Diese Funktionalität ist nur im Objektmodell verfügbar. Sie können GUIDs nicht mit Stsadm.exe oder dem [Sites Web service]Web service beibehalten.

2. Geben Sie an, wie Warnungen und Fehler beim Importvorgang behandelt werden sollen (standardmäßig wird der Importvorgang nicht beendet, wenn eine Warnung oder ein nicht schwerwiegender Fehler auftritt).

   Weitere Informationen finden Sie in den Artikeln zu den Eigenschaften HaltOnNonfatalError und HaltOnWarning.

3. Wenn Sie diese Entscheidungen getroffen und die Werte in der SPImportSettings-Klasse festgelegt haben, übergeben Sie die Klasse als Parameter an SPImport, und führen Sie den Importauftrag aus.

Siehe auch

Aufgaben

Gewusst wie: Migrieren einer Website von einem Speicherort an einen anderen

Konzepte

Inhaltsmigration (Übersicht)

Migrieren von Sicherheitsinformationen

Protokollieren von Inhaltsmigrationsereignissen

Verwenden eines Inhaltsmigrationspakets