Serviços de automação do PowerPoint no SharePointPowerPoint Automation Services in SharePoint

Saiba como usar Microsoft PowerPoint Automation Services fazer conversões de apresentação do lado do servidor de e para uma variedade de formatos de arquivo.Learn to use Microsoft PowerPoint Automation Services to do server-side presentation conversions to and from a variety of file formats.

IntroduçãoIntroduction

Muitas empresas grandes e médias, usam suas bibliotecas Microsoft SharePoint Server como um repositório para apresentações Microsoft PowerPoint.Many businesses, large and small, use their Microsoft SharePoint Server libraries as a repository for Microsoft PowerPoint presentations. Essas empresas todos têm suas próprias necessidades específicas para armazenar, distribuir e atualizar suas apresentações.These businesses all have their own particular needs for storing, distributing, and updating their presentations. O Microsoft PowerPoint Automation Services é um novo recurso do Microsoft SharePoint que pode ajudar as empresas a gerenciar suas apresentações.Microsoft PowerPoint Automation Services is a new feature of Microsoft SharePoint that can help enterprises to manage their presentations. É um serviço compartilhado que fornece conversão autônoma, do servidor de apresentações em outros formatos.It is a shared service that provides unattended, server-side conversion of presentations into other formats. Ele foi projetado desde o início trabalhem nos servidores e pode processar vários arquivos de apresentação de maneira confiável e previsível.It was designed from the outset to work on servers and can process many presentation files in a reliable and predictable manner.

Usando PowerPoint Automation Services, você pode converter do formato de arquivo binário do PowerPoint (. ppt) e o formato de arquivo do Open XML PowerPoint (. pptx) para outros formatos. Por exemplo, convém atualizar um lote de PowerPoint arquivos 97 - 2003 para arquivos de apresentação do Open XML. Você também pode criar uma ação personalizada no menu Editar para permitir que usuários criem uma versão em PDF de apresentações sob demanda.Using PowerPoint Automation Services, you can convert from the PowerPoint binary file format (.ppt) and the PowerPoint Open XML file format (.pptx) to other formats. For example, you may want to upgrade a batch of PowerPoint 97-2003 files to Open XML presentation files. You could also create a custom action in the Edit menu to allow users to create a PDF version of presentations on demand.

Observação

O PowerPoint Automation Services aproveita as facilidades de recursos do SharePoint e é um recurso dele.PowerPoint Automation Services takes advantage of facilities of SharePoint and is a feature of it. Você deve ter o SharePoint instalado para usar o PowerPoint Automation Services.You must have SharePoint installed to use PowerPoint Automation Services. Se você estiver usando o SharePoint em um farm de servidores, deverá habilitar explicitamente os serviços de automação do PowerPoint.If you are using SharePoint in a server farm, you must explicitly enable PowerPoint Automation Services.

Cenários de serviços de automação do PowerPointPowerPoint Automation Services scenarios

Os cenários a seguir descrevem algumas maneiras que você pode usar PowerPoint Automation Services para automatizar o apresentações de processamento em um servidor:The following scenarios describe a couple of ways that you can use PowerPoint Automation Services to automate processing presentations on a server:

  • Uma empresa de grande porte armazena todas as suas apresentações de ganhos anualmente em uma única biblioteca de documentos em um site de intranet corporativa. A biblioteca contém um grande número de apresentações que foram acumulados ao longo dos anos. O departamento de TI deseja atualizar todos os arquivos de apresentação no PowerPoint de formato de arquivo binário 97 - 2003 (. ppt) para o formato de arquivo de apresentação do Open XML (. pptx). O desenvolvedor que está executando a conversão decide implantar uma solução no servidor que será percorrer cada um dos arquivos na biblioteca, verifique se o arquivo está no formato. ppt e converter cada arquivo. ppt para o formato de arquivo. pptx.A large enterprise stores all of their yearly earnings presentations in a single document library on a corporate intranet site. The library contains a large number of presentations that have accumulated over the years. The IT department wants to upgrade all of the presentation files in the PowerPoint 97-2003 binary file format (.ppt) to the Open XML presentation file format (.pptx). The developer who is performing the conversion decides to deploy a solution to the server that will iterate through each of the files in the library, check to see whether the file is in the .ppt format, and convert each .ppt file to the .pptx file format.

  • Um departamento de vendas regional fornece estimativas de serviço personalizado a cada um dos seus clientes. Cada vendedor analisa suas aspas com clientes em uma reunião, pessoalmente ou online. Após a reunião, vendedor fornece uma cópia da citação ao cliente em formato PDF. O departamento contrata um fornecedor para criar um verbo personalizado no menu Editar para arquivos do PowerPoint armazenada em uma biblioteca de documentos em sua extranet. Quando o verbo é clicado, o servidor executa um programa que converte o arquivo do PowerPoint em PDF localizado na mesma biblioteca.A regional sales department provides custom service estimates to each of their clients. Each salesperson reviews their quotes with clients in a meeting, either in-person or online. After the meeting, the salesperson provides a copy of the quote to the customer in the form of a PDF. The department hires a vendor to create a custom verb in the Edit menu for PowerPoint files stored in a document library in their extranet. When the verb is clicked, the server runs a program that converts the PowerPoint file to a PDF located in the same library.

Formatos de apresentação de fonte com suporteSupported source presentation formats

Os formatos de apresentação de fonte com suporte para conversão são:The supported source presentation formats for conversion are as follows:

  • Formato de apresentação de formato de arquivo XML aberto (. pptx)Open XML File Format presentation format (.pptx)

  • apresentação de PowerPoint 97 - 2003 (. ppt)PowerPoint 97-2003 presentation (.ppt)

Formatos de documento de destino com suporteSupported destination document formats

Os formatos de documentos de destino com suporte incluem todos os formatos de documentos de origem com suporte e o seguinte:The supported destination document formats include all of the supported source document formats and the following:

  • . pptx (formato de apresentação de formato de arquivo do open XML).pptx (Open XML File Format presentation format)

  • .pdf.pdf

  • . XPS (open XML Paper Specification).xps (Open XML Paper Specification)

  • .jpg.jpg

  • PNG Portable Network Graphics Format.png (Portable Network Graphics Format)

Limitações do PowerPoint Automation ServicesLimitations of PowerPoint Automation Services

PowerPoint Automation Services não inclui recursos para impressão de documentos. No entanto, é simples converter arquivos de apresentação PowerPoint (. ppt e. pptx) para PDF ou XPS e spool-los para uma impressora.PowerPoint Automation Services does not include capabilities for printing documents. However, it is straightforward to convert PowerPoint presentation files (.ppt and .pptx) to PDF or XPS and spool them to a printer.

API de serviços de automação do PowerPointPowerPoint Automation Services API

Para usar o PowerPoint Automation Services, você usa sua interface de programação para enviar uma solicitação de conversão para o SharePoint Server.To use PowerPoint Automation Services, you use its programming interface to send a conversion request to the SharePoint server. Para cada solicitação de conversão, especifique quais arquivos que você deseja converter e o formato de saída do trabalho de conversão.For each conversion request, you specify which files you want to convert and the output format of the conversion job. Para algumas solicitações de conversão, você também pode especificar quais tipos de conteúdo for convertido, incluindo comentários, os slides ocultos ou propriedades do documento.For some conversion requests, you can also specify what types of content is converted, including comments, hidden slides, or document properties.

PowerPoint Automation Services usa o método padrão assíncrono para envio e recebimento de solicitações de conversão. Assim, você pode escrever código que continua a executar depois que uma solicitação de conversão foi enviada. Se você precisar fornecer notificações aos usuários depois que uma solicitação de conversão foi concluída, você pode especificar um representante que faz referência a um método de retorno de chamada a ser executada quando a operação for concluída.PowerPoint Automation Services uses the asynchronous pattern method for sending and receiving conversion requests. Thus, you can write code that continues to execute after a conversion request has been sent. If you need to provide notification to users after a conversion request has been completed, you can specify a delegate that references a callback method to execute when the operation completes.

Observação

[!OBSERVAçãO] Para obter mais informações sobre como trabalhar com o padrão de design assíncrono, consulte o Assíncrona Programming Overview.For more information about how to work with the asynchronous design pattern, see the Asynchronous Programming Overview.

As seções a seguir contêm uma lista limitada das classes que são necessárias para envio e recebimento de que solicitações de uma conversão. Todas essas classes estão contidas no namespace Microsoft.Office.Server.PowerPoint.Conversion.The sections below contain a limited list of the classes that are necessary for sending and receiving a conversion requests. All of these classes are contained in the Microsoft.Office.Server.PowerPoint.Conversion namespace.

Classe de Base de solicitaçãoRequest Base Class

A classe Request é a classe mais fundamental no namespace da Microsoft.Office.Server.PowerPoint.Conversion. Todos os outros tipos desolicitação de — PresentationRequest, PictureRequest, PdfRequeste XpsRequest— herdar a partir dele.The Request class is the most fundamental class within the Microsoft.Office.Server.PowerPoint.Conversion namespace. All of the otherrequest types— PresentationRequest, PictureRequest, PdfRequest, and XpsRequest—inherit from it.

Tabela 1. Solicitação de membros da classe baseTable 1. Request base class members

Nome do membroMember name DescriçãoDescription
método BeginConvert(Microsoft.SharePoint.SPServiceContext, System.AsyncCallback, System.Object)BeginConvert(Microsoft.SharePoint.SPServiceContext, System.AsyncCallback, System.Object) method
Começa a operação de conversão. O primeiro parâmetro, serviceContext, especifica o contexto do site do SharePoint onde se encontra o arquivo a ser convertido. Use o parâmetro callback para especificar um representante que faz referência a um método a ser executado depois que a operação for concluída. Use o parâmetro state se você precisar passar qualquer informação adicional de código de chamada para o método de retorno de chamada. Begins the conversion operation. The first parameter, serviceContext, specifies the context of the SharePoint site where the file to be converted is located. Use the callback parameter to specify a delegate that references a method to execute once the operation has completed. Use the state parameter if you need to pass any additional information from the calling code to the callback method.
Retorna um objeto IAsyncResult .Returns an IAsyncResult object.
método EndConvert(IAsyncResult)EndConvert(IAsyncResult) method
Termina a operação de conversão. O parâmetro result espera que o objeto resultante IAsyncResult que retorna a solicitação de conversão BeginConvert correspondente. Se essa solicitação não foi concluída quando EndConvert é chamado, o thread de chamada está bloqueado até que a operação de conversão seja concluída. Ends the conversion operation. The result parameter expects the resulting IAsyncResult object that the corresponding BeginConvert conversion request returns. If that request has not been completed when EndConvert is called, the calling thread is blocked until the conversion operation is complete.
Não retorna um valor.Does not return a value.

Classe de PresentationRequestPresentationRequest class

A classe de PresentationRequest, que é herdada da classe Request, converte um arquivo do PowerPoint 97 - 2003 (. ppt) ou apresentação de formato de arquivo do Open XML (. pptx) em outro formato de arquivo de apresentação. No primeiro cenário mencionado acima, você pode usar esta classe para converter arquivos de apresentação mais antigos em uma biblioteca de documentos para o formato de apresentação do formato de arquivo Open XML.The PresentationRequest class, which inherits from the Request class, converts a PowerPoint 97-2003 file (.ppt) or Open XML File Format presentation (.pptx) to another presentation file format. In the first scenario mentioned above, you use this class to convert older presentation files in a document library to the Open XML File Format presentation format.

O método construtor para a classe PresentationRequest tem três parâmetros obrigatórios:The constructor method for the PresentationRequest class has three required parameters:

  • _input_— leva o arquivo que você deseja converter como um objeto Stream .input—Takes the file that you want to convert as a Stream object.

  • _extension_— uma cadeia de caracteres que especifica a extensão de arquivo do arquivo sendo convertido.extension—A string that specifies the file extension of the file being converted.

  • _output_— um objeto de SPFileStream que especifica onde a saída será armazenada.output—An SPFileStream object that specifies where the output will be stored.

A classe PresentationRequest tem uma sobrecarga de única para seu método de construtor que adiciona um parâmetro settings. O parâmetro settings aceita um objeto PresentationSettings como um argumento.The PresentationRequest class has a single overload for its constructor method that adds a settings parameter. The settings parameter accepts a PresentationSettings object as an argument.

Dica: Ao converter o objeto Stream de saída de volta para um objeto SPFile , verifique se a extensão fornecida para o arquivo resultante corresponde à extensão do tipo de arquivo que você deseja (. ppt ou. pptx).Tip: When converting the output Stream object back to an SPFile object, check that the extension given to the resulting file matches the extension of the file type that you want (.ppt or .pptx).

Classe de PdfRequestPdfRequest class

A classe de PdfRequest, que também é herdada da classe Request, converte um arquivo do PowerPoint 97 - 2003 (. ppt) ou apresentação de formato de arquivo do Open XML (. pptx) para o arquivo de a.pdf. No segundo cenário mencionado acima, você pode usar esta classe para converter apresentações para arquivos PDF.The PdfRequest class, which also inherits from the Request class, converts a PowerPoint 97-2003 file (.ppt) or Open XML File Format presentation (.pptx) to a.pdf file. In the second scenario mentioned above, you use this class to convert presentations to PDF files.

The constructor method for the PdfRequest class also has three required parameters— input, extension, and output—similar to the PresentationRequest class.The constructor method for the PdfRequest class also has three required parameters— input, extension, and output—similar to the PresentationRequest class.

A classe PdfRequest também tem uma única sobrecarga para seu método de construtor que adiciona um parâmetro settings. O parâmetro settings aceita um objeto FixedFormatSettings como um argumento.The PdfRequest class also has a single overload for its constructor method that adds a settings parameter. The settings parameter accepts a FixedFormatSettings object as an argument.

Dica: Ao converter o objeto Stream de saída de volta para um objeto SPFile , verifique se a extensão fornecida para o arquivo resultante corresponde à extensão do tipo de arquivo que você deseja (. pdf).Tip: When converting the output Stream object back to an SPFile object, check that the extension given to the resulting file matches the extension of the file type that you want (.pdf).

Classe de PictureRequestPictureRequest class

A classe de PictureRequest, que também é herdada da classe Request, converte um PowerPoint 97 - 2003 arquivo (. ppt) ou apresentação de formato de arquivo do Open XML (. pptx) a uma coleção de arquivos de imagem no formato the.jpg ou. PNG.The PictureRequest class, which also inherits from the Request class, converts a PowerPoint 97-2003 file (.ppt) or Open XML File Format presentation (.pptx) to a collection of image files in either the.jpg or .png format.

The constructor method for the PictureRequest class also has four required parameters. The input, extension, and output parameters are similar to the parameters for the PresentationRequest class constructor. The constructor method for the PictureRequest class also has a required format parameter, which must be a constant from the PictureFormat enumeration.The constructor method for the PictureRequest class also has four required parameters. The input, extension, and output parameters are similar to the parameters for the PresentationRequest class constructor. The constructor method for the PictureRequest class also has a required format parameter, which must be a constant from the PictureFormat enumeration.

A classe PictureRequest não tem nenhum sobrecargas para seu método de construtor.The PictureRequest class does not have any overloads for its constructor method.

Dica: A classe PictureRequest retorna um Stream que contém um pacote de arquivos de imagem.Tip: The PictureRequest class returns a stream that contains a package of image files. Ao converter o objeto de saída Stream volta a um objeto de SPFile , verifique se a extensão dada ao arquivo resultante é .zip.When converting the output Stream object back to an SPFile object, check that the extension given to the resulting file is .zip.

Criando um aplicativo de serviços de automação do PowerPointBuilding a PowerPoint Automation Services application

A maneira mais fácil para mostrar como escrever código que usa PowerPoint Automation Services é criar um aplicativo de console.The easiest way to show how to write code that uses PowerPoint Automation Services is to build a console application. Você deve criar e executar o aplicativo de console, no SharePoint Server, não em um computador cliente.You must build and run the console application on the SharePoint Server, not on a client computer. O código para iniciar solicitações de conversão é semelhante se o código de solicitação de conversão é incorporado a uma Web Part, um fluxo de trabalho ou um manipulador de eventos.The code to start conversion requests is similar whether the conversion request code is incorporated into a web part, a workflow, or an event handler. Usando o PowerPoint Automation Services a partir de um aplicativo de console, o procedimento a seguir mostra como usar a API sem adicionar as complexidades de uma Web Part, um manipulador de eventos ou um fluxo de trabalho.By using PowerPoint Automation Services from a console application, the following procedure shows how to use the API without adding the complexities of a web part, an event handler, or a workflow.

Observação

Como o PowerPoint Automation Services é um serviço do SharePoint, você pode usá-lo somente em um aplicativo executado diretamente em um servidor do SharePoint.Because PowerPoint Automation Services is a service of SharePoint, you can use it only in an application that runs directly on a SharePoint Server. Você deve criar o aplicativo como um farm solution.You must build the application as a farm solution. Você não pode usar PowerPoint Automation Services de um soluçăo em área restrita.You cannot use PowerPoint Automation Services from a sandboxed solution.

Para criar o aplicativoTo build the application

  1. Inicie Microsoft Visual Studio 2012.Start Microsoft Visual Studio 2012.

  2. No menu arquivo, aponte para novo e, em seguida, selecione o projeto.On the File menu, point to New, and then choose Project.

  3. Na caixa de diálogo Novo projeto, em Installed, expanda modelos, expanda Visual c# e escolha Windows.In the New Project dialog box, under Installed, expand Templates, expand Visual C#, and then chose Windows.

  4. Na lista de modelos de projeto, escolha o Aplicativo de Console.In the list of project templates, choose Console Application.

  5. Certifique-se de que o projeto na Visual Studio refere-se .NET Framework 4.Be sure that the project in Visual Studio targets .NET Framework 4.

    Observação

    [!OBSERVAçãO] Versões anteriores do SharePoint Server necessário que você .NET Framework 3.5 de destino. Agora, as bibliotecas de Microsoft. SharePoint referenciar assemblies no .NET Framework 4. Também Certifique-se de que seu projeto refere-se a completo .NET Framework 4 e não o .NET Framework 4 perfil do cliente.Previous versions of SharePoint Server required that you target .NET Framework 3.5. The Microsoft.SharePoint libraries now reference assemblies in .NET Framework 4. Also make sure that your project targets the full .NET Framework 4 and not the .NET Framework 4 Client Profile.

  6. Na caixa nome, digite o nome que você deseja usar para o seu projeto, como PAS_Sample.In the Name box, type the name that you want to use for your project, such as PAS_Sample.

  7. Na caixa local, digite o local onde você deseja colocar o projeto.In the Location box, type the location where you want to place the project.

  8. Clique em OK para criar a solução.Click OK to create the solution.

  9. Por padrão, Visual Studio 2012 cria projetos que CPUs x86 de destino, mas para criar aplicativos SharePoint Server, devem ser direcionados qualquer CPU.By default, Visual Studio 2012 creates projects that target x86 CPUs, but to build SharePoint Server applications, you must target any CPU.

    Se você estiver criando um aplicativo Microsoft Visual c#, no Solution Explorer, clique com botão direito do projeto e, em seguida, clique em Propriedades.If you are building a Microsoft Visual C# application, in Solution Explorer, right-click the project, and then click Properties.

  • Na janela de Propriedades do projeto, clique em criar.In the project Properties window, click Build.

  • Aponte para a lista de configuração e selecione Todas as configurações.Point to the Configuration list, and select All Configurations.

  • Aponte para a lista de Alvos de plataforma e selecione Any CPU.Point to the Platform Target list, and select Any CPU.

    Se você estiver criando um Microsoft Visual Basic aplicativo .NET Framework, na janela Propriedades, clique em Compilar.If you are building a Microsoft Visual Basic .NET Framework application, in the Properties window, click Compile.

  • Clique em Compilar opções avançadas.Click Advanced Compile Options.

  • Aponte para a lista de configuração e selecione Todas as configurações.Point to the Configuration list, and then select All Configurations.

  • Aponte para a lista de Alvos de plataforma e, em seguida, clique em Qualquer CPU.Point to the Platform Target list, and then click Any CPU.

  1. No menu projeto, clique em Adicionar referência para abrir a caixa de diálogo Adicionar referência.On the Project menu, click Add Reference to open the Add Reference dialog box.

  2. Expanda Assemblies e faça o seguinte:Expand Assemblies, and then do the following:

  • Expanda Framework e, em seguida, adicione uma referência ao System. Web.Expand Framework, and then add a reference to System.Web.

  • Expanda extensões e, em seguida, adicione uma referência ao Microsoft. SharePoint.Expand Extensions, and then add a reference to Microsoft.SharePoint.

  1. Também na caixa de diálogo Adicionar referência, escolha Procurar, navegue até o local para o Microsoft.Office.Server.PowerPoint.dll (o local padrão é C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.Office.Server.PowerPoint\v4.0_15.0.0.0__71e9bce111e9429c), selecione o assembly e escolha Adicionar.Also in the Add Reference dialog box, choose Browse, navigate to the location for the Microsoft.Office.Server.PowerPoint.dll (default location is C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.Office.Server.PowerPoint\v4.0_15.0.0.0__71e9bce111e9429c), select the assembly, and then choose Add.

Os seguintes exemplos de c# e Visual Basic mostram um aplicativo simples PowerPoint Automation Services que converte um PowerPoint arquivo 97 - 2003 (. ppt) na pasta de documentos compartilhados de um site do SharePoint para um arquivo de Open XML (. pptx) PowerPoint na mesma pasta.The following C# and Visual Basic examples show a simple PowerPoint Automation Services application that converts a PowerPoint 97-2003 file (.ppt) in the Shared Documents folder of a SharePoint site to a PowerPoint Open XML file (.pptx) in the same folder.


using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text;
using System.Web;
using Microsoft.SharePoint;
using Microsoft.Office.Server.PowerPoint.Conversion;

namespace PAS_Sample
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                string siteURL = "http://localhost";
                using (SPSite site = new SPSite(siteURL))
                {
                    using (SPWeb web = site.OpenWeb())
                    {
                        Console.WriteLine("Begin conversion");

                        // Get a reference to the "Shared Documents" library 
                        // and the presentation file to be converted.
                        SPFolder docs = web.Folders[siteURL + 
                            "/Shared Documents"];
                        SPFile file = docs.Files[siteURL + 
                            "/Shared Documents/Pres1.ppt"];

                        // Convert the file to a stream and create an
                        // SPFileStream object for the conversion output.
                        Stream fStream = file.OpenBinaryStream();
                        SPFileStream stream = new SPFileStream(web, 0x1000);

                        // Create the presentation conversion request.
                        PresentationRequest request = new PresentationRequest(
                            fStream,
                            ".ppt",
                            stream);

                        // Send the request synchronously, passing
                        // in a 'null' value for the callback parameter, 
                        // and capturing the response in the result object.
                        IAsyncResult result = request.BeginConvert(
                            SPServiceContext.GetContext(site),
                            null,
                            null);

                        // Use the EndConvert method to get the result. 
                        request.EndConvert(result);

                        // Add the converted file to the document library.
                        SPFile newFile = docs.Files.Add(
                            "newPres1.pptx", 
                            stream, 
                            true);
                        Console.WriteLine("Output: {0}", newFile.Url);

                    }
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine("Error: " + ex.Message);
            }
            finally
            {
                Console.WriteLine("Complete");
                Console.ReadKey();
            }
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq
Imports System.Text
Imports System.Web
Imports Microsoft.SharePoint
Imports Microsoft.Office.Server.PowerPoint.Conversion

Namespace PAS_Sample
    Class Program
        Private Shared Sub Main(args As String())
            Try
                Dim siteURL As String = "http://localhost"
                Using site As New SPSite(siteURL)
                    Using web As SPWeb = site.OpenWeb()
                        Console.WriteLine("Begin conversion")

                        ' Get a reference to the "Shared Documents" library 
                        ' and the presentation file to be converted.
                        Dim docs As SPFolder = web.Folders(siteURL + _
                            "/Shared Documents")
                        Dim file As SPFile = docs.Files(siteURL + _
                            "/Shared Documents/Pres1.ppt")

                        ' Convert the file to a stream and create an
                        ' SPFileStream object for the conversion output.
                        Dim fStream As Stream = file.OpenBinaryStream()
                        Dim stream As New SPFileStream(web, &H1000)

                        ' Create the presentation conversion request.
                        Dim request As New PresentationRequest(fStream, _
                            ".ppt", 
                            stream)

                        ' Send the request synchronously, passing
                        ' in a Nothing value for the callback parameter, 
                        ' and capturing the response in the result object.
                        Dim result As IAsyncResult = request.BeginConvert(_
                            SPServiceContext.GetContext(site), _
                            Nothing, _
                            Nothing)

                        ' Use the EndConvert method to get the result. 
                        request.EndConvert(result)

                        ' Add the converted file to the document library.
                        Dim newFile As SPFile = docs.Files.Add(_
                            "newPres1.pptx", _
                            stream, _
                            True)

                        Console.WriteLine("Output: {0}", newFile.Url)
                    End Using
                End Using
            Catch ex As Exception
                Console.WriteLine("Error: " + ex.Message)
            Finally
                Console.WriteLine("Complete")
                Console.ReadKey()
            End Try
        End Sub
    End Class
End Namespace

Para criar e executar o exemploTo build and run the example

  1. Adicione um documento de PowerPoint chamado Pres1.ppt para a pasta de documentos compartilhados no site do SharePoint.Add a PowerPoint document named Pres1.ppt to the Shared Documents folder in the SharePoint site.

  2. Criar e executar o exemplo.Build and run the example.

  3. Após um minuto executar o processo de conversão, navegue até a pasta de documentos compartilhados no site do SharePoint e atualize a página. Agora, a biblioteca de documentos contém um novo documento do PowerPoint, Pres1.pptx.After waiting one minute for the conversion process to run, navigate to the Shared Documents folder in the SharePoint site, and refresh the page. The document library now contains a new PowerPoint document, Pres1.pptx.

Os serviços de automação do PowerPoint no SharePoint oferecem aos negócios recursos avançados para gerenciar seus arquivos de apresentação.PowerPoint Automation Services on SharePoint provides businesses with advanced capabilities for managing their presentation files. Essa solução de alto desempenho permite a manipulação de apresentação escalável, do servidor e geração, como um lote ou sob demanda.This high-performance solution allows scalable, server-side presentation manipulation and generation, as a batch or on-demand.

Observação

Antes de executar o exemplo, certifique-se de que o PowerPoint Automation Services tenha sido habilitado no console da administração central do SharePoint.Before you run the example, make sure that PowerPoint Automation Services has been enabled in the SharePoint Central Administration console.
Para verificar se o PowerPoint Automation Services está habilitado, faça o seguinte:To verify that PowerPoint Automation Services is enabled, do the following:

  • No console da administração central, em configurações do sistema, escolha gerenciar serviços no servidore verifique se o serviço de conversão do PowerPoint está definido como iniciado.In the Central Administration console, under System Settings, choose Manage services on server, and then make sure that the PowerPoint Conversion Service is set to Started.
  • Também no console da administração central, em Gerenciamento de aplicativos, escolha gerenciar aplicativos de serviçoe, em seguida, certifique-se de que o aplicativo de serviço de conversão do PowerPoint e o serviço de conversão do PowerPoint O proxy de aplicativo está definido como iniciado.Also in the Central Administration console, under Application Management, choose Manage service applications, and then make sure that the PowerPoint Conversion Service Application and PowerPoint Conversion Service Application Proxy are set to Started.

ConclusãoConclusion

Os serviços de automação do PowerPoint no SharePoint oferecem aos negócios recursos avançados para gerenciar seus arquivos de apresentação.PowerPoint Automation Services on SharePoint provides businesses with advanced capabilities for managing their presentation files. Essa solução de alto desempenho permite a manipulação de apresentação escalável, do servidor e geração, como um lote ou sob demanda.This high-performance solution allows scalable, server-side presentation manipulation and generation, as a batch or on-demand.

Confira tambémSee also