Pola i atrybuty elementów roboczych w usłudze Azure Boards
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Pola elementów roboczych służą do śledzenia informacji. Pola są definiowane dla organizacji i udostępniane we wszystkich projektach zdefiniowanych dla tej organizacji. Do przejrzenia pól zdefiniowanych dla organizacji można użyć jednego z dwóch narzędzi. Te narzędzia są dostępne zarówno dla modeli procesów odziedziczonych, jak i hostowanych xml.
Pola elementów roboczych służą do śledzenia informacji. Pola są definiowane dla kolekcji i udostępniane we wszystkich projektach zdefiniowanych dla tej kolekcji. Do przejrzenia pól zdefiniowanych dla kolekcji można użyć jednego z dwóch narzędzi.
- Strona sieci Web Pola przetwarzania>: dostępna dla modelu procesów dziedziczonego
- Eksplorator pól elementu roboczego: dostępne dla modeli procesów dziedziczonego i lokalnego kodu XML.
Opis każdego pola zdefiniowanego w procesie systemowym można znaleźć w temacie Indeks pola elementu roboczego.
Wymagania wstępne
- Aby wyświetlić pola zdefiniowane dla organizacji lub kolekcji, musisz być członkiem grupy aplikacji Project Collection Valid Users lub mieć uprawnienie Wyświetl informacje na poziomie wystąpienia na wartość Zezwalaj dla organizacji lub kolekcji.
Wyświetlanie listy lub przeglądanie pól
Aby wyświetlić listę lub przejrzeć pola, możesz użyć jednego z następujących narzędzi, w zależności od modelu procesu — dziedziczenia, hostowanego kodu XML lub lokalnego kodu XML — używanego. Aby uzyskać indeks pól zdefiniowanych w procesach domyślnych, zobacz Indeks pola elementu roboczego.
Narzędzie | Dziedziczenie | Hostowany kod XML | Lokalny kod XML |
---|---|---|---|
Portal internetowy: lista dziedziczona i pola zdefiniowane niestandardowe | ✔️ | ✔️1 | |
Eksplorator pól elementu roboczego | ✔️ | ✔️ | ✔️ |
narzędzie wiersza polecenia witadmin listfields | ✔️ | ✔️ | ✔️ |
Uwaga
- Obsługiwane tylko w przypadku procesów domyślnych (Agile, CMMI, Scrum).
Typy i nazwy danych pól
Każdy typ elementu roboczego określa pola zdefiniowane dla elementów roboczych odwołujących się do tego typu. Każde pole jest skojarzone z wieloma atrybutami, z których wiele jest ustawianych przez system i nie można ich zmienić.
Każde pole jest definiowane przez następujące trzy atrybuty.
- Typ danych: określa typ danych, które można wprowadzić w polu, takie jak Wartość logiczna, Podwójna, Liczba całkowita, HTML i Ciąg. Opisy poszczególnych typów danych można znaleźć w temacie Query fields, operators, and macros (Pola zapytań, operatory i makra).
- Przyjazna nazwa: określa nazwę przypisaną do pola i wybraną dla pola w klauzuli kwerendy. Ta nazwa może różnić się od nazwy wyświetlanej w formularzu elementu roboczego.
- Nazwa odwołania: określa nazwę używaną podczas tworzenia zapytania WIQL lub improwizowanego szablonu elementu roboczego przy użyciu poleceń interfejsu API REST lub definiowania definicji typów elementów roboczych XML. Po zdefiniowaniu nie można zmienić nazwy odwołania.
Opis każdego atrybutu pola i sposobu ich wyświetlania można znaleźć w temacie Atrybuty pola i Atrybuty pól listy w dalszej części tego artykułu. Aby zapoznać się z omówieniem sieci WITs i elementów roboczych, zobacz Śledzenie pracy z historiami użytkowników, problemami, usterkami, funkcjami i epikami.
Co to jest pole? Jak są używane nazwy pól?
Każdy typ elementu roboczego jest skojarzony z 31 polami systemowymi i kilkoma polami specyficznymi dla typu. Elementy robocze służą do planowania i śledzenia projektu.
Każde pole obsługuje śledzenie fragmentu informacji o pracy do wykonania. Wartości przypisywane do pola są przechowywane w magazynie danych śledzenia pracy, które można tworzyć zapytania w celu określenia stanu i trendów.
Opisy i użycie każdego pola zdefiniowanego dla podstawowych procesów systemowych, procesów Agile, Basic, Scrum i CMMI można znaleźć w temacie Indeks pola elementu roboczego.
Nazwy pól
Nazwa pola elementu roboczego jednoznacznie identyfikuje każde pole elementu roboczego. Upewnij się, że nazwy pól należą do następujących wytycznych:
- Nazwy pól muszą być unikatowe w kolekcji konta/projektu
- Nazwy pól muszą mieć co najmniej 128 znaków Unicode
- Nazwy pól nie mogą zawierać żadnych spacji wiodących ani końcowych, ani dwóch lub więcej kolejnych spacji
- Nazwy pól muszą zawierać co najmniej jeden znak alfabetyczny
- Nazwy pól nie mogą zawierać następujących znaków:
.,;'`:~\/\*|?"&%$!+=()[]{}<>
.
Ponieważ pola niestandardowe są definiowane dla organizacji lub kolekcji, nie można dodać pola niestandardowego do procesu o tej samej nazwie pola, którą dodajesz do innego procesu.
Aby uzyskać więcej informacji, zobacz Ograniczenia i konwencje nazewnictwa.
Pola systemowe i wstępnie zdefiniowane
Wszystkie pola zdefiniowane przez system mają nazwy odwołań rozpoczynające się od system, na przykład System.AreaPath, System.AssignedTo i kontynuują w tym wzorcu.
Wstępnie zdefiniowane pola zdefiniowane przez domyślny proces zaczynają się od usługi Microsoft.VSTS, a następnie różnią się w zależności od ich użycia. Przykłady wstępnie zdefiniowanych pól używanych w typowych celach planowania i integracji z programem Office Project w celu integracji z kompilacją Team Foundation i integracji z zarządzaniem przypadkami testowymi (TCM) są następujące:
- Microsoft.VSTS.Common.Priority
- Microsoft.VSTS.Scheduling.DueDate
- Microsoft.VSTS.Build.FoundIn
- Microsoft.VSTS.TCM.Steps
Aby zapoznać się z omówieniem wszystkich pól systemowych i wstępnie zdefiniowanych dla domyślnych procesów/szablonów procesów, zobacz Indeks pola elementu roboczego. Aby uzyskać więcej informacji na temat określania nazw pól, zobacz Ograniczenia nazewnictwa.
Pola niestandardowe
Ponieważ pola niestandardowe są definiowane dla organizacji lub kolekcji projektów, nie można dodać pola niestandardowego do procesu o tej samej nazwie pola, którą dodajesz do innego procesu.
Podczas dodawania pól niestandardowych zwróć uwagę na następujące limity:
- Dla każdego elementu WIT można zdefiniować maksymalnie 64 pola
- Maksymalnie 512 pól można zdefiniować na proces
Typ danych pola określa rodzaj i rozmiar danych, które można przechowywać w polu. Pole może mieć tylko jeden typ zdefiniowany w kolekcji projektów. To ograniczenie zachęca organizacje do używania typowych pól między projektami i typami elementów roboczych.
Po dodaniu pola niestandardowego do dziedziczonego procesu usługa Azure DevOps przypisuje nazwę odwołania poprzedzoną prefiksem Custom , a następnie nazwę pola z usuniętymi spacjami. Na przykład dodasz pole o nazwie DevOps Triage, a nazwą referencyjną jest Custom.DevOpsTriage. W nazwie odwołania nie są dozwolone żadne spacje.
Jak określić typ danych pola?
Typ danych pól zdefiniowanych dla organizacji można wyświetlić, otwierając stronę Pola procesu>.
Gdy kolekcja projektu używa modelu procesu dziedziczenia do dostosowywania śledzenia pracy, możesz wyświetlić typ danych pól, otwierając stronę Pola procesu>.
Jeśli jest używany lokalny model procesu XML, możesz wyszukać typ danych za pomocą indeksu pola Element roboczy. Możesz też otworzyć Eksploratora pól elementu roboczego, aby przejrzeć pola zdefiniowane i ich przypisania atrybutów lub użyć polecenia witadmin listfields , aby wyświetlić listę atrybutów pola. Aby uzyskać więcej informacji, zobacz Temat Eksplorator pól elementów roboczych i Atrybuty pól listy w dalszej części tego artykułu.
Strona internetowa Pola przetwarzania>
Aby przejrzeć listę pól zdefiniowanych dla organizacji lub kolekcji, otwórz pozycję Pola procesu>ustawień>organizacji.
Wybierz logo usługi Azure DevOps, aby otworzyć projekty. Następnie wybierz pozycję Ustawienia organizacji.
Następnie wybierz pozycję Proces.
Uwaga
Jeśli nie widzisz ustawienia Proces, pracujesz z serwera TFS-2018 lub starszej wersji. Strona Proces nie jest obsługiwana. Należy użyć funkcji obsługiwanych dla lokalnego modelu procesów XML.
Następnie wybierz pozycję Pola.
Pola wymienione odpowiadają wszystkim polam zdefiniowanym dla organizacji lub kolekcji. Obejmuje to wszystkie pola niestandardowe i te zdefiniowane dla procesów systemowych.
Uwaga
Jeśli nie widzisz pola, kolekcja używa lokalnego procesu XML. Strona Pola nie jest obsługiwana w tym procesie.
Opisy i użycie każdego pola, a także nazwa odwołania dla każdego pola, można wyszukać je w indeksie pola Element roboczy. Możesz również uzyskać nazwę odwołania do pól z pola Typy elementów roboczych — interfejs API REST listy.
Eksplorator pól elementu roboczego
Przy użyciu narzędzia Eksplorator pól elementów roboczych można wyszukać przypisania atrybutów pól.
Aby uzyskać dostęp do Eksploratora pól elementu roboczego, należy zainstalować narzędzie edytora procesów. Na podstawie zainstalowanej wersji programu Visual Studio pobierz narzędzie edytora procesów z jednego z następujących rozszerzeń.
- Visual Studio 2019: Edytor szablonów przetwarzania.
- Visual Studio 2017: Edytor szablonów procesu TFS. Możesz również użyć tej wersji edytora procesów, aby zmodyfikować formularze elementów roboczych w starym stylu. Nie można jej używać do edytowania formularzy skojarzonych z nowymi formularzami internetowymi.
- Visual Studio 2015: TFS Power Tools.
Atrybuty pól
Istnieje wiele atrybutów niezmiennych i ukrytych dla każdego pola elementu roboczego. Następująca tabela zawiera opis każdego atrybutu. Atrybuty mają różne nazwy w zależności od tego, czy są one uzyskiwane za pośrednictwem interfejsu API REST — uzyskiwanie interfejsu API REST lub wyświetlanie za pomocą narzędzia Eksploratora pól elementów roboczych (ŻONA).
Atrybuty przypisane do pola zależą od używanej platformy i wersji. Na przykład niektóre atrybuty nie są obsługiwane w procesie dziedziczenia. Aby wyszukać nazwę odwołania dla pola, zobacz Indeks pola elementu roboczego.
Atrybut
Typ atrybutu
Opis
REST:
ŻONA: AllowedValues
— kolekcja
Pobiera kolekcję prawidłowych wartości dla pola zawierającego wartości listy wyboru. Możesz to zmienić, określając listę wyboru lub listę globalną (lokalną).
Czy można zmienić?=Tak
REST: canSortBy
ŻONA: CanSortBy
boolean
Wskazuje, czy wyniki zapytania można sortować za pomocą tego pola.
Czy można zmienić?=Nie
REST: opis
ŻONA: HelpText
string
Określa opis pola, który definiuje również tekst pomocy wyświetlany po umieszczeniu wskaźnika myszy na polu w formularzu elementu roboczego.
Czy można zmienić?=Tak
REST:
ŻONA: IDENTYFIKATOR
Integer
Określa wewnętrzny identyfikator pola.
Czy można zmienić?=Nie
REST:
ŻONA: IsCloneable
boolean
Wskazuje, czy wartość zdefiniowana dla pola jest kopiowana, gdy użytkownik zdecyduje się skopiować element roboczy. Na przykład pola Tytuł, Tagi i Opis są kopiowane, ale pola Identyfikator i Historia nie są kopiowane.
Czy można zmienić?=Nie
REST:
ŻONA: IsComputed
boolean
Wskazuje, czy wartość ustawiona przez to pole jest obliczana przez system (Prawda) lub nie (Fałsz). Przykłady obliczonych pól to te, które są ustawiane przez system, takie jak id, poprawiona data, data zmiany i liczba linków zewnętrznych.
Czy można zmienić?=Nie
REST:
ŻONA: IsCoreField
boolean
Wskazuje, czy to pole jest określone dla wszystkich typów elementów roboczych.
Czy można zmienić?=Nie
REST:
ŻONA: IsEditable
boolean
Wskazuje, czy użytkownicy mogą modyfikować to pole (Prawda) lub nie (Fałsz). Przykłady pól, które nie można edytować, to te, które są ustawiane przez system, takie jak pola ID, Revision, Created By i Changed By
Czy można zmienić?=Nie
REST: isIdentity
ŻONA: IsIdentity
boolean
Wskazuje, czy to pole jest polem Tożsamość . Pola tożsamości to pola ciągów używane do przechowywania tożsamości użytkowników.
Czy można zmienić?=Nie
REST:
ŻONA: IsIndexed1
boolean
Wskazuje, czy to pole jest indeksowane w celu obsługi wyszukiwania.
Czy można zmienić?=Nie
REST:
ŻONA: IsLongText
boolean
Wskazuje, że pole może zawierać więcej niż 255 znaków, na przykład pola przypisane do typu danych Zwykłego tekstu, HTML lub Historii.
Czy można zmienić?=Nie
REST: isPicklist2 ŻONA:
boolean
Wskazuje, czy pole jest skojarzone z listą wyboru. Wartość jest ustawiona na Wartość True , gdy jest zdefiniowane pole niestandardowe dla usługi Azure DevOps, a typ Lista wyboru (ciąg) lub Lista wyboru (Liczba całkowita) jest zaznaczona. Wartość jest ustawiona na Fałsz dla dziedziczych pól, które definiują listy wyboru.
Czy można zmienić?=Nie
REST: isPicklistSuggested2 ŻONA:
boolean
Wskazuje, czy pole umożliwia użytkownikom wprowadzanie własnych wartości dla listy wyboru. Wartość jest ustawiona na Wartość True , gdy pole niestandardowe jest zdefiniowane dla usługi Azure DevOps, listy wyboru (ciągu) lub typu Lista wyboru (liczba całkowita) jest zaznaczone, a pole wyboru Zezwalaj użytkownikom na ustawianie własnych wartości jest zaznaczone.
Czy można zmienić?=Tak
REST: isQueryable
ŻONA: IsQueryable
boolean
Wskazuje, czy pole jest wyświetlane w zestawie pól, które można dodać do filtrowania zapytania elementu roboczego (Prawda), czy też nie (Fałsz). Większość pól można wykonywać zapytania.
Czy można zmienić?=Nie
REST:
ŻONA: IsReportable 3
boolean
Wskazuje, czy atrybut możliwy do raportowania jest zdefiniowany lub ustawiony na coś innego niż Brak. Ten atrybut można zmienić w środowiskach lokalnych.
Czy można zmienić?=Tak
REST:
ŻONA: IsUsedInGlobalWorkflow
boolean
Wskazuje, czy pole jest zdefiniowane w globalnym przepływie pracy.
Czy można zmienić?=Nie
REST:
ŻONA: IsUserNameField
boolean
Wskazuje, czy pole jest używane do wyświetlania pola Tożsamość.
Czy można zmienić?=Nie
REST: nazwa
ŻONA: Imię i nazwisko
string
Przyjazna nazwa przypisana do pola. Nie można zmienić przyjaznej nazwy dla usługi Azure DevOps, ale można jej zmienić lokalnie przy użyciu polecenia witadmin changefield .
Czy można zmienić?=tylko on-prem
REST: picklistId
ŻONA: HelpText
Identyfikator GUID
Jeśli pole jest listą wyboru, identyfikator skojarzonej listy wyboru, w przeciwnym razie ma wartość null. Unikatowa wartość identyfikatora GUID jest przypisywana po wybraniu pola niestandardowego dla usługi Azure DevOps i listy wyboru (ciąg) lub typu Lista wyboru (liczba całkowita).
Czy można zmienić?=Nie
REST:
ŻONA: ZabronioneValues
— kolekcja
Pobiera kolekcję niedozwolonych wartości dla pola, które określa takie wartości. Niedozwolone wartości można definiować tylko dla wdrożeń lokalnych.
Czy można zmienić?=tylko on-prem
REST: readOnly
ŻONA:
boolean
Wskazuje, czy pole jest ustawione na tylko do odczytu. W przypadku usług Azure DevOps Services można zmienić tylko pola niestandardowe na tylko do odczytu. Nie można modyfikować pól systemowych.
Czy można zmienić?=Tak
REST: referenceName
ŻONA: ReferenceName
string
Określa nazwę odwołania pola.
Czy można zmienić?=Nie
REST:
ŻONA: ReportingAttributes3
Określa szczegóły, wymiar lub miarę, w zależności od tego, czy i w jaki sposób pole ma być uwzględnione w raportach. Dane z pól, które mają wartość inną niż Brak dla tego atrybutu, są eksportowane do magazynu danych i mogą być uwzględniane w raportach SQL.
Czy można zmienić?=tylko on-prem
REST:
ŻONA: ReportingName3
string
Określa etykietę pola, gdy dane są wyświetlane w raportach SQL. Jeśli nie określisz wartości, zostanie użyta przyjazna nazwa pola.
Czy można zmienić?=tylko lokalnie
REST:
ŻONA: ReportingReferenceName3
string
Określa inną nazwę odwołania do pola używanego podczas eksportowania danych do magazynu danych relacyjnych. Jeśli nie określisz wartości, zostanie użyta nazwa odwołania do pól.
Czy można zmienić?=tylko lokalnie
REST: supportedOperations
ŻONA:
set
Zestaw operatorów zapytań, które są prawidłowe do użycia podczas odwoływania się do tego pola. Aby zapoznać się z krótkim omówieniem obsługiwanych operacji opartych na typie danych, zobacz Szybkie informacje o zapytaniach, Operatory i makra obsługiwane dla każdego typu danych.
Czy można zmienić?=Nie
REST:
ŻONA: SupportsTextQuery
boolean
Wskazuje, czy pole obsługuje zapytania tekstowe, takie jak Zawiera słowa, Nie zawiera wyrazów.
Czy można zmienić?=Nie
REST:
ŻONA: SystemType
string
Określa typ danych pola, odwołując się do nazwy systemu, takiej jak System.DateTime lub System.String.
Czy można zmienić?=Nie
REST: typ
ŻONA: FieldType
string
Określa typ danych pola, taki jak wartość logiczna, data/godzina, liczba całkowita, ciąg itd. Aby uzyskać pełną listę i opisy, zobacz Pola zapytań, operatory i makra.
Czy można zmienić?=Nie
REST: użycie
ŻONA: Użycie
string
Określa, czy pole jest przeznaczone do użytku z elementami roboczymi (WorkItem) lub obiektami linku elementu roboczego (WorkItemLink). Użycie większości pól to WorkItem. Aby uzyskać pełną listę wartości użycia, zobacz Pobieranie pól, FieldUsage.
Czy można zmienić?=Nie
Uwaga
- W przypadku wdrożeń lokalnych można włączyć indeksowanie dla pola, aby poprawić czasy odpowiedzi zapytania podczas filtrowania w polu. Aby uzyskać więcej informacji, zobacz Pola indeksowane w dalszej części tego artykułu.
- Atrybuty isPicklist i isPicklistSuggested są przypisywane tylko do pól niestandardowych zdefiniowanych dla dziedziczonego procesu. Model odziedziczonego procesu jest obsługiwany w przypadku usługi Azure DevOps Server 2019 i nowszych wersji. Aby uzyskać więcej informacji, zobacz Dziedziczony model procesu.
- Wszystkie atrybuty raportowania są prawidłowe tylko w przypadku wdrożeń lokalnych, których projekty zostały skonfigurowane do obsługi raportowania programu SQL Server i usług SQL Server Analysis Services.
Atrybuty z możliwością raportowania
Wszystkie atrybuty raportowania są prawidłowe tylko w przypadku wdrożeń lokalnych, których projekty zostały skonfigurowane do obsługi raportowania programu SQL Server i usług SQL Server Analysis Services. Aby uzyskać więcej informacji, zobacz Dodawanie raportów do projektu.
Opis każdego atrybutu z możliwością raportowania można znaleźć w temacie [Dodawanie lub modyfikowanie pól elementów roboczych w celu obsługi raportowania]((/previous-versions/azure/devops/reference/xml/add-or-modify-work-item-fields-to-support-reporting).
Aby zapoznać się z listą pól, które mają atrybuty raportowalne zdefiniowane domyślnie, zobacz Dokumentację pól z możliwością raportowania.
Pola indeksowane
Indeksowanie dla pola elementu roboczego można włączyć lub wyłączyć przy użyciu polecenia witadmin indexfield . Po włączeniu indeksowania dla pola można zwiększyć wydajność znajdowania elementów roboczych, których zapytania określają to pole. Domyślnie indeksowane są następujące pola: Przypisano do, Data utworzenia, Zmieniono według, Stan, Przyczyna, Identyfikator obszaru, Identyfikator iteracji i Typ elementu roboczego.
Jeśli dodasz pole niestandardowe, które jest używane w wielu zapytaniach dotyczących elementów roboczych, możesz włączyć indeksowanie dla tego pola. Aby uzyskać więcej informacji, zobacz Zarządzanie polami elementów roboczych (witadmin).
Atrybuty pola listy
Atrybuty przypisane do pola można wyświetlić przy użyciu interfejsu API REST Pola — Pobierz interfejs API REST. Wprowadź nazwę organizacji w polu OrganizationName.
https://dev.azure.com/OrganizationName/_apis/wit/fields/FieldReferenceName
Na przykład w tym miejscu wymieniono atrybuty ścieżki iteracji, określając nazwę odwołania , System.IterationPath
dla organizacji fabrikam.
https://dev.azure.com/fabrikam/_apis/wit/fields/System.IterationPath
Zwrócone dane:
{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://dev.azure.com/mseng/_apis/wit/fields/System.IterationPath"
}
Atrybuty przypisane do pola można wyświetlić przy użyciu interfejsu API REST Pola — Pobierz interfejs API REST. Wprowadź nazwę organizacji w polu OrganizationName. Aby rozpocząć korzystanie z interfejsu REST, zobacz Dokumentacja interfejsu API REST usługi Azure DevOps Services
https://{ServerName:Port}/tfs/{Collection}/_apis/wit/fields/FieldReferenceName?api-version={version}
Na przykład w tym miejscu wymieniono atrybuty ścieżki iteracji, określając nazwę odwołania , System.IterationPath
dla serwera fabrikam.
https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1
Zwrócone dane:
{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1"
}
Wyświetlanie listy atrybutów przy użyciu witadmin
narzędzia wiersza polecenia
Możesz wyświetlić listę atrybutów pól — takich jak typ danych, atrybuty raportu i indeksowanie — za pomocą polecenia witadmin listfields.
Możesz na przykład wprowadzić następujące polecenie, aby wyświetlić listę atrybutów zdefiniowanych dla określonego pola, takich jak Microsoft.VSTS.Common.Issue.
witadmin listfields /collection:http://fabrikam:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue
Informacje o polach i atrybutach są wyświetlane dla nazwanego pola, jak pokazano w tym przykładzie.
Field: Microsoft.VSTS.Common.Issue
Name: Issue
Type: String
Reportable As: dimension
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)
Indexed: False
Parametr Use wskazuje nazwę każdego projektu i typ elementu roboczego, w którym jest używane pole.
Dodawanie i modyfikowanie pól
Aby dodać pola do procesu, należy dodać je do co najmniej jednego typu elementu roboczego. Aby uzyskać więcej informacji, zobacz Dostosowywanie procesu dziedziczenia.
Możesz dodawać lub modyfikować pola zawarte w funkcji WIT lub dodawać niestandardowe WIT. Aby uzyskać więcej informacji, zobacz:
- W przypadku kolekcji projektów korzystających z modelu procesu dziedziczenia: Dostosowywanie procesu dziedziczenia.
- W przypadku kolekcji projektów korzystających z lokalnego modelu procesu XML: Dostosuj lokalny model procesu XML.
Możesz zmienić nazwę pola, indeks i atrybuty raportu dla dowolnego pola z wyjątkiem pól systemowych przy użyciu narzędzia wiersza polecenia witadmin . Aby uzyskać więcej informacji, zobacz Zarządzanie polami elementów roboczych-witadmin.
Powiązane artykuły
- Krótki przewodnik dotyczący zapytań
- Indeks pola elementu roboczego
- Wybieranie modelu procesu dla kolekcji projektów
- Add or modify a field to track work (Dodawanie lub modyfikowanie pola pod kątem śledzenia pracy)
- Zarządzanie polami elementów roboczych przy użyciu narzędzia witadmin
- Dokumentacja metadanych usługi Azure Boards Analytics