PowerPoint-Automatisierungsdienste in SharePoint

In diesem Artikel erfahren Sie, wie Sie mithilfe von Microsoft PowerPoint Automation Services Präsentationen serverseitig in verschiedene Dateiformate bzw. aus verschiedenen Dateiformaten konvertieren können.

Einführung

Viele Unternehmen unterschiedlichster Größe verwenden ihre Microsoft SharePoint Server-Bibliotheken als Repository für Microsoft PowerPoint-Präsentationen. Dabei stellen sie alle jeweils eigene Anforderungen an die Speicherung, Verteilung und Aktualisierung der Präsentationen. Microsoft PowerPoint Automation Services ist ein neues Feature von Microsoft SharePoint, mit dem Unternehmen ihre Präsentationen verwalten können. Es handelt sich um einen freigegebenen Dienst, der eine unbeaufsichtigte, serverseitige Konvertierung von Präsentationen in andere Formate ermöglicht. Der Dienst wurde für das Arbeiten auf Servern entwickelt und kann zahlreiche Präsentationsdateien auf verlässliche und vorhersehbare Weise verarbeiten.

Mit PowerPoint Automation Services können Sie das PowerPoint-Binärdateiformat (.ppt) und das PowerPoint-Open XML-Dateiformat (.pptx) in andere Formate konvertieren. Sie können beispielsweise mehrere PowerPoint 97-2003-Dateien in Open XML-Präsentationsdateien konvertieren. Sie können auch eine benutzerdefinierte Aktion im Menü Bearbeiten erstellen, damit Benutzer bei Bedarf eine PDF-Version ihrer Präsentationen erstellen können.

Anwendungsszenarien für PowerPoint Automation Services

Die folgenden Szenarien beschreiben einige Möglichkeiten der Verwendung von PowerPoint Automation Services zum Automatisieren der Präsentationsverarbeitung auf einem Server:

• Ein Großunternehmen speichert alle Präsentationen zum Gewinn in einer einzelnen Dokumentbibliothek auf einer Unternehmens-Intranetwebsite. Die Bibliothek enthält zahlreiche Präsentationen, die sich über die Jahre angesammelt haben. Die IT-Abteilung möchte alle Präsentationsdateien im PowerPoint 97-2003-Binärdateiformat (.ppt) in das Open XML-Präsentationsdateiformat (.pptx) umwandeln. Die diese Konvertierung durchführenden Entwickler möchten eine Lösung auf dem Server bereitstellen, die alle Dateien in der Bibliothek durchläuft, prüft, ob die Datei das PPT-Format aufweist, und anschließend eine solche Datei in das PPTX-Dateiformat umwandelt.

• Eine regionale Vertriebsabteilung bietet maßgeschneiderte Kundendienstangebote für jeden einzelnen Kunden. Jeder Verkäufer überprüft zusammen mit dem Kunden seine Angebote in einem Meeting, entweder persönlich oder online. Nach dem Meeting stellt der Verkäufer eine Kopie des Angebots für den Kunden in Form einer PDF zur Verfügung. Die Abteilung beauftragt einen Anbieter damit, ein benutzerdefiniertes Verb im Menü Bearbeiten für die in einer Dokumentbibliothek in ihrem Extranet gespeicherten PowerPoint-Dateien zu erstellen. Durch Klicken auf das Verb führt der Server ein Programm aus, das die PowerPoint-Datei in eine in der gleichen Bibliothek gespeicherte PDF umwandelt.

Unterstützte Formate der Quellpräsentation

Die folgenden Formate der Quellpräsentation werden bei der Konvertierung unterstützt:

• Open XML-Präsentationsformat (.pptx)

• PowerPoint 97-2003-Präsentation (.ppt)

Unterstützte Formate des Zieldokuments

Die unterstützten Formate der Zieldokumente umfassen alle unterstützten Formate der Quelldokumente und die folgenden Formate:

• .pptx (Open XML-Präsentationsformat)

• .pdf

• .xps (Open XML Paper Specification)

• .jpg

• .png (Portable Network Graphics Format)

Einschränkungen von PowerPoint Automation Services

PowerPoint Automation Services umfasst keine Funktionen zum Ausdrucken von Dokumenten. Es ist jedoch einfach, PowerPoint-Präsentationsdateien (.ppt und .pptx) in PDF- oder XPS-Dateien zu konvertieren, und sie an einen Drucker zu senden.

PowerPoint Automation Services-API

Wenn Sie PowerPoint Automation Services verwenden möchten, senden Sie über die Programmierschnittstelle des Features eine Konvertierungsanforderung an den SharePoint-Server. In jeder Konvertierungsanforderung geben Sie an, welche Dateien konvertiert werden sollen und welches Ausgabeformat für den Konvertierungsauftrag gewünscht ist. Bei bestimmten Konvertierungsanforderungen können Sie auch den zu konvertierenden Inhaltstyp angeben, einschließlich Kommentare, ausgeblendete Folien oder Dokumenteigenschaften.

PowerPoint Automation Services verwendet die asynchrone Mustermethode zum Senden und Empfangen von Konvertierungsanforderungen. Sie können somit einen Code schreiben, mit dem mit der Ausführung fortgefahren wird, nachdem eine Konvertierungsanforderung gesendet wurde. Wenn Sie die Benutzer über den Abschluss einer Konvertierungsanforderung benachrichtigen möchten, können Sie eine Stellvertretung angeben, die auf eine auszuführende Rückrufmethode verweist, sobald der Vorgang abgeschlossen ist.

Die folgenden Abschnitte beinhalten eine eingeschränkte Liste von Klassen, die zum Senden und Empfangen von Konvertierungsanforderungen erforderlich sind. All diese Klassen sind im Microsoft.Office.Server.PowerPoint.Conversion-Namespace enthalten.

Request-Basisklasse

Die Request-Klasse ist die grundlegendste Klasse im Microsoft.Office.Server.PowerPoint.Conversion-Namespace. Alle anderen request-Typen - PresentationRequest, PictureRequest, PdfRequest und XpsRequest - erben von dieser.

Tabelle 1. Request-Basisklassenelemente

PresentationRequest-Klasse

Die PresentationRequest-Klasse, die von der Request-Klasse erbt, wandelt eine PowerPoint 97-2003-Datei (.ppt) oder Open XML-Präsentationsdatei (.pptx) in ein anderes Dateiformat um. Im ersten oben erwähnten Szenario wird diese Klasse zum Konvertieren älterer Präsentationsdateien in einer Dokumentbibliothek in das Open XML-Präsentationsdateiformat verwendet.

Die Konstruktormethode für die PresentationRequest-klasse verfügt über drei erforderliche Parameter:

• input: Verwendet die Datei, die Sie als Stream-Objekt konvertieren möchten.

• extension Eine Zeichenfolge, die die Dateierweiterung der zu konvertierenden Datei angibt.

• output: Ein SPFileStream-Objekt , das angibt, wo die Ausgabe gespeichert wird.

Die PresentationRequest-Klasse verfügt über eine Überladung für die Konstruktormethode, die einen settings-Parameter hinzufügt. Der settings-Parameter lässt ein PresentationSettings-Objekt als Argument zu.

Tipp: Wenn Sie das Stream-Ausgabeobjekt zurück in ein SPFile-Objekt konvertieren, überprüfen Sie, ob die erweiterung, die der resultierenden Datei zugewiesen wird, mit der Erweiterung des gewünschten Dateityps übereinstimmt (.ppt oder .pptx).

PdfRequest-Klasse

Die PdfRequest-Klasse, die auch von der Request-Klasse erbt, konvertiert eine PowerPoint 97-2003-Datei (.ppt) oder Open XML-Präsentationsdatei (.pptx.) in eine PDF-Datei. Im zweiten oben erwähnten Szenario wird diese Klasse zum Konvertieren von Präsentationen in PDF-Dateien verwendet.

Die Konstruktormethode für die PdfRequest-Klasse verfügt ebenfalls über drei erforderliche Parameter – Eingabe, Erweiterung und Ausgabe – ähnlich der PresentationRequest-Klasse .

Die PdfRequest-Klasse verfügt auch über eine Überladung für die Konstruktormethode, die einen settings-Parameter hinzufügt. Der settings-Parameter lässt ein FixedFormatSettings-Objekt als Argument zu.

Tipp: Wenn Sie das Stream-Ausgabeobjekt zurück in ein SPFile-Objekt konvertieren, überprüfen Sie, ob die erweiterung der resultierenden Datei mit der Erweiterung des gewünschten Dateityps übereinstimmt (.pdf).

PictureRequest-Klasse

Die PictureRequest-Klasse, die auch von der Request-Klasse erbt, wandelt eine PowerPoint 97-2003-Datei (.ppt) oder Open XML-Präsentationsdatei File (.pptx) in eine Auflistung von Bilddateien im JPG- oder PNG-Format um.

Die Konstruktormethode für die PictureRequest-Klasse verfügt ebenfalls über vier erforderliche Parameter. Die Eingabe-, Erweiterungs- und Ausgabeparameter ähneln den Parametern für den PresentationRequest-Klassenkonstruktor. Die Konstruktormethode für die PictureRequest-Klasse verfügt auch über einen erforderlichen format-Parameter, der eine Konstante aus der PictureFormat-Enumeration sein muss.

Die Klasse PictureRequest hat keine Überladungen für ihre Konstruktormethode.

Tipp: Die Klasse PictureRequest gibt einen Datenstrom mit einem Paket von Bilddateien zurück. Vergewissern Sie sich bei der Rückkonvertierung des Ausgabeobjekts des Typs Stream in ein Objekt des Typs SPFile, dass die ausgegebene Datei die Dateiendung „.zip“ hat.

Erstellen einer PowerPoint Automation Services-Anwendung

Am einfachsten kann das Schreiben von Code, der PowerPoint Automation Services verwendet, anhand der Erstellung einer Konsolenanwendung veranschaulicht werden. Sie müssen die Konsolenanwendung auf dem SharePoint Server, und nicht auf einem Clientcomputer erstellen und ausführen. Der Code zum Starten von Konvertierungsanforderungen ist unabhängig davon, ob der Code der Konvertierungsanforderung in ein Webpart, einen Workflow oder einen Ereignishandler integriert ist. Bei Verwendung von PowerPoint Automation Services aus einer Konsolenanwendung zeigt das folgende Verfahren, wie Die API verwendet wird, ohne die Komplexität eines Webparts, eines Ereignishandlers oder eines Workflows hinzuzufügen.

So erstellen Sie die Anwendung

1. Starten Sie Microsoft Visual Studio 2012.

2. Zeigen Sie im Menü Datei auf Neu, und wählen Sie dann Projekt.

3. Erweitern Sie im Dialogfenster Neues Projekt unter InstalliertVorlagen, erweitern Sie Visual C#, und wählen Sie dann Windows.

4. Wählen Sie in der Liste der Projektvorlagen Konsolenanwendung

5. Vergewissern Sie sich, dass das Visual Studio-Projekt auf .NET Framework 4 verweist.

   Hinweis

   Beim Einsatz früherer SharePoint Server-Versionen musste auf .NET Framework 3.5 verwiesen werden. Jetzt verweisen die Microsoft.SharePoint-Bibliotheken auf Assemblys in .NET Framework 4. Stellen Sie außerdem sicher, dass das Projekt auf die Vollversion von .NET Framework 4 verweist, nicht auf das .NET Framework 4 Client Profile.

6. Geben Sie in das Feld Name den gewünschten Namen für das Projekt ein, zum Beispiel „PAS_Sample“.

7. Geben Sie im Feld Speicherort den Speicherort ein, an dem das Projekt abgelegt werden soll.

8. Klicken Sie zum Erstellen der Projektmappe auf OK.

9. Standardmäßig erstellt Visual Studio 2012 Projekte, die auf x86-CPUs abzielen, zum Erstellen von SharePoint Server-Anwendungen muss jedoch auf alle CPUs abgezielt werden.

   Klicken Sie beim Erstellen einer Microsoft Visual C#-Anwendung im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und klicken Sie dann auf Eigenschaften.

• Klicken Sie im Projektfenster Eigenschaften auf Build

• Zeigen Sie auf die Liste Konfiguration, und wählen Sie Alle Konfigurationen.

• Zeigen Sie auf die Liste Zielplattform, und wählen Sie Alle CPUs.

  Klicken Sie beim Erstellen einer Microsoft Visual Basic .NET Framework-Anwendung im Fenster Eigenschaften auf Kompilieren.

• Klicken Sie auf Erweiterte Kompilierungsoptionen.

• Zeigen Sie auf die Liste Konfiguration, und wählen Sie Alle Konfigurationen.

• Zeigen Sie auf die Liste Zielplattform, und klicken Sie dann auf Alle CPUs.

10. Klicken Sie im Menü Projekt auf Verweis hinzufügen, um das Dialogfeld Verweis hinzufügen zu öffnen.

11. Erweitern Sie Assemblys, und führen Sie die folgenden Aktionen durch:

• Erweitern Sie Framework, und fügen Sie dann einen Verweis auf System.Web hinzu.

• Erweitern Sie Erweiterungen, und fügen Sie dann einen Verweis auf Microsoft.SharePoint hinzu.

12. Wählen Sie im Dialogfenster Verweis hinzufügenDurchsuchen, navigieren Sie zum Speicherort für die Datei „Microsoft.Office.Server.PowerPoint.dl“ (standardmäßig ist dies C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.Office.Server.PowerPoint\v4.0_15.0.0.0__71e9bce111e9429c), wählen Sie die Assembly aus, und wählen Sie dann Hinzufügen.

Die folgenden C#- und Visual Basic-Beispiele zeigen eine einfache PowerPoint Automation Services-Anwendung, die eine PowerPoint 97-2003-Datei (.ppt) im Ordner „Freigegebene Dokumente" einer SharePoint-Website in eine PowerPoint Open XML-Datei (.pptx) im gleichen Ordner konvertiert.

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

So erstellen Sie das Beispiel und führen es aus

1. Fügen Sie ein PowerPoint-Dokument mit dem Namen Pres1.ppt zum Ordner „Freigegebene Dokumente" auf der SharePoint-Website hinzu.

2. Erstellen Sie das Beispiel, und führen Sie es aus.

3. Warten Sie eine Minute ab, bis der Konvertierungsprozess ausgeführt wird, navigieren Sie zum Ordner „Freigegebene Dokumente" auf einer SharePoint-Website, und aktualisieren Sie die Seite. Die Dokumentbibliothek enthält nun ein neues PowerPoint-Dokument, Pres1.pptx.

Das SharePoint-Feature PowerPoint Automation Services gibt Unternehmen erweiterte Funktionen für die Verwaltung von Präsentationsdateien an die Hand. Die hochleistungsfähige Lösung ermöglicht eine skalierbare, serverseitige Verarbeitung oder Generierung von Präsentationsdateien, entweder batchbasiert oder bedarfsbasiert.

Schlussbemerkung

Das SharePoint-Feature PowerPoint Automation Services gibt Unternehmen erweiterte Funktionen für die Verwaltung von Präsentationsdateien an die Hand. Die hochleistungsfähige Lösung ermöglicht eine skalierbare, serverseitige Verarbeitung oder Generierung von Präsentationsdateien, entweder batchbasiert oder bedarfsbasiert.

Siehe auch

• Entwickeln mit SharePoint 2010 Word Automation Services

• PowerPoint Developer Center

• SharePoint Developer Center