Hinzufügen und Ändern von Arbeitsaufgabenfeldern zum Unterstützen von Berichten

Mit Arbeitsaufgabenfeldern können Sie Daten für einen Arbeitsaufgabentyp verfolgen und die Filterkriterien für Abfragen definieren. Außerdem können sie in Berichten verwendet werden. Mit Ausnahme von Systemfeldern muss jedes Feld, das in einem Bericht angezeigt werden soll, in der Definitionsdatei für die Typen von Arbeitsaufgaben definiert werden, die vom jeweiligen Feld nachverfolgt werden. Systemfelder werden automatisch für jeden Arbeitsaufgabentyp definiert. Sie müssen jedoch im Arbeitsaufgabenformular enthalten sein, um die Dateneingabe zu unterstützen.

Zum Unterstützen von Berichten können Sie Felder hinzufügen oder die Attribute vorhandener Felder ändern. Wenn Sie Felder hinzufügen oder ändern, sollten Sie systematische Namenskonventionen übernehmen, um sicherzustellen, dass Daten in Ordnern des SQL Server Analysis Services-Cubes logisch gruppiert werden.

In diesem Thema

• Bewährte Methoden

• Verwenden eines vorhandenen Felds

• Auflisten der für eine Teamprojektsammlung definierten Felder

• Berichtsfähige Feldattribute

• Ändern von berichtsfähigen Attributen für ein Feld

• Hinzufügen von Feldern zum Unterstützen von Berichten

• Überprüfen der an berichtsfähigen Feldattributen vorgenommenen Änderungen

• Bewährte Methoden beim Zuweisen von Verweisnamen für Berichte

• Berichtsfähige Felder, die in MSF-Prozessvorlagen definiert sind

Bewährte Methoden

Beachten Sie die folgenden bewährten Methoden, bevor Sie ein Feld hinzufügen oder ändern:

• Stellen Sie fest, ob Sie ein Feld verwenden können, das bereits in der Teamprojektsammlung definiert ist, die das Teamprojekt enthält. Mit der Verwendung eines vorhandenen Felds wird eine projektübergreifende Berichterstellung unterstützt.

• Stellen Sie fest, ob Sie ein Feld verwenden können, das bereits in einer anderen Projektauflistung in der Bereitstellung von Visual Studio Team Foundation Server definiert ist. Mit der Verwendung eines vorhandenen Felds wird eine projektübergreifende Berichterstellung unterstützt.

• In jeder Projektauflistung können maximal 1.024 Felder enthalten sein, und in allen Projektauflistungen einer Bereitstellung von Team Foundation Server zusammen können insgesamt 1.024 eindeutige berichtsfähige Felder vorhanden sein. Zusammengeführte Felder zählen als ein berichtsfähiges Feld.

• Führen Sie eine Standardprozedur und einen Prüfvorgang ein, um Felder in Prozessvorlagen, Teamprojekten oder Projektauflistungen hinzuzufügen und zu ändern.

• Verwenden Sie beim Bezeichnen von Feldern für die Berichterstellung systematische Namenskonventionen. Wenn Sie Verweisnamen auf systematische Weise in allen Teamprojektsammlungen einer Bereitstellung von Team Foundation Server zuweisen, werden ein konsistenteres und praktischeres Warehouse und Cubeschema garantiert, und Schemakonflikte im Warehouse können vermieden werden. Weitere Informationen finden Sie unter Lösen von Schemakonflikten im Data Warehouse.

  Sie können einem Arbeitsaufgabenfeld bis zu vier Bezeichnungsattribute zuweisen:

  Tipp

  Feldern, die in den Prozessvorlagen für Microsoft Solutions Framework definiert sind, wird kein Berichtsname oder Berichtsverweisname zugewiesen. In der Standardeinstellung werden Verweisname und Namensattribute verwendet.

  • name. Der Anzeigename des Felds, der in den Dropdownmenüs von Arbeitsaufgabenabfragen angezeigt wird. Der Anzeigename muss über alle in einem Teamprojekt definierten Felder hinweg eindeutig sein. Der Anzeigename kann sich auch von der angezeigten Bezeichnung unterscheiden, die dem Feld im Arbeitsaufgabenformular zugewiesen wird. Weitere Informationen finden Sie unter XML-Elementreferenz für Control.

  • refname. Die eindeutige Bezeichnung, die dem Feld zugewiesen wird und die es von allen anderen in der Teamprojektsammlung definierten Feldern unterscheidet. Der refname zugewiesene Wert kann nicht geändert werden.

    Informationen zu Anforderungen und Einschränkungen bei Anzeigenamen und Verweisnamen für Felder finden Sie unter Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte.

  • reportingname. Optionales Attribut. Der Name, der zum Identifizieren eines Felds in Berichten verwendet wird. Wenn nicht explizit festgelegt, wird der dem name-Attribut zugewiesene Wert verwendet.

  • reportingrefname. Optionales Attribut. Die eindeutige Bezeichnung, die einem berichtsfähigen Feld zugewiesen wird und die es von allen anderen berichtsfähigen Feldern unterscheidet, die in allen Teamprojektsammlungen definiert sind. Wenn nicht explizit festgelegt, wird der dem refname-Attribut zugewiesene Wert verwendet. Empfohlene Namenskonventionen finden Sie unter Bewährte Methoden beim Zuweisen von Verweisnamen für Berichte weiter unten in diesem Thema.

    Tipp

    Die Verweisnamen für Berichte sind nur in einem PivotTable-Bericht oder im Analysis Services-Cube sichtbar.

Verwenden eines vorhandenen Felds

Sie sollten ein bereits definiertes Feld verwenden, wenn dieses Feld mit den Informationen übereinstimmt, die Sie in die Nachverfolgung und Berichterstellung einschließen möchten. Führen Sie die folgenden Schritte aus, um ein vorhandenes Feld zu verwenden:

• Identifizieren Sie das Feld, das Sie verwenden möchten. Verwenden Sie den Befehl witadmin listfields, um die Felder und zugehörigen Attribute zu ermitteln, die für alle Projektauflistungen definiert sind. Weitere Informationen finden Sie weiter unten in diesem Thema unter Auflisten der für eine Teamprojektsammlung definierten Felder.

• Ermitteln Sie, ob das Feld berichtsfähig ist und ob die reportable-Attribute Ihren Berichtsanforderungen entsprechen.

• Wenn das Feld nicht berichtsfähig ist, ändern Sie mit witadmin changefield das reportable-Attribut für die Projektauflistungen, in denen es verwendet wird. Weitere Informationen finden Sie unter Ändern von berichtsfähigen Attributen für ein Feld weiter unten in diesem Thema.

• Fügen Sie das Feld für die Projektauflistung, in der es nicht definiert ist, den XML-Definitionsdateien für die Arbeitsaufgabentypen hinzu, die Sie zum Nachverfolgen von Daten verwenden möchten. Weitere Informationen finden unter Hinzufügen von Feldern zum Unterstützen von Berichten weiter unten in diesem Thema.

Auflisten der für eine Teamprojektsammlung definierten Felder

Mit dem Befehl witadmin listfields können Sie Felder und ihre zugehörigen Attribute auflisten. Sie können ein bestimmtes Feld oder alle in einer Projektauflistung definierten Felder aufführen. Der Befehl witadmin listfields weist die folgende Syntax auf:

witadmin listfields /collection:CollectionURL /n:RefName 

Weitere Informationen finden Sie unter Aufführen von Arbeitsaufgabenfeldern und Anzeigen von Attributen, die Feldern zugewiesen sind.

Berichtsfähige Feldattribute

Berichtsfähige Felder verfügen über den reportable-Attributwert Detail, Dimension oder Measure. Die folgenden Attribute bestimmen, wie Arbeitsaufgabenfelder in die Data Warehouse-Datenbanken exportiert und verarbeitet werden:

• reportingtype. Um ein Feld in Berichte einzuschließen, muss dem reportable-Attribut einer der folgenden Werte zugewiesen werden:

  • Weisen Sie Detail zu, um das Feld in die relationale Warehouse-Datenbank, jedoch nicht in den Cube zu exportieren. Wie das folgende Beispiel zeigt, wird der Detail-Typ nur für Integer-, Double-, String- oder DateTime-Felder verwendet:

    <FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">
    

  • Weisen Sie Dimension zu, um das Feld in die relationale Warehouse-Datenbank und in den Cube zu exportieren. Wie das folgende Beispiel zeigt, wird Dimension nur für Integer-, Double-, String- oder DateTime-Felder verwendet. Dieser Wert ist hilfreich, um Felder einzuschließen, die zum Filtern von Berichten verwendet werden (z. B. Felder mit Listen gültiger Werte).

    <FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">
    

  • Weisen Sie Measure zu, um die Verarbeitung von vorausberechneten Werten im Cube zu unterstützen. Verwenden Sie den Measure-Typ nur für Integer- und Double-Felder.

    Wenn Sie Measure als reportingtype zuweisen, muss sum als formula zugewiesen werden, wie das folgende Beispiel zeigt:

    <FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">
    

• reportingrefname. Sie können einem Feld, das als berichtsfähig markiert ist, einen anderen Verweisnamen zuweisen. Wird kein Wert angegeben, wird der dem refname-Attribut zugewiesene Wert verwendet.

  Sie können dieses Attribut verwenden, um in Berichten enthaltene Felder zusammenzuführen oder zu trennen. Um zwei Felder zusammenzuführen, die über unterschiedliche Verweisnamen verfügen und in verschiedenen Projektauflistungen definiert sind, weisen Sie beiden den gleichen reportingrefname zu. Um zwei Felder zu trennen, die über den gleichen Verweisnamen verfügen, jedoch in verschiedenen Projektauflistungen definiert sind, weisen Sie jedem Feld einen anderen reportingrefname zu.

  Sie sollten Felder nach Möglichkeit immer zusammenführen, um die Anzahl von Feldern im Warehouse zu minimieren und die maximale Grenze von 1024 berichtsfähigen Feldern nicht zu überschreiten. Sie können gruppenübergreifende Berichte mit zusammengeführten Feldern generieren.

• reportingname. Sie können einem Feld, das zum Anzeigen von Daten in Berichten verwendet wird, eine andere Bezeichnung zuweisen. Wird kein Wert angegeben, wird der für das name-Attribut zugewiesene Anzeigename verwendet. Der reportingname zugewiesene Wert wird im Cube angezeigt. Der reportingrefname zugewiesene Wert wird nicht angezeigt.

  Wichtig

  Sie sollten Berichtsfelder mit bewährten Methoden bezeichnen, damit sie in den PivotTable-Berichten zusammen gruppiert werden. Weitere Informationen finden Sie unter Bewährte Methoden beim Zuweisen von Verweisnamen für Berichte.

Ändern berichtsfähiger Attribute für ein Arbeitsaufgabenfeld

Sie können ein vorhandenes Feld berichtsfähig machen, indem Sie die für eine Projektauflistung definierten Attributzuweisungen des Felds ändern. Ein vorhandenes Feld wird in einer oder mehreren Arbeitsaufgabentypdefinitionen definiert. Sie können auch alle Attribute ändern, die bestimmen, wie ein Feld in den Data Warehouses verarbeitet wird.

Sie können die Attributzuweisung eines Felds mithilfe der folgenden Schritte ändern:

1. Sie können den witadmin changefield-Befehl verwenden, um eine Attributzuweisung zu einem Feld zu ändern. Dieser Befehl wird für eine Teamprojektsammlung ausgeführt. Verwenden Sie folgende Syntax:

   witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]
   

   Um ein vorhandenes Feld berichtsfähig zu machen, ändern Sie den reportingtype. Um das AW.Common.TeamPriority-Feld beispielsweise für die Filterung von Berichten verfügbar zu machen, weisen Sie ihm den Wert Dimension zu:

   witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension 
   

   Weitere Informationen finden Sie unter Verwalten von Arbeitsaufgabenfeldern [witadmin].

2. (Optional) Wenn Sie über mehrere Projektauflistungen verfügen, können Sie bei Bedarf ähnliche Änderungen am Arbeitsaufgabenfeld vornehmen, das in der jeweiligen Auflistung definiert ist. Um Schemakonflikte beim Exportieren und Verarbeiten von Daten in den Data Warehouse-Datenbanken zu vermeiden, müssen diesen Attributen über alle Auflistungen hinweg die gleichen Werte zugewiesen werden:

   • Feldtyp (Der Wert für dieses Feld kann für ein vorhandenes Feld nicht geändert werden.)

   • Berichtstyp

   • Berichtsname

   Weitere Informationen finden Sie unter Lösen von Schemakonflikten im Data Warehouse.

3. Nachdem Sie alle Änderungen an den Arbeitsaufgabenfeldern vorgenommen haben, die Sie zur Berichterstellung verwenden möchten, müssen die Data Warehouse-Datenbanken verarbeitet werden. Sie können die Webdienste ProcessWarehouse und ProcessAnalysis verwenden, die durch den WarehouseControlWebService verfügbar sind.

   Durch diesen Schritt wird sichergestellt, dass Personen, die Berichte verwenden, kein Fehler angezeigt wird, wenn die Feldattribute von Ihnen geändert werden. Weitere Informationen finden Sie unter Manuelles Verarbeiten des Data Warehouses und des Analysis Services-Cubes für Team Foundation Server.

   Weitere Informationen finden Sie unter Verwalten von Arbeitsaufgabenfeldern [witadmin].

Hinzufügen von Feldern zum Unterstützen von Berichten

Sie können der Definition eines oder mehrerer Arbeitsaufgabentypen Felder hinzufügen. Beim Hinzufügen des Felds sollten Sie allen Typen von Arbeitsaufgaben, für die das Feld die Berichterstellung unterstützt, die gleiche Feldelementdefinition hinzufügen. Wenn Sie möchten, dass das Feld projektübergreifende Berichterstellung unterstützt, sollte es allen Arbeitsaufgabentypen in allen Teamprojekten hinzugefügt werden, für die Berichte erstellt werden.

Weitere Informationen finden Sie unter den folgenden Themen:

• Arbeiten mit Arbeitsaufgabenfeldern

• Hinzufügen oder Entfernen eines Felds von einem Arbeitsaufgabentyp

• FIELD (Definition)-Element

Überprüfen der an berichtsfähigen Feldattributen vorgenommenen Änderungen

Sie können die Änderungen überprüfen, die Sie an Attributen für berichtsfähige Felder vorgenommen haben, indem Sie die Data Warehouses bei Bedarf verarbeiten und dann überprüfen, ob die Berichte aktualisiert wurden. Sie können auch warten, bis die Warehouse-Adapteraufträge ausgeführt werden. In der Standardeinstellung wird die relationale Datenbank alle paar Minuten verarbeitet. Der Cube wird in der Standardeinstellung jedoch nur alle zwei Stunden verarbeitet.

1. Verarbeiten Sie das relationale Data Warehouse bei Bedarf mit dem ProcessWarehouse WarehouseControlWebService.

2. Verarbeiten Sie den Cube bei Bedarf mit dem ProcessAnalysisDatabase WarehouseControlWebService.

3. Überprüfen Sie, ob die Berichte aktualisiert werden. Zeigen Sie einen Bericht durch das Dashboard oder den Berichts-Manager an. Weitere Informationen finden Sie unter Dashboards (Agile) oder Berichte (Agile).

Bewährte Methoden beim Zuweisen von Verweisnamen für Berichte

Für Berichtsverweisnamen sollten Sie Bezeichnungen zuweisen, mit denen Sie die Felder im PivotTable-Bericht und im Cube leicht finden können. Dazu können Sie systematische Namenskonventionen anwenden, sodass Felder in einer logischen Reihenfolge gruppiert werden. Wenn die Felder nicht in einer hilfreichen Weise gruppiert werden, können Sie außerdem den Berichtsverweisnamen eines Felds ändern.

Die Anwendung einer systematischen Namenskonvention wird immer wichtiger, da alle berichtsfähigen Daten aus allen Teamprojekten, die in allen Projektauflistungen definiert sind, in ein einzelnes relationales Data Warehouse geschrieben werden. Daten aus diesem Warehouse werden dann verarbeitet und in den Cube geschrieben. Da Arbeitsaufgabenfelder für jede Projektauflistung verschieden verwaltet werden, können unterschiedliche Bezeichnungen angewendet werden und zu einem Satz von Feldern führen, der zum Unterstützen der Erstellung von Berichten ungünstig organisiert ist.

Arbeitsaufgabenfelder, die über einen berichtsfähigen Dimensionstyp verfügen, entsprechen Dimensionsattributen im Cube. Dimensionsattribute werden in Ordnern organisiert, die auf dem Verweisnamen für Berichte basieren, der in der Prozessvorlage oder der Definition des Arbeitsaufgabentyps zugewiesen wird. Die folgenden Zuordnungstypen treten auf:

• Felder mit dem Präfix "System" sind systemintern und werden direkt unter der Arbeitsaufgabendimension mit "Work Item" vorangestellt aufgelistet.

• Andere Felder werden in Ordnern platziert, deren Namen den Präfixen in den zugehörigen Verweisnamen entsprechen. Beispielsweise werden Felder, die über das Präfix "Microsoft.VSTS.Common" verfügen, im Ordner mit der Bezeichnung "Microsoft VSTS Common" aufgeführt.

Wie die folgende Abbildung zeigt, wird ein Ordner für jede Präfixgruppe von Feldern hinzugefügt, die gemeinsam ein Präfix verwenden:

In der folgenden Tabelle sind die Felder aufgeführt, deren Verweisnamen mit "System" beginnen und die im PivotTable-Bericht mit dem Präfix "Work Item" aufgeführt werden. Diese Felder werden direkt unter der Arbeitsaufgabendimension platziert. Alle anderen Felder werden in Ordnern platziert, deren Namen den Präfixen in den zugehörigen Verweisnamen entsprechen.

In der folgenden Tabelle sind die Felder aufgeführt, die im PivotTable-Bericht im Ordner mit der Bezeichnung "Microsoft.VSTS.Common" unter der Arbeitsaufgabendimension angezeigt werden. Diese Felder verfügen über Verweisnamen, die mit "Microsoft.VSTS.Common" beginnen.

Berichtsfähige Felder, die in MSF-Prozessvorlagen definiert sind

In den folgenden Tabellen sind die Felder, die in den Microsoft Solutions Framework (MSF)-Prozessvorlagen definiert sind, sowie die Standardzuweisungen der Felder aufgeführt. Diese Felder werden nur für Teamprojekte angezeigt, die mit Version 5.0 einer MSF-Prozessvorlage erstellt wurden. Nur die auf berichtsfähig festgelegten Felder werden aufgeführt.

• Detailfelder

• Dimensionsfelder

• Measurefelder

Eine vollständige Liste von Feldern, die in den MSF-Prozessvorlagen definiert sind, finden Sie unter Verwenden von Systemfeldern und von den MSF-Prozessvorlagen definierten Feldern. Wenn Sie ein Teamprojekt aktualisiert haben, müssen möglicherweise zusätzliche Aufgaben ausgeführt werden, bevor Sie mit einigen dieser Felder arbeiten können. Weitere Informationen finden Sie unter Aktualisieren eines aktualisierten Teamprojekts für den Zugriff auf neue Funktionen.

Detailfelder

Dimensionsfelder

Measurefelder

Siehe auch

Referenz

Verwalten von Arbeitsaufgabenfeldern [witadmin]

Konzepte

Arbeiten mit Arbeitsaufgabenfeldern

Erstellen, Anpassen und Verwalten von Berichten für die Anwendungslebenszyklus-Verwaltung von Visual Studio

Weitere Ressourcen

Manuelles Verarbeiten des Data Warehouses und des Analysis Services-Cubes für Team Foundation Server

Lösen von Schemakonflikten im Data Warehouse

Definieren von Arbeitsaufgabenfeldern