Wyświetlanie listy pól i atrybutów elementów roboczych

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Pola elementów roboczych służą do śledzenia informacji w usłudze Azure DevOps. Te pola są definiowane na poziomie organizacji i są współużytkowane we wszystkich projektach w organizacji. Aby przejrzeć pola zdefiniowane dla organizacji, możesz użyć jednego z następujących dwóch narzędzi, które są dostępne dla modeli procesów Dziedziczone i Hostowane XML:

• Strona internetowa Pola przetwarzania >
• Eksplorator pól zadania

Opis każdego pola zdefiniowanego w procesie systemowym można znaleźć w temacie Indeks pola elementu roboczego.

Wymagania wstępne

Kategoria	Wymagania
Uprawnienia użytkownika	Aby wyświetlić pola zdefiniowane dla organizacji lub kolekcji: członek grupy aplikacji Project Collection Valid Users lub uprawnienie View instance-level information ustawione na Zezwalaj dla organizacji lub kolekcji.

Lista lub przegląd pól

Aby wyświetlić listę lub przejrzeć pola, użyj jednego z następujących narzędzi opartych na modelu procesu — dziedziczonego, hostowanego kodu XML lub lokalnego kodu XML. 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 pól dziedziczonych i zdefiniowanych przez użytkownika	✔️	✔️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 zawarte w elementach roboczych tego typu. Każde pole ma wiele atrybutów, z których wiele jest zdefiniowanych przez system i niezmiennych.

Pola są definiowane przez następujące trzy atrybuty:

• Typ danych: wskazuje rodzaj danych, które można wprowadzić w polu, takie jak Wartość logiczna, Podwójna, Liczba całkowita, HTML lub Ciąg. Aby uzyskać szczegółowe opisy poszczególnych typów danych, zobacz Pola zapytań, operatory i makra.
• Przyjazna nazwa: przyjazna dla użytkownika nazwa przypisana do pola używana podczas wybierania pola w klauzuli zapytania. Ta nazwa może różnić się od nazwy wyświetlanej w formularzu elementu roboczego.
• Nazwa referencyjna: identyfikator używany podczas tworzenia zapytań WIQL, improwizowanych szablonów elementów roboczych, wykonywania poleceń interfejsu API REST lub definiowania definicji typów elementów roboczych XML. Nazwa odwołania jest stała i nie można jej zmienić po ustawieniu.

Aby uzyskać szczegółowy opis każdego atrybutu pola i instrukcje dotyczące ich wyświetlania, zobacz Atrybuty pola i Atrybuty pól listy w dalszej części tego artykułu. Aby zapoznać się z omówieniem typów elementów roboczych (WIT) 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 zawiera 31 pól systemowych i kilka pól specyficznych dla typu. Elementy robocze są używane do planowania i śledzenia projektu.

Każde pole przechwytuje określone informacje o pracy do wykonania. Wartości przypisywane do tych pól są przechowywane w magazynie danych śledzenia pracy, umożliwiając tworzenie zapytań określających stan i trendy.

Odnośnie opisów i sposobów użycia każdego pola określonego dla podstawowych procesów systemowych — Agile, Basic, Scrum i CMMI— odwołaj się do indeksu pól Elementu roboczego Work item field index.

Nazwy pól

Nazwa pola elementu roboczego jednoznacznie identyfikuje każde pole elementu roboczego. Upewnij się, że nazwy pól są zgodne z następującymi wytycznymi:

• Unikatowość: nazwy pól muszą być unikatowe w ramach konta lub kolekcji projektów.
• Długość: nazwy pól muszą zawierać 128 znaków Unicode lub mniej.
• Odstępy: nazwy pól nie mogą mieć spacji wiodących ani końcowych ani zawierać dwóch lub więcej kolejnych spacji.
• Kompozycja: Nazwy pól muszą zawierać co najmniej jeden znak alfabetyczny.
• Niedozwolone znaki: nazwy pól nie mogą zawierać następujących znaków: .,;':~/*|?" &%$!+=()[]{}<>'.

Ponieważ pola niestandardowe są definiowane na poziomie organizacji lub kolekcji, nie można dodać pola niestandardowego o tej samej nazwie do wielu procesów.

Aby uzyskać więcej informacji, zobacz Ograniczenia i konwencje nazewnictwa.

Pola systemowe i wstępnie zdefiniowane

Nazwa pola elementu roboczego jednoznacznie identyfikuje każde pole w usłudze Azure DevOps. Upewnij się, że nazwy pól są zgodne z następującymi wytycznymi:

• Unikatowość: nazwy pól muszą być unikatowe w ramach konta lub kolekcji projektów.
• Długość: nazwy pól muszą zawierać maksymalnie 128 znaków Unicode.
• Odstępy: nazwy pól nie mogą mieć spacji wiodących ani końcowych, ani zawierać wielu kolejnych spacji.
• Kompozycja: Nazwy pól muszą zawierać co najmniej jeden znak alfabetyczny.
• Niedozwolone znaki: nazwy pól nie mogą zawierać następujących znaków: .,;':~/*|?" &%$!+=()[]{}<>'.

Ponieważ pola niestandardowe są definiowane na poziomie organizacji lub kolekcji, nie można dodać pola niestandardowego o tej samej nazwie do wielu procesów.

Aby uzyskać więcej informacji, zobacz Ograniczenia i konwencje nazewnictwa.

Pola niestandardowe

Ponieważ pola niestandardowe są definiowane na poziomie organizacji lub kolekcji projektów, nie można dodać pola niestandardowego o tej samej nazwie do wielu procesów.

Podczas dodawania pól niestandardowych zwróć uwagę na następujące limity:

• Maksymalna liczba pól na typ elementu roboczego (WIT): 64
• Maksymalna liczba pól na proces: 512

Typ danych pola określa rodzaj i rozmiar danych, które mogą być przechowywane w polu. Każde pole może mieć tylko jeden typ zdefiniowany w kolekcji projektów, zachęcając do używania typowych pól w różnych projektach i typach elementów roboczych.

Po dodaniu pola niestandardowego do dziedziczonego procesu, Azure DevOps przypisuje nazwę odwołania z prefiksem Custom i nazwą pola bez spacji. Na przykład dodanie pola o nazwie DevOps Triage powoduje wyświetlenie nazwy referencyjnej Custom.DevOpsTriage. Spacje nie są dozwolone w nazwach odwołań.

Aby uzyskać więcej informacji, zobacz Ograniczenia i konwencje nazewnictwa.

Jak określić typ danych pola?

Możesz wyświetlić typy danych pól zdefiniowanych dla Twojej organizacji, otwierając stronę Pola procesu.

Przeglądanie listy pól

Aby przejrzeć listę pól zdefiniowanych dla organizacji lub kolekcji, wykonaj następujące czynności:

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

   

2. Wybierz Proces.

   

3. Wybierz Pola.

   Pola wymienione odpowiadają wszystkim polam zdefiniowanym dla organizacji lub kolekcji, które obejmują wszystkie pola niestandardowe i pola zdefiniowane dla procesów systemowych.

   

   Uwaga

   Jeśli nie widzisz pola, kolekcja używa lokalnego procesu XML. Strona Pola nie jest obsługiwana dla tego procesu.

   Opisy, użycie i nazwy odwołań dla każdego pola można znaleźć w indeksie pola Element roboczy. Ponadto można pobrać nazwy odwołań do pól przy użyciu interfejsu API REST Work Item Types Field - List.

Eksplorator pól zadania roboczego

Używając narzędzia Eksplorator pól elementów roboczych, można przeglądać przypisania atrybutów pól.

Aby uzyskać dostęp do Eksploratora pól elementu roboczego, zainstaluj narzędzie Edytor procesów. Na podstawie zainstalowanej wersji programu Visual Studio pobierz narzędzie edytora procesów z jednego z następujących rozszerzeń.

• Program Visual Studio 2019 i 2022: aktualnie nie ma dostępnego rozszerzenia edytora szablonów procesowych. Można jednak nadal dostosowywać szablony procesów przy użyciu innych narzędzi, takich jak dowolny edytor tekstów lub edytor XML. Możesz również użyć portalu internetowego usługi Azure DevOps w celu dostosowania, szczególnie w przypadku procesów dziedziczynych.
• 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 niezmienialnych 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 pobierasz je za pośrednictwem interfejsu API REST — Pobierz, czy wyświetlasz je za pomocą narzędzia Eksplorator pól elementów roboczych (WIFE).

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 znaleźć nazwę referencyjną pola, zobacz Indeks pól elementów roboczych.

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: ID

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 niedostępnych pól to te, które są ustawiane przez system, takie jak ID, Rewizja, Utworzone przez i Zmienione przez.
Czy można zmienić?=Nie

REST: isIdentity
ŻONA: IsIdentity

boolean

Wskazuje, czy to pole jest polem Identity. 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 w przypadku pól przypisanych do typu danych PlainText, HTML lub History.
Czy można zmienić?=Nie

REST: isPicklist² ŻONA:

Boolean

Wskazuje, czy pole jest skojarzone z listą wyboru. Wartość jest ustawiona na True, gdy zdefiniowane jest pole niestandardowe dla Azure DevOps i wybrany jest typ Lista wyboru (ciąg) lub Lista wyboru (liczba całkowita). Wartość jest ustawiona na Fałsz dla dziedziczonych pól, które definiują listy wyboru.
Czy można zmienić?=Nie

REST: isPicklistSuggested² ŻONA:

Typ logiczny

Wskazuje, czy pole umożliwia użytkownikom wprowadzanie własnych wartości dla listy wyboru. Wartość jest ustawiona na True, gdy pole niestandardowe jest zdefiniowane dla platformy Azure DevOps, gdy wybrano typ Listy wyboru (String) lub Listy wyboru (Integer), oraz gdy zaznaczono pole wyboru Zezwalaj użytkownikom na ustawianie własnych wartości.
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 (Tak), czy też nie (Nie). Większość pól jest zapytaniowa.
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ści.
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 lokalnie

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, gdy pole niestandardowe jest zdefiniowane dla usługi Azure DevOps i wybrany jest typ Lista wyboru (ciąg) lub Lista wyboru (liczba całkowita).
Czy można zmienić?=Nie

REST:
ŻONA: ZabronioneWartości

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 lokalnie

REST: readOnly
ŻONA:

Wartość logiczna

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ę referencyjną 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 lokalnie

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³

ciąg znaków

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: obsługiwaneOperacje
Ż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

ciąg znaków

Określa typ danych pola, na przykład wartość logiczna, data/godzina, liczba całkowita, napis 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). Zastosowanie większości pól to WorkItem. Aby uzyskać pełną listę wartości użycia, odwołaj się do Get Fields, 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 pól listy

Aby wymienić atrybuty przypisane do pola, użyj interfejsu API REST Fields - Get. Zastąp ciąg OrganizationName rzeczywistą nazwą organizacji.

https://dev.azure.com/OrganizationName/_apis/wit/fields/FieldReferenceName

Aby wyświetlić atrybuty dla ścieżki iteracji, użyj nazwy odwołania System.IterationPath dla organizacji fabrikam.

https://dev.azure.com/fabrikam/_apis/wit/fields/System.IterationPath

**Returned data:**

> [!div class="tabbedCodeSnippets"]
> ```JSON
> {
> "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

• Zapoznaj się z Przewodnikiem szybkiego odniesienia do zapytań, aby szybko zrozumieć składnię i użycie zapytań.
• Zapoznaj się z indeksem pól elementu roboczego, aby wyświetlić wszystkie dostępne pola.
• Dodaj pola dla dziedziczonego procesu i zarządzaj nimi, aby dostosować pola zgodnie z wymaganiami dotyczącymi dziedziczonego procesu.
• Uzyskaj dostęp do dokumentacji metadanych dla usługi Azure Boards Analytics , aby poznać metadane analizy i możliwości raportowania.