Udostępnij za pośrednictwem


Konwencje nazewnictwa obiektów śledzenia elementów pracy

W Visual Studio Team Foundation Server (TFS), wszystkie prace śledzenia zapasu obiekty są skojarzone z jedną lub więcej nazw.Większość ma wyświetlane przyjaznej nazwy i wszystkie, z wyjątkiem typy elementów roboczych i wyświetla globalne, są skojarzone z nazwy odwołania.Przyjazna nazwa jest identyfikatorem unikatowy, użytkownika widoczne dla pola.Przy użyciu przyjaznej nazwy zapewnić spójność we wszystkich projektów zespołowych i pracy typy elementów w kolekcji projektów.TFS jest używana wewnętrznie Nazwa odwołania i nie można go zmienić po zostało zdefiniowane.

Poniższa tabela zawiera podsumowanie wymaganiami dotyczącymi nazw, które muszą być spełnione dla każdego elementu roboczego śledzenia obiektu.

Obiekt śledzenia elementu pracy

Nazwa odwołania

Przyjazna nazwa

Typ elementu pracy

Nie dotyczy

Nazwa każdego typu elementu roboczego może zawierać do 255 znaków Unicode i musi być unikatowy w obrębie projektu zespołowego.

Pole elementu pracy

Parametr wymagany.Zobacz odwołania wymagania nazwa.

Pole nazwy może być do 128 znaków Unicode i musi być unikatowy w obrębie zbioru projektu zespołowego.

Typ łącza

Parametr wymagany.Zobacz odwołania wymagania nazwa.

Zdefiniuj dwie przyjaznej nazwy dla każdego typu łącze: Nazwa do przodu i wstecznego.Te nazwy może być do 128 znaków Unicode i musi być unikatowa dla wszystkich typów łącza zdefiniowane dla kolekcji projektu zespołowego.

Kategoria

Parametr wymagany.Zobacz odwołania wymagania nazwa.

Przyjazne nazwy kategorii może być do 128 znaków Unicode i musi być unikatowy w obrębie projektu zespołowego.

Lista globalne

Nie dotyczy

Nazwa każdej listy globalnych może zawierać maksymalnie 254 znaków Unicode i musi być unikatowy w obrębie zbioru projektu zespołowego.

Przyjazna nazwa wymagania

Oprócz wymagań podsumowywania w tabeli wcześniej wymienione w tym temacie przyjaznej nazwy, które można zdefiniować powinny spełniać następujące wymagania:

  • Nazwy nie może być pusta.

  • Nazwy nie mogą mieć początku lub na końcu znaków odstępu.

  • Nazwy nie mogą zawierać odwróconej (\).

  • Nazwa pola nie może zawierać następujących znaków: odwróconej (\), kropki (.) i otwarcie i zamknięcie kwadratowe nawiasy kwadratowe ([]).

  • Nazwy nie mogą zawierać dwóch lub więcej kolejnych znaków odstępu.

Wymagania dotyczące Nazwa odwołania

Zdefiniuj nazwę odwołania przy dodawaniu lub utworzyć pola elementów roboczych, typ łącza lub kategorii.Wszystkie nazwy odwołania może mieć do 70 Unicode znaków.

Nazwa odwołania można określić przy użyciu znaki alfanumeryczne, znaki podkreślenia i znaki łącznika.Nazwa odwołania do każdego musi zawierać co najmniej jednego okresu (.), ale nie okres mogą pojawiać się na początku lub na końcu nazwy.Nazwa odwołania nie można uruchomić z liczbą lub podkreśleniem, a nie może mieć wiele kolejnych łączniki, takich jak (-).

Pole nazwy odwołania i mobilność

Język definicji typu elementu roboczego zawiera koncepcję Nazwa odwołania do pola.Może pomóc pole nazwy odwołania do definicji port między Team Foundation kolekcje projektu i umożliwia także integracji osób trzecich do wyszukiwania i odnoszą się do określonych pól.Te nazwy są globalnie unikatowy, podobnie jak globalnie unikatowy nazw w aplikacji .NET Framework.

Nie można zmienić pole nazwy odwołania.Jeśli na przykład zmiany nazwy pola "Tytuł" do "Nagłówek" Nazwa odwołania pola tego pola nie zmienia się.Integracji i wewnętrznej reprezentacji pól należy używać Nazwa odwołania pola zamiast w zależności od tego samego nazwę pola.

Przestrzeń nazw systemu służy tylko do definiowania podstawowe wszystkie pola systemowe, które są wymagane dla Team Foundation funkcje systemu.Team Foundation Serveruniemożliwia tworzenie pola System.X, ponieważ może ona utrudniać Team Foundation Server funkcji.

Przestrzeń nazw firmy Microsoft jest używana do definiowania pól śledzenia elementów pracy.Pola te są definiowane w definicji typu elementu roboczego szablony procesów TFS.TFS uniemożliwia tworzenie pola Microsoft.X.Jednak metoda ta jest zalecane, ponieważ może ona utrudniać Team Foundation Server funkcje TFS lub przez Kreatora konfiguracji funkcji pomyślnie zaktualizować zespół projektu po uaktualnieniu TFS.

Klientów i partnerów można tworzyć własne nazw pól dla typów elementów roboczych niestandardowych.

Opisy pól system i zdefiniowane w szablony procesów TFS, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

Przykłady nazw pól odniesienia

Poniższe przykłady pokazują poprawne pola nazwy odwołania, w różnych obszarach nazw.

Przykłady nazw systemu

System.Id

System.Title

System.CreatedBy

System.CreationDate

System.ChangedBy

System.ChangedDate

System.State

System.Reason

Przykłady nazw firmy Microsoft

Microsoft.Common.Status

Microsoft.Common.Priority

Microsoft.Scheduling.Duration

Microsoft.Scheduling.PercentComplete

Microsoft.Testing.TestCaseName

Przykłady w inne obszary nazw

Klientów i partnerów można również definiować własne obszary nazw do obsługi ich typy elementów roboczych niestandardowych.Na przykład fikcyjne firmy Trey Research zdefiniować następujące typy elementu pracy niestandardowe:

TreyResearch.Common.Severity

TreyResearch.Common.Phase

TreyResearch.RiskManagement.RiskType

TreyResearch.RiskManagement.Resolution

Fikcyjne oprogramowania firmy A.Odniesienia Corporation może zdefiniować następujące typy elementu pracy:

A_Datum.common.BusinessPriority

A_Datum.Bug.FoundInPhase

A_Datum.Bug.FixInPhase

Zobacz też

Informacje

Element FIELD (Definition) — Odwołanie

Koncepcje

Dostosowywanie obiektów śledzenia elementów pracy, aby wspierać procesy zespołu