Gewusst wie: Anpassen der Willkommensseite

Letzte Änderung: Montag, 19. April 2010

Gilt für: SharePoint Server 2010

Inhalt dieses Artikels
Bearbeiten einer Willkommensseite mit dem webbasierten SharePoint-Editor
Anpassen von Seitenabfragezeichenfolgen zum Filtern von Willkommmensseiteninhalt basierend auf Metadatenwerten
Angeben eines neuen Formulars für einen Dokumentenmappen-Inhaltstyp

Dokumentenmappen weisen eine anpassbare Webpartseite auf, die Seite Willkommen. Auf dieser Seite werden standardmäßig ein Bild, die Eigenschaften der angegebenen Dokumentenmappe sowie der Inhalt der Dokumentenmappe angezeigt. In diesem Thema werden Anpassungen vorgestellt, die Sie an der Seite Willkommen auf der Website- und der Listenebene vornehmen können.

Wenn Sie Änderungen auf der Websiteebene vornehmen möchten, wählen Sie die Option Die Willkommenseite von Dokumentenmappen aktualisieren, die von diesem Inhaltstyp erben in der Benutzeroberfläche aus. Speichern Sie die Einstellungen der Dokumentenmappe, um die Seite Willkommen in Ihrer Dokumentbibliothek zu aktualisieren.

Vorsicht
Änderungen, die durch Anpassen der Seite Willkommen auf der Listenebene vorgenommen werden, werden auf der Seite automatisch für alle Instanzen dieses Inhaltstyps aktualisiert.

Änderungen an Willkommensseiten werden standardmäßig nicht mittels Push an untergeordnete Inhaltstypen übertragen. Dadurch wird verhindert, dass Benutzer Anpassungen an einer Willkommensseite auf untergeordneten Seiten versehentlich überschreiben. Es wird empfohlen, Änderungen an Willkommensseiten nur auf der niedrigsten erforderlichen Ebene vorzunehmen oder indem Sie die Inhaltstypen als schreibgeschützt festlegen. Angenommen, Sie erstellen den Dokumentenmappen-Inhaltstyp "Pitch Book" und passen die Willkommensseite an. Wenn Sie dann die Willkommensseite des grundlegenden Dokumentenmappen-Inhaltstyps anpassen und diese Änderung mittels Push übertragen, wird die angepasste Seite "Pitch Book" mit der Seite des übergeordneten Dokumentenmappen-Inhaltstyps überschrieben. Aktivieren Sie das Kontrollkästchen Die Willkommenseite von Dokumentenmappen aktualisieren, die von diesem Inhaltstyp erben, um Änderungen an der Willkommensseite mittels Push an alle untergeordneten Seiten zu übertragen.

Dokumentenmappen weisen eine Seite pro Inhaltstyp auf. Deshalb gelten Änderungen an der Willkommensseite für einen Dokumentenmappen-Inhaltstyp für alle Instanzen dieses Inhaltstyps. Verwenden Sie Webparts, um Daten basierend auf dem Kontext dynamisch abzurufen. Beispielsweise wird durch Hinzufügen eines Pinnwand-Webparts der Kontext der Dokumentenmappe verwendet, sodass für jede Pitch Book-Instanz unterschiedliche Notizen angezeigt werden.

Zum Anpassen der Willkommensseite können Sie drei Methoden verwenden:

1. Verwenden Sie den webbasierten SharePoint-Seiten-Editor, indem Sie auf der Seite Einstellungen der Dokumentenmappe auf den Link Homepage anpassen klicken.

2. Verwenden Sie SharePoint Designer. Sie benötigen die erforderlichen Berechtigungen für den Zugriff auf das Websiteobjekt All Files. Öffnen Sie SharePoint Designer, navigieren Sie zu der Dokumentbibliothek, in der die Dokumentenmappe gespeichert ist, navigieren Sie zum Ordner Forms, navigieren Sie zu dem Ordner für Ihren Dokumentenmappen-Inhaltstyp, und öffnen Sie dann docsethomepage.aspx.

3. Verwenden Sie das Dokumentenmappen-Objektmodell zum Implementieren einer kompletten benutzerdefinierten Seite. APIs zum Anpassen der Willkommensseite finden Sie im Microsoft.Office.DocumentManagement.DocumentSets-Namespace.

Bearbeiten einer Willkommensseite mit dem webbasierten SharePoint-Editor

Wechseln Sie zu einen benutzerdefinierten Inhaltstyp Dokumentenmappe, den Sie im Websiteinhaltstyp-Katalog erstellt haben, klicken Sie auf Einstellungen für Dokumentenmappe, und klicken Sie dann auf den Link zum Anpassen der Willkommensseite. Es wird eine Seite angezeigt, die wie die Dokumentenmappe aussieht. Klicken Sie im Menüband auf der Registerkarte Seite auf Seite bearbeiten, um die Seite zu bearbeiten.

Webparts können in vier Zonen hinzugefügt werden. Legen Sie für das Webpart ein anderes Bild fest. Fügen Sie am unteren Rand des Patches ein Pinnwand-Webpart hinzu, damit Benutzer Kommentare hinterlassen können. Um diese Änderungen vorzunehmen, klicken Sie auf Webpart hinzufügen in Zone 4, und wählen Sie dann Pinnwand in der Kategorie für das Webpart für die Zusammenarbeit im sozialen Netzwerk aus.

Wenn Sie alle Bearbeitungen vorgenommen haben, können Sie die Änderungen speichern. Klicken Sie im Menüband auf der Registerkarte Seite auf Bearbeitung beenden. Da die Willkommensseite auf der Websiteebene bearbeitet wurde, kehren Sie zur Seite Einstellungen für Dokumentenmappe zurück, aktivieren Sie das Kontrollkästchen zum Übertragen der Änderungen an der Willkommensseite mittels Push, und speichern Sie die Einstellungen für die Dokumentenmappe. Navigieren Sie nun zu einer Dokumentenmappe. Sie werden feststellen, dass die Webseite für alle Dokumentenmappen angepasst wurde.

Anpassen von Seitenabfragezeichenfolgen zum Filtern von Willkommmensseiteninhalt basierend auf Metadatenwerten

Auf Willkommensseiten der Dokumentenmappe wird Inhalt basierend auf dem Inhalt der aktuellen Dokumentenmappe dynamisch geladen. Dies bedeutet, dass sich bestimmte Webparts, wie z. B. das Webpart für Inhaltsabfragen (Content By Query Web Part, CQWP), nicht wie erwartet verhalten. Wenn Sie ein CQWP konfigurieren, ist es für jede Dokumentenmappe statisch, und es ist nicht möglich, Ergebnisse basierend auf der Dokumentenmappe im Kontext dynamisch abzurufen. Sie können CQWP so einrichten, dass basierend auf einem Metadatenwert der Seite gefiltert wird. Da es aber nur eine einzige Willkommensseite für einen Dokumentenmappen-Inhaltstyp gibt, ist dies für die Willkommensseite der Dokumentenmappen nicht möglich. Die praktikabelste Lösung ist die Verwendung einer Seitenabfragezeichenfolge. Von Dokumentenmappen wird jedoch standardmäßig nicht die gewünschte Seitenabfragezeichenfolge bereitgestellt, weshalb diese angepasst werden muss.

Zum Implementieren einer Lösung basierend auf einer angepassten Seitenabfragezeichenfolge erstellen Sie ein Webpart, das auf die Willkommensseite der Dokumentenmappe umleitet und eine Abfragezeichenfolge mit dem Metadatenwert enthält, den Sie im CQWP verwenden möchten. Dazu erstellen Sie ein Webpart, das Sie auf der Willkommensseite der Dokumentenmappe platzieren können. Fügen Sie in der ASCX-Datei für das Webpart den folgenden Code ein:

if (!String.IsNullOrEmpty(Request.QueryString["Column"]))
{
 
}
else
{
   string thisPage = Request.Url.AbsoluteUri; 
   integer docSetId = Request.QueryString["ID"];
    DocumentSet myItem = Microsoft.Office.DocumentManagement.DocumentSets.DocumentSet.GetDocumentSet(templates.Items[docSetId].Folder); 
    thisPage+="&Column=";
    thisPage+=myItem["Column"].ToString();
    Response.Redirect(thisPage);  
}

Mit der If-Anweisung wird überprüft, ob die Abfragezeichenfolge für Column übergeben wurde. Ist dies der Fall, sind keine weiteren Schritte erforderlich. Andernfalls sollte auf die Willkommensseite der Dokumentenmappe umgeleitet werden, die die Abfragezeichenfolge enthält. Nun können Sie ein CQWP hinzufügen, um die Seitenabfragezeichenfolge, die Sie übergeben, zu verwenden. Wählen Sie im Abschnitt für zusätzliche Filter des CQWP Ihre Spalte aus, und geben Sie [PageQueryString: Column Name] für Benutzerdefinierter Wert oder benutzerdefinierte Abfrage ein. Damit verfügen Sie über ein CQWP, mit dem basierend auf Metadateneigenschaften gefiltert werden kann, die als Abfragezeichenfolgen übergeben werden, ohne dass ein benutzerdefiniertes Webpart zum Abfragen des entsprechenden Inhalts erstellt werden muss.

Angeben eines neuen Formulars für einen Dokumentenmappen-Inhaltstyp

Das Formular, mit dem neue Dokumentenmappen erstellt werden, befindet sich im Ordner _layouts auf dem SharePoint-Server. Es gibt nur ein einziges Formular für alle Dokumentenmappen-Inhaltstypen. Es kann vorkommen, dass ein benutzerdefiniertes Formular benötigt wird. Mit einem benutzerdefinierten Formular können Metadaten automatisch eingegeben oder zusätzliche Formatierungen hinzugefügt werden, sodass in Abhängigkeit von den Optionen, die ein Benutzer auswählt, nur die angegebenen Felder angezeigt werden.

Der Dokumentenmappen-Inhaltstyp enthält die Eigenschaft NewFormUrl. Wenn Sie diese Eigenschaft ändern, können Sie angeben, welches neue Formular für den Inhaltstyp verwendet wird. Durch Ändern dieser Eigenschaft können Sie ein benutzerdefiniertes neues Formular für jeden Dokumentenmappen-Inhaltstyp angeben. Bevor Sie diese Eigenschaft ändern, erstellen Sie eine neue ASPX-Seite, und speichern Sie sie im Ordner _layouts oder in einem untergeordneten Ordner von _layouts. Wenn Sie das Formular in einem Ordner speichern, fügen Sie die Datei web.config hinzu, die die Dokumentenmappenassembly enthält, die zum Erstellen einer Dokumentenmappe mithilfe des Dokumentenmappen-Objektmodells erforderlich ist.

Das folgende Beispiel veranschaulicht eine benutzerdefinierte neue Dokumentenmappenseite: zuerst die CodeBehind-Seite customdocumentset.aspx und dann die Codepage customdocumentset.cs.

<%@ Page Language="C#" AutoEventWireup="true"  CodeFile="CustomNewDocset.aspx.cs" Inherits="_Default" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title></title>
</head>
<body>
    <asp:Literal ID="litList" runat="server" />
    <asp:Literal ID="litCt" runat="server" />
</body>
</html>
 

using System;
using System.Collections.Generic;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using Microsoft.SharePoint;
 
public partial class _Default : System.Web.UI.Page 
{
    protected void Page_Load(object sender, EventArgs e)
    {
SPList list = SPContext.Current.List;
litList.Text = list.Title;
SPContentTypeId ctid = new SPContentTypeId(Request.QueryString.GetValues("ContentTypeId")[0]);
SPContentType ct = list.ContentTypes[ctid];
litCt.Text = ct.Name;
    }
}

Die Datei web.config ist die Konfigurationsdatei, die in dem Ordner gespeichert werden muss, der die benutzerdefinierte neue ASPX-Dokumentenmappenseite enthält. Die Datei web.config ist erforderlich, da andernfalls kein Zugriff auf das Dokumentenmappen-Objektmodell möglich ist. Fügen Sie ggf. Verweise auf andere Assemblys hinzu. Falls die benutzerdefinierte neue Dokumentenmappenseite im Stammverzeichnis des Ordners _layouts und nicht in einem anderen Ordner gespeichert ist, benötigen Sie die Datei web.config nicht.

<?xml version="1.0"?>
<!-- 
    Note: As an alternative to editing this file manually, you can use the 
    Web admin tool to configure settings for your application. Use
    the Website->ASP.NET Configuration option in Visual Studio.
    A full list of settings and comments can be found in 
    machine.config.comments, which is usually located in the 
    \Windows\Microsoft.Net\Framework\v2.x\Config directory.
-->
<configuration>
<system.web>
<!-- 
            Set compilation debug="true" to insert debugging 
            symbols into the compiled page. Because this 
            affects performance, set this value to true only 
            during development.
        -->
<compilation debug="false">
<assemblies>
<add assembly="Microsoft.Office.DocumentManagement, Version=14.0.0.0, Culture=neutral, PublicKeyToken=94DE0004B6E3FCC5"/>
</assemblies>
</compilation>
</system.web>
</configuration>

Die URL für den Dokumentenmappen-Inhaltstyp muss aktualisiert werden, um die benutzerdefinierte neue Dokumentenmappenseite verwenden zu können. Das nächste Beispiel ist ein Windows PowerShell-Skript, das verwendet werden kann. Übergeben Sie die URL zur Website, die den Dokumentenmappen-Inhaltstyp enthält, den Sie ändern möchten. Geben Sie die entsprechende Inhaltstyp-ID für das ctid-Element des Inhaltstyps an, den Sie ändern möchten. SharePoint Server aktualisiert die NewFormUrl-Eigenschaft, um die benutzerdefinierte neue Dokumentenmappenseite anstelle der Standardseite zu verwenden. Die Zeichenfolge $siteurl sollte die URL mit dem benutzerdefinierten Dokumentenmappen-Inhaltstyp sein. Die Zeichenfolge $ctid ist die Inhaltstyp-ID der Dokumentenmappe, die geändert wird. Die Einstellung $contentType.NewFormUrl ist der Speicherort in Bezug auf den Ordner _layouts, der das benutzerdefinierte neue Dokumentenmappenformular enthält.

$siteUrl = "http://mysite"
$ctid = "0x0120D520"
param($siteUrl)
$site = New-Object Microsoft.SharePoint.SPSite($siteUrl)
$web = $site.RootWeb; 
$contentTypeId = New-Object Microsoft.Sharepoint.SPContentTypeId($ctid)
$contentType = $web.ContentTypes[$contentTypeId]
$contentType.NewFormUrl = "_layouts/CustomNewDocset/CustomNewDocset.aspx"
$contentType.Update()
$web.Dispose()
$site.Dispose()

Nachdem Sie das Windows PowerShell-Skript ausgeführt haben, erstellt SharePoint Server eine neue benutzerdefinierte Dokumentenmappenseite und ändert den Wert der newFormUrl-Eigenschaft in die neue Seite. Wenn Sie die Dropdownliste Neues Dokument in einer Dokumentbibliothek verwenden, um eine neue Dokumentenmappe zu erstellen, wird die benutzerdefinierte Seite angezeigt.

Siehe auch

Aufgaben

Gewusst wie: Erstellen eines neuen Dokumentenmappenformulars

Referenz

DefaultDocumentCollection

WelcomePageFields

FieldLinks

Konzepte

Dokumentenmappen