Definieren des Projektportal-Plug-Ins für eine Prozessvorlage

Artikel
03/12/2013

Mit dem Portal-Plug-In können Sie die ursprünglichen Dokumentbibliotheken, die ursprüngliche Bibliotheksstruktur und die ursprünglichen Dokumente eines Teamprojektportals definieren.Sie können auch die Aufgaben zum Erstellen von Dashboards und Excel-Berichten einschließen, die zur Verwendung mit den Prozessvorlagen für Microsoft Solutions Framework (MSF) vorgesehen sind.

Wichtig
Die Aufgaben, die Sie im Plug-In für SharePoint-Produkte angeben, werden nur ausgeführt, wenn Sie beim Erstellen eines Teamprojekts eine SharePoint-Website erstellen.

In diesem Thema

Name und Speicherort des Portal-Plug-Ins
Aufgaben und Abhängigkeiten der Portalerstellung
Erstellen der Website und Angeben der Websitevorlage
Erstellen von Dokumentbibliotheken
Erstellen der Ordnerstruktur einer Dokumentbibliothek
Angeben von Dateien, die in Dokumentbibliotheken hochgeladen werden sollen
Aktivieren von Dashboardfunktionen

Name und Speicherort des Portal-Plug-Ins

In der folgenden Tabelle sind die Namen der Portal-Plug-In-Datei, des Ordners und des Plug-Ins für die MSF-Prozessvorlagen zusammengefasst.

Dateiname:	WssTasks.xml
Ordnername:	Windows SharePoint Services
Plug-In-Name:	Microsoft.ProjectCreationWizard.Portal

Hinweis
Sie können die Namen der XML-Datei und des Ordners, jedoch nicht den des Plug-Ins ändern.Visual Studio Team Foundation Server enthält keinen Mechanismus für die Bereitstellung clientseitiger Plug-Ins, Richtlinien oder anderer Änderungen.Wenn Sie diese Funktion bereitstellen möchten, verwenden Sie Ihr eigenes Verteilungs- und Installationsprogramm.

Zurück nach oben

Aufgaben und Abhängigkeiten der Portalerstellung

Geben Sie in der Portal-Plug-In-Datei eine oder mehrere Aufgaben mit den zugehörigen Abhängigkeiten an.Sie geben die folgenden Hauptaufgaben an:

Erstellen der Website mit einer angegebenen Websitevorlage
Erstellen von Dokumentbibliotheken
Erstellen von Ordnern und Hochladen von Dateien in die Dokumentbibliotheken
Aktivieren von Dashboardfunktionen

Ein Beispiel für eine Aufgabe, mit der ein einfaches Projektportal angegeben wird, finden Sie in der Datei WssTasks.xml in der Prozessvorlage für MSF for Agile Software Development.

Weitere Informationen zu Websiteanforderungen und zur Websiteverwaltung finden Sie unter SharePoint Products and Team Foundation Server

Zurück nach oben

Erstellen der Website und Angeben der Websitevorlage

Sie müssen eine Websitevorlage angeben, auf der das Projektportal basiert.Die Websitevorlage muss auch im SharePoint-Portal von Team Foundation Server verfügbar sein.Sitevorlagen sind nicht in der Prozessvorlage enthalten.

Geben Sie die Sitevorlage mithilfe des site-Elements an.

<site template="" language=""/>

In der folgenden Tabelle werden die Attribute für das site-Element beschrieben.

Attribut	Beschreibung
Vorlage	Gibt die zu verwendende Vorlage an.Sie müssen eine Vorlage angeben, die auf dem Server definiert ist, der SharePoint-Produkte für die zu erstellenden Teamprojekte hostet. Um die Funktionen zu verwenden, die mit der aktuellen Version der Prozessvorlagen für MSF verfügbar sind, geben Sie eine der folgenden Zeichenfolgen an: TFS2010 Agile Dashboard TFS2010 CMMI Dashboard
language	Gibt eine Gebietsschema-ID für die zu verwendende Sprachversion der Websitevorlage an.Die ID der englischen Version lautet 1033.

Vorlage

Gibt die zu verwendende Vorlage an.Sie müssen eine Vorlage angeben, die auf dem Server definiert ist, der SharePoint-Produkte für die zu erstellenden Teamprojekte hostet.

Um die Funktionen zu verwenden, die mit der aktuellen Version der Prozessvorlagen für MSF verfügbar sind, geben Sie eine der folgenden Zeichenfolgen an:

TFS2010 Agile Dashboard
TFS2010 CMMI Dashboard

language

Gibt eine Gebietsschema-ID für die zu verwendende Sprachversion der Websitevorlage an.Die ID der englischen Version lautet 1033.

Im folgenden Beispiel wird gezeigt, wie auf die englische Version der aktuellen Version der MSF Agile-Prozessvorlage verwiesen wird, die Dashboards unterstützt.

<tasks>
  <task id="SharePointPortal" name="Create Sharepoint Portal" plugin="Microsoft.ProjectCreationWizard.Portal" completionMessage="Project portal site created.">
    <dependencies />
    <taskXml>
        <Portal>
           <site template="TFS2010 Agile Dashboard" language="1033" />  
       . . . 
        </Portal>

Hinweis
Alle anderen im Portal-Plug-In definierten Aufgaben hängen von der Websiteerstellungsaufgabe ab, da das Projektportal erstellt sein muss, bevor Sie zusätzliche Dokumentbibliotheken erstellen oder Dateien kopieren können.

Leistung von Prozessvorlagen

Die in WssTasks.xml angegebenen Dateien werden als Teil der Prozessvorlage eingeschlossen, wenn diese hochgeladen wird.Von der Größe der Prozessvorlage hängt es ab, wie lange die Erstellung eines neuen Teamprojekts dauert.Bei umfangreicheren Prozessvorlagen dauert die Erstellung neuer Teamprojekte länger.Deshalb sollten Sie alternative Strategien zur Bereitstellung von Dateien erwägen, wenn sich die Leistung der Prozessvorlage vermindert.

Verwenden der Sitevorlage

Sie können Dateien als Teil der SharePoint-Websitevorlage verwenden.Dadurch werden die Dateien aus der Prozessvorlage in die Sitevorlage verschoben, was die Leistung bei der Erstellung neuer Teamprojekte optimiert.

Das Aufführen von Dateien in WssTasks.xml bietet jedoch einen Vorteil.Sie können Microsoft Project-Dateien und Microsoft Excel-Dateien mit dem bereits beschriebenen queryid-Attribut an eine Abfrage binden.Dies erleichtert Teammitgliedern das Öffnen der Dateien, da sie bereits mit dem richtigen Team Foundation Server und der richtigen Abfrage verbunden sind.

Verwenden einer alternativen Website

Wenn Sie über eine größere Sammlung von Dateien verfügen, die übergreifend in mehreren Teamprojekten verwendet werden, können Sie eine alternative Website zum Hosten der Dateien verwenden und im Projektportal oder auf Webseiten einen Link zu den Dateien herstellen.Durch diese Strategie wird auch die Leistung bei der Erstellung von Teamprojekten optimiert, da die Dateien nicht in das Projektportal kopiert werden müssen.Weitere Informationen finden Sie unter Share Process Guidance for a Team Project.

Zurück nach oben

Erstellen von Dokumentbibliotheken

Nachdem das Projektportal erstellt wurde, können Sie die zusätzlich zu erstellenden Dokumentbibliotheken angeben.Verwenden Sie zum Angeben einer Dokumentbibliothek das documentLibrary-Element.

<documentLibraries>
   <documentLibrary name="" description="" isProcessGuidance="true | false" />
</documentLibraries>

Hinweis
Die Versionsverwaltung für eine Dokumentbibliothek kann in der Prozessvorlage weder aktiviert noch deaktiviert werden.Sie können die Versionsverwaltung über die Windows SharePoint Services-Sitevorlage oder nach der Projekterstellung aktivieren bzw. deaktivieren.

In der folgenden Tabelle werden die Attribute für das documentLibrary-Element beschrieben.

Attribut	Beschreibung
name	Gibt den Namen der Dokumentbibliothek an, die im Projektportal angezeigt wird.
description	Stellt eine Beschreibung der Dokumentbibliothek bereit, die im Projektportal angezeigt wird.
isProcessGuidance	Gibt an, ob die Dokumentbibliothek verwendet wird, um Prozessleitfadeninhalt zu unterstützen.

Im folgenden Beispiel wird veranschaulicht, wie Sie eine Dokumentbibliothek mit dem Namen Development erstellen, die vom Entwicklungsteam zum Speichern von Dokumenten verwendet werden kann.

<documentLibraries>
. . .
   <documentLibrary name="Process Guidance" description="How to make best use of the Team Foundation Server tools and process" isProcessGuidance="true" />
. . .
</documentLibraries>

Zurück nach oben

Erstellen der Ordnerstruktur einer Dokumentbibliothek

Nachdem das Projektportal erstellt wurde, können Sie zusätzliche Ordner angeben, die erstellt werden sollen.Sie können auch Dateien angeben, die kopiert werden sollen, z. B. Vorlagendateien.

Verwenden Sie das folder-Element, um einen neuen Ordner zu erstellen.

<folders>
   <folder documentLibrary="" name=""/>
</folders>

In der folgenden Tabelle werden die Attribute für das folder-Element beschrieben.

Attribut	Beschreibung
documentLibrary	Gibt die Dokumentbibliothek an, in der der Ordner erstellt werden soll.
name	Gibt den Namen des Ordners an.

Im folgenden Beispiel wird veranschaulicht, wie ein Ordner mit dem Namen Trip Reports in der Dokumentbibliothek Development erstellt wird, in der Entwickler Reiseprotokolle von Konferenzen oder Kundenbesuchen speichern können.

<folders>
   <folder documentLibrary="Development"
           name="Trip Reports"/>
</folders>

Zurück nach oben

Angeben von Dateien, die in Dokumentbibliotheken hochgeladen werden sollen

Darüber hinaus müssen Dateien in Dokumentbibliotheken und Ordner kopiert werden.Die Quelldateien befinden sich unter dem Ordner Windows SharePoint Services.Sie müssen ein Ziel im Projektportal angeben.

<files>
   <file source="" documentLibrary="" target="" queryId="" /> 
</files>

In der folgenden Tabelle werden die Attribute für das file-Element beschrieben.

Attribut	Beschreibung
source	Ein relativer Pfad zur lokalen Kopie der Datei.Im Allgemeinen beginnt der Quellpfadname immer mit Windows SharePoint Services. Dies ist der Name des Ordners, in dem das Portal-Plug-In definiert ist.
documentLibrary	Der Name der Dokumentbibliothek, in die die Datei kopiert wird.
Ziel	Ein relativer Pfad zum Ziel im Projektportal, in das die Datei kopiert wird.
queryId	Gibt den Namen einer Arbeitsaufgabenabfrage an, die an die Datei gebunden ist.Wenn die Datei erstmalig geöffnet wird, wird sie mit den Ergebnissen aus der Abfrage gefüllt.Dieses Attribut ist optional, und die angegebene Abfrage muss in der Datei workitems.xml vorhanden sein. Hinweis queryId gilt nur für XLS-Dateien.

Im folgenden Beispiel wird veranschaulicht, wie eine Vorlagendatei mit dem Namen Project Checklist in den Ordner Project Management kopiert wird.In diesem Beispiel wird auch festgelegt, dass die Datei, wenn sie zuerst geöffnet ist, mit den Ergebnissen aus der Arbeitsaufgabenabfrage Project Checklist gefüllt werden soll.

<files>
   <file source="Windows SharePoint Services\Templates\Project Checklist.xls" 
      documentLibrary="Project Management" 
      target="Project Checklist.xls" 
      queryId="Project Checklist" />
</files>

Hinweis
Sie können Ordner und Dateien als Teil der Sitevorlage aufnehmen, ohne sie im XML-Code aufzulisten.

Hinweis
Wenn Sie EXE-Dateien angeben und die SharePoint-Website keine EXE-Dateien unterstützt, können Sie mit der Prozessvorlage keine Teamprojekte erstellen.

Prozessleitfaden-Inhalt und Unterstützungsdateien

Bei einem Prozessleitfaden handelt es sich um Inhalte, die die bei der Arbeit an einem Softwareprojekt von Teammitgliedern zu befolgenden Prozesse dokumentieren.Arbeitsaufgaben, Berichte und Abfragen können sich während des Lebenszyklus eines Teamprojekts ändern und sich von Teamprojekt zu Teamprojekt unterscheiden.Prozessleitfadeninhalt stellt Details zu einem Teamprojekt bereit, z. B. Informationen zum Ausfüllen von Arbeitsaufgabenfeldern, Bespiele für fehlerfreie und fehlerhafte Berichte oder Beschreibungen der Abfragen.Außerdem enthält ein Prozessleitfaden Details über den Prozess, der bei einem Teamprojekt befolgt werden muss, z. B. zu übernehmende Rollen und durchzuführende Aktivitäten.

Wählen Sie in der MSDN Library können Sie auf den Inhalt des Prozessleitfadens für die meisten Artefakte zugreifen, die von jeder der Standardprozessvorlagen definiert werden, die Team Foundation Server bereitstellt.Sie können den Inhalt durchsuchen, der auf MSDN aus einem der folgenden Themen verfügbar ist: Visual Studio Scrum 2.0, MSF for Agile 6.0 und MSF for CMMI 6.0.

Um den Zugriff auf den Prozessleitfaden von den Arbeitsaufgabenformularen in Team Explorer zu unterstützen, wird eine Reihe von .htm- Dateien auf den Prozessleitfadenordner innerhalb der Dokumenten-SharePoint-Bibliothek hochgeladen.Diese Dateien geben URLs für den MSDN-Inhalt an, der geöffnet wird, wenn ein Teammitglied das Prozessleitfadensymbol Prozessleitfaden für Arbeitsaufgabe öffnen innerhalb eines Arbeitsaufgabenformulars auswählt.Diese Dateien werden auf Grundlage der file Aufgaben hochgeladen, die innerhalb des Portal-Plug-Ins definiert werden.Beispielsweise definiert die agile Prozessvorlage file die folgenden Aufgaben:

<!-- Process Guidance -->
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="ProcessGuidance.html" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="ProcessGuidance.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\AboutWorkItems.htm" documentLibrary="Process Guidance" target="Supporting Files/AboutWorkItems.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\AboutWorkItems.htm" documentLibrary="Process Guidance" target="Supporting Files/AboutWorkItems.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Bug.htm" documentLibrary="Process Guidance" target="Supporting Files/Bug.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Bug.htm" documentLibrary="Process Guidance" target="Supporting Files/Bug.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Issue.htm" documentLibrary="Process Guidance" target="Supporting Files/Issue.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Issue.htm" documentLibrary="Process Guidance" target="Supporting Files/Issue.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="Supporting Files/ProcessGuidance.htm" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="Supporting Files/ProcessGuidance.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\SharedSteps.htm" documentLibrary="Process Guidance" target="Supporting Files/Shared Steps.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\SharedSteps.htm" documentLibrary="Process Guidance" target="Supporting Files/Shared Steps.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Task.htm" documentLibrary="Process Guidance" target="Supporting Files/Task.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Task.htm" documentLibrary="Process Guidance" target="Supporting Files/Task.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\TestCase.htm" documentLibrary="Process Guidance" target="Supporting Files/Test Case.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\TestCase.htm" documentLibrary="Process Guidance" target="Supporting Files/Test Case.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\UserStory.htm" documentLibrary="Process Guidance" target="Supporting Files/User Story.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\UserStory.htm" documentLibrary="Process Guidance" target="Supporting Files/User Story.aspx" />

Sie können diese Dateien anpassen, damit sie auf andere Ressourcen für Prozessleitfäden verweisen.Sie können auch Dateien hinzufügen, um Zugriff auf andere Prozessleitfäden zu unterstützen, die Sie für das Team erstellt haben.Weitere Informationen finden Sie unter Konfigurieren eines Projektportals und Prozessleitfaden.

Zurück nach oben

Aktivieren von Dashboardfunktionen

Dashboards zeigen Projektdaten an, unterstützen Untersuchungen und helfen Teams, häufige Aufgaben schnell auszuführen.Auf Dashboards werden mehrere Excel-Berichte und Team Web Access-Webparts angezeigt.

Mit dem activateFeatures-Element verursachen Sie die Erstellung der Dashboards und Excel-Berichte.Sie müssen den folgenden Code in das Portal-Element der Portal-Plug-In-Datei einschließen, um die Erstellung der Dashboards und Excel-Berichte für ein Teamprojekt zu aktivieren.

So aktivieren Sie Dashboardfunktionen, die zur Verwendung mit der MSF-Prozessvorlage für agile Softwareentwicklung vorgesehen sind:

      <Portal>
    . . . 
        <activateFeatures>
          <!-- TfsDashboardAgileMoss -->
          <feature featureId="0D953EE4-B77D-485b-A43C-F5FBB9367207" />
          <!-- TfsDashboardAgileQuickLaunch -->
          <feature featureId="1D363A6D-D9BA-4498-AD1A-9874ACA5F827" />
        </activateFeatures>
    . . . 
      </Portal>

So aktivieren Sie Dashboardfunktionen, die zur Verwendung mit der MSF-Prozessvorlage für CMMI vorgesehen sind:

      <Portal>
    . . . 
<activateFeatures>
          <!-- TfsDashboardCmmiMoss -->
          <feature featureId="3D0BA288-BF8E-47F0-9680-7556EDEF6318" />
          <!-- TfsDashboardCmmiProcessDocLibraries -->
          <feature featureId="8610B95B-063F-4FB5-837C-BCF2FE9423C6" />
        </activateFeatures>
    . . . 
      </Portal>

Zurück nach oben