Benutzerdefinierte Verarbeitung von konvertierten Dokumenten
Letzte Änderung: Montag, 8. März 2010
Gilt für: SharePoint Server 2010
Inhalt dieses Artikels
Benutzerdefinierte Vorverarbeitung von konvertierten Dokumenten
Benutzerdefinierte Nachbearbeitung von konvertierten Dokumenten
Zusätzliche Nachbearbeitung von konvertierten Dokumenten
Standardmäßig werden in Microsoft SharePoint Server 2010 einige Schritte zur Nachbearbeitung an der konvertierten Kopie ausgeführt, die der Dokumentkonverter übermittelt hat, wie z. B. der Kopie Metadaten der Originaldatei hinzuzufügen und die Kopie wieder in derselben Dokumentbibliothek abzulegen wie die Originaldatei. Sie können diese Aktionen zur Nachbearbeitung jedoch durch eigene Aktionen ersetzen oder zusätzliche Aktionen anfügen. Darüber hinaus können Sie benutzerdefinierte Verarbeitungsschritte durchführen, ehe der Dokumentkonverter aufgerufen wird.
Weitere Informationen zur Nachbearbeitung, die standardmäßig von SharePoint Server 2010 durchgeführt wird, finden Sie unter Konvertierte Dokumente.
Benutzerdefinierte Vorverarbeitung von konvertierten Dokumenten
Wenn Sie benutzerdefinierte Vorverarbeitungsaktionen durchführen möchten, ehe die Originaldatei von SharePoint Server 2010 an den Dokumentkonverter übergeben wird, erstellen Sie eine Assembly, die die ISPConversionProcessor-Schnittstelle implementiert. Die PreProcess-Methode dieser Schnittstelle nimmt zwei Argumente an:
Ein Bytearray, das den Bytestream der Originaldatei darstellt.
Ein SPExecutingConversionRequest-Objekt, das schreibgeschützte Eigenschaften enthält, die die an die Convert-Methode übergebenen Argumente darstellt, wie etwa benutzerdefinierte Konfigurationsinformationen, die an den Dokumentkonverter übergeben werden, den Dateinamen der konvertierten Kopie, die Konvertierungspriorität, die E-Mail-Adressen der zu benachrichtigenden Benutzer und ob die konvertierte Kopie der Benachrichtigung als Anlage angefügt werden soll oder nicht.
Zum Aufrufen der benutzerdefinierten Vorverarbeitungsassembly legen Sie zwei Parameter der Convert-Methode fest:
Legen Sie den handlerAssembly-Parameter auf eine Zeichenfolge fest, die den Speicherort der benutzerdefinierten Assembly darstellt.
Legen Sie den handlerClass-Parameter auf eine Zeichenfolge fest, die den Namen der Klasse in der für die Vorverarbeitung aufzurufenden Assembly darstellt.
Wenn Sie die Convert-Methode aufrufen und dabei diese Parameter so festgelegt sind, wird die benutzerdefinierte Assembly wiederum von SharePoint Server 2010 mithilfe der PreProcess-Methode aufgerufen. Die Assembly kann dann ihre Aktionen durchführen und ein Bytearray zurückgeben, das die zu SharePoint Server 2010 konvertierte Datei darstellt. Dieses Bytearray wird wiederum von SharePoint Server 2010 an den Dokumentkonverter übergeben.
Benutzerdefinierte Nachbearbeitung von konvertierten Dokumenten
Wenn Sie die von SharePoint Server 2010 durchgeführten Nachbearbeitungsaktionen durch eigene Aktionen ersetzen möchten, erstellen Sie eine Assembly, die die ISPConversionProcessor-Schnittstelle implementiert. Die PostProcess-Methode dieser Schnittstelle nimmt zwei Argumente an:
Ein SPExecutingConversionRequest-Objekt, das schreibgeschützte Eigenschaften enthält, die die an die Convert-Methode übergebenen Argumente darstellt, wie etwa benutzerdefinierte Konfigurationsinformationen, die an den Dokumentkonverter übergeben werden, den Dateinamen der konvertierten Kopie, die Konvertierungspriorität, die E-Mail-Adressen der zu benachrichtigenden Benutzer und ob die konvertierte Kopie der Benachrichtigung als Anlage angefügt werden soll oder nicht. Darüber hinaus umfasst das Objekt ein Bytearray, das die konvertierte Datei darstellt.
Ein unbekannter Typ, der das Ergebnis darstellt.
Zum Aufrufen der benutzerdefinierten Nachbearbeitungsassembly legen Sie zwei Parameter der Convert-Methode fest:
Legen Sie den handlerAssembly-Parameter auf eine Zeichenfolge fest, die den Speicherort der benutzerdefinierten Assembly darstellt.
Legen Sie den handlerClass-Parameter auf eine Zeichenfolge fest, die den Namen der Klasse in der für die Nachbearbeitung aufzurufenden Assembly darstellt.
Wenn Sie die Transform-Methode aufrufen und dabei diese Parameter so festgelegt sind, nachdem der Dokumentkonverter eine konvertierte Kopie der Originaldatei generiert hat, wird die benutzerdefinierte Assembly von SharePoint Server 2010 mithilfe der PostProcess-Methode aufgerufen. Die benutzerdefinierte Assembly kann die Aktionen zur Nachbearbeitung durchführen. In diesem Fall wird keine Nachbearbeitung von SharePoint Server 2010 durchgeführt, und die konvertierte Kopie wird nicht in dieselbe Dokumentbibliothek wie das Original verschoben.
Zusätzliche Nachbearbeitung von konvertierten Dokumenten
Für die Durchführung zusätzlicher Nachbearbeitungsaktionen, nachdem SharePoint Server 2010 die Nachbearbeitung der konvertierten Kopie beendet hat, schreiben Sie einen Codehandler, der auf das Convert-Listenereignis wartet. Dieses Ereignis wird in SharePoint Server 2010 ausgelöst, wenn ein Dokument erfolgreich konvertiert, verarbeitet und wieder in derselben Dokumentbibliothek wie die Originaldatei abgelegt wurde.
.gif "Hinweis") Hinweis |
|---|
Die Before-Eigenschaften des Ereignisses verweisen auf die Originaldatei, und die After-Eigenschaften verweisen auf die konvertierte Kopie. |