Freigeben über

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

  • Artikel

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 Team Foundation Server (TFS) vorgesehen sind.

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. Weitere Informationen zu Websiteanforderungen und zur Websiteverwaltung finden Sie unter Anforderungen von SharePoint-Produkten für Team Foundation Server.

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 TFS-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 Namen des Plug-Ins ändern.TFS enthält keinen Mechanismus für die Bereitstellung clientseitiger Plug-Ins, Richtlinien oder anderer Änderungen.Wenn Sie diese Art von Funktion bereitstellen möchten, verwenden Sie Ihr eigenes Verteilungs- und Installationsprogramm.

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 einer der Prozessvorlagen für TFS. Sie können die neuesten Prozessvorlagen von TFS herunterladen.

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

template

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 die folgende Zeichenfolge an: Team Foundation Server Project Portal.

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="Team Foundation Server Project Portal" 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 Konfigurieren oder Hinzufügen eines Projektportals.

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>

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>

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.

target

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.

Prozessleitfadeninhalt 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.

Über die MSDN Library haben Sie Zugriff auf den Prozessleitfadeninhalt zu den meisten Artefakten, die in den einzelnen von TFS bereitgestellten Standardprozessvorlagen definiert sind. Die MSDN-Inhalte können nach folgenden Themen durchsucht werden: Visual Studio Scrum, MSF for Agile und MSF for CMMI.

Um den Zugriff auf den Prozessleitfaden von Arbeitsaufgabenformularen in Team Explorer zu unterstützen, wird eine Reihe von HTM-Dateien in den Prozessleitfadenordner innerhalb der SharePoint-Dokumentbibliothek hochgeladen. Diese Dateien geben URLs für den MSDN-Inhalt an, der geöffnet wird, wenn ein Teammitglied in einem Arbeitsaufgabenformular auf das Symbol für den Prozessleitfaden Prozessleitfaden für Arbeitsaufgabe öffnen klickt. Diese Dateien werden auf Grundlage der file-Aufgaben hochgeladen, die im Portal-Plug-In definiert werden. Beispielsweise definiert die agile Prozessvorlage die folgenden file-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 oder Hinzufügen eines Projektportals.

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 Prozessvorlage für Visual Studio Scrum vorgesehen sind:

      <Portal>
    . . . 
<activateFeatures>
         <!-- TfsDashboardScrumWss -->
          <feature featureId="71EC0D67-21AB-4560-A825-9D976DA09D04" />
          <!-- TfsDashboardAgileQuickLaunch -->
          <feature featureId="1D363A6D-D9BA-4498-AD1A-9874ACA5F827" />
        </activateFeatures>
    . . . 
      </Portal>

So aktivieren Sie Dashboardfunktionen, die zur Verwendung mit der Prozessvorlage für die MSF 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 Prozessvorlage für MSF CMMI vorgesehen sind:

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

Siehe auch

Konzepte

Anpassen einer Prozessvorlage

Übersicht über Prozessvorlagendateien