Definieren von globalen Listen

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Wichtig

Dieser Artikel gilt für die Projektanpassung für gehostete XML- und lokale XML-Prozessmodelle. Die Anpassung von gehostetem XML unterstützt das Hinzufügen und Aktualisieren globaler Listen mit einem Prozessupdate. Weitere Informationen finden Sie unter Verarbeiten von Vorlagenanpassungsunterschieden.

Das Vererbungsprozessmodell unterstützt keine globalen Listen. Eine Übersicht über Prozessmodelle finden Sie unter Anpassen ihrer Arbeitsnachverfolgungserfahrung.

Mithilfe globaler Listen können Sie die Arbeit minimieren, die erforderlich ist, um eine Liste zu aktualisieren, die in den Definitionen mehrerer Arbeitselementtypen (WITs) angezeigt wird. Globale Listen sind Auswahllisten, die Sie in ein oder mehrere Felder und Definitionen von Arbeitsaufgabentypen einschließen können.

Sie können Listenelemente für mehrere WITs für eine Sammlung freigeben, indem Sie die Listenelemente in ein oder mehrere Elemente GLOBALLIST einbetten.

Beim Definieren von Arbeitsaufgabentypen stellen Sie möglicherweise fest, dass einige Felder die gleichen Werte verwenden. Häufig können Sie für mehrere WITs und sogar für mehrere Projekte freigeben. Einige dieser Werte, wie z. B. die Buildnummer nächtlicher Builds, ändern sich häufig, sodass Administratoren diese Listen ständig an zahlreichen Speicherorten aktualisieren müssen. Globale Listen können insbesondere dann nützlich sein, wenn eine Liste aus einem externen System abgeleitet werden muss. Angenommen beispielsweise, ein Unternehmen pflegt eine separate Kundendatenbank. Wenn Sie einen von einem Kunden gefundenen Fehler melden, wird der Name des Kunden in ein benutzerdefiniertes Feld Found By Customer eingegeben.

Sie können globale Listen für eine Auflistung als XML-Datei verwalten, die Sie auflisten, importieren, exportieren und löschen können. Der Name jeder globalen Liste kann aus bis zu 254 Unicode-Zeichen bestehen und muss innerhalb einer Auflistung eindeutig sein.

Hinweis

In den Standardprozessen oder Prozessvorlagen sind weder systemdefiniert noch vordefinierte globale Listen angegeben.

Voraussetzungen

Für die Projektsammlung, in der die globalen Listen definiert sind, müssen Sie über die folgenden Berechtigungen verfügen:

  • Um globale Listen zu exportieren oder auflisten zu können, müssen Sie Mitglied der Gruppe Project Sammlung Gültige Benutzer sein oder die Berechtigung Informationen auf Sammlungsebene anzeigen auf Zulassen festgelegt haben.

  • Um globale Listen zu importieren, müssen Sie Mitglied der Sicherheitsgruppe Project Sammlungsadministratoren sein.

Um eine globale Liste hinzuzufügen oder zu ändern, verwenden Sie das Befehlszeilentool witadmin , um die Definition für globale Listen zu importieren und zu exportieren. Weitere Informationen finden Sie unter Verwalten globaler Listen. Um eine globale Liste zu verwenden, fügen Sie sie der Definition FIELD innerhalb eines Arbeitselementtyps hinzu. Siehe Alle FIELD-Elemente.

Hinzufügen und Verwalten globaler Listen

Eine globale Liste ist ein Satz von Elementen LISTITEM , die von allen Projekten in einer Auflistung global gespeichert und verwendet werden. Globale Listen sind für Felder nützlich, die in mehreren Arbeitselementtypen definiert sind, wie „Betriebssystem“, „In Build gefunden“ und „In Build korrigiert“.

Sie können eine oder mehrere globale Listen und deren Elemente auf der Grundlage des von Ihnen verwendeten Prozessmodells mithilfe einer der folgenden Methoden definieren:

  • Innerhalb einer WIT XML-Definition, die Sie einem Projekt oder einer Prozessvorlage hinzufügen (gehostetes XML und lokales XML)
  • Innerhalb einer globalen Listen-XML-Definitionsdatei, die Sie in eine Projektsammlung importieren (lokales XML)
  • Innerhalb einer globalen Workflow-XML-Definitionsdatei , die Sie in eine Projektsammlung (lokales XML) importieren.

Hinweis

Für das Gehostete XML-Prozessmodell gelten die folgenden Grenzwerte für den globalen Listenimport:

  • Insgesamt 64 globale Listen
  • Insgesamt 512 Elemente pro Liste
  • Ungefähr 10.000 Elemente können insgesamt in allen globalen Listen definiert werden, die für alle WITs angegeben sind.

Syntaxstruktur

In der folgenden Tabelle werden die Elemente GLOBALLIST und LISTITEM beschrieben. Sie können diese Elemente verwenden, um eine Auflistung von Werten zu erstellen, die dem Benutzer als Auswahlliste oder Dropdownmenü mit Elementen angezeigt wird.

Element

Beschreibung

GLOBALLIST

Definiert einen Satz von LISTITEM-Elementen , die für eine Auflistung gespeichert sind und die von allen Projekten in einer Auflistung verwendet werden können.

<GLOBALLIST name="globalListName">  
<LISTITEM> . . . </LISTITEM>  
</GLOBALLIST>

globalListName: Eine Textzeichenfolge, die zwischen 1 und 255 Zeichen enthält.

GLOBALLIST ist ein erforderliches untergeordnetes Element des GLOBALLISTS-Elements und ein optionales untergeordnetes Element der ALLOWEDVALUES-, SUGGESTEDVALUES- und - PROHIBITEDVALUES Elemente. Weitere Informationen finden Sie unter ALLOWEDVALUES-, SUGGESTEDVALUES- und PROHIBITEDVALUES-XML-Elemente.

LISTITEM

Definiert einen gültigen Listenwert. Globale Listen dürfen keine Gruppen aus dem Projektumfang enthalten, da sie nicht auf ein Projekt begrenzt sind.

<LISTITEM value="Name" />

LISTITEM ist ein erforderliches untergeordnetes Element von GLOBALLIST und ein optionales untergeordnetes Element der ALLOWEDVALUESElemente , SUGGESTEDVALUESund PROHIBITEDVALUES .

Beispiel einer globalen Liste

Durch Hinzufügen der folgenden Syntax können Sie eine globale Liste innerhalb einer XML-Definitionsdatei für einen Arbeitsaufgabentyp oder einen globalen Workflow definieren:

<GLOBALLISTS>  
       <GLOBALLIST name="name of global list">  
          <LISTITEM value="List item 1" />  
          <LISTITEM value="List item 2" />  
          <LISTITEM value="List item 3" />  
          <LISTITEM value="List item 4" />  
          . . .  
          <LISTITEM value="List item n" />  
       </GLOBALLIST>  
</GLOBALLISTS>  

Mit der folgenden Syntax können Sie innerhalb einer XML-Definitionsdatei für einen Arbeitsaufgabentyp auf eine globale Liste verweisen:

<GLOBALLISTS>  
      <GLOBALLIST name=" name of global list 1" />  
      <GLOBALLIST name=" name of global list 2" />  
      . . .  
      <GLOBALLIST name=" name of global list n" />  
</GLOBALLISTS>  

Informationen zur Struktur und zum Speicherort von Definitionsdateien für Typen von Arbeitselementen oder globalen Workflows finden Sie unter Alle WITD-Elemente bzw. GLOBALWORKFLOW.

Globale Beispielliste für eine Projektsammlung

Um einer Projektsammlung eine globale Liste hinzuzufügen, können Sie die folgende Syntax importieren, indem Sie den Befehl witadmin importgloballist verwenden:

<gl:GLOBALLISTS xmlns:gl="http://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">  
       <GLOBALLIST name="NameOfGlobalList">  
       <LISTITEM value="ListItem1" />  
       <LISTITEM value="ListItem2" />  
       <LISTITEM value="ListItem3" />  
       <LISTITEM value="ListItem4" />  
  . . .  
       <LISTITEM value="ListItemN" />  
       </GLOBALLIST>  
</gl:GLOBALLISTS>  

Eine globale Liste darf nicht leer sein. Für GLOBALLIST jedes Element muss mindestens ein Element LISTITEM definiert sein.

Gibt es globale Listen, die automatisch mit Daten gefüllt werden?

Ja für lokale Azure DevOps Server. Die globale Liste mit dem Namen Builds. TeamProjectName wird jedes Mal angefügt, wenn ein Build ausgeführt wird. Im Laufe der Zeit kann diese Liste sehr lang werden. Eine bewährte Methode ist es, nicht benutzte Einträge regelmäßig aus der Liste zu entfernen.

Weitere Informationen zur Verwendung dieser Liste finden Sie unter Abfrage basierend auf Build- und Testintegrationsfeldern.