Udostępnij za pośrednictwem


Modyfikowanie lub dodawanie pola do obsługi zapytań, raportów i przepływu pracy

Projekt zespołowy zawiera 100 lub więcej pól danych na podstawie szablonu procesu używanego do tworzenia projektu zespołu.Każde pole jest skojarzone z parą nazw, atrybutów i zasad.Można zmodyfikować istniejące pole lub dodać pole niestandardowe do obsługi śledzenia wymagań dodatkowych danych.Na przykład można dostosować listę pobrania w menu rozwijanym, dodać regułę do określenia wartości domyślnej lub ograniczyć wartość, jaką może ona przybrać lub zmienić atrybut pola.

Aby dodać reguły pól, dodać pole niestandardowe lub zmienić etykietę pola na formularzu elementu roboczego, należy edytować definicję XML dla tego typu elementu roboczego (WIT).Aby zmienić atrybutu pola lub zmienić nazwę pola, należy użyć witadmin Narzędzia wiersza polecenia.

Pole definicji nazwy, atrybuty i reguł

Dostosowywanie listy wyboru

Wybierz listy, które są wartościami wyliczonymi, które są wyświetlane w menu rozwijanym w postaci elementu roboczego i w kolumnie Wartość w edytorze zapytań.Metoda, która umożliwia dostosowywanie listy wyboru w zależności od typu pola.

Ciąg ogólny lub pola liczb całkowitych

Aby zmodyfikować listę pobrania dla większości ciągów lub pól liczb całkowitych w obrębie formularza elementu roboczego, należy edytować definicję WIT.Na przykład aby dodać niestandardowe pole Rozdzielczość i listę pobrania, należy określić kod XML jak pokazano.



Niestandardowe pole i lista wyboru

Wybierz listę niestandardowe pola.
<FIELD name="Resolution" refname="MyCompany.Resolution" type="String">    
<ALLOWEDVALUES>
   <LISTITEM value="By Design" />
   <LISTITEM value="Duplicate" />
   <LISTITEM value="External" />
   <LISTITEM value="Fixed" />
   <LISTITEM value="Not Repro" />
   <LISTITEM value="Postponed" />
   <LISTITEM value="Won’t Fix" />
</ALLOWEDVALUES>
</FIELD>

Reguły obsługują łączenie list, ograniczanie, do kogo stosuje się listę i ustawianie warunków na to, kiedy pojawi się lista w formularzu elementu roboczego.Zasady kontroli, czy Lista dystrybucji podzielonego do wyświetlania jego poszczególne elementy Członkowskie lub lista jest filtrowana przy użyciu opcjonalnego expanditems i filteritems atrybutów.Użyj globalnej listy, aby zminimalizować nakład pracy wymagany do zaktualizowania listy, która jest współużytkowana przez WIT lub projekty zespołów.

Aby dowiedzieć się więcej, zobacz Definiowanie list wyboru i Definiowanie list globalnych.

Określonych pól, w których pobranie listy są definiowane w inny sposób

Aby zmodyfikować listy pobrania w następujących polach, zapoznaj się z tematem odpowiednie właściwości:

Dla wszystkich innych pól, które mają pobranie listy skojarzone z them─such jako działania, Stan automatyzacji, dziedziny, priorytet, oraz others─you można wyszukiwać definicje te pola z indeks pola elementów roboczych.

Dodawanie reguł do pola

Edytuj definicję WIT, aby dodać pole niestandardowe reguły do polaMożna ograniczyć zasady mające zastosowanie do określonych użytkowników lub grup.Większość reguł obsługuje atrybuty for lub not w celu podkreślenia, która reguła ma zastosowanie, a która nie.

Na przykład z następujący fragment kodu, mogą zostać wymuszone zasada czy tylko członkowie zespołu zarządzania, klient określona grupa TFS, można zmodyfikować pola rangę stosu, od momentu utworzenia elementu pracy.

<FIELD name="Stack Rank" refname="Microsoft.VSTS.Common.StackRank" type="Double" reportable="dimension">
   <FROZEN not="[project]\Management Team" />
   <HELPTEXT>Work first on items with lower-valued stack rank. Set in triage.</HELPTEXT>
</FIELD>

Reguły stosuje się do wykonywania następujących czynności:

Do wykonania tej akcji:

Użyj tego elementu XML:

Określ etykietkę narzędzia.

HELPTEXT

Określ wartość, jaką może mieć pole.

CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY, and REQUIRED

Skopiuj wartość lub określ wartość domyślną.

COPY, DEFAULT, i SERVERDEFAULT

Ogranicz liczbę osób, które mogą modyfikować pole.

VALIDUSER, for i not pola atrybutów reguły

Wymuś dopasowania na pola ciągu do wzorca.

MATCH

Warunkowe zastosowanie reguł na podstawie wartości w pozostałych polach.

WHEN, WHENNOT, WHENCHANGED, and WHENNOTCHANGED

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

Edytuj plik definicji WIT XML, aby dodać reguły lub dodaj pole niestandardowe

Aby dodać reguły lub pole niestandardowe, eksportuj, edytuj, a następnie importuj plik definicji WIT.

Proces dostosowywania obiekt WIT

Z witadmin, można importować i eksportować plików definicji.Inne można użyć narzędzia obejmują Edytor procesów, dostępnej za pomocą pobieranie TFS zaawansowanych narzędzi, lub Menedżera projektu zespołowego TFS, dostępny w witrynie CodePlex projekt zasobów społeczności.

Każde pole, którego chcesz użyć do śledzenia danych, musi być dodane do pliku definicji typu elementu roboczego.Dotyczy to wszystkich pól poza polami systemowymi (których nazwa odwołania rozpoczyna się od System.), które są automatycznie definiowane dla każdego WIT.

Aby dodać niestandardowe pole, edytować definicję ZEZWÓ do dodania FIELD elementu w obrębie FIELDS sekcji i Control elementu w obrębie FORM sekcji.

Aby dodać pole niestandardowe

  1. Jeśli użytkownik nie ma uprawnień administratora projektu dla projektu zespołowego je uzyskać.

  2. Otwórz okno wiersza polecenia, w którym jest zainstalowany program Visual Studio lub Team Explorer, a następnie wprowadź:

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

    W 64-bitowej wersji systemu Windows należy zastąpić % programfiles % elementem % programfiles(x86) %.Możesz Pobierz Team Explorer za darmo.

  3. Eksportowanie definicji WIT.

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"

    Przykładem CollectionURL jest http://fabrikamprime:8080/tfs/DefaultCollection.

  4. Zlokalizuj sekcję pliku XML, który definiuje pola typu i który zaczyna się od FIELDS.

  5. Dodaj element FIELD, który określa nazwę pola niestandardowego w celu dodania.Należy określić następujące wymagane atrybuty: przyjazna name, refname (nazwa odwołania) i type.Aby uzyskać więcej informacji, zobacz Element FIELD (Definition) — Odwołanie.

    Poniższy kod określa pole niestandardowe, żądającego, z nazwą odniesienia FabrikamFiber.MyTeam.Requestor i wskazuje listę dozwolonych wartości, z wartością domyślną klienta.

    <FIELD name="Requestor" refname="FabrikamFiber.MyTeam.Requestor" type="String" reportable="Dimension">
       <ALLOWEDVALUES>
          <LISTITEM value="Customer" />
          <LISTITEM value="Executive Management" />
          <LISTITEM value="Other" />
          <LISTITEM value="Support" />
          <LISTITEM value="Team" />
          <LISTITEM value="Technicians" />
          <DEFAULTVALUE value="Customer" />
        </ALLOWEDVALUES>
    </FIELD>
    
    PoradaPorada

    Elementy na liście zawsze są wyświetlane w porządku alfanumerycznym, bez względu na sposób wprowadzania w pliku XML definicji.

    Nazwa odwołania lub refname, jest nazwą programową dla pola.Wszystkie inne zasady powinny dotyczyć refname.Aby uzyskać więcej informacji, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów.

  6. Dodaj Control elementu w obrębie FORM sekcji tak, aby pole niestandardowe pojawia się w formularzu w grupie elementów, gdzie ma się pojawić.

    Na przykład poniższy fragment kodu dodaje pole Wnioskodawca do wyświetlenia poniżej pola Przyczyna w formularzu elementu roboczego.

    <Column PercentWidth="50">
       <Group Label="Status">
          <Column PercentWidth="100">
             <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assi&amp;gned To:" LabelPosition="Left" />
             <Control FieldName="System.State" Type="FieldControl" Label="&amp;State:" LabelPosition="Left" />
             <Control FieldName="System.Reason" Type="FieldControl" Label="Reason:" LabelPosition="Left" ReadOnly="True" />
             <Control FieldName="FabrikamFiber.MyTeam.Requestor" Type="FieldControl" Label="Requestor:" LabelPosition="Left" ReadOnly="True" />
          </Column>
       </Group>
    </Column>
    
    PoradaPorada

    Definicja schematu dla śledzenia elementów roboczych definiuje wszystkie elementy podrzędne elementu FORM jako elementy pisane łącznie i wszystkie inne elementy jako pisane samymi wielkimi literami.Jeśli wystąpiły błędy podczas sprawdzania poprawności plików definicji typów, sprawdź strukturę wielkości liter elementów.Również struktura znaczników otwierających i zamykających musi być zgodna z regułami składni XML.

    Aby uzyskać więcej informacji, zobacz Element formantu XML — Odwołanie.

  7. Zaimportuj plik definicji typu elementu roboczego.

    witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"

  8. Otwórz TWA lub Team Explorer, aby wyświetlić zmiany.Jeśli klient jest już otwarty, należy odświeżyć stronę.

    Poniższa ilustracja pokazuje, że formularza elementu pracy dla elementu zaległego produktu zawiera teraz nowe pole.

    Pole niestandardowe dodawane do definicji typu i formularza

Aby uzyskać więcej informacji o korzystaniu z witadmin, zobacz Importowanie i eksportowanie elementów pracy oraz zarządzanie nimi [witadmin].

Aby zmienić etykietę pola formularza elementu roboczego

  1. Eksportowanie pliku definicji WIT.

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"

  2. W FORM i Layout sekcje, Znajdź definicji pola, który chcesz zmodyfikować.W tym przykładzie modyfikuje etykietę Tytuł pola:

    <Column PercentWidth="70">
      <Control Type="FieldControl" FieldName="System.Title" Label="Title" LabelPosition="Left" />
    </Column>
    
  3. Zmień pola, aby portugalski tworzyć gałęzie office Praca nad tym projektem konkretnego zespołu może być odczytany przez nazwę etykiety Tytuł pól podczas pracy z formularza elementu pracy.Zawrzyj portugalskie słowo oznaczające tytuł (Titulo) w polu Tytuł.

    <Column PercentWidth="70">
      <Control Type="FieldControl" FieldName="System.Title" Label="Title (Título):" LabelPosition="Left" />
    </Column>
    
  4. Zaimportuj plik definicji typu elementu roboczego.

    witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"

Zmiana atrybutu istniejącego pola

Możesz użyć witadmin changefield do zmiany atrybutów istniejącego pola.Na przykład następujące polecenie zmienia przyjazną nazwę zdefiniowaną dla elementu MyCompany.Type na Metoda oceny.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.Type /name:"Evaluation Method"

Poniższa tabela zawiera podsumowanie atrybuty można zmienić za pomocą witadmin changefield.

Atrybut

Opis

Typ danych

Określa typ danych, który akceptuje pole.Ogólnie rzecz biorąc nie można zmienić typu danych pola po jego zdefiniowaniu.Można przełączyć typ danych pola tylko dla pól typu HTML lub PlainText.

Przyjazna nazwa

Przyjazna nazwa pojawia się w menu rozwijanych dla zapytań dotyczących elementów roboczych i musi być unikatowa dla wszystkich pól, które są zdefiniowane w kolekcji projektów zespołowych.Przyjazna nazwa może się różnić od etykiety formy, która pojawia się na formularzu elementu pracy.

Indeksowalne

Można włączyć indeksowanie w polu w celu poprawienia czasów odpowiedzi na zapytanie podczas filtrowania pola.Domyślnie indeksowane są następujące pola: Przypisane do, Data utworzenia, Zmienione przez, Stan, Przyczyna, Identyfikator obszaru, Identyfikator iteracji i Typ elementu roboczego.

Atrybuty raportowania

Można zmienić nazwę pola, jaka pojawia się w raporcie, nazwę odwołania raportu i typ raportowania.Można lokalizować raportujące przyjazne nazwy.

Typ raportowania określa, czy dane pola są zapisywane w relacyjnej hurtowni danych, czy zarówno w relacyjnej hurtowni danych, jak i module OLAP, albo czy ma zostać wygenerowana wstępnie obliczona suma wartości podczas przetwarzania modułu OLAP.

Pełna lista pól zgłoszeniu domyślne, zobacz Odwołanie pól do raportowania dla Visual Studio ALM.Aby uzyskać więcej informacji o module OLAP, zobacz Perspektywy i grupy pomiarowe udostępniane w Analysis Services Cube dla Visual Studio.

Synchronizacja

Można włączyć lub wyłączyć synchronizację z usługą Active Directory dla pól, które są skojarzone z kontami użytkowników.

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ę pobrań, dodać lub zmodyfikować ścieżek obszaru i iterację i Dodaj reguły do pola.Kreatora konfiguracji funkcji zaktualizuje swoje projekty zespołowe i uzyskasz dostęp do najnowszych funkcji.

Aby dowiedzieć się o innych dostosowań, który można bezpiecznie dokonać, które należy unikać, zobacz dostosować pracy śledzenia doświadczenie: przed można dostosować zrozumieć skutki konserwacji i aktualizacji.

Q: gdzie więcej informacji na temat wszystkich pól i pola atrybutów już zdefiniowany dla mojego projektu zespołowego?

ODP indeksu pól zdefiniowany w ramach procesu TFS domyślne szablony, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

Oprócz atrybutów, które mogą być zmieniane dla pola elementu roboczego, istnieje kilka niezmiennych i praktycznie ukrytych atrybutów dla każdego pola.Możesz przejrzeć zadania tych pól przy użyciu narzędzia eksploratora pola elementów roboczych.To narzędzie jest dostęp za pomocą narzędzia power Edytor procesów po zainstalowaniu TFS zaawansowanych narzędzi.

Eksplorator pola elementu roboczego

Eksplorator pól elementu pracy

Opis każdego z atrybutów, zobacz ten wpis: elementu roboczego pola atrybutów — użytkownik może i nie można zmienić.

P: Jak dodaje się pole obsługujące integrację z kontrolą testów, kompilacji i wersji?

ODP kilka WITs zawiera pola, które zawierają informacje, jest generowany przez procesy automatyczne, które integrują się z kontroli wersji Team Foundation tworzenia Microsoft Test Manager i Team Foundation.Dodać jedno z pól do swojego WITs niestandardowe, możesz edytować definicję ZEZWÓ zgodnie z krokami opisane wcześniej w tym temacie.

Na przykład można dodać pola Znaleziono w i Zintegrowane w kompilacji, które są wyświetlane w definicjach typów dla błędów.Te pola kojarzą usterki z kompilacjami, w których zostały odnalezione lub naprawione.Można użyć poniższego wycinka kodu, aby dodać te pola do definicji typów elementów roboczych.

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
</FIELD>
<FIELD name="Integration Build" refname="Microsoft.VSTS.Build.IntegrationBuild" type="String" reportable="dimension">
    <HELPTEXT>Product build number this bug was fixed in</HELPTEXT>
</FIELD>

Aby uzyskać więcej informacji, zobacz Pola obsługujące integrację z testowaniem, kompilowaniem i kontrolą wersji.

P: Kiedy należy użyć globalnej listy zamiast prostej listy wyboru?

Odp.: Gdy lista jest używana w kilku typach elementów roboczych w kilku projektach zespołowych, utrzymywanie jej jako globalnej listy minimalizuje wymagania dotyczące konserwacji.Ponadto jeśli części listy muszą wyglądać inaczej w różnych typach elementów roboczych lub projektach zespołowych, można zdefiniować globalną listę dla części listy wyboru.Zobacz Definiowanie list wyboru i Definiowanie list globalnych.

Pyt są ich ograniczenia dotyczące modyfikowania pól systemu?

A: Tak.Nie można zmienić nazwy pól systemowych i nie można stosować do nich niektórych reguł.Na przykład nie można skopiować lub ustawić na puste pól używanych do śledzenia, kto utworzył, zmienił lub zamknął element roboczy ani pól daty i godziny używanych przez system.

Nazwy pól systemowych wszystkie zaczynają się prefiksem „System” (na przykład System.ID).Wszystkie pola systemowe są zdefiniowane dla wszystkich WIT, bez względu na to, czy uwzględni się je w definicji WIT, czy nie.Aby dowiedzieć się więcej na temat każdego pola, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

P: Czy istnieje sekwencja, w której reguły są oceniane?

Odp.: Tak, jednak kilka czynników wpływa na to, jak system przetwarza wiele reguł w taki sposób, że wynik końcowy nie zawsze jest w pełni znany od samego początku.Uzyskanie wstępnym oczekiwane zachowanie i kontakty, zobacz Zastosowanie reguły do pola elementu roboczego.

P: Jak należy nazwać pola, aby obsługiwały raportowanie?

O: Aby obsługiwać raportowanie, można dodawać pola lub zmieniać atrybuty istniejących pól.Podczas dodawania lub zmiany pól należy nazwać je systematycznie tak, aby można było odnaleźć je w module Analysis Services, ponieważ pola są logicznie pogrupowane w foldery.Aby dowiedzieć się więcej, zobacz Dodawanie i modyfikowanie pól elementów roboczych w celu obsługi raportowania.

Pyt.: czy istnieje sposób, aby ograniczyć liczbę nazw, które są widoczne w polu przypisany do?

A: Tak.Domyślnie menu rozwijane w polu Przypisane do wyświetla wszystkich użytkowników, którym udzielono dostępu do TFS.Jest to domyślna grupa uprawnionych użytkowników.Wyjątek do tej reguły jest w Team Web Access, menu kontekstowe, które obsługują przypisywanie elementów roboczych są ograniczone do członków zespołu.

Najbardziej wydajnym sposobem Zastosuj zabezpieczenia jest do tworzenia niestandardowych grup, które można zarządzać w systemie Windows lub w programie TFS.

  1. Utwórz grupę zabezpieczeń, której chcesz użyć, i dodaj konta do grupy.Na przykład utwórz nową grupę o nazwie Współautorzy w zespole.Zobacz Dodawanie użytkowników do zespołów i projektów.

  2. Zmodyfikuj plik definicji dla każdego typu elementu pracy, w którym ma zostać ograniczony zestaw użytkowników.Dodaj element VALIDUSER do definicji elementu FIELD dla Przypisane do pola, a następnie określ grupę TFS.

    Na przykład poniższa wstawka kodu może być dodana do definicji zadania, aby ograniczyć grupę użytkowników dla pola Przypisano do tylko członków zespołu dodanych do grupy zadaniowej zespołu TFS.

    <FIELD name="Assigned To" refname="System.AssignedTo" type="String" reportable="dimension" syncnamechanges="true">
       <HELPTEXT>The person currently working on this task</HELPTEXT>
       <ALLOWEXISTINGVALUE />
       <VALIDUSER group="Team Contributors" />
    </FIELD>
    

    Określając element ALLOWEXISTINGVALUE można uniknąć błędów sprawdzania poprawności, które w przeciwnym razie mogłyby nastąpić, w chwili gdy członkowie opuszczaliby zespół i nie byliby już zarejestrowanymi współautorami projektu.

P: Jak dodać niestandardowe formanty do pola?

ODP Using model obiektów do śledzenia elementów pracy, programistycznie tworzenia, zmiany i Znajdź usterek, zadań i innych WITs.Można również utworzyć niestandardowe formanty, które dodają funkcje do formularza elementu roboczego.

Na przykład można dodać następujące niestandardowe formanty, które są dostępne za pośrednictwem niestandardowe formanty do śledzenia elementów roboczych TFS projektu w witrynie CodePlex:

  • Zrzut ekranu formant, który umożliwia operację kopiowania i wklejania obrazów do pola HTML.

  • Formant przeglądarki sieci Web, który umożliwia użytkownikowi hostowanie strony w Internecie i przekazywanie wartości pól do tej strony.

  • Wielowartościowy formant, który obsługuje wprowadzanie wielu wartości dla pola przez pokazanie listy pól wyboru.

P: Jak zmienić mapowania pól, które obsługują integrację Projekt - TFS?

ODP projektów zespołowych utworzone na podstawie domyślny szablon procesu TFS obejmują domyślny plik mapowania projektu firmy Microsoft.Korzystając z programu Project do planowania i śledzenia elementów roboczych przechowywanych w TFS, konieczne może okazać się mapowanie dodatkowych pól Projektu lub zmiana sposobu opublikowania i odświeżania pola TFS.Można to zrobić Dostosowywanie pliku mapowania projektu Microsoft.

Aby dowiedzieć się więcej o korzystaniu z elementów roboczych TFS projektu, zobacz Tworzenie zaległości i zadań za pomocą programu Project.

Q: najlepszy sposób, aby zarządzać dużą liczbę pól niestandardowych co to jest?

ODP Jeśli musisz dodać dużą liczbę pól niestandardowych, które będą używane w kilku WITs lub kilka projektów zespołu, użyj globalnego przepływu pracy.Można uprościć czynności konserwacji poprzez zachowanie globalnego zestawu pól i list pobrania za pomocą globalnego przepływu pracy.Zobacz Globalny przepływ elementów XML — Odwołanie.

P: Jak mam usunąć pole?

ODP po usunięciu pola z określonego typu elementu roboczego tego pola nie jest usuwany z kolekcji lub serwer bazy danych, nawet jeśli nie odwołuje się żadnych ZEZWÓ.Aby usunąć pole, wykonaj następujące kroki.

  1. Usuń FIELD definicji ze wszystkich definicji ZEZWÓ i globalnych przepływów pracy, które odwołują się do jej.

  2. Sprawdź, czy pole nie jest używane.Na przykład:

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomContact
    
    Field: MyCompany.CustomContact
    Name: Custom Contact
    Type: String
    Reportable As: dimension
    Use: Not In Use
    Indexed: False
    
  3. Usuń pole.Na przykład:

    witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomContact
    
  4. Jeśli usunięte pole zostało zgłoszeniu, odbudowy hurtowni danych może usunąć starego pola i jego wartości.

Aby uzyskać więcej informacji, zobacz Zarządzanie polami elementów pracy [witadmin].

P: Jakie inne obszary można dostosować?

ODP zobacz Kompleksowy przegląd wszystkich opcji konfiguracji i dostosowania dostępnych w programie Visual Studio TFS.

P: Do kogo mogę się zwrócić, aby uzyskać dodatkowe informacje?

ODP można uzyskać odpowiedzi lub zadać pytanie, odwiedź forum: programu Team Foundation Server — Zarządzanie projektami & elementu roboczego.