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.

• Strona internetowa Pola przetwarzania>
• Eksplorator pól elementu roboczego

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

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

Strona internetowa Pola przetwarzania>

Aby przejrzeć listę pól zdefiniowanych dla organizacji lub kolekcji, otwórz pozycję Pola procesu>ustawień>organizacji.

1. Wybierz logo usługi Azure DevOps, aby otworzyć projekty. Następnie wybierz pozycję Ustawienia organizacji.

   

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

3. 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: IsIndexed¹

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: isPicklist² Ż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: isPicklistSuggested² Ż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 ³

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: ReportingAttributes³

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: ReportingName³

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: ReportingReferenceName³

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

1. 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.
2. 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.
3. 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 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.IterationPathdla 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"
}

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.

Powiązane artykuły

• Krótki przewodnik dotyczący zapytań
• Indeks pola elementu roboczego
• Dodawanie pól dla dziedziczonego procesu i zarządzanie nimi
• Dokumentacja metadanych usługi Azure Boards Analytics