Heraufstufung und Herabstufung von Dokumenteigenschaften
Letzte Änderung: Montag, 1. November 2010
Gilt für: SharePoint Foundation 2010
Die Heraufstufung von Eigenschaften bezeichnet den Vorgang, bei dem Werte aus Eigenschaften eines Dokuments extrahiert und in entsprechende Spalten in der Listen- oder Dokumentbibliothek geschrieben werden, in der das Dokument gespeichert ist. Herunterstufung von Eigenschaften ist der umgekehrte Vorgang. Dabei werden Werte aus Listenspalten gelesen und in Dokumenteigenschaften geschrieben.
Microsoft SharePoint Foundation kann zusammen mit einem Dokumentparser verwendet werden, um den Heraufstufungs- und Herabstufungsvorgang für Eigenschaften zu automatisieren. Wenn die Werte von Dokumenteigenschaften geändert werden, können die Änderungen automatisch zurück in die Liste geschrieben werden. Wenn die Werte der Spalten oder Felder in einem Listenelement geändert werden, können die Änderungen automatisch zurück in das dem Listenelement zugeordnete Dokument geschrieben werden. Auf diese Weise bleiben das Dokument und das zugeordnete Listenelement synchron.
In SharePoint Foundation wird die Herauf- oder Herabstufung von Eigenschaften initiiert, wenn die folgenden Ereignisse auftreten:
Eine Datei wird in eine Dokumentbibliothek hochgeladen.
Die Felder eines Listenelements, das einer Datei zugeordnet ist, werden geändert.
Die Properties-Eigenschaft eines SPFile-Objekts wird programmgesteuert aktualisiert.
Eine Datei wird nach der Änderung des Listenschemas zum ersten Mal heruntergeladen.
In jedem Fall wird von SharePoint Foundation ermittelt, ob dem Dateityp ein Parser zugeordnet ist. Wenn dies der Fall ist, wird von SharePoint Foundation der Parser aufgerufen, dem das Dokument und ein Eigenschaftenbehälterobjekt übergeben werden. Anschließend wird der Eigenschaftenbehälter vom Parser mit Werten gefüllt, die in der Liste heraufgestuft werden sollen, oder die Werte, die im Dokument herabgestuft werden sollen, werden aus dem Eigenschaftenbehälter extrahiert.
In SharePoint Foundation werden nur Dokumenteigenschaften herauf- oder herabgestuft, die Listenspalten entsprechen, die für das Dokument gelten. Die für ein Dokument geltenden Spalten werden durch Folgendes angegeben:
Den Inhaltstyp des Dokuments, sofern dieser zugewiesen ist.
Die Spalten in der Dokumentbibliothek, wenn das Dokument keinen Inhaltstyp hat.
Weitere Informationen zu Inhaltstypen finden Sie unter Inhaltstypen.
Außerdem wird die gesamte Sammlung der Dokumenteigenschaften von SharePoint Foundation in einer Hashtabelle gespeichert, auf die programmgesteuert über die Properties-Eigenschaft eines SPFile-Objekts zugegriffen werden kann. Sie können nicht über eine Benutzeroberfläche auf die Hashtabelle mit den Dokumenteigenschaften zugreifen.
Weitere Informationen zur Herauf- und Herabstufung von Dokumenteigenschaften für XML-Dateien durch den integrierten XML-Parser finden Sie unter Höher- und Tieferstufen von Eigenschaften von XML-Dokumenten.
Heraufstufung
Von SharePoint Foundation wird eine Instanz der IParserPropertyBag-Schnittstelle erstellt, und das Objekt wird mit den für die Liste angegebenen Dokumenteigenschaften gefüllt. Anschließend wird der Dokumentparser für den Dateityp aufgerufen. Dann wird die Parse-Methode des Parsers aufgerufen, wobei das Dokument und der Eigenschaftenbehälter als Argumente übergeben werden. Nach der Rückgabe der Methode greift SharePoint Foundation auf den Eigenschaftenbehälter zu und ermittelt, welche Dokumenteigenschaften welchen Listenspalten entsprechen, und schreibt die entsprechenden Werte in die Liste.
In der folgenden Abbildung wird der Vorgang der Dokumentheraufstufung veranschaulicht. Dabei werden Dokumenteigenschaften vom Parser extrahiert und in den Eigenschaftenbehälter geschrieben. Drei der vier Dokumenteigenschaften sind im Inhaltstyp des Dokuments enthalten. Von SharePoint Foundation wiederum werden die Eigenschaften im Eigenschaftenbehälter mit Spalten (Feldern) der Dokumentbibliothek verglichen. Anschließend werden diese Eigenschaften in der Dokumentbibliothek heraufgestuft; das heißt, die Eigenschaftswerte werden in die entsprechenden Spalten geschrieben. Da der Inhaltstyp des Dokuments die Spalte Status nicht enthält, wird die vierte Dokumenteigenschaft (Status) von SharePoint Foundation nicht heraufgestuft, obwohl die Dokumentbibliothek eine entsprechende Spalte enthält. Außerdem werden von SharePoint Foundation alle vier Dokumenteigenschaften in die Properties-Eigenschaft des SPFile-Objekts geschrieben, das das Dokument in der Dokumentbibliothek darstellt.
.gif "Höherstufen von Eigenschaften mithilfe eines benutzerdefinierten Parsers")
Herunterstufung
Von SharePoint Foundation wird eine Instanz von IParserPropertyBag-Schnittstelle erstellt, und das Objekt wird mit für die Liste angegebenen Dokumenteigenschaften gefüllt. Anschließend wird der Dokumentparser für den Dateityp aufgerufen. Dann wird die Demote-Methode des Parsers aufgerufen, wobei das Dokument und der Eigenschaftenbehälter als Argumente übergeben werden. Die Demote-Methode greift auf den Eigenschaftenbehälter zu, ordnet Listenspalten Dokumenteigenschaften zu und schreibt die entsprechenden Werte zurück in das Dokument.
In der folgenden Abbildung wird der Vorgang der Dokumentherabstufung gezeigt. Zum Aktualisieren von zwei Dokumenteigenschaften wird von SharePoint Foundation der Parser aufgerufen, dem dabei das zu aktualisierende Dokument und ein Eigenschaftenbehälterobjekt mit den zwei Dokumenteigenschaften übergeben wird. Die Eigenschaftswerte werden vom Parser aus dem Eigenschaftenbehälter gelesen, und die Eigenschaften im Dokument werden aktualisiert. Wenn die Aktualisierung des Dokuments abgeschlossen ist, wird ein Kennzeichen festgelegt, das in einem Ausgabeparameter übergeben wird, aus dem hervorgeht, dass das Dokument geändert wurde. Dann wird das aktualisierte Dokument von SharePoint Foundation in der Dokumentbibliothek gespeichert.
.gif "Tieferstufen von Eigenschaften mithilfe eines benutzerdefinierten Parsers")