Zmiana sterowania łączami w taki sposób, aby ograniczyć relacje pomiędzy nimi

Można kontrolować, które elementy robocze łączą się wzajemnie poprzez dostosowanie formularza pracy. Możesz kontrolować rodzaje łączy i elementów roboczych, które użytkownicy mogą przeglądać i dodawać w formancie łączy. Na przykład można dodać kartę do formularza, która pomaga w zarządzaniu funkcjami zależnymi. Na tej karcie można dodawać formant łączy i ograniczać relacje łącza, które członkowie zespołu mogą przeglądać i wykonywać z tego formantu, aby uwzględnić tylko łącza do innych funkcji.

Używasz elementu Control, atrybut LinksControl Type, aby użytkownicy mogli tworzyć relacje łączy między elementów roboczymi i innych obiektami w bazie danych Team Foundation. Następnie możesz użyć elementów podrzędnych LinksControlOptions, aby określić opcje kontrolowania tego, jakie łącza członkowie zespołu mogą dodać do elementów roboczych lub obiektów, które łączą. Ponadto można zdefiniować domyślne kolumny, które mają być wyświetlane dla listy łączy w tym formancie.

Aby uzyskać podsumowanie ograniczeń łączy, które są zdefiniowane dla szablonów procesów programu TFS, zobacz Formanty łączy, ograniczenia i odwołania pola. Aby uzyskać więcej informacji dotyczących typów łącz, zobacz Odwołania do elementu typów łączy.

W tym temacie

• Określanie formantu łącza

• Stosunek kontroli łącza

• Ograniczenie relacji łącza do elementów roboczych

• Ograniczanie relacji łącza do zestawów zmian, hiperłączy i innych elementów innych niż robocze

• Ograniczenie relacji łącza do typów elementów roboczych

• Określanie domyślnych kolumn do wyświetlenia

Określanie formantu łącza

Używasz opcji LinksControl, aby umożliwiać użytkownikom dodawanie, wyświetlanie i zarządzanie relacjami łączy w formularzu elementu roboczego. Za pomocą tego formantu można otworzyć, edytować, dodawać i usuwać łącza.

Formularz można dostosować tak, aby jedna karta wyświetlał tylko łącza nadrzędne i podrzędne, a inna wszystkie typy łączy. W poniższym przykładzie karta, która jest oznaczona etykietą „Wszystkie łącza”, jest tworzona, której członkowie zespołu mogą użyć, aby dodać wszystkie typy łączy. Ponadto domyślne kolumny, które są wyświetlane dla łączy wyświetlania, to ID, Typ elementu pracy, Tytuł, Przydzielone do, Stan i pole Komentarz łącza.

Formant łącza

<Tab Label="All Links">
   <Control Type="LinksControl" Name="All" >
      <LinksControlOptions>
         <LinkColumns>
            <LinkColumn RefName="System.ID" />
            <LinkColumn RefName="System.WorkItemType" />
            <LinkColumn RefName="System.Title" />
            <LinkColumn RefName="System.AssignedTo" />
            <LinkColumn RefName="System.State" />
            <LinkColumn LinkAttribute="System.Links.Comment" />
         </LinkColumns>
      </LinksControlOptions>
   </Control>
</Tab>

Powrót do początku

Stosunek kontroli łącza

Kiedy dodajesz formant łącza do formularza elementu roboczego, możesz określić filtry, które ograniczają typy łączy oraz elementy robocze, które użytkownicy mogą dodawać podczas korzystania z formantów. Poniższa tabela opisuje opcjonalne elementy podrzędne, które kontrolują relacje łącza.

Element	Opis
WorkItemLinkFilters	Ogranicza typy łączy, które mogą być używane do łączenia z elementami roboczymi.
ExternalLinkFilters	Ogranicza typy łączy, które mogą być używane do łączenia z obiektem innymi niż element roboczy, takim jak zestaw zmian, hiperłącze lub element kontroli wersji.
WorkItemTypeFilters	Ogranicza typy elementów roboczych, z którymi użytkownik może się łączyć i projektów zespołowych, w których te elementy robocze są zdefiniowane.
Filter	Określa typy łączy lub typy elementów roboczych, które chcesz uwzględnić lub wykluczyć.

Powrót do początku

Ograniczenie relacji łącza do elementów roboczych

Używasz elementów podrzędnych WorkItemLinkFilters i Filter do definiowania, które typy łączy które łącza kontrolują należy uwzględnić lub wykluczyć. Ten element umożliwia ograniczanie typy łączy, które mogą zostać wybrane przez formanty łączy do utworzenia relacji do elementów roboczych, które są zdefiniowane w tym samym projekcie. Składnia dla tych elementów wyglądają następująco.

<WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="linkTypeRefName" FilterOn="reversename | forwardname" />
</WorkItemLinkFilters>

Atrybut	Opis
FilterType	Wymagany WorkItemLinkFilters atrybut. Określa metodę, która jest używana do filtrowania zestawu typów łącz dostarczanych w zestawie elementów Filter. Można użyć poniższych prawidłowych wartości: exclude: zapobiega tworzeniu łączy na podstawie typów łączy wyświetlanych w elementach Filter. excludeAll: zabrania tworzenia łączy dowolnego typu. include: Służy do umożliwienia tylko tych typów łączy, które wymieniono w elementach Filter. includeAll: Służy do umożliwienia tworzenia łączy z wszystkich typów łącza.
LinkType	Wymagany Filter atrybut. Określa nazwę odwołania do pewnego typu łącza. Aby uzyskać więcej informacji, zobacz Odwołania do elementu typów łączy.
FilterOn	Opcjonalny atrybut Filter. Określa typ filtru do zastosowania do typu łącza. Można użyć poniższych prawidłowych wartości: forwardname: służy do filtrowania przesyłanej dalej nazwy zdefiniowanej dla typu łącza. reversename: Służy do filtrowania przesyłanej z powrotem nazwy, która jest zdefiniowana dla typu łącza. Jeśli nie określono tego parametru, do filtrowania typu łącza są używane nazwy wykonywalna i wsteczna. Jeśli topologia typu łącza to sieć, nazwy wykonywalna i wsteczna są takie same. Aby uzyskać więcej informacji, zobacz Odwołania do elementu typów łączy.

Przykład: Z wyłączeniem dwóch typów łączy do elementów roboczych

Można zdefiniować formant łączy, który pozwala na relacje łączy dla wszystkich typów łączy z wyjątkiem niestandardowego typu łącza wymagania i typu łącze hierarchii systemu przy użyciu następującego przykładu kodu.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="exclude">
         <Filter LinkType="MyLinks.LinkTypes.Requirement" /> 
         <Filter LinkType="System.LinkTypes.Hierarchy" /> 
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
. . .
</Control>

Powrót do początku

Ograniczanie relacji łącza do zestawów zmian, hiperłączy i innych elementów innych niż robocze

Używasz elementów podrzędnych ExternalLinkFilters i Filter do definiowania, które typy łączy do elementów zewnętrznych dla projektu, które łącza kontrolują należy uwzględnić lub wykluczyć. Składnia dla tych elementów wyglądają następująco.

<ExternalLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="externalLinkName" />
</ExternalLinkFilters>

Atrybut	Opis
FilterType	Opcjonalny atrybut ExternalLinkFilters. Określa metodę, która jest używana do filtrowania zestawu typów łącz dostarczanych w zestawie elementów Filter. Można użyć poniższych prawidłowych wartości: exclude: uniemożliwia tworzenie łączy na podstawie typów łączy wyświetlanych w elementach Filter. excludeAll: zabrania tworzenia łączy dowolnego typu. include: Służy do umożliwienia tylko tych typów łączy, które wymieniono w elementach Filter. includeAll: Służy do umożliwienia tworzenia łączy z wszystkich typów łącza. Jeśli nie określono tego parametru, wszystkie łącza do zewnętrznych elementów roboczych są wykluczone.
LinkType	Wymagany Filter atrybut. Określa nazwę odwołania do pewnego typu łącza, aby wykluczyć lub uwzględnić. Możesz określić poniższe typy łączy: Ustalone w grupie zmian Załącznik wynikowy Plik kodu źródłowego Wyniki testu Element roboczy hiperłącza

Przykład: Wyklucz wszystkie łącza do elementów niebędących elementami roboczymi

Poniższy przykład definiuje formant łączy, który obejmuje wszystkie typy łącza do elementów roboczych, takie jak powiązane i nadrzędny/podrzędny, lecz wyklucza typy łączy do elementów innych niż robocze, takich jak zestawy zmian, hiperłącza, i wyniki testów.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="includeAll" /> 
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
</Control>

Poniższy przykład definiuje formant łącza, który pozwala użytkownikom na określenie tylko typu łącza zestawu zmian i połączenie się tylko z zestawami zmian.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="excludeAll"/>
      <ExternalLinkFilters FilterType="include" /> 
         <Filter LinkType="Fixed in Changeset" />
      </ExternalLinkFilters> 
 </LinksControlOptions>
. . .
</Control>

Powrót do początku

Ograniczenie relacji łącza do typów elementów roboczych

Używasz elementów podrzędnych WorkItemTypeFilters i Filter w celu ograniczenia typów elementów roboczych z którymi można połączyć format łącza. Możesz ograniczać relacje łącza do projektu zespołowego lub według typu elementu roboczego. Składnia dla tych elementów wyglądają następująco.

<WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" >
   <Filter WorkItemType="workItemTypeReferenceName" />
</WorkItemTypeFilters>

Atrybut	Opis
Scope	Opcjonalny atrybut WorkItemTypeFilters. Definiuje zakres filtru zastosowany do zestawu typów elementów roboczych dostarczanych w zestawie elementów Filter. Można użyć poniższych prawidłowych wartości: all: Służy do zezwalania, aby łącza zostały utworzone na wszystkich typach elementów pracy określonych dla elementów Filter. project: Służy do umożliwienia utworzenia łączy tylko do tych typów elementów roboczych, które są zdefiniowane dla bieżącego projektu. Jeśli nie określono, łącza do wszystkich typów elementów roboczych są dozwolone.
FilterType	Wymagany WorkItemTypeFilters atrybut. Określa metodę, która jest używana do filtrowania zestawu typów łącz dostarczanych w zestawie elementów Filter. Można użyć poniższych prawidłowych wartości: exclude: Służy do uniemożliwienia typów elementu roboczego wymienionych w elementach Filter. excludeAll: zabrania tworzenia elementów roboczych dowolnego typu. include: Służy do umożliwienia typów elementu roboczego wymienionych w elementach Filter. includeAll: Służy do umożliwienia typów elementu roboczego.
WorkItemType	Wymagany Filter atrybut. Określa nazwę odwołania dla typu elementu roboczego.

Przykład: Ograniczanie relacji łączy do elementów roboczych zadań

Poniższy przykład definiuje formant łączy, który zezwala na formowanie tylko relacji hierarchicznych do zadań, które są zdefiniowane w projekcie zespołowym.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="System.LinkTypes.Hierarchy" />
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll"/>
      <WorkItemTypeFilters Scope ="project" FilterType="include" />
         <Filter WorkItemType="Task" />
      </WorkItemTypeFilters> 
   </LinksControlOptions>
. . .
</Control>

Powrót do początku

Określanie domyślnych kolumn do wyświetlenia

Używasz elementów podrzędnych LinkColumns i LinkColumn, aby określać domyślne kolumny do wyświetlania w formancie łącza. Możesz określić nazwę odwołania dla pola elementu roboczego albo atrybut łącza. Składnia dla tych elementów wyglądają następująco.

<LinkColumns>
   <LinkColumn RefName="reference name" | LinkAttribute=" link attribute name" />
</LinkColumns>

Kolejność, w której elementy te są wyszczególnione na liście, definiuje kolejność, w jakiej pola kolumny są wyświetlane w formularzu elementu roboczego. Aby uzyskać listę nazw odwołań i atrybutów łączy, zobacz Odwołania pola elementu pracy dla Visual Studio ALM. Następująca składnia określa wyświetlanie czterech kolumn: Identyfikator, Stan, Tytuł i Komentarz przypisywany do łącza.

<Control Type="LinksControl">
. . .
   <LinksControlOptions>
      <LinkColumns>
         <LinkColumn RefName="System.ID" />
         <LinkColumn RefName="System.State" />
         <LinkColumn RefName="System.Title" />
         <LinkColumn LinkAttribute="System.Links.Comment" />
      </LinkColumns>
   </LinksControlOptions>
</Control>

Powrót do początku

Zobacz też

Informacje

Elementy LinksControlOptions

Koncepcje

Formanty łączy, ograniczenia i odwołania pola

Odwołania do elementu typów łączy

Określanie sterowania formularzem elementu pracy