Zarządzanie polami elementów pracy

Artykuł
06/09/2015

Można zarządzać pola typu elementów roboczych, zdefiniowane dla kolekcji projektów zespołowych przy użyciu następujących witadmin polecenia:

changefield: Zmienia atrybuty co najmniej jednego pola.Jeśli wprowadzisz zmiany w jednym z następujących atrybutów, zmiany dla wszystkich typów elementów roboczych i projektów zespołowych w kolekcji projektów zespołowych:

Typ danych dla PlainText lub HTML pól.

Ważne
Po uaktualnieniu Team Foundation Server ze starszej wersji do bieżącej wersji, typ przydziału dla opis pola (System.Description) jest automatycznie przekonwertować z PlainText do HTML.Z changefield polecenia, można przywrócić zawartość tego pola do wyświetlenia jako zwykły tekst.

Przyjazna nazwa wyświetlający w zapytania o elementy robocze.Ta nazwa może różnić się od wyświetlanej w formularzu elementu pracy.
Raportowanie atrybutów zawierające nazwę pola, jak w raporcie, Nazwa odwołania do raportu i typ raportowania.
Synchronizacja z usługą Active Directory — użytkownik może Włącz/Wyłącz synchronizacji pól Nazwa osoby.

deletefield: Usuwa określone pole.
indexfield: Przechodzi w stan indeksowania lub wyłączyć dla określonego pola.Po włączeniu indeksowania dla pola, może zwiększyć wydajność znajdowanie elementów pracy, w których zapytania Określ tego pola.Po dodaniu pola niestandardowego, którego można używać w wielu kwerend elementów roboczych, można włączyć indeksowanie dla tego pola.
listfields: Wyświetla atrybuty dla określonego pola lub wszystkie pola.

Aby uruchomić witadmin wiersza polecenia narzędzie, Otwórz okno poleceń gdzie albo Visual Studio lub Team Explorer jest zainstalowany, a następnie wprowadź:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

W przypadku 32-bitowej wersji systemu Windows, zastępuje %programfiles(x86)% z %programfiles%.

Omówienie pól zdefiniowane w obrębie domyślnych szablonów procesu dołączonym do Team Foundation Server, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

[!UWAGA]

Można tworzyć i modyfikować pola elementów roboczych za pomocą edytora procesu, narzędzie power dla Visual Studio.To narzędzie nie jest obsługiwany.Aby uzyskać więcej informacji, zobacz następujące strony w witrynie sieci Web firmy Microsoft: Team Foundation Server zaawansowanych narzędzi.

Wymagania

Do tworzenia listy pól, musisz mieć swoją wyświetlić informacje dotyczące projektu uprawnienia do projektu zespołowego w kolekcji o wartości Zezwalaj.
Aby usunąć lub zmień nazwę pola lub zmienić atrybutu pola, musi być członkiem Administratorzy programu Team Foundation grupy zabezpieczeń lub administratorów kolekcji projektów grupy zabezpieczeń.

Aby uzyskać więcej informacji, zobacz Uprawnienia serwera programu Team Foundation Server i Domyślne grupy, uprawnienia i role serwera TFS [przekierowanie].

[!UWAGA]

Nawet wtedy, gdy użytkownik loguje się z uprawnieniami administracyjnymi, należy otworzyć okno wiersza polecenia z podniesionymi uprawnieniami do wykonania tej funkcji na serwerze, na którym działa Windows Server 2008.Aby otworzyć okno Wiersz polecenia z podwyższonym poziomem uprawnień, wybierz polecenie Start, otwórz wiersza polecenia menu skrótów, a następnie wybierz Uruchom jako Administrator.Aby uzyskać więcej informacji, zobacz witrynę sieci Web firmy Microsoft: kontroli dostępu użytkownika.

witadmin changefield /collection:CollectionURL /n:RefName    [/name:NewName]     [/syncnamechanges:true | false]    [/reportingname:ReportingName]     [/reportingrefname:ReportingRefName]    [/reportingtype:Type]    [/reportingformula:Formula]    [/type:PlainText | HTML]    [/noprompt]

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]

witadmin indexfield /collection:CollectionURL /n:Name /index:on|off 

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

Parametry

Parametr	Opis
/collection:CollectionURL	Określa identyfikator URI kolekcji projektów zespołowych.Format identyfikatora URI jest następująca: http://nazwa_serwera: port/NazwaKataloguWirtualnego/CollectionName Jeśli katalog wirtualny nie jest używany, format identyfikatora URI jest następująca: http://Nazwa_serwera: port / CollectionName
/n:RefName /n:Name	Nazwa odwołania pola typu elementu roboczego.
/index	Określa, że należy włączyć lub wyłączyć funkcję indeksowania dla określonego pola.Określ on umożliwiające indeksowanie i off wyłączyć indeksowanie.
/name:NewName	Określa nową nazwę dla pola.
/syncnamechanges	Określa pole elementu pracy do przechowywania nazwy i aby zaktualizować zmiany w usłudze Active Directory lub grupy roboczej.Ta opcja jest prawidłowa tylko wtedy, gdy pole o typie danych ciągu jest określone dla typename. Określ true Włącz synchronizację dla pola danych, ustaw false Aby wyłączyć synchronizację dla pola danych.
/reportingname:ReportingName	Określa nazwę pola w magazynie danych, który ma być używany do raportowania.
/reportingrefname:ReportingRefName	Nazwa odwołania pola w magazynie danych, który ma być używany do raportowania.
/reportingtype:Type	Określa, jak to pole jest używane w magazynu dla usługi raportowania.Następujące wartości są prawidłowe: dimension:Używany w przypadku pól Liczba całkowita, ciąg lub wartość daty/godziny. detail:Używany w przypadku pól Liczba całkowita, Podwójna, ciąg lub wartość daty/godziny. measure:Używana do liczby całkowitej i podwójne pola.Domyślny typ agregacji to suma.Można określić inny typ agregacji przy użyciu formula parametru. none:Umożliwia wyłączenie reportability w polu. Aby uzyskać więcej informacji, zobacz Definiowanie i modyfikowanie pól elementu roboczego.
/reportingformula:Formula	Określa formuła agregacji, który ma być używany, gdy pole jest raportowana jako measure.Jest obsługiwane tylko formuła sum.
/type:HTML \| PlainText	Określa można przekonwertować wartości pola z PlainText do HTML lub HTML do PlainText.Można określić tę opcję tylko w przypadku pól, których typ przydziału jest PlainText lub HTML.Zobacz Element FIELD (Definition) — Odwołanie.
/unused	Wyświetla wszystkie pola, które nie są używane przez dowolnego projektu zespołowego zdefiniowane w kolekcji projektów zespołowych.
/noprompt	Wyłącza monit o potwierdzenie.
/?or help	Wyświetla Pomoc dotyczącą polecenia w oknie wiersza polecenia.

Uwagi

Pola indeksowane

Indeks kwerendy jest tworzony oparte na na te pola, które mają indeksowania włączone.Ten indeks poprawia czas odpowiedzi podczas wykonywania kwerend zawierających indeksowane pól.

Domyślnie indeksowane są następujące pola: Przypisane do, Data utworzenia, Zmienione przez, Stan, Przyczyna, Identyfikator obszaru, Identyfikator iteracji i Typ elementu roboczego.Jeśli istnieją inne pola w ich kwerend często używane przez zespół, możesz dodać je do indeksu zapytania.

Synchronizowanie nazwiska osób z usługi Active Directory

Należy ręcznie Włącz synchronizację wszelkie niestandardowe pola elementów roboczych, które są używane do przypisywania nazwiska osób, które odwołują się do usługi Active Directory.Należy włączyć synchronizacji dla każdego pola dla każdej kolekcji projektów zespołowych zawierającego pola niestandardowe.

Wszystkie pola odwołania system pokazujące nazwiska osób mają atrybut syncnamechanges ustawioną true. Takie pola zawierają System.AuthorizedAs, System.AssignedTo, System.ChangedBy i System.CreatedBy. Synchronizacja w włączone dla każdego pola Nazwa osoby, zdefiniowany w ramach jednej z domyślnych szablonów procesu.Aby uzyskać więcej informacji, zobacz Zadania i odwołanie do pola przepływu pracy.

Po włączeniu synchronizacji, to pole nie jest już zawiera statyczny ciąg.Zamiast tego pola zawiera nazwę skojarzoną z kontem użytkownika.Po zmianie nazwy użytkownika w usłudze Active Directory lub grupy roboczej, pole z syncnamechanges ustawioną true Nowa nazwa wyświetlana jest automatycznie.

Po przypisaniu syncnamechanges atrybut do pola ciągu, zawsze pole akceptuje prawidłowych nazw użytkownika.Jednak pole nie zezwalać na nazwy grup, które są przechowywane w Team Foundation Server lub w usłudze Active Directory, jeśli jest jednym z następujących warunków true:

Reguła VALIDUSER jest określona przez wszystkie typy elementów pracy
Reguła VALIDUSER jest określona dla typu elementu roboczego
Zasada ALLOWEDVALUES jest określona dla typu elementu roboczego i tej reguły ma kryteria filtrowania, które wyklucza grup

Aby uzyskać więcej informacji, zobacz Wszystkie elementy XML All FIELD — Odwołanie.

Atrybuty można zmienić dla każdego typu elementu roboczego

Możesz zmienić następujące atrybuty i wartości zdefiniowany dla pola, zmieniając definicji typu elementu pracy, w którym pojawi się pole:

Nazwa wyświetlający na formularzu elementu pracy.Zobacz Element formantu XML — Odwołanie.
Tekst pomocy.Zobacz Definiowanie tekstu pomocy w formularzu elementu roboczego [przekierowanie].
Dozwolone wartości lub elementy na liście pobrania lub w menu rozwijanym.Zobacz Dostosowywanie listy wyboru (menu rozwijane) (przekierowane).

Przykłady

Jeśli nie podano inaczej, w każdym przykładzie są stosowane następujące wartości:

Identyfikator URI dla kolekcji projektów zespołowych: DefaultCollection-http://AdventureWorksServer:8080/tfs
Nazwa pola elementu roboczego: AdventureWorks.Field
Domyślnym kodowaniem: UTF-8

Lista pól

Użyj witadmin listfields wyświetlić zestaw pól w użyciu, aby wybrać jeden do dodania do typu elementu roboczego.Można również, listy przypisań atrybutów zdefiniowane dla określonego pola i określania pola, które są używane przez które projektów zespołowych.

Wyświetl atrybuty pola elementu pracy

Wpisz następujące polecenie, aby wyświetlić listę atrybutów zdefiniowane dla określonego pola, takie jak Microsoft.VSTS.Common.Issue.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue
```
Atrybuty i pola są wyświetlane informacje nazwanego pola, jak pokazano w tym przykładzie.
```
Field: Microsoft.VSTS.Common.Issue
Name: Issue
Type: String
Reportable As: dimension
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)
Indexed: False
```
Użyj parametru wskazuje nazwę każdego projektu i typu elementu roboczego, gdy to pole jest używane.Aby uzyskać więcej informacji dotyczących pola atrybutów, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

Lista wszystkich pól w kolekcji projektów zespołowych

Wpisz następujące polecenie, aby wyświetlić listę wszystkich pól zdefiniowane dla kolekcji projektów zespołowych.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
```
Pojawi się pole informacji dla wszystkich pól dla kolekcji projektów nazwanych.Zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

Pola listy, które nie są używane

Wpisz następujące polecenie, aby wyświetlić listę pól, które są już używane w kolekcji projektów zespołowych przez dowolnego typu elementu roboczego.

witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /unused

Atrybuty i pola są wyświetlane informacje dla każdego pola, który nie jest używany, jak pokazano w tym przykładzie.

Field: Microsoft.VSTS.CMMI.TaskType
Name: Task Type
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Field: Microsoft.VSTSUE.Common.Flag
Name: Flag
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Field: Microsoft.VSTSUE.Common.Progress
Name: Progress
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Zmień nazwę pola

Możesz zmienić przyjazną nazwę pola elementu pracy do spełniać konwencje nazewnictwa używane przez zespół.Należy zauważyć, że nowa nazwa jest stosowane do wszystkie typy elementów pracy, które odwołują się do pola zmienione w wszystkich projektów zespołowych w kolekcji projektów.Przyjazna nazwa wyświetlana podczas definiowania kryteria filtrowania w zapytania o elementy robocze.Nazwa wyświetlana na formularzu elementu roboczego może być inne niż przyjaznej nazwy zdefiniowane dla tego pola.

Aby zmienić nazwę pola elementu pracy

Wpisz następujące polecenie, aby zmienić przyjazną nazwę przypisaną do Microsoft.VSTS.Common.Rank do ważnych rangę.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"

Potwierdzenie typu wiersz y , a następnie naciśnij klawisz ENTER.Zaczekaj, aż zostanie wyświetlony następujący komunikat:

Field renamed.

Aby sprawdzić zmiany importowane do tego pojedynczego projektu

In Team Explorer, choose Refresh.

Najnowsze aktualizacje są pobierane z serwera, który obejmuje zmiany wprowadzone tylko nazwę pola.Poczekaj kilka sekund odświeżania zakończyć.
Wybierz nową kwerendę do utworzenia zapytania.
Wybierz w edytorze zapytań kliknij tutaj, aby dodać klauzulę łącze, aby dodać wiersz, należy wybrać opcję puste pola komórkami, a w komórce, wpisz rangę.Następujący komunikat, który pojawi się powyżej listy wyników.Wskazuje pozycję nie można odnaleźć.

Uruchom zapytanie, aby wyświetlić wyniki zapytania. TF51005: Zapytanie odwołuje się do pola, który nie istnieje.Ten błąd jest spowodowany << rangę >>.
Usuń wartość Porządkuj od pola komórki, a następnie wpisz ważne rangę do komórki.
Wybierz <> w Operator komórki, a następnie wpisz 1 do wartość komórki.
On the Query toolbar, choose Run.
Otwórz menu skrótów dla każdego wiersza w wynikach i wybierz polecenie opcji kolumn.Scroll down in the Availablecolumns list.Należy zauważyć, że rangę pole nie jest już dostępny, ale ważne rangę pole jest obecny.
Wybierz ważne rangę w dostępne kolumny pole, a następnie wybierz > przycisk (Dodaj zaznaczone kolumny).Wybierz przycisk OK.

Zwróć uwagę, że przyjazną nazwę dla Microsoft.VSTS.Common.Rank została zmieniona z rangę na rangę ważne przez cały na liście konstruktora i wyniki zapytania.
Zamknij kwerendę.Wybierz nr po wyświetleniu monitu, aby zapisać kwerendę.
Utwórz nowy element roboczy zadania.Wybierz nowych elementów roboczych łącze, a następnie wybierz zadanie.

Ten element pracy jest tworzony z typu elementu roboczego, która zmieniła się i zaimportować.
Zwróć uwagę na to, w stan pole, które etykietę zmieniono nazwę pola, rangę, nie została zmieniona.Jest to spowodowane etykiety pól w formularzach elementu pracy do projektu zespołowego nadrzędnego zakresu i niezależne od po prostu określona nazwa pola całego serwera.

[!UWAGA]

Aby uzyskać więcej informacji na temat zmiany etykiety pól w formularzach elementu pracy, zobacz Zmienianie etykiety pola (przekierowane).
Zamknij nowe zadanie i wybrać nr po wyświetleniu monitu, aby zapisać elementu pracy.

Zmień raportu jako wartość pola.

Następujące polecenie Określa o parametrach typu pola daty/godziny AdventureWorks.CreatedOn do wymiaru.To pole danych przechodzi magazynu i baz danych usług Analysis Services, tak aby może służyć do filtrowania raportów.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.CreatedOn /reportingtype:dimension

Następujące polecenie określa możliwość typ pola podwójnym AdventureWorks.Field do pomiaru raportu.Wszelkie działania są agregowane przez sum.

witadmin reportfield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field /reportingtype:measure

Włącz synchronizację niestandardowe pola Nazwisko osoby

Następujące polecenie włącza synchronizację AW pola elementu pracy.Pola NazwaKlienta zdefiniowanych na potrzeby Collection1 na AdventureWorksServer.

Sprawdź typ danych pola, które ma zostać przekonwertowany

Sprawdź typ danych przypisany do pola, takie jak MyCompany.CustomerName, który chcesz synchronizować wprowadzając następujące polecenie:
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName
```

Włącz synchronizację

Aby włączyć synchronizacji dla pola o nazwie osoby, wpisz następujące polecenie, zastępując dane dotyczące argumentów, które są wyświetlane w tym miejscu:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true
```
Zostanie wyświetlony monit o potwierdzenie następujące:

This will change properties for field {0} on the Team Foundation Server.Do you want to continue?
Typ 0 potwierdzenie zmiany w tym polu lub 1 Aby anulować żądanie.

Jeśli żądanie zmiany zakończy się powodzeniem, zostanie wyświetlony następujący komunikat potwierdzający:

The field was updated.

Jeśli żądania zmiany nie powiedzie się, zostanie wyświetlony komunikat o błędzie.Najbardziej typowe błędy, które mogą być wprowadzone próbuje zmienić pole odwołania systemu lub próby zmiany w polu dane typu innego niż ciąg.Operacje te nie są obsługiwane.

Usuń pole

Przed usunięciem pola, należy sprawdzić, czy pole nie jest w użyciu.Jeśli pole jest w użyciu, należy najpierw usunąć pola z typy elementów roboczych, używające go przed usunięciem z kolekcji projektów zespołowych.Następujące polecenie usuwa pole AdventureWorks.Field z Collection1:

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field

Należy sprawdzić, czy pole nie jest w użyciu

Wpisz następujące polecenie, określając nazwę odwołania dla pola elementu pracy, takich jak MyCompany.MyProcess.MyField.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.MyProcess.MyField
```
Informacje wyświetlane dla pola, sprawdź, czy wartość dla Use jest "Not In Use" w następujący sposób w tym przykładzie.
```
Field: MyCompany.MyProcess.MyField
Name: MyField
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False
```
Jeśli Use pole wskazuje pole jest w użyciu, a następnie usunąć je z każdego typu elementu roboczego dla każdego projektu zespołowego, który znajduje się.Na przykład pole Microsoft.VSTS.TCM.SystemInfo wskazuje, że jest używany przez usterki i kodu usterką typy elementu pracy dla projektów cztery: Arroyo, pustynią, komputera ręcznego i sprężyny.
```
Field: Microsoft.VSTS.TCM.SystemInfo
Name: System Info
Type: Html
Reportable As: None
Use: Arroyo (Bug), Desert (Bug), Palm (Bug), Springs (Bug, Code Defect)
Indexed: False
```
Aby można było usunąć to pole, musisz usunąć go z każdego typu elementu pracy dla każdego projektu zespołowego, dla którego jest zdefiniowana na liście.Aby usunąć pole, zmodyfikować definicję typu elementu roboczego przez usunięcie FIELD i Control elementów, które zawierają nazwy odwołanie do pola.Zobacz Importowanie i eksportowanie elementów pracy oraz zarządzanie nimi [witadmin], Element FIELD (Definition) — Odwołanie i Element formantu XML — Odwołanie.

Usuwanie pola z kolekcji projektów zespołowych

Wpisz następujące polecenie, aby usunąć to pole MyCompany.MyProcess.MyField, a następnie wybierz Enter.
```
witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName
```
Wprowadź y monicie z potwierdzeniem wykonanie tej czynności.

Pytania i odpowiedzi

Pyt jakie dostosowania I wybierz i nadal korzystać z Kreatora konfiguracji funkcji można zaktualizować mojego projektu zespołowego, po uaktualnieniu TFS?

Odp można dodać niestandardowe pola, dostosować listę pobrania i Dodaj reguły do pola.Kreatora konfiguracji funkcji zaktualizuje swoje projekty zespołowe i uzyskasz dostęp do najnowszych funkcji.

Zmiana atrybutów pola nie jest zalecane.Aby dowiedzieć się więcej o które dostosowania można bezpiecznie dokonać oraz należy unikać, zobacz dostosować pracy śledzenia doświadczenie: przed można dostosować zrozumieć skutki konserwacji i aktualizacji.

Zobacz też

Koncepcje

Rozwiązywanie konfliktów dotyczących schematów, które pojawiają się w magazynie danych

Dodawanie i modyfikowanie pól elementów roboczych w celu obsługi raportowania

Odwołania pola elementu pracy dla Visual Studio ALM

Odwołanie pól do raportowania dla Visual Studio ALM

Inne zasoby

witAdmin: dostosowywanie obiektów i zarządzanie nimi w celu śledzenia elementów pracy

Udostępnij za pośrednictwem