Convertir documentos de Word a PDF con el uso de SharePoint Server 2010 y Word Automation Services (traducción automática)

SharePoint 2010 Servicios de automatización de Word disponibles con SharePoint Server 2010 admite convertir documentos de Word a otros formatos. Esto incluye el PDF. En este artículo describe cómo utilizar un receptor de eventos de elemento de documento biblioteca lista para llamar a Servicios de automatización de Word para convertir documentos de Word a PDF cuando se agregan a la lista. Las comprobaciones de receptor de eventos si agrega el elemento de lista es un documento de Word. Si es así, crea un trabajo de conversión para crear una versión PDF del documento Word y empuja hacia el trabajo de conversión a la cola de trabajo de conversión de Servicios de automatización de Word.

En este artículo se describe los pasos siguientes para mostrar cómo se llama a la Servicios de automatización de Word para convertir un documento:

1. Creación de una solución de aplicación de definición de lista de SharePoint 2010 en Visual Studio 2010.
   
   
2. Agregar una referencia al ensamblado Microsoft.Office.Word.Server.
   
   
3. Adición de un receptor de eventos
   
   
4. Agregar el código de ejemplo para la solución.
   
   

Crear una aplicación de definición de lista de SharePoint 2010 en 2010 de Visual Studio

En este artículo se utiliza la aplicación de una definición de lista de SharePoint 2010 para el código de ejemplo.

Para crear una aplicación de definición de lista de SharePoint 2010 en 2010 de Visual Studio

Agregar una referencia al ensamblado de servidor de Word Microsoft Office

Para utilizar Servicios de automatización de Word, debe agregar una referencia a la Microsoft.Office.Word.Server a la solución.

Para agregar una referencia al ensamblado de servidor de Microsoft Office Word

Adición de un receptor de eventos

Este artículo utiliza un receptor de eventos que utiliza el ensamblado Microsoft.Office.Word.Server para crear trabajos de conversión de documento y agregar a la cola de trabajo de conversión de Servicios de automatización de Word.

Para agregar un receptor de eventos

Agregar el código de ejemplo para la solución

Reemplace el contenido del archivo de origen de ConvertWordToPDFEventReceiver.cs con el código siguiente.

using System;
using System.Security.Permissions;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Security;
using Microsoft.SharePoint.Utilities;
using Microsoft.SharePoint.Workflow;

using Microsoft.Office.Word.Server.Conversions;

namespace ConvertWordToPDF.ConvertWordToPDFEventReceiver
{
  /// <summary>
  /// List Item Events
  /// </summary>
  public class ConvertWordToPDFEventReceiver : SPItemEventReceiver
  {
    /// <summary>
    /// An item was added.
    /// </summary>
    public override void ItemAdded(SPItemEventProperties properties)
    {
      base.ItemAdded(properties);

      // Verify the document added is a Word document
      // before starting the conversion.
      if (properties.ListItem.Name.Contains(".docx") 
        || properties.ListItem.Name.Contains(".doc"))
      {
        //Variables used by the sample code.
        ConversionJobSettings jobSettings;
        ConversionJob pdfConversion;
        string wordFile;
        string pdfFile;

        // Initialize the conversion settings.
        jobSettings = new ConversionJobSettings();
        jobSettings.OutputFormat = SaveFormat.PDF;

        // Create the conversion job using the settings.
        pdfConversion = 
          new ConversionJob("Word Automation Services", jobSettings);

        // Set the credentials to use when running the conversion job.
        pdfConversion.UserToken = properties.Web.CurrentUser.UserToken;

        // Set the file names to use for the source Word document
        // and the destination PDF document.
        wordFile = properties.WebUrl + "/" + properties.ListItem.Url;
        if (properties.ListItem.Name.Contains(".docx"))
        {
          pdfFile = wordFile.Replace(".docx", ".pdf");
        }
        else
        {
          pdfFile = wordFile.Replace(".doc", ".pdf");
        }

        // Add the file conversion to the conversion job.
        pdfConversion.AddFile(wordFile, pdfFile);

        // Add the conversion job to the Word Automation Services 
        // conversion job queue. The conversion does not occur
        // immediately but is processed during the next run of
        // the document conversion job.
        pdfConversion.Start();

      }
    }
  }
}

Servicios de automatización de Word provistos de SharePoint Server 2010 le permite crear soluciones de documentos basados en servidor. Combina la funcionalidad proporcionada por Servicios de automatización de Word con el contenido proporcionado con el SDK de XML abierto de soporte de manipulación le permite crear soluciones de documentos enriquecidos que se ejecutan en el servidor que no requieren la automatización de la aplicación de cliente de Word de documento.

Ejemplos de los tipos de operaciones admitidas por Servicios de automatización de Word son los siguientes:

• Conversión entre formatos de documento (por ejemplo, DOC a DOCX)
  
  
• Convertir a formatos fijos (por ejemplo, PDF o XPS)
  
  
• La actualización de campos
  
  
• Importación de "fragmentos de un formato alternativo"
  
  

En este artículo contiene código de ejemplo que muestra cómo crear un controlador de eventos de lista de SharePoint que puede crear Servicios de automatización de Word trabajos de conversión en respuesta a los documentos de Word que se agrega a la lista. Esta sección, ejemplos de código tomados desde el código de ejemplo completo y funcional proporcionado anteriormente en este artículo utiliza para describir el enfoque adoptado por el presente artículo.

El controlador de eventos de ItemAdded en el controlador de eventos de la lista en primer lugar comprueba que el elemento agregado a la lista de la biblioteca de documentos es un documento de Word al comprobar el nombre del documento para la extensión de nombre de archivo .doc o .docx.

// Verify the document added is a Word document
// before starting the conversion.
if (properties.ListItem.Name.Contains(".docx") 
    || properties.ListItem.Name.Contains(".doc"))
{

Si el elemento es un documento de Word el código crea y inicializa objetos ConversionJobSettings y ConversionJob para convertir el documento al formato PDF.

//Variables used by the sample code.
ConversionJobSettings jobSettings;
ConversionJob pdfConversion;
string wordFile;
string pdfFile;

// Initialize the conversion settings.
jobSettings = new ConversionJobSettings();
jobSettings.OutputFormat = SaveFormat.PDF;

// Create the conversion job using the settings.
pdfConversion = 
  new ConversionJob("Word Automation Services", jobSettings);

// Set the credentials to use when running the conversion job.
pdfConversion.UserToken = properties.Web.CurrentUser.UserToken;

El documento de Word para convertir y el nombre del documento PDF para crearse se agregan a la ConversionJob.

// Set the file names to use for the source Word document
// and the destination PDF document.
wordFile = properties.WebUrl + "/" + properties.ListItem.Url;
if (properties.ListItem.Name.Contains(".docx"))
{
  pdfFile = wordFile.Replace(".docx", ".pdf");
}
else
{
  pdfFile = wordFile.Replace(".doc", ".pdf");
}

// Add the file conversion to the Conversion Job.
pdfConversion.AddFile(wordFile, pdfFile);

Por último, el ConversionJob se agrega a la cola de trabajo de conversión de Servicios de automatización de Word.

// Add the conversion job to the Word Automation Services 
// conversion job queue. The conversion does not occur
// immediately but is processed during the next run of
// the document conversion job.
pdfConversion.Start();

Ver el vídeo

Duración del vídeo: 06: 15 | Tamaño de archivo: 7,5 MB | Tipo: WMV

Tomar el código

• Blog del equipo de Microsoft Word 2010: Introducción A servicios de automatización de word
  
  
• Word Automation Services
  
  
• Word Automation Services Class Library
  
  
• ConversionJobSettings
  
  
• ConversionJob
  
  
• Open xml Developer Center
  
  
• Open XML SDK 2.0 para Microsoft Office
  
  
• Descargar: Abrir XML SDK 2.0 para Microsoft Office