Zarządzanie polami elementów pracy

Artykuł
03/22/2013

Można zarządzać w polach typu elementu pracy, które są zdefiniowane dla Kolekcja projektów zespołu przy użyciu następujących witadmin polecenia:

changefield: Zmienia się co najmniej jeden atrybut pola.Po zmianie jednego z następujących atrybutów, zmiana ta dotyczy wszystkich typów elementów pracy i projektów zespołów w obrębie Kolekcja projektów zespołu:

Typ danych dla PlainText lub HTML pól.

Ważne
Uaktualniając Team Foundation Server z wcześniejszej wersji na bieżącą wersję, typ przydziału dla Opis (System.Description), pole jest automatycznie konwertowana z PlainText do HTML.Z changefield polecenia, można przywrócić zawartość tego pola do wyświetlania zwykłego tekstu.

Przyjazna nazwa którym wyświetlane są w kwerendzie elementu pracy.Ta nazwa może różnić się od pozostałych wyświetlana w formularzu elementu pracy.
Zgłoszenie atrybutów który składa się z nazwy pola wyświetlaną w polu raportu, nazwa raportu odwołania i zgłoszeniu typu.
Synchronizacja z usługą Active Directory - można włączyć/wyłączyć synchronizację pola Imię i nazwisko osoby.

deletefield: Usuwa określone pole.
indexfield: Włącza indeksowania lub wyłączyć dla określonego pola.Po włączeniu, indeksowanie dla pola, może zwiększyć wydajność znajdowanie elementów pracy, w których kwerendy określenie tego pola.Jeśli dodasz pole niestandardowe używane w wielu kwerend elementu pracy, można włączyć indeksowanie dla tego pola.
listfields: Wyświetla listę atrybutów dla wszystkich pól lub określonego pola.

Aby uruchomić witadmin wiersza polecenia narzędzia, Otwórz okno wiersza polecenia gdzie albo Visual Studio lub Team Explorer jest zainstalowany i wprowadź:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

W 64-bitowych wersji systemu Windows, należy zastąpić %programfiles% z %programfiles(x86)%.

Omówienie pól zdefiniowanych w ramach procesu domyślnych szablonów dostarczonych z Team Foundation Server, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

[!UWAGA]

Można tworzyć i modyfikować pola elementu pracy przy użyciu edytora procesu, narzędzie zasilania do Visual Studio.To narzędzie nie jest obsługiwana.Aby uzyskać więcej informacji, zobacz następującą stronę w witrynie firmy Microsoft w sieci Web: Team Foundation Server narzędzia.

Wymagania

Aby wyświetlić listę pól, musisz mieć swój Widok informacji na poziomie projektu uprawnienie dla zespołu projektu w kolekcji ustawione na Zezwalaj na.
Aby usunąć lub zmienić nazwę pola lub zmiana atrybutu pola, musi być członkiem Team Foundation Administratorzy grupy zabezpieczeń lub Administratorzy zbioru projektu grupy zabezpieczeń.

Aby uzyskać więcej informacji, zobacz Team Foundation Uprawnienia serwera i Team Foundation Grupy domyślne serwera, uprawnień i ról.

[!UWAGA]

Nawet jeśli użytkownik zaloguje się z uprawnieniami administracyjnymi, należy otworzyć podniesionymi okna wiersza polecenia, aby wykonać tę funkcję na serwerze, na którym działa Windows Server 2008.Aby otworzyć podniesionymi okna wiersza polecenia, wybierz polecenie Start, otwórz wiersza polecenia menu skrótów, a następnie wybierz polecenie Uruchom jako Administrator.Aby uzyskać więcej informacji, odwiedź witrynę sieci Web firmy Microsoft: Kontrola 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 Kolekcja projektów zespołu.Format dla identyfikatora URI jest następująca: http://nazwa_serwera: port/NazwaKataloguWirtualnego/nazwa_kolekcji Jeśli katalog wirtualny nie jest używany, format dla identyfikatora URI jest następująca: http://Nazwa_serwera: port / nazwa_kolekcji
/n:RefName /n:Name	Nazwa odwołania pole Typ elementu pracy.
/index	Określa, aby włączyć lub wyłączyć indeksowanie dla tego pola.Określ on Aby włączyć indeksowanie i off do wyłączenie indeksowania.
/name:NewName	Określa nową nazwę dla pola.
/syncnamechanges	Określa, aby zastosować pole elementu pracy, do przechowywania nazw i 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ślony dla typename. Określ true Aby włączyć synchronizację dla pola danych, należy określić false Aby wyłączyć synchronizację dla pola danych.
/reportingname:ReportingName	Określa nazwę pola w magazynie danych do wykorzystania w sprawozdaniu.
/reportingrefname:ReportingRefName	Określa nazwę odwołania, pola w magazynie danych do wykorzystania w sprawozdaniu.
/reportingtype:Type	Określa, jak to pole jest używane w magazynie za zgłoszenie.Prawidłowe są następujące wartości: dimension:Używane dla pól Liczba całkowita, ciąg znaków lub data/godzina. detail:Używane dla pól Liczba całkowita, Double, ciąg znaków lub data/godzina. measure:Używane dla pól podwójne i liczba całkowita.Domyślny typ agregacji jest suma.Można określić inny typ agregacji, przy użyciu formula parametru. disable:Używany, aby wyłączyć reportability na polu. Aby uzyskać więcej informacji, zobacz Praca z polami elementu pracy.
/reportingformula:Formula	Określa formułę agregacji stosowaną, gdy pole zostanie zgłoszona jako measure.Jedynym obsługiwanym formuła jest sum.
/type:HTML \| PlainText	Określa, że należy przekonwertować zawartość tego pola z PlainText do HTML lub HTML do PlainText.Można określić tę opcję tylko dla pól, których przydział typu jest PlainText lub HTML.Zobacz Element pola (definicja).
/unused	Wyświetla listę wszystkich pól, które nie są używane przez każdego projektu zespołu zdefiniowane w Kolekcja projektów zespołu.
/noprompt	Wyłącza monitowanie o potwierdzenie.
/?or help	Wyświetla Pomoc na temat polecenia w oknie wiersza polecenia.

Uwagi

Pola indeksowane

Indeks kwerendy podstawie tworzony jest na tych pól, które mają indeksowania włączone.Indeks ten poprawia czas reakcji, kiedy wykonywania kwerend, które zawierają pola indeksowane.

Domyślnie następujące pola są zaindeksowane: przydzielone do, Data utworzenia, zmienione przez, Państwo, przyczyną identyfikator obszaru, identyfikator iteracji i typ pozycji roboczej.W przypadku innych pól, które często używane przez zespół w ich kwerend, można je dodać do indeksu kwerendy.

Synchronizowanie nazwiska osób z usługą Active Directory

Należy ręcznie włączyć synchronizację wszystkich pól elementu pracy niestandardowe, które są używane do przypisywania nazwiska osób, które odwołują się usługi Active Directory.Należy włączyć synchronizację dla każdego pola dla każdej kolekcji projektu zespołu, który zawiera pola niestandardowe.

Wszystkie pola Odwołanie systemu, które pokazują nazwiska osób mają atrybut syncnamechanges ustawiona na true. Takie się tu System.AuthorizedAs, System.AssignedTo, System.ChangedBy i System.CreatedBy. Synchronizacja w włączona dla każdego pola Nazwa osoby, która jest zdefiniowana w jednym z domyślnych szablonów procesów.Aby uzyskać więcej informacji, zobacz Zadania i odwołanie do pola przepływu pracy.

Po włączeniu synchronizacji, w polu nie jest już wyświetlana static string.Zamiast tego to pole zawiera nazwę skojarzonej z kontem użytkownika.Po zmianie nazwy użytkownika w usłudze Active Directory lub w grupie roboczej, pole z syncnamechanges ustawiona na true Nowa nazwa jest automatycznie wyświetlana.

Podczas przypisywania syncnamechanges atrybut z polem ciąg zawsze pole akceptuje poprawnych imion użytkowników.Jednak pole nie obsługuje nazw grup, które są przechowywane w Team Foundation Server lub w usłudze Active Directory, jeśli którykolwiek z następujących warunków jest true:

Reguła VALIDUSER jest określona przez wszystkie typy elementów pracy
Reguła VALIDUSER jest określona dla typu elementu pracy
Reguła ALLOWEDVALUES jest określona dla typu elementu pracy i tej zasady ma kryteria filtrowania, które nie obejmuje grupy

Aby uzyskać więcej informacji, zobacz Wszystkie odniesienia do elementów XML pola.

Atrybuty, można zmienić dla każdego typu elementu pracy

Możesz zmienić następujące atrybuty lub wartości zdefiniowane dla pola przez zmianę definicji typu elementu pracy, w której pojawia się pole:

Nazwa którym jest wyświetlana w formularzu pracy.Zobacz Odwołanie Element XML kontroli.
Tekst pomocy.Zobacz Definiowanie tekstu pomocy dla pola elementu pracy.
Dozwolone wartości lub elementów w polu listy wyboru lub w menu rozwijanym.Zobacz Definiowanie list użytkowników, list wyboru i list globalnych.

Przykłady

Chyba że ustalono inaczej w każdym przykładzie stosuje się następujące wartości:

Identyfikator URI dla Kolekcja projektów zespołu: http://AdventureWorksServer:8080/tfs/DefaultCollection
Nazwa pola elementu pracy: AdventureWorks.Field
Domyślne kodowanie: UTF-8

Pola listy

Użyj witadmin listfields Aby zobaczyć zestaw pól w użyciu, aby wybrać jedną, aby dodać do typ pozycji roboczej.Ponadto można wyświetlić listę przypisywania atrybutów zdefiniowanych dla określonego pola i określić pola, które są używane przez które projekty zespołu.

Wyświetlić atrybuty pola elementu pracy

Wprowadź następujące polecenie, aby wyświetlić listę atrybutów zdefiniowanych dla określonego pola, takie jak Microsoft.VSTS.Common.Issue.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue
```
Informacji o atrybutach i pole pojawia się dla pola o nazwie, jak pokazano w poniższym 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
```
Wykorzystania parametru wskazuje nazwę każdego projektu oraz typ pozycji roboczej, w przypadku gdy to pole jest używane.Aby uzyskać więcej informacji o atrybutach pola, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

Lista wszystkich pól w Kolekcja projektów zespołu

Wprowadź następujące polecenie, aby wyświetlić listę wszystkich pól zdefiniowanych dla Kolekcja projektów zespołu.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
```
Zostanie wyświetlone pole informacji dla wszystkich pól dla kolekcji o nazwie projektu.Zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

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

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

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

Informacji o atrybutach i pole pojawia się dla każdego pola, które nie jest używany, jak pokazano w poniższym 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

Zmiana nazwy pola

Można zmienić przyjazną nazwę pola elementu pracy, aby spełniać konwencje nazewnictwa, używane przez zespół.Należy zauważyć, że nową nazwę jest stosowane do wszystkich typów towarów pracy, odwołujące się do zmienionego pola we wszystkich projektach zespołu w kolekcji projektu.Przyjazna nazwa wyświetla podczas definiowania kryteriów filtru w kwerendzie elementu pracy.Nazwa wyświetlana na formularza elementu pracy może być inna niż przyjazną nazwę zdefiniowaną dla pola.

Aby zmienić nazwę pola elementu pracy

Wprowadź następujące polecenie, aby zmienić przyjazną nazwę przypisaną do Microsoft.VSTS.Common.Rank do rangi ważne.

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

Wpisz w wierszu potwierdzenie y i naciśnij klawisz ENTER.Poczekaj, aż zostanie wyświetlony następujący komunikat:

Field renamed.

Aby sprawdzić zmiany przywożone z jednym projektem

In Team Explorer, choose Refresh.

Najnowsze aktualizacje są pobierane z serwera, które obejmują zmiany, które po prostu się na nazwę pola.Odczekaj kilka sekund, aby zakończyć odświeżanie.
Wybierz polecenie Nowa kwerenda Aby utworzyć kwerendę.
W edytorze zapytań wybierz kliknij tutaj, aby dodać klauzulę łącze, aby dodać wiersz, wybierz opcję Pusta pola komórek, a w komórce, należy wpisać rangi.Następujący komunikat, który pojawi się powyżej listy wyników.Ten komunikat oznacza, że ranga nie można znaleźć.

Uruchom kwerendę, aby zobaczyć wyniki kwerendy. TF51005: Kwerenda odwołuje się do pola, który nie istnieje.Błąd jest spowodowany przez << ranga >>.
Usuń wartość Porządkuj od pola komórki, a następnie wpisz ważne rangi w komórce.
Wybierz < > w Operator komórki, a następnie wpisz 1 w wartość komórki.
Na kwerendy pasek narzędzi, wybierz polecenie uruchomić.
Otwórz menu skrótów dla każdego wiersza w wynikach i wybierz Opcje kolumna.Przewiń w dół dostępnekolumny listy. Należy zauważyć, że Ranga pole nie jest już obecny, ale Ranga ważne pole znajduje się.
Wybierz Ranga ważne w Dostępne kolumny pole, a następnie wybierz polecenie > przycisk (Dodaj zaznaczone kolumny).Wybierz przycisk OK.

Należy zauważyć, że przyjazną nazwę dla Microsoft.VSTS.Common.Rank została zmieniona z rangę do rangi ważne całej listy konstruktora i wyników kwerendy.
Zamknij kwerendę.Wybierz polecenie nr kiedy zostanie wyświetlony monit o zapisać kwerendę.
Utworzyć nowy element pracy zadania.Wybierz polecenie Nowe elementy pracy połączony, a następnie wybierz polecenie zadanie.

Tego elementu pracy jest tworzona z typ pozycji roboczej, który zmienił i przywożonych.
Okaże się, w stanu pole, którego etykietę dla pola o zmienionej nazwie, Ranga, nie zmienił się.To dlatego etykiety pól w formularzach elementu pracy są ograniczone do zespołu projektu nadrzędnego i są niezależne od tylko określona nazwa pola całego serwera.

[!UWAGA]

Aby uzyskać więcej informacji na temat sposobu zmieniania etykiety pól w formularzach elementu pracy, zobacz Zmiana etykiety na pole.
Zamknij nowe zadanie i wybierz polecenie nr kiedy zostanie wyświetlony monit o zapisywanie elementu pracy.

Zmienić raport jako wartość pola.

Następujące polecenie określa zdolność do przekazywania typ pola daty/godziny AdventureWorks.CreatedOn do wymiaru.To pole danych wprowadza magazynu i baz danych usług Analysis Services, dzięki czemu mogą być używane do filtrowania raportów.

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

Następujące polecenie określa zdolność do przekazywania typu Double pola AdventureWorks.Field do pomiaru.Wszelkie środki są łączone za pomocą sumy.

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

Włącz synchronizację niestandardowego pola Nazwisko osoby

Następujące polecenie włącza synchronizację dla AW pole elementu pracy.Wybrać pola NazwaKlienta zdefiniowane dla kolekcji1 na AdventureWorksServer.

Sprawdź typ danych pola, które chcesz przekonwertować

Sprawdź, czy typ danych przypisany do pola, na przykład MyCompany.CustomerName, który ma zostać zsynchronizowany, wpisując następujące polecenie:
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName
```

Włącz synchronizację

Aby włączyć synchronizację dla pola o nazwie osoba, należy wpisać następujące polecenie, zastępując dane dotyczące argumentów, które przedstawiono poniżej:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true
```
Wyświetlany jest następujący monit potwierdzenia:

This will change properties for field {0} on the Team Foundation Server.Do you want to continue?
Typ 0 o potwierdzenie, że chcesz zmienić wartości pola, lub 1 Aby anulować żądanie.

Jeśli żądanie zmiany kończy się powodzeniem, pojawi się następujący komunikat z potwierdzeniem:

The field was updated.

Jeśli żądanie zmiany kończy się niepowodzeniem, pojawia się komunikat o błędzie.Najczęściej popełnianych błędów, które mogą być dokonywane są próbuje zmienić pole odwołania systemu lub próbuje zmienić polem o typie danych innym niż ciąg.Operacje te nie są obsługiwane.

Usuwanie pola

Zanim usuniesz pole, należy sprawdzić, czy pole jest w użyciu.Jeśli pole jest używane, należy najpierw usunąć pole z typów elementów pracy, które go używają, przed usunięciem go z kolekcji zespołu projektu.Następujące polecenie usuwa pole AdventureWorks.Field z kolekcji1:

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

Sprawdź, czy pole nie jest używany

Wprowadź następujące polecenie, podając nazwę odniesienia, w polu Element pracy, na przykład 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" się następujące zmiany 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, czy pole jest używane, a następnie należy usunąć go z każdego typu elementu pracy dla każdego projektu zespołu, który ma na liście.Na przykład, pole Microsoft.VSTS.TCM.SystemInfo wskazuje, czy to jest używany przez typów elementów pracy błędów i wad kodu dla czterech projektów: Arroyo, pustynia, Palm 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
```
Można było usunąć to pole, musisz usunąć go z każdego typu elementu pracy wymienionych dla każdego zespołu projektu, dla którego został zdefiniowany.Aby usunąć pole, zmodyfikować definicję typ pozycji roboczej przez usunięcie FIELD i Control elementy, które zawierają nazwę pola odwołania.See Dostosowywanie typów elementów pracy i zarządzanie nimi [witadmin], Element pola (definicja), and Odwołanie Element XML kontroli.

Usuwanie pola z Kolekcja projektów zespołu

Wprowadź następujące polecenie, aby usunąć pole MyCompany.MyProcess.MyField, a następnie wybierz Enter.
```
witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName
```
Wprowadź y w wierszu potwierdzenia, aby wykonać ten krok.

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 pracy w celu obsługi raportowania

Odwołania pola elementu pracy dla Visual Studio ALM

Objętych obowiązkiem sprawozdawczym odniesienia pól dla programu Visual Studio Informatykami

Inne zasoby

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

Udostępnij za pośrednictwem