Speicherortbasierte Metadatenstandardwerte

Letzte Änderung: Donnerstag, 15. April 2010

Gilt für: SharePoint Server 2010

Inhalt dieses Artikels
Einführung in speicherortbasierte Metadatenstandardwerte
Bedingungen und Rangfolge
Registrieren von Ereignisempfängern für die Anwendung von Standardmetadaten
Konfigurieren von Metadatenstandardwerten für Speicherorte
Programmierbarkeit speicherortbasierter Standardmetadaten

In diesem Thema werden Standardwerte für standortbasierte Metadaten, Konfigurationsoptionen, Rangfolgeregeln zur Steuerung der Anwendung der Metadaten und die Anwendung von Standardmetadaten durch standortbasierte Metadatenstandardwerte mithilfe von Ereignisempfängern vorgestellt.

Einführung in speicherortbasierte Metadatenstandardwerte

Mit speicherortbasierten Metadatenstandardwerten werden die Standardwerte von Metadatenfeldern basierend auf dem Speicherort verwaltet und so angewendet, dass die Metadatenstandardwerte verfügbar sind, wenn der Benutzer ein Dokument bearbeitet. Wenn ein Benutzer mit einer Microsoft SharePoint Server 2010-Website interagiert, werden von SharePoint Server die Standardwerte angewendet, sodass diese angezeigt werden, wenn der Benutzer zum ersten Mal ein Dokumentbearbeitungsformular anzeigt. In Microsoft Office 2010-Anwendungen wie beispielsweise Microsoft Word 2010 werden die Standardwerte für einen Speicherort beim Speichern des Dokuments abgerufen. Beim Speichern des Dokuments werden von der Clientanwendung Inhaltstypinformationen für den Speicherort abgerufen, in dem das Inhaltselement gespeichert ist, und vom Server werden die Standardwerte angewendet und das Eigenschaftsschema im Office 2010-Dokument erstellt.

Bedingungen und Rangfolge

Speicherortbasierte Metadatenstandardwerte folgen Bedingungsregeln, mit denen bestimmt wird, wann Standardwerte auf ein Dokument angewendet werden. In diesem Abschnitt werden zuerst die Bedingungen aufgeführt, und anschließend werden die bei der Anwendung der Bedingungen verwendeten Rangfolgeregeln erläutert.

Standardwerte werden in folgenden Fällen angewendet:

  • Beim Hochladen einer einzelnen Datei

  • Beim Hinzufügen von Dateien als Massenbearbeitung mithilfe der Explorer-Ansicht oder mithilfe des ActiveX-Steuerelements Mehrere Dokumente hochladen

  • Beim Erstellen einer neuen Veröffentlichungsseite

  • Beim Erstellen eines neuen Standarddokuments in einem Dokumentsatz

  • Beim Erstellen eines Dokuments durch einen Workflow

  • Beim direkten Speichern aus Office 2010-Clientanwendungen oder einem SharePoint-Arbeitsbereich

  • Nach Abschluss der Dokumentkonvertierung

In SharePoint Server 2010 werden speicherortbasierte Metadatenstandardwerte angewendet und erzwungen, indem zunächst ein Satz von allgemeinen Rangfolgeregeln festgelegt wird, mit denen bestimmt werden soll, welche Metadatenstandardwerte angewendet werden und in welcher Reihenfolge. Beispielsweise werden bestimmte Rangfolgeregeln verwendet, um Standardwerte auf den Server anzuwenden, Ereignisempfänger zu registrieren, die Reihenfolge von Ereignissen zu bestimmen, die beim Hochladen eines Dokuments auf den Server ausgelöst werden, usw.

Wie und wann von SharePoint Server 2010 speicherortbasierte Metadatenstandardwerte auf Elemente angewendet werden, wird dadurch gesteuert, wie die Rangfolge vom Feature festgelegt wird. Beim Hochladen eines Dokuments in einen Ordner in einer Dokumentbibliothek werden zunächst speicherortbasierte Metadatenstandardwerte für Spalten von verschiedenen Stellen bezogen. Dazu gehören:

  1. Das hochzuladende Dokument, das einen Spaltenwert, eine integrierte Spalte wie beispielsweise Titel enthalten kann, oder ein Dokument, das vorher mit einem angewendeten Schema (das die gleiche Spalte enthielt) gespeichert wurde. In beiden Fällen kann das hochzuladende Dokument einen Spaltenwert enthalten.

  2. Die Felddefinition in der Liste, mit der ein Standardwert angegeben werden kann.

  3. Der Speicherort, in den das Dokument in der Dokumentbibliothek hochgeladen wird, für den ein Standardspaltenwert angegeben werden kann.

Mithilfe von Rangefolgeregeln wird der Wert ermittelt, der auf eine Spalte angewendet wird:

  • Wenn das hochgeladene Dokument einen Wert für das Feld enthält, der dem Listenstandard für die Felddefinition entspricht, wird der aktuelle Wert des Felds basierend auf Rangefolgeregeln von SharePoint Server 2010 mit einem speicherortbasierten Standardwert überschrieben, wenn dieser vorhanden ist.

  • Wenn das hochgeladene Dokument einen Wert enthält, der nicht mit dem Listenstandard übereinstimmt, wird der Wert von SharePoint Server 2010 beibehalten, auch wenn ein speicherortbasierter Standardwert dafür vorhanden ist.

  • Wenn ein Feld nicht vorhanden ist, wird vom Server der in der Felddefinition festgelegte Standardwert verwendet.

Registrieren von Ereignisempfängern für die Anwendung von Standardmetadaten

Beim ersten Konfigurieren eines speicherortbasierten Metadatenstandardwerts für einen Speicherort in einer Dokumentbibliothek wird von SharePoint Server 2010 ein neuer synchroner ItemAdded-Post-Event-Ereignisempfänger für diese Dokumentbibliothek registriert. Nach der Registrierung des Ereignisses wird dieses vom Server auf die pro Speicherort geltenden Standardwerte angewendet. Eine Folge von Ereignissen beeinflusst, wie speicherortbasierte Metadatenstandardwerte aus Dokumenten in die entsprechende Spalte in einer SharePoint Server 2010-Liste höher gestuft werden, welche Standardwerte für einen Speicherort angegeben werden und ob die Werte von Eigenschaften aktualisiert oder korrigiert werden müssen.

  1. Benutzer lädt ein Dokument in einen Speicherort hoch. Zu diesem Zeitpunkt werden Metadaten aus dem Dokument höher gestuft.

  2. Der neue ItemAdded-Ereignisempfänger wird ausgeführt. Dabei wird überprüft, welche speicherortbasierten Metadatenstandardwerte für den Speicherort angegeben sind. Wenn ein Standardwert angegeben ist und der aktuelle Wert dem Standardwert für den angegebenen Inhaltstyp entspricht, wird der Wert von Eigenschaften aktualisiert.

  3. Dem Benutzer wird das Standardbearbeitungsformular für das Element angezeigt. Dabei werden bereits die richtigen Standardwerte für den Speicherort angezeigt.

Wenn Sie den letzten Standardwert pro Speicherort aus der Dokumentbibliothek entfernen, wird die Registrierung des Ereignisempfängers vom Server aufgehoben.

Nach dem Hochladen des Dokuments auf den Server wird das ItemAdded-Ereignis ausgelöst, und die Metadatenwerte des Dokuments für alle Spalten werden in die entsprechende Spalte in der Liste höher gestuft. In SharePoint Server 2010 wird das Bearbeitungsformular für das Dokument angezeigt, und auf dem Server werden die tatsächlichen Metadatenwerte anhand allgemeiner Rangefolgeregeln geändert.

Konfigurieren von Metadatenstandardwerten für Speicherorte

Sie können für Spalten, von denen das Festlegen von Standardwerten unterstützt wird, speicherortbasierte Metadatenstandardwerte in einer Ordnerhierarchie konfigurieren. Wenn Metadatenwerte in einem übergeordneten Ordner konfiguriert werden, erben die Unterordner die Metadatenwerte vom übergeordneten Ordner, sofern nicht für einen Unterordner explizit ein anderer Metadatenwert angegeben ist. Abhängig davon, ob bzw. wie Ordner oder Metadaten über die Benutzeroberfläche oder API geändert werden, können die Standardmetadatenwerte von Ordnern und Unterordnern beeinflusst werden.

Wenn keine Standardwerte für Ordner und Unterordner konfiguriert sind und die Liste nur eine Spalte enthält (eine Textspalte mit dem Namen TheOnlyColumn mit einer leeren Zeichenfolge als Standardwert), werden die Standardmetadatenwerte von Ordnern und Unterordnern basierend auf der Vererbung durch drei nacheinander ausgeführte Aktionen geändert. Stellen Sie sich z. B. eine Beispielstruktur vor, in der Folgendes gilt:

  • Ein Ordner mit dem Namen DocLib ist der übergeordnete Ordner.

  • Die Ordner Alpha und Beta sind Unterordner des Ordners DocLib.

  • Die Ordner AlphaOne und AlphaTwo sind Unterordner von Alpha.

  • BetaOne ist ein Unterordner von Beta.

Erste Aktion: Navigieren zum Ordner Beta und Festlegen eines Standardwerts

Ein Benutzer navigiert zum Ordner Beta und legt für TheOnlyColumn den Standardwert Z fest.

Tabelle 1. Auswirkungen der Festlegung von Metadatenwerten auf Ordner: Erste Aktion

Wenn Sie in diesem Ordner ein Element hinzufügen ...

Lautet der Standardwert von TheOnlyColumn ...

DocLib (Stamm)

Leer

Alpha

Leer

AlphaOne

Leer

AlphaTwo

Leer

Beta

Z

BetaOne

Z

Die Änderung wirkt sich auf die Ordner Beta und BetaOne aus: Die Änderung des Metadatenwerts von Beta wirkt sich auf BetaOne aus, da BetaOne ein Unterordner von Beta ist und daher den Metadatenwert des übergeordneten Ordners erbt.

Zweite Aktion: Navigieren zum Ordner Alpha und Festlegen eines Standardwerts

Ein zweiter Benutzer navigiert zum Ordner Alpha und legt den Standardwert Y fest.

Tabelle 2. Auswirkungen der Festlegung von Metadatenwerten auf Ordner: Zweite Aktion

Wenn Sie in diesem Ordner ein Element hinzufügen ...

Lautet der Standardwert von TheOnlyColumn ...

DocLib (Stamm)

Leer

Alpha

Y

AlphaOne

Y

AlphaTwo

Y

Beta

Z

BetaOne

Z

Die Änderung wirkt sich auf den Ordner Alpha und dessen Unterordner aus. Die Beta-Ordner sind nicht betroffen.

Dritte Aktion: Navigieren zum Ordner AlphaOne und Festlegen eines Standardwerts

Schließlich navigiert ein weiterer Benutzer zum Ordner AlphaOne und legt den Standardwert X fest.

Tabelle 3. Auswirkung der Festlegung von Metadatenwerten auf Ordner: Dritte Aktion

Wenn Sie in diesem Ordner ein Element hinzufügen ...

Lautet der Standardwert von TheOnlyColumn ...

DocLib (Stamm)

Leer

Alpha

Y

AlphaOne

X

AlphaTwo

Y

Beta

Z

BetaOne

Z

Der Wert des Ordners AlphaTwo ist immer noch Y. Die Änderung am Ordner AlphaOne wirkt sich nicht auf AlphaTwo aus, da AlphaTwo nicht dem Ordner AlphaOne untergeordnet ist.

Programmierbarkeit speicherortbasierter Standardmetadaten

Das Objektmodell für speicherortbasierte Metadatenstandardwerte befindet sich hauptsächlich im MetadataDefaults-Typ. Das Objektmodell enthält Methoden, mit deren Hilfe Sie speicherortbasierte Metadatenstandardwerte anwenden und Standardmetadaten in String- und SPFolder-Objekten abrufen, festlegen und entfernen und Standardwerte von Feldern abrufen können. Die verwaltete Referenzdokumentation für MetadataDefaults enthält Codeausschnitte, mit denen diese Funktionalität veranschaulicht wird.

Siehe auch

Konzepte

Verwalten von Dokumenten

Programmiermodell für die Dokumentverwaltung

Weitere Ressourcen

Ereignisse in SharePoint Foundation 2010