Prozessvorlagen-Plug-In für Berichte
Aktualisiert: November 2007
Mit dem Plug-In für Berichte werden die anfänglichen Berichte eines Teamprojekts definiert. Der Name des Plug-Ins lautet Microsoft.ProjectCreationWizard.Reporting. Die XML-Datei für Berichte hat den Namen ReportsTasks.xml und befindet sich im Ordner Berichte in der Ordnerhierarchie der Prozessvorlage. Sie können die Namen der XML-Datei und des Ordners ggf. ändern.
Geben Sie in der XML-Datei eine oder mehrere Aufgaben mit den zugehörigen Abhängigkeiten an. Ein Beispiel für Aufgaben, mit denen einfache Berichte angegeben werden, finden Sie in der Datei ReportsTasks.xml in der Prozessvorlage für MSF for Agile Software Development.
.gif "Hinweis") Hinweis: |
|---|
Team Foundation Server enthält keinen Mechanismus für die Bereitstellung clientseitiger Plug-Ins, Richtlinien oder anderer Änderungen. Wenn Sie Plug-Ins, Richtlinien oder andere Änderungen für Team Explorer bereitstellen möchten, müssen Sie ein eigenes Verteilungs- und Installationsprogramm verwenden. |
Berichterstellungssite
Damit die Berichte ordnungsgemäß ausgeführt werden, müssen Sie eine Berichterstellungssite erstellen. Die Homepage des Projektportals enthält eine Verknüpfung zur Berichterstellungssite mit der Bezeichnung Berichte. Um die Berichterstellungssite zu erstellen, verwenden Sie das im folgenden Beispiel veranschaulichte site-Element.
<task
id="Site"
plugin="Microsoft.ProjectCreationWizard.Reporting"
completionMessage="Project Reporting site created.">
<dependencies/>
<taskXml>
<ReportingServices>
<site />
</ReportingServices>
</taskXml>
</task>
Ordner
Sie können Ordner auf der Berichterstellungssite mit dem folder-Element erstellen. Verwenden Sie das path-Attribut, um den relativen Pfadnamen des neuen Ordners anzugeben. Der Ordner wird auf der Projektsite und unter dem Ordner Berichte in Team Explorer angezeigt.
<folder path=""/>
Im folgenden Beispiel wird ein öffentlicher Ordner auf der Berichterstellungssite erstellt.
<task id="Populate Reports"
plugin="Microsoft.ProjectCreationWizard.Reporting"
completionMessage="Project site created.">
<dependencies>
<dependency taskId="Site"/>
</dependencies>
<taskXml>
<ReportingServices>
<folders>
<folder path="Public"/>
</folders>
</ReportingServices>
</taskXml>
</task>
Berichte
Berichte werden durch RDL-Dateien definiert. Um der Berichterstellungssite Berichte hinzuzufügen, kopieren Sie die RDL-Dateien des Berichts in einen Ordner unterhalb des Ordners Berichte in der Prozessvorlage. Verwenden Sie dann das report-Element, um die notwendigen Eigenschaften und die Datenquellen für den Bericht zu beschreiben.
<report name=""
filename=""
folder=""
cacheExpiration ="30">
In der folgenden Tabelle werden die Attribute für das report-Element beschrieben.
Attribut |
Beschreibung |
|---|---|
name |
Der Name des Berichts, der auf der Berichterstellungssite und in Team Explorer angezeigt werden soll. |
filename |
Ein relativer Pfad unter dem lokalen Ordner Berichte, über den die RDL-Berichtdatei abgerufen wird. |
folder |
Der Name eines relativen Pfads, unter dem der Bericht der Berichterstellungssite hinzugefügt werden soll. |
cacheExpiration |
Legt die Standarddauer zum Zwischenspeichern des Berichts in Minuten fest. |
Sie können Werte für Parameter in einem Bericht angeben. Dieses Verfahren wird häufig verwendet, um dem aktuellen Teamprojekt den Parameter Project zuzuordnen. Die meisten Berichte werden ohne Verweis auf das aktuelle Teamprojekt nicht ordnungsgemäß ausgeführt. Um dem aktuellen Teamprojekt den Parameter Project zuzuordnen, geben Sie den Wert als $$PROJECTNAME$$ an.
<parameters>
<parameter name="" value=""/>
</parameters>
In der folgenden Tabelle werden die Attribute für das property-Element beschrieben.
Attribut |
Beschreibung |
|---|---|
name |
Der Name des Parameters im zu bindenden Bericht. |
value |
Der Wert, an den der Parameter gebunden werden soll. |
Sie müssen jeden Datenquellennamen in jedem Bericht einer Team Foundation Server-Livedatenquelle zuordnen. Verwenden Sie das reference-Element, um eine Datenquelle anzugeben.
<datasources>
<reference name="" dsname=""/>
</datasources>
In der folgenden Tabelle werden die Attribute für das reference-Element beschrieben.
Attribut |
Beschreibung |
|---|---|
name |
Der Name der Datenquelle im Bericht. |
dsname |
Der Name der Team Foundation Server-Datenquelle. Dieser Wert lautet normalerweise TfsReportDS oder TfsOlapReportDS. |
Das folgende Beispiel veranschaulicht, wie der Bericht Work Items hinzugefügt wird. Der Parameter Project wird an das aktuelle Teamprojekt und der Bericht an die Datenquelle TfsReportDS gebunden.
<report name="Work Items"
filename="Reports\Work Items.rdl"
folder=""
cacheExpiration ="30">
<parameters>
<parameter name="Project" value="$$PROJECTNAME$$"/>
</parameters>
<datasources>
<reference name="/TfsOlapReportDS" dsname="TfsOlapReportDS"/>
<reference name="/TfsReportDS" dsname="TfsReportDS"/>
</datasources>
</report>
Siehe auch
Aufgaben
Gewusst wie: Überprüfen von Berichtänderungen
Konzepte
Vorlagen-Plug-In für Windows SharePoint Services
Prozessvorlagen-Plug-In für Versionskontrolle
Vorlagen-Plug-In für Gruppen und Berechtigungen