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 elementu roboczego

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

Wymagania wstępne

Uprawnienia: aby wyświetlić pola zdefiniowane dla organizacji lub kolekcji, 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, 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 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 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.

Opisy i użycie każdego pola zdefiniowanego dla podstawowych procesów systemowych — Agile, Basic, Scrum i CMMI — zapoznaj się z indeksem pola Element roboczy.

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ą zawierać spacji wiodących ani końcowych ani zawierać co najmniej dwóch 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ą zawierać 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 usługa Azure DevOps przypisuje nazwę odwołania poprzedzoną prefiksem Niestandardowy, a następnie 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?

Typ danych pól zdefiniowanych dla organizacji można wyświetlić, 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 w tym procesie.

   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 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, 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: obecnie nie ma dostępnego rozszerzenia Edytora szablonów procesu. 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 interfejs API REST, czy wyświetlasz je za pomocą narzędzia Eksplorator 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 Element roboczy.

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 niezwiązanych pól 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:

Wartość logiczna

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:

Wartość logiczna

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 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 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 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ę 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 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³

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. Zastąp ciąg OrganizationName rzeczywistą nazwą organizacji.

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

Aby na przykład wyświetlić listę atrybutów ścieżki iteracji, użyj nazwy System.IterationPath odwołania dla fabrikam organizacji:

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

• Aby szybko zrozumieć składnię i użycie zapytań, zapoznaj się z przewodnikiem Szybki dostęp do zapytania.
• Zapoznaj się z indeksem pola Elementu roboczego, aby wyświetlić wszystkie dostępne pola elementu roboczego.
• 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.