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