Me pedía el otro día un amigo una función para subir archivos a una librería de documentos de Sharepoint desde un equipo remoto. Yo, aunque no lo habia hecho nunca, pense que seria una tarea sencilla de realizar usando los servicios Web expuestos por Sharpoint. Tras un rato de investigación descubrí que no hay ningun servicio Web de Sharepoint que permita hacer esto de manera directa.
Tras un poco más de información encontre un solución sencilla, basada en hacer una llamada PUT al servidor de Sharepoint. Podeís ver a continuación un código de ejemplo de esta solución.
/// <summary>
/// Función que sube un archivo a un servidor Sharepoint remoto
/// usando una petición PUT.
/// </summary>
/// <param name="localFile">Path del archivo local</param>
/// <param name="remoteFile">Url del archivo remoto</param>
/// <remarks>
/// Esta función sirve desde la versión 1.0 del Framework en adelante
/// </remarks>
public void UploadDocument(string localFile, string remoteFile)
{
// Leer el archivo local
FileStream fs = new FileStream(localFile, FileMode.Open, FileAccess.Read);
byte[] buffer = new byte[fs.Length];
fs.Read(buffer, 0, Convert.ToInt32(fs.Length));
fs.Close();
// Creamos el objeto request para lanzar la petición
WebRequest wr = WebRequest.Create(remoteFile);
wr.Credentials = System.Net.CredentialCache.DefaultCredentials;
wr.Method = "PUT";
wr.ContentLength = buffer.Length;
// Escribimos el archivo en sitio remoto
BinaryWriter bw = new BinaryWriter(wr.GetRequestStream());
bw.Write(buffer, 0, buffer.Length);
bw.Close();
// Obtener el resultado de la petción
HttpWebResponse wres = (HttpWebResponse)wr.GetResponse();
wres.Close();
}
El código anterior funciona perfectamente, pero tiene dos pegas, si subimos el archivo así no se guarda el historial de versiones y la petición es síncrona, lo que puede ser un problema para subir muchos archivos o archivos grandes. La primera es inevitable usando el método de hacer PUT, la segunda, si utilizamos el Framework 2.0 de .Net es simple de solucionar. Podemos utilizar las funciones asíncronas de la clase WebClient para subir el archivo. Tambien, podriamos hacerlo en .Net 1.x, pero tendríamos que usar hilos . Aquí va un pequeño ejemplo de código de como subir un archivo asíncronamente.
/// <summary>
/// Función que sube un archivo a un servidor Sharepoint remoto,
/// de manera asíncrona, usando una petición PUT.
/// </summary>
/// <param name="localFile">Path del archivo local</param>
/// <param name="remoteFile">Url del archivo remoto</param>
/// <remarks>
/// Esta función sirve desde la versión 2.0 del Framework en adelante,
/// no funciona en 1.0, ni en 1.1
/// </remarks>
public void UploadDocumentAsync(string localFile, string remoteFile)
{
// Leemos el archivo
FileStream fs = new FileStream(localFile, FileMode.Open, FileAccess.Read);
byte[] buffer = new byte[fs.Length];
fs.Read(buffer, 0, Convert.ToInt32(fs .Length));
fs.Close();
//Subimos el archivo de manera asíncrona
WebClient wc = new WebClient();
wc.Credentials = System.Net.CredentialCache.DefaultCredentials;
//Manejador de evento para obtener información sobre el progreso
wc.UploadProgressChanged += new UploadProgressChangedEventHandler(UploadProgressChanged);
//Manejador de evento para saber cuando se completo la subida del archivo
wc.UploadDataCompleted += new UploadDataCompletedEventHandler(UploadDataCompleted);
//Iniciamos la subida del archivo asincronamente
wc.UploadDataAsync(new Uri(remoteFile), "PUT", buffer);
//Podriamos cancelar la carga del archivo
//wc.CancelAsync();
}
/// <summary>
/// Manejador de evento que recibe información sobre
/// el progreso de la carga asíncrona del fichero.
/// </summary>
void UploadProgressChanged(object sender, UploadProgressChangedEventArgs e)
{
String msg = string.Format("Progreso: {0}%", e.ProgressPercentage);
Trace.WriteLine(msg);
}
/// <summary>
/// Manejador de evento que recibe información sobre
/// el resultado de la operación de carga del fichero
/// cuando esa se completa
/// </summary>
void UploadDataCompleted(object sender, UploadDataCompletedEventArgs e)
{
if (e.Cancelled == true)
Trace.WriteLine("Se cancelo la operación");
else if (e.Error != null)
{
String msg =
string.Format(
"Se produjo una excepción durante la operación: {0}",
e.Error.ToString());
Trace.WriteLine(msg);
}
}
Pero que pasa si no podemos vivir sin el historial. Pues existe un tercer cámino, bastante más complejo, que es crear un Web Service e integrarlo en el API de Sharepoint. La solución no es tan sencilla de realizar como las anteriores, pero esta perfectamente explicada en este artículo. Además, alguien ya implemento este web service y lo compartio con la comunidad, podeís descargarlo, desde GotDotNet
Seguro que alguno de los lectores de mi blog incluso sugiere alguna otra via…
