Dies ist der erste Post einer Serie von Posts, die die Erstellung von Websitespalten, Inhaltstypen und List- bzw. Bibliotheks-Defintionen per Feature zeigen sollen.
Oftmals möchte man eine eigene Listdefinition oder eine eigene Dokumentenbibliothek erstellen, die einige Modifikationen zur Standardliste bzw. Bibliothek enthält. Da die Listen und Bibliotheken als Features umgesetzt sind, kann man diese kopieren und als Basis für die eigene Weiterentwicklung verwenden. Für die Erstellung einer Kopie der Standard Dokumentenbibliothek sind die Schritte wie folgt:
1. Verzeichnis C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES\DocumentLibrary kopieren unter einem neuen Namen (z.B. RGDocLib)
2. Neue ID (GUID) vergeben in der Datei feature.xml.
3. Datei DocumentLibrary.xml im Unterverzeichnis anpassen:
a. Attribut Type auf einen neuen Wert setzen (z.B. 10001). Ich verwende normalerweise einen Wert, der größer als 10000 ist, um nicht in Konflikt mit MOSS bzw. WSS Werten zu kommen.
b. Attribut Name anpassen. Wird der Wert dieses Attributes geändert, muss auch das Verzeichnis, in welchem sich die Datei Schema.xml befindet (standardmäßig ist dies DocLib), mit dem gleichem Namen umbenannt werden.
c. Attribut Description mit einer eigenen Beschreibung füllen
d. Attribut Image ggf. mit einer neuen Url belegen
4. Feature installieren über folgenden Befehl:
a. Stsadm –o installfeature –name RGDocLib
5. Feature aktivieren auf einem Web
a. Stsadm –o activatefeature –name RGDocLib –url http://rgserver/websites/team1
6. IISREST durchführen
7. Danach kann die neue Dokumentenbibliothek in Websitesaktionen -> Erstellen angelegt werden.
Fehlerquellen und deren Behebung:
Oftmals erhält man beim Erstellen einer neuen Liste / Bibliothek aus einer eigenen Vorlage die Fehlermeldung:
Exception from HRESULT: 0x81070201
Diese ist zuächst einmal absolut nichtssagend und kann mehrere Ursachen haben. Um dem Problem auf die Spur zu kommen, kann man wie folgt vorgehen:
1. Den Tracing Service von SharePoint (Windows SharePoint Services Tracing) starten. Diesen sollte man in einer produktiven Umgebung standardmäßig abschalten und nur bei Problemen einschalten, da er zusätzlich Festplattenspeicher und auch Resourcen verschwendet.
2. Aktion, die den Fehler verursacht hat nochmal ausführen
3. LOG-Datei (C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\LOGS) mit dem aktuellsten Datum öffnen. Ganz am Ende finden sich die Einträge, die zu diesem Fehler geführt haben.
In den meisten Fällen ist die Ursache für obigen Fehler, dass das Attribut Name in der XML-Datei, die in der Feature.xml referenziert ist, geändert wurde (siehe oben 3b). Dadurch versucht MOSS bzw. WSS eine Datei Schema.xml in gleichnamigem Verzeichnis zu finden. Heißt das Verzeichnis nicht gleich, wie der Wert im Attribut Name, kommt es zu obiger Fehlermeldung.