odi's blog

Ich habe mich heute mal ein wenig mit der Erstellung von neuen Webpartseiten auseinandergesetzt, und es war wirklich eine Auseinandersetzung. šber die Websiteeinstellungen lassen sich neue Webpartseiten anlegen, diese Seiten haben nur den Nachteil, dass die Schnellstartleiste fehlt. Also, ab einfachsten die default.aspx im SharePoint Designer laden und unter einem anderen Namen abspeichern, dann habe ich ja eine neue Webpartseite. Gesagt getan, und die Seite war danach auch da und konnte verwendet werden. Ich habe dann auf diese Seite ein paar Webparts abgelegt und diese Webparts auch konfiguriert, u.a. soll bei Symbolleistentyp "Keine Symbolleiste" eingetragen sein. Meine Site also soweit zusammengestellt und dann als Vorlage in den Websitevorlagenkatalog gespeichert. Soweit so gut.

Aus der Vorlage dann eine neue Site erstellt, auf die neue Webpartseite gegangen und aus allen Wolken gefallen. Der Symbolleistentyp war auf "Vollst„ndige Symbolleiste" eingestellt. Also das Webpart nocheinmal konfiguriert, die Vorlage gespeichert, aus der Vorlage wieder eine Site angelegt: gleiches Ergebnis, der Symbolleistentyp passt wieder nicht.

Wie ist die neue Webpartseite entstanden? Ich hatte die default.aspx im SharePoint Designer ge”ffnet und dort unter einem anderen Namen gespeichert. OK, dann gehen wir eben einen anderen Weg.

Die Site ber den SharePoint Designer ge”ffnet und die default.aspx kopiert. Nach meinem Verst„ndnis sollte jetzt das Gleiche passieren wie bei dem vorherigen Versuch. Diese neue Kopie ebenfalls soweit zusammengestellt, wie ich es vorher schon gemacht hatte, u.a. auch den Symbolleistentyp eingestellt, und die Site dann wieder im Websitevorlagenkatalog gespeichert.

Wieder eine Site angelegt, diesesmal mit der neuen Vorlage, auf die neue neue Webpartseite gegangen, und siehe da, der Symbolleistentyp passt.

Was l„sst sich jetzt aus diesen Erkenntnissen ableiten? Wenn eine neue Webpartseite angelegt werden soll, dann kopiere eine bestehende Seite ber den SharePoint Designer. Beim Speichern unter einem anderen Namen scheint irgendetwas zu passieren (oder vielleicht auch nicht zu passieren).

Websitevorlagen sollen den Inhaltsadministrator u.a. dabei untersttzen, vordefinierte Strukturen zu schaffen, damit eine Site nicht gleich von Anfang an ein chaotisches Eigenleben entwickelt. Daher ist es recht angenehm, dass man zun„chst eine Site so "zurecktzupfen" kann, wie sie aussehen soll, und anschlieáend ber die Websiteeinstellungen im Katalog eine Vorlage ablegen kann. W„ren da nicht drei in meinen Augen sehr unangenehme Dinge, von denen ich eigentlich zwei in die Kategorie "Fehler" einordnen wrde.

1. Symbolleistentyp geht verloren
Eine der Eigenschaften, die fr ein Webpart eingestellt werden k”nnen, ist der Symbolleistentyp. In einigen F„llen bietet es sich an, dass hier die Option "Keine Symbolleiste" ausgew„hlt wird, wodurch die Ausgabe "Neues Dokument hinzufgen" unterdrckt wird. Wird die Site als Vorlage gespeichert und dann basierend auf dieser Vorlage eine neue Site angelegt, dann wird der Symbolleistentype wieder auf "šbersichtssymbolleiste" umgestellt. Dieses Verhalten wrde ich in die Kategorie "Fehler" einordnen.

2. Standardwebparts gehen verloren
In einer SharePoint-Site, die aus den Standard-Vorlagen (Teamwebsite, etc.) angelegt werden, stehen einige ntzliche Webparts, wie z.B. das Inhalts-Editor-Webpart zur Verfgung. Wird eine Site als Template gespeichert, und dann mit STSADM -o addtemplate in den globalen Vorlagenkatalog aufgenommen, sodass die Vorlage auch fr eine Site-Collection verwendet werden kann, dann fehlen genau diese Webparts, nachdem basierend auf der Vorlage eine neue Site-Collection angelegt wurde. Sie k”nnen zwar ber "Auffllen" wieder in den Webpartkatalog aufgenommen werden, aber das ist trotzdem „rgerlich, vor allem, wenn die Site-Collections automatisiert angelegt werden, also kein Administrator anschlieáend "auffllen" kann. Auch dieses Verhalten wrde ich in die Kategorie "Fehler" einordnen, wobei dies wie gesagt nur auftritt, wenn die Vorlage mit STSADM zugefgt wurde.

3. Gruppen/Rollen werden nicht korrekt in die Vorlage bernommen
Fr mich geh”rt zu einer Vorlage auch, dass Vorbereitungen fr die Berechtigungen gemacht werden k”nnen, also SharePoint-Gruppen angelegt und diese Gruppen in Listen und Bibliotheken verwendet werden k”nnen, sodass die Zugriffe entsprechend eingestellt werden k”nnen. Nicht immer drfen die Teilnehmer einer Site wirklich in allen Listen und Bibliotheken schreiben. Jetzt zun„chst die gute Nachricht: wird fr eine Vorlage eine Rolle/Gruppe angelegt, dann steht diese Gruppe auch nach der Anwendung der Vorlage zur Verfgung. Die schlechte Nachricht: wurde eine Bibliothek oder Liste mit eigenen Berechtigungen konfiguriert, dann wird nach dem Anwenden der Vorlage wieder die Vererbung in Kraft gesetzt. D.h., die in der Vorlage eingestellten Berechtigungen in der Liste oder Bibliothek gehen verloren. Auch hier wrde ich gern von einem "Fehler" sprechen, aber mit den richtigen Argumenten wrde ich mich ja vielleicht auch berzeugen lassen, dass es sich eher um ein "Feature" handelt.

Insgesamt wurden meine Hoffnungen, mit Websitevorlagen recht gut Grundstrukturen zu schaffen, drastisch ged„mpft. Vielleicht habe ich ja die Latte auch einfach nur zu hoch geh„ngt, aber „rgern tue ich mich trotzdem.

Zum Thema PDF-Suche und SharePoint v3.0 gibt es inzwischen reichlich Beitr„ge im Web. Nachdem sich Microsoft mit dem Artikel 927675 (http://support.microsoft.com/kb/927675/en-us) ebenfalls mit einem Betrag gemeldet hat, sollte das Thema eigentlich reichhaltig behandelt sein.

Um die Einstellungen aus dem Microsoft-Artikel vornehmen zu k”nnen haben wir ein Tool erstellt, dass bei der Konfiguration helfen soll. Dieses Tool, samt kurzer Beschreibung liegt hier zum download.

For all international readers:

Searching in PDF-files in SharePoint Services v3.0 needs some editing in the registry as Microsoft has shown in article 927675 in the knowledge base. To check (and set) the settings for crawling PDF-files, we have made a small tool. This tool is free, you can download it here.

Um Daten von einem SharePoint-Web in ein anderes SharePoint-Web zu transportieren, habe ich ein kleines Tool erstellt, mit dem der Inhalt einer Liste oder Bibliothek in eine XML-Datei exportiert werden kann. Hierbei werden alle Attribute eines Listeneintrags mitgenommen, auch wenn sie auf readonly gesetzt sind.

Das gleiche Tool bietet mir die M”glichkeit, die Daten wieder zu importieren, wobei auch eine Mapping-Tabelle angegeben werden kann, wenn Feldnamen ge„ndert wurden. Die Performance ist zwar nicht berauschend, aber man kann ja nicht alles haben. Mit diesem Tool haben wir unsere SharePoint-Installation von v2.0 nach v3.0 umgestellt.

Eines ist bei einem solchen Import sehr unsch”n: die Information, wann ein Eintrag erstellt wurde, und durch wen er erstellt wurde wird von SharePoint automatisch gefllt. Die Felder sind readonly, und auch wenn das readonly-Attribut an den betreffenden Feldern umgestellt wird, schreibt SharePoint gnadenlos seine Informationen in die Felder. Damit kann ich zwar sch”n sehen wann ich importiert habe, aber als Ersteller ist jetzt auch immer der Administrator eingetragen. Wenn die Entstehung der Daten zurckverfolgt werden soll, dann ist diese Arbeitsweise sehr st”rend.

Ich werde noch ein wenig darber nachdenken, aber ich glaube im Moment, dafr gibt es keine vernnftige L”sung (auáer direkt in die Datenbank zu schreiben, was ich eigentlich vermeiden will).

Einer unserer Entwickler hat in den letzten Tagen ein wenig schlechte Laune bekommen, weil die Festplatte in seinem Virtual PC Image (wir entwickeln in diesen Images, weil dann leichter zwischen verschiedenen Umgebungen umgeschaltet werden kann) voll wurde, und er noch nicht einmal mehr die Sicherheits-Patches von Microsoft installieren konnte. Er ist gerade dabei unsere Anwendung von SharePoint v2 auf SharePoint v3 umzustellen, und arbeitet dafr mit der Beta 2 bzw. dem B2TR.

Irgendwie konnte ich mir nicht vorstellen, dass die Festplatte so schnell voll wird, zumal eine Installation von Office 2007 B2TR, Sharepoint Designer 2007 B2TR und Windows SharePoint Services 2007 B2TR inkl. Windows Server 2003, SQL Server 2005 und Visual Studio 2005 ca. 11 GB belegt. Also haben wir uns die Verzeichnisse in seinem Virtual PC mal genauer angesehen, und siehe da, in "%CommonProgramFiles%Microsoft Sharedweb server extensions12LOGS" waren ca. 4 GB Log-Dateien enthalten. Fr diese Datenmenge hat es nur wenige Tage gebraucht.

Ich habe noch keinen Schalter gefunden, mit dem die Log-Dateien komplett abgeschaltet werden k”nnen, aber ber die "SharePoint 3.0-Zentraladministration" kann unter Vorg„nge > Protokollierung und Berichterstellung > Diagnoseprotokollierung im Abschnitt "Ablaufverfolgungsprotokoll" die Anzahl der Protokolldateien und auch die Anzahl der Minuten je Protokolldatei eingestellt werden. Werden diese Werte recht klein gew„hlt, werden zwar immer noch Log-Dateien angelegt und gefllt, aber die Datenmenge wird deutlich reduziert.

Ich wnsche mir, dass Microsoft dies in der RTM von Hause aus reduziert, sodass nicht bei jeder Installation diese Log-Einstellungen ge„ndert werden mssen.

Ich will mich hier zwar berwiegend mit der Administration von SharePoint auseinandersetzen, aber man muss auch ber den Tellerrand schauen. In diesem Zusammenhang stolpert man unweigerlich ber die "Code Access Security" (CAS), die fr Webparts wichtig ist, die irgendwie auf Resourcen (z.B. das Active Directory) zugreifen wollen. Mit SharePoint v2 bricht man sich so ziemlich die Finger, auch wenn es recht gute Artikel und Blogs dazu gibt. Mit SharePoint v3 soll jetzt alles besser werden, und Maurice Prather hat hierzu einen wirklich guten Artikel verfasst. Das sch”ne an diesem neuen Feature in SharePoint v3: jetzt kann der Entwickler sein Webpart (seine Solution) verpacken, und muss sich um die korrekten Einstellungen kmmern. Wir Admins brauchen es nur noch zu installieren . Nichts mehr mit web.config editieren, oder gar den Trust Level auf Full setzen.

Mitch Milam hat einen interessanten Artikel verfasst, der sich mit der Problematik besch„ftigt, dass beim Zugriff via STSADM eine Fehlermeldung erscheint, dass auf die Konfigurationsdatenbank nicht zugegriffen werden kann.

Grob zusammengefasst: der Benutzer, der mit STSADM arbeitet braucht Zugriffsrechte auf den SQL Server auf dem die Datenbank(en) liegt.

Wer sich bei Microsoft die Windows SharePoint Services (WSS) herunterl„dt, erh„lt fr die Datenhaltung eine Microsoft Data Engine (MSDE) mitgeliefert, eigentlich ein vollwertiger SQL Server 2000, der aber zumindest um seine grafischen Administrationswerkzeuge beraubt wurde. In der gleichen Situation ist der Administrator eines Windows 2003 Small Business Server.

Wie mache ich jetzt am geschicktesten ein Backup von den SQL-Datenbanken? šber STSADM regelm„áig eine Sicherung einer Site zu machen, ist sicherlich eine Option (ich werde mich dazu demn„chst noch „uáern), aber sp„testens, wenn es mehrere Sites gibt, und vor allem nicht kontrolliert werden kann, wie und wann neue Sites angelegt werden, wird es mit einer Sicherung via STSADM schwierig.

Eine (aus Administrator-Sicht vernnftige) Variante ist die Sicherung der SQL-Datenbanken. Da mit der MSDE wenigstens das Administrationswerkzeug OSQL mitgeliefert wird, sind wir immerhin in der Lage, den SQL Server mit Befehlen zu fttern. Da bietet es sich doch an, eine Batchdatei anzufertigen, die regelm„áig eine Sicherung einer SQL-Datenbank anfertigt. Ein Batch zum Sichern kann so aussehen:

@ECHO OFF

REM ***********************************************************************************
REM
REM DBBACKUP
REM ========
REM
REM written by SPO/odi, 07/2006
REM
REM Backup the database or the transaction log of a SQL Server database using OSQL.
REM Runs also with MSDE and WMSDE.
REM
REM ***********************************************************************************

ECHO.
ECHO DBBACKUP
ECHO ——–
ECHO.
ECHO by SPO/odi, 07/2006
ECHO.

IF "%1"=="" GOTO SYNTAX
IF "%2"=="" GOTO SYNTAX
IF "%3"=="" GOTO SYNTAX
IF "%4"=="" GOTO SYNTAX

IF /I "%1"=="DB" GOTO BACKUP_DB
IF /I "%1"=="TRANS" GOTO BACKUP_TRANS

GOTO SYNTAX

:BACKUP_DB

SET DATABASE=%2
SET BACKUPPATH=%3
SET SERVER=%4

SET BACKUPFILE=%BACKUPPATH%\%DATABASE%.bak

SET BACKUPFILE=%BACKUPFILE:[=%
SET BACKUPFILE=%BACKUPFILE:]=%

IF "%SERVER%"=="" GOTO BACKUP_DB_NO_INSTANCE

OSQL -E -S %SERVER% -Q "Backup Database %DATABASE% to disk='%BACKUPFILE%' with init"

GOTO ENDE

:BACKUP_DB_NO_INSTANCE

OSQL -E -Q "Backup Database %DATABASE% to disk='%BACKUPFILE%' with init"

GOTO ENDE

:BACKUP_TRANS

SET DATABASE=%2
SET BACKUPPATH=%3
SET SERVER=%4

SET BACKUPFILE=%BACKUPPATH%\%DATABASE%.trn

SET BACKUPFILE=%BACKUPFILE:[=%
SET BACKUPFILE=%BACKUPFILE:]=%

IF "%SERVER%"=="" GOTO BACKUP_TRANS_NO_INSTANCE

OSQL -E -S %SERVER% -Q "Backup Transaction %DATABASE% to disk='%BACKUPFILE%' with init"

GOTO ENDE

:BACKUP_TRANS_NO_INSTANCE

OSQL -E -Q "Backup Transaction %DATABASE% to disk='%BACKUPFILE%' with init"

GOTO ENDE

:SYNTAX

ECHO Syntax:
ECHO.
ECHO DBBACKUP DB database backuppath servername : backup the database
ECHO.
ECHO DBBACKUP TRANS database backuppath servername : backup the transaction log
ECHO.
ECHO Example:
ECHO   DBBACKUP DB master c:ackup myserversharepoint
ECHO.
ECHO   Will backup the database 'master' from the SQL Server at 'myserversharepoint'
ECHO   to the directory 'c:ackup'.
ECHO.
ECHO If the databasename contains special characters like '-', use brackets around the
ECHO databasename ([my-db]).
ECHO.
:ENDE

SET DATABASE=
SET BACKUPPATH=
SET BACKUPFILE=
SET SERVER=

Die Wiederherstellung muss natrlich genauso funktionieren. Eine Batchdatei fr die Wiederherstellung so gesicherter Datenbanken, kann wie folgt aussehen:

@ECHO OFF

REM ***********************************************************************************
REM
REM DBRESTORE
REM =========
REM
REM written by SPO/odi, 07/2006
REM
REM Backup the database or the transaction log of a SQL Server database using OSQL.
REM Runs also with MSDE and WMSDE.
REM
REM ***********************************************************************************

ECHO.
ECHO DBRESTORE
ECHO ———
ECHO.
ECHO by SPO/odi, 07/2006
ECHO.

IF "%1"=="" GOTO SYNTAX
IF "%2"=="" GOTO SYNTAX
IF "%2"=="" GOTO SYNTAX

SET DATABASE=%1
SET RESTOREPATH=%2
SET SERVER=%3

IF "%SERVER%"=="" SET SERVER=COMPUTERNAME

SET RESTOREFILE_DB=%RESTOREPATH%\%DATABASE%.bak
SET RESTOREFILE_TRN=%RESTOREPATH%\%DATABASE%.trn

SET RESTOREFILE_DB=%RESTOREFILE_DB:[=%
SET RESTOREFILE_DB=%RESTOREFILE_DB:]=%

SET RESTOREFILE_TRN=%RESTOREFILE_TRN:[=%
SET RESTOREFILE_TRN=%RESTOREFILE_TRN:]=%

IF EXIST %RESTOREFILE_TRN% GOTO RESTORE_WITH_TRN

ECHO Restore database %DATABASE% …
ECHO.

OSQL -E -S %SERVER% -Q "Restore Database %DATABASE% from disk='%RESTOREFILE_DB%' with recovery"

GOTO ENDE

:RESTORE_WITH_TRN

ECHO Restore database and transaction log for %DATABASE% …
ECHO.

OSQL -E -S %SERVER% -Q "Restore Database %DATABASE% from disk='%RESTOREFILE_DB%' with norecovery"
OSQL -E -S %SERVER% -Q "Restore Log %DATABASE% from disk='%RESTOREFILE_TRN%' with recovery"

GOTO ENDE

:SYNTAX

ECHO The script will look into the backuppath. If only a file named {database}.bak
ECHO is found, just the database will be restored. If also a file named
ECHO {database}.trn is found, the database and the transaction log are restored.
ECHO.
ECHO Syntax:
ECHO.
ECHO DBRESTORE database backuppath servername : restore the database
ECHO.
ECHO.
ECHO Example:
ECHO   DBRESTORE master c:ackup myserversharepoint
ECHO.
ECHO   Will restorethe database 'master' on the SQL Server at 'myserversharepoint'
ECHO   from directory 'c:ackup'.
ECHO.
ECHO If the databasename contains special characters like '-', use brackets around the
ECHO databasename ([my-db]).
ECHO.

:ENDE

SET DATABASE=
SET RESTOREPATH=
SET RESTOREFILE_DB=
SET RESTOREFILE_TRN=

Mit Hilfe der Geplanten Tasks der Systemsteuerung kann so ein regelm„áiges Backup der Datenbank angelegt werden. Wenn z.B. auf einem Windows 2003 Small Business Server mit diesen Hilfsmitteln die SharePoint-Datenbank gesichert wird, dann kann die Sicherungsdatei mit dem normalen Datei-Backup auf ein Band geschrieben werden.