Dokumentkonverter
Letzte Änderung: Freitag, 19. November 2010
Gilt für: SharePoint Server 2010
Inhalt dieses Artikels
Prozess der Dokumentkonvertierung im Überblick
Umfang des Dokumentkonverters
Dateitypen der Dokumentkonvertierung
Konvertieren IRM-geschützter Dateien
Konvertierungspriorität
Ein Dokumentkonverter ist eine benutzerdefinierte ausführbare Datei, die anhand eines Dokuments eines bestimmten Dateityps eine Kopie der entsprechenden Datei in einem anderen Dateiformat erstellt. Beispielsweise kann ein Dokumentkonverter aus einer Microsoft Excel 2010-Datei eine -Datei generieren. Mithilfe von Dokumentkonvertern können Sie Inhalte gemäß Ihren Geschäftserfordernissen in verschiedene Versionen übertragen. Beispielsweise könnten Sie Dokumentationsentwürfe für die langfristige Archivierung in ein anderes, endgültiges Format konvertieren, oder möglicherweise müssen Sie die interne Dokumentation in ein anderes Format konvertieren, um sie auf einer Website für Kunden bereitzustellen.
Microsoft SharePoint Server 2010 umfasst ein erweiterbares Grundgerüst, das es Ihnen ermöglicht, eigene benutzerdefinierte Dokumentkonverter für die Dokumentbibliotheken in einer Webanwendung einzusetzen. Nachfolgend werden die Grundschritte zur Entwicklung eines benutzerdefinierten Dokumentkonverters aufgeführt:
Sicherstellen, dass die Dokumentkonvertierung für Ihre Webanwendung aktiviert ist.
Erstellen einer ausführbaren Datei, die mithilfe eines bestimmten Befehlszeilenbefehls aufgerufen werden kann.
Packen der ausführbaren Datei zusammen mit einer Definitionsdatei für die Dokumentkonvertierung als ein Feature, das auf Webanwendungsebene bereitgestellt und aktiviert werden kann.
Installieren und Aktivieren des Dokumentkonverters; der Dokumentkonverter kann über die Benutzeroberfläche der Zentraladministration weiter konfiguriert werden.
Weitere Informationen zu dem Befehlszeilenbefehl, auf den Dokumentkonverter reagieren müssen, finden Sie unter Befehl "Ausführen" für Dokumentkonverter.
Weitere Informationen zur Bereitstellung von Dokumentkonvertern finden Sie unter Bereitstellung von Dokumentkonvertern.
Prozess der Dokumentkonvertierung im Überblick
Da Dokumentkonvertierungen ressourcenintensiv sein können, basiert SharePoint Server 2010 auf den beiden Diensten DocConvLoadBalancer und DocConvLauncher, um den Lastenausgleich, die Priorisierung und die Zeitplanung der Konvertierungen zu verwalten. Wenn ein Benutzer eine Dokumentkonvertierung initiiert, entweder über die Benutzeroberfläche oder ein Objektmodell, wird die Dokumentkonvertierungsanfrage von SharePoint Server 2010 an diese beiden Dienste weitergegeben. Der Dokumentkonverter wird schließlich vom DocConvLaunch-Dienst aufgerufen. Bei einem Aufruf generiert der Dokumentkonverter eine konvertierte Kopie auf der Grundlage der Originaldatei. SharePoint Server 2010 übernimmt dann die konvertierte Kopie und führt gewisse Nachbearbeitungen durch. Diese setzen sich wie folgt zusammen:
Metadaten werden aus der Originaldatei zur konvertierten Kopie hinzugefügt, wenn die standardmäßige Nachbearbeitung für Dokumentkonverter verwendet wird. In anderen Fällen, z. B. bei der intelligenten Dokumenterstellung, verwendet die SharePoint Server 2010 die nicht standardmäßige Nachbearbeitung, um Metadaten aus der Originaldatei zur konvertierten Kopie hinzuzufügen.
Dokumentkonverter übertragen alle Felder in der alten Datei im Rahmen der standardmäßigen Nachbearbeitung in die neue Datei.
// Set required properties. foreach (SPField field in file.Item.Fields) { // If we have a field that is not read only, // where the child does not have a value yet // but the parent does, copy that field. if (!field.ReadOnlyField && !field.Hidden && newFile.Item[field.InternalName] == null && file.Item[field.InternalName] != null) { newFile.Item[field.InternalName] = file.Item[field.InternalName]; fUpdateNewFile = true; } }Bei der intelligenten Dokumenterstellung werden keine Metadaten auf Seiten übertragen. Dies ist der Fall, da bei der intelligenten Dokumenterstellung eine Nachbearbeitung ausgeführt wird, die false für runDefaultPostProcessing zurückgibt.
bool runDefaultPostProcessing = true; if (tp != null) tp.PostProcess(etr, cdti, out runDefaultPostProcessing); if (runDefaultPostProcessing)Weitere Informationen zur Nachbearbeitung bei der SharePoint Server 2010 finden Sie in den Informationen zur PostProcess()-Methode.
Hinzufügen von Metadaten, die die zum Generieren der konvertierten Kopie verwendete Originaldatei und den Dokumentkonverter identifizieren.
Benachrichtigen der angegebenen Benutzer, dass die Konvertierung durchgeführt wurde.
Ablegen der konvertierten Kopie in derselben Dokumentbibliothek wie die Originaldatei.
Weitere Informationen zu den Diensten DocConvLoadBalancer und DocConvLaunch finden Sie unter Für die Dokumentkonvertierung erforderliche Dienste.
Weitere Informationen zu dem Befehlszeilenbefehl, auf den Dokumentkonverter reagieren müssen, finden Sie unter Befehl "Ausführen" für Dokumentkonverter.
Weitere Informationen zu den Nachbearbeitungsschritten, die von SharePoint Server 2010 an konvertierten Kopien ausgeführt werden, finden Sie unter Konvertierte Dokumente.
Umfang des Dokumentkonverters
Dokumentkonverter werden auf der Webanwendungsebene aktiviert. Nach dem Aktivieren eines Dokumentkonverters für eine Webanwendung ist der Konverter in jeder Dokumentbibliothek auf jeder Website in dieser Webanwendung aktiviert.
Es ist nicht möglich, einen Dokumentkonverter für eine bestimmte Website oder Dokumentbibliothek zu deaktivieren.
Sie können auch verhindern, dass ein Dokumentkonverter auf der Benutzeroberfläche angezeigt wird. In einem solchen Fall kann nur über das SharePoint Server 2010-Objektmodell auf den Dokumentkonverter zugegriffen werden. Angenommen, ein Dokumentkonverter wird von Administratoren nur im Rahmen einer Batchverarbeitung zur Archivierung von Elementen verwendet. Anderen Benutzern ist es nicht möglich, diesen Dokumentkonverter über die Benutzeroberfläche zu verwenden.
Dateitypen der Dokumentkonvertierung
Bei einer Webanwendung können mithilfe mehrerer Konverter Originaldokumente mit derselben Dateityperweiterung verarbeitet und konvertierte Kopien derselben Dateityperweiterung generiert werden. So können Sie beispielsweise mithilfe mehrerer Konverter eine Excel-Datei in eine PowerPoint-Datei konvertieren. Jeder Konverter führt verschiedene Konvertierungsfunktionen an der Datei aus, die endgültige Dateityperweiterung ist jedoch in allen Fällen dieselbe. Aus diesem Grund sind mehrere konvertierte Kopien desselben Dateityps für dasselbe Originaldokument möglich.
In SharePoint Server 2010 wird die GUID des Konverters gespeichert, der zum Erstellen einer bestimmten konvertierten Kopie verwendet wurde. Ob ein bestimmter Konverter zum Generieren einer Kopie verwendet wurde, wird vielmehr anhand der GUID als der Dateityperweiterung ermittelt.
Konvertieren IRM-geschützter Dateien
Wird ein Dokument durch die Verwaltung von Informationsrechten (Information Rights Management, IRM) geschützt, ist jede konvertierte Kopie ebenfalls durch IRM geschützt. Wenn Sie bei einem Dokument in einem IRM-geschützten Dateiformat einen Konverter auswählen, der eine konvertierte Kopie in einem nicht durch IRM geschützten Dateiformat generieren würde, führt die Konvertierung zu einem Fehler.
Konvertierungspriorität
Bei der Konvertierung von Dokumenten können Sie eine Priorität festlegen und zwischen drei Ebenen wählen. Der DocConversionLauncherService-Dienst prüft die Priorität für die Dokumentkonvertierung beim Planen der Reihenfolge, in der Dokumentkonvertierungsanforderungen erfüllt werden.
Folgende Werte können als Priorität ausgewählt werden.
1 (Hoch)
Standardpriorität für alle Dokumentkonvertierungen, die über die Benutzeroberfläche von SharePoint Server 2010 initiiert werden.
2 (Normal)
Standardpriorität für alle Dokumentkonvertierungen, die mithilfe des Windows SharePoint Services-Objektmodells initiiert werden.
3 (Niedrig)
Empfohlene Prioritätsebene für große Batches an Dokumentkonvertierungen. Dokumentkonvertierungen können ressourcenintensiv sein, vor allem bei einer Ausführung in Batches.
Die Priorität der Dokumentkonvertierung kann nicht explizit über die Benutzeroberfläche festgelegt werden.
Sie können die Priorität einer Dokumentkonvertierungsanforderung explizit mithilfe des Objektsmodells festlegen, indem Sie das Prioritätsargument der Convert-Methode festlegen.
Siehe auch
Konzepte
Übersicht über Dokumentkonverter
Benutzerdefinierte Verarbeitung von konvertierten Dokumenten