Procedimiento para personalizar la implementación de escenarios desconectados
Última modificación: miércoles, 22 de septiembre de 2010
Hace referencia a: SharePoint Server 2010
La implementación de contenido funciona bien siempre y cuando haya disponible una conexión clara entre la granja de servidores de origen y la de destino. No obstante, no siempre hay disponible una conexión funcional y confiable entre una granja de servidores de creación de origen y una granja de servidores de producción de destino. Por ejemplo, las barreras geográficas, los firewall que impiden el acceso o las caídas de red son todas situaciones en las que el uso de una conexión de red para transportar un paquete de exportación a una granja de servidores de producción de destino no siempre es confiable. En estos casos, Microsoft recomienda que trabaje con el modelo de objetos de Microsoft SharePoint Server 2010 y la API de migración de contenido de SharePoint Foundation para completar mediante programación los pasos de exportación e importación de la migración de contenido y buscar un modo alternativo de transportar el paquete de exportación a la granja de servidores de producción de destino y, a continuación, ejecutar el código de importación personalizado.
Tal y como se describió en Implementación de contenido entre servidores, cada implementación de contenido implica realizar tres pasos: exportar, transportar e importar. En este caso, el transporte se administra de manera manual, no mediante programación. Por ejemplo, puede transportar el paquete de contenido exportado en medios portátiles o usar un cliente de FTP para cargar los datos en un archivo compartido independiente desde el que se puede importar.
Para exportar un paquete de contenido mediante el uso de la API de migración de contenido
Llame a la API de migración de contenido con las opciones que desea especificar.
Almacene un token de cambio.
La aplicación ejecuta la exportación, comprueba si hay excepciones e informa de las mismas cuando ello es necesario. Si la ejecución se realiza correctamente, la aplicación crea el paquete exportado con el nombre proporcionado y lo almacena en la ubicación proporcionada.
Nota
Una vez completada la exportación y creado un paquete de contenido puede transportar el paquete exportado mediante el uso de un FTP, medios portátiles, etc. Después de transportar los datos a una ubicación de archivo al que puede tener acceso el proceso de importación, puede comenzar la importación.
Para importar un paquete de contenido mediante el uso de la API de migración de contenido
Busque el archivo que creó mediante el uso del modelo de objetos durante la exportación. Si está usando el código de ejemplo proporcionado, el nombre de archivo es export.cmp.
Ejecute el código de importación. El código de importación realiza lo siguiente:
Crea un objeto SPImportSettings con propiedades establecidas como definidas en el código.
Crea un nuevo objeto SPImport y administra los tokens de cambio de preimportación y postimportación, el control de versiones del contenido, la configuración de la memoria caché y la programación del contenido implementado recientemente.
Nota
Por motivos de rendimiento, SharePoint Server 2010 no llama a receptores de eventos de manera predeterminada. De manera predeterminada, las escuchas no se activan cuando la implementación de contenido crea contenido. Sin embargo, si está usando aplicaciones de terceros o código personalizado que requieren que se activen receptores de eventos durante la importación, puede establecer la propiedad SuppressAfterEvents en false. Cuando se establezca esta marca, puede experimentar una pérdida de rendimiento significativa, pero se reciben todos los requisitos especificados en la importación.
Nota
Se ha de llamar a la API de migración de contenido en el servidor de origen y establecerse las opciones específicas, como la propiedad RetainObjectIdentity, en true.
Ejemplo
Para ayudarle a usar la API de migración de contenido de SharePoint Foundation con la característica de implementación de contenido de SharePoint Server 2010, este tema incluye un código de ejemplo que usa la API de migración de contenido con la implementación de contenido de SharePoint Server 2010. El ejemplo muestra cómo la característica de implementación de contenido interactúa con la API de migración de contenido para crear una exportación; los conceptos y la sintaxis necesarios al usar la API de migración de contenido para completar la exportación, la importación y la ruta de acceso; y la definición de trabajo y los pasos para la ejecución de la implementación de contenido de SharePoint Server 2010.
El código de ejemplo se divide en dos aplicaciones más pequeñas: una aplicación de exportación y otra de importación.
using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint.Deployment;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Publishing;
using Microsoft.SharePoint.Publishing.Administration;
/* Note: Before running this sample code, or any custom deployment solution, disable auto-spawning for the Variations feature
* on your source site if it is enabled.
**/
namespace CustomDeployment
{
class Program
{
private static SavedCacheSettings savedCacheSettings;
private static string sourceUrl = "http://samplesource/";
private static string destinationUrl = "http://sampledestination/";
private static string destinationRootWebUrl;
static void Main(string[] args)
{
// This region defines content deployment export settings,
// runs the export, and catches an exceptions during export
// and outputs them.
#region Export
try
{
SPExportSettings exportSettings = new SPExportSettings();
// Turn on extra output for testing
exportSettings.CommandLineVerbose = true;
// The name of the file targeted by the export
exportSettings.BaseFileName = "export.cmp";
// The directory on the file system in which
// to put the exported package
exportSettings.FileLocation = @"%temp%";
// If the file exists, overwrite it
exportSettings.OverwriteExistingDataFile = true;
// Export all security settings; change this if needed
exportSettings.IncludeSecurity = SPIncludeSecurity.All;
// The URL of the site being exported
exportSettings.SiteUrl = sourceUrl;
// The last major and minor versions
exportSettings.IncludeVersions = SPIncludeVersions.LastMajorAndMinor;
// Compress the exported file
exportSettings.FileCompression = true;
// Create a new export object with the correct settings
SPExport export = new SPExport(exportSettings);
// Optionally add event handlers to the export
// object for:
// Started
// ProgressUpdated
// Completed
// Canceled
// Error
// Compressing
// Run the export
export.Run();
}
// Catch any exceptions during export and output them
catch (Exception ex)
{
Console.Error.Write(ex.ToString());
throw;
}
#endregion //Export
// This region defines import settings, creates a new
// SPImportObject with those settings, manages versioning
// and caching, and applies appropriate conditions if the
// object is a Web site or root Web site
#region Import
try
{
SPImportSettings importSettings = new SPImportSettings();
// Turn on extra output for testing
importSettings.CommandLineVerbose = true;
// IMPORTANT: retains object IDs
importSettings.RetainObjectIdentity = true;
// The directory of the file being imported
importSettings.FileLocation = @"%temp%";
// The name of the file being imported
importSettings.BaseFileName = "export.cmp";
// The URL of the site into which content is being imported
importSettings.SiteUrl = destinationUrl;
//Import all the security settings from the package
importSettings.IncludeSecurity = SPIncludeSecurity.All;
// Retain author name during import; change if needed
importSettings.UserInfoDateTime = SPImportUserInfoDateTimeOption.ImportAll;
// Don't fire event receivers during import;
// change if needed
importSettings.SuppressAfterEvents = true;
// Add new versions when importing items that
// already exist
importSettings.UpdateVersions = SPUpdateVersions.Append;
// Create a new import object with specified settings
SPImport import = new SPImport(importSettings);
// Turn down caching during the import
SiteCacheSettingsWriter.UpdateCacheSettingsDuringImport(importSettings.SiteUrl, true);
// Save the cache settings to restore after
// the import finishes
savedCacheSettings = SiteCacheSettingsWriter.SaveCacheSettingsBeforeImport(importSettings.SiteUrl);
// Change tokens for pre-import and post-import
SPChangeToken startChangeToken, endChangeToken;
using (SPSite destinationSite = new SPSite(importSettings.SiteUrl))
{
// Get the change token from the destination site
startChangeToken = destinationSite.CurrentChangeToken;
// Save the root Web URL for future use
destinationRootWebUrl = destinationSite.RootWeb.ServerRelativeUrl;
}
import.ObjectImported += new EventHandler<SPObjectImportedEventArgs>(import_ObjectImported);
// Optionally add event handlers to the
// import object for:
// Started
// ProgressUpdated
// Completed
// Cancelled
// Error
// Uncompressing
// Run the import
import.Run();
using (SPSite destinationSite = new SPSite(importSettings.SiteUrl))
{
// Get the change token from the
// destination site AFTER import
endChangeToken = destinationSite.CurrentChangeToken;
// Enable scheduling of the items just deployed
ScheduledItem.EnableSchedulingOnDeployedItems(destinationSite, startChangeToken, endChangeToken, "Succeeded");
}
}
// Catch any exceptions during import and output them
catch (Exception ex)
{
Console.Error.Write(ex.ToString());
throw;
}
finally
{
// Update the cache settings because import is done
SiteCacheSettingsWriter.UpdateCacheSettingsDuringImport(destinationUrl, false);
}
#endregion
}
private static void import_ObjectImported(object sender, SPObjectImportedEventArgs e)
{
// Is the imported object a Web site?
if ((e != null) && (e.Type == SPDeploymentObjectType.Web))
{
// Is the imported object the root Web site?
if (string.Compare(e.TargetUrl, destinationRootWebUrl, StringComparison.OrdinalIgnoreCase) == 0)
{
// The root Web site is being imported, so restore
// the cache-related root Web site properties.
SiteCacheSettingsWriter.RestoreCacheSettingsOnImport(destinationUrl, savedCacheSettings);
}
}
return;
}
}
}
Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SharePoint.Deployment
Imports Microsoft.SharePoint
Imports Microsoft.SharePoint.Publishing
Imports Microsoft.SharePoint.Publishing.Administration
' Note: Before running this sample code, or any custom deployment solution, disable auto-spawning for the Variations feature
' * on your source site if it is enabled.
' *
Namespace CustomDeployment
Friend Class Program
Private Shared savedCacheSettings As SavedCacheSettings
Private Shared sourceUrl As String = "http://samplesource/"
Private Shared destinationUrl As String = "http://sampledestination/"
Private Shared destinationRootWebUrl As String
Shared Sub Main(ByVal args() As String)
' This region defines content deployment export settings,
' runs the export, and catches an exceptions during export
' and outputs them.
' #Region "Export"
Try
Dim exportSettings As New SPExportSettings()
' Turn on extra output for testing
exportSettings.CommandLineVerbose = True
' The name of the file targeted by the export
exportSettings.BaseFileName = "export.cmp"
' The directory on the file system in which
' to put the exported package
exportSettings.FileLocation = "%temp%"
' If the file exists, overwrite it
exportSettings.OverwriteExistingDataFile = True
' Export all security settings; change this if needed
exportSettings.IncludeSecurity = SPIncludeSecurity.All
' The URL of the site being exported
exportSettings.SiteUrl = sourceUrl
' The last major and minor versions
exportSettings.IncludeVersions = SPIncludeVersions.LastMajorAndMinor
' Compress the exported file
exportSettings.FileCompression = True
' Create a new export object with the correct settings
Dim export As New SPExport(exportSettings)
' Optionally add event handlers to the export
' object for:
' Started
' ProgressUpdated
' Completed
' Canceled
' Error
' Compressing
' Run the export
export.Run()
' Catch any exceptions during export and output them
Catch ex As Exception
Console.Error.Write(ex.ToString())
Throw
End Try
' #End Region 'Export
' This region defines import settings, creates a new
' SPImportObject with those settings, manages versioning
' and caching, and applies appropriate conditions if the
' object is a Web site or root Web site
' #Region "Import"
Try
Dim importSettings As New SPImportSettings()
' Turn on extra output for testing
importSettings.CommandLineVerbose = True
' IMPORTANT: retains object IDs
importSettings.RetainObjectIdentity = True
' The directory of the file being imported
importSettings.FileLocation = "%temp%"
' The name of the file being imported
importSettings.BaseFileName = "export.cmp"
' The URL of the site into which content is being imported
importSettings.SiteUrl = destinationUrl
'Import all the security settings from the package
importSettings.IncludeSecurity = SPIncludeSecurity.All
' Retain author name during import; change if needed
importSettings.UserInfoDateTime = SPImportUserInfoDateTimeOption.ImportAll
' Don't fire event receivers during import;
' change if needed
importSettings.SuppressAfterEvents = True
' Add new versions when importing items that
' already exist
importSettings.UpdateVersions = SPUpdateVersions.Append
' Create a new import object with specified settings
Dim import As New SPImport(importSettings)
' Turn down caching during the import
SiteCacheSettingsWriter.UpdateCacheSettingsDuringImport(importSettings.SiteUrl, True)
' Save the cache settings to restore after
' the import finishes
savedCacheSettings = SiteCacheSettingsWriter.SaveCacheSettingsBeforeImport(importSettings.SiteUrl)
' Change tokens for pre-import and post-import
Dim startChangeToken, endChangeToken As SPChangeToken
Using destinationSite As New SPSite(importSettings.SiteUrl)
' Get the change token from the destination site
startChangeToken = destinationSite.CurrentChangeToken
' Save the root Web URL for future use
destinationRootWebUrl = destinationSite.RootWeb.ServerRelativeUrl
End Using
AddHandler import.ObjectImported, AddressOf import_ObjectImported
' Optionally add event handlers to the
' import object for:
' Started
' ProgressUpdated
' Completed
' Cancelled
' Error
' Uncompressing
' Run the import
import.Run()
Using destinationSite As New SPSite(importSettings.SiteUrl)
' Get the change token from the
' destination site AFTER import
endChangeToken = destinationSite.CurrentChangeToken
' Enable scheduling of the items just deployed
ScheduledItem.EnableSchedulingOnDeployedItems(destinationSite, startChangeToken, endChangeToken, "Succeeded")
End Using
' Catch any exceptions during import and output them
Catch ex As Exception
Console.Error.Write(ex.ToString())
Throw
Finally
' Update the cache settings because import is done
SiteCacheSettingsWriter.UpdateCacheSettingsDuringImport(destinationUrl, False)
End Try
' #End Region
End Sub
Private Shared Sub import_ObjectImported(ByVal sender As Object, ByVal e As SPObjectImportedEventArgs)
' Is the imported object a Web site?
If (e IsNot Nothing) AndAlso (e.Type = SPDeploymentObjectType.Web) Then
' Is the imported object the root Web site?
If String.Compare(e.TargetUrl, destinationRootWebUrl, StringComparison.OrdinalIgnoreCase) = 0 Then
' The root Web site is being imported, so restore
' the cache-related root Web site properties.
SiteCacheSettingsWriter.RestoreCacheSettingsOnImport(destinationUrl, savedCacheSettings)
End If
End If
Return
End Sub
End Class
End Namespace
Vea también
Tareas
Procedimiento para implementar contenido entre servidores