Definire i controlli dei collegamenti per limitare le relazioni di collegamento

È possibile controllare quali elementi di lavoro si collegano tra loro personalizzando il form di lavoro.In particolare, è possibile controllare i tipi di collegamenti e di elementi di lavoro che gli utenti possono visualizzare e aggiungere in un controllo collegamenti.Ad esempio, può essere necessario aggiungere al form una scheda che consente di gestire funzionalità dipendenti.In tale scheda, è possibile aggiungere il controllo collegamenti, quindi limitare le relazioni di collegamento che i membri del team possono visualizzare e impostare il controllo in modo da includere solo i collegamenti alle altre funzionalità.

Si utilizza l'attributo LinksControlType dell'elemento Control per consentire agli utenti di creare relazioni di collegamento tra elementi di lavoro e altri oggetti nel database di Team Foundation.È possibile quindi utilizzare gli elementi figlio LinksControlOptions per definire le opzioni per controllare quali collegamenti i membri del team possono aggiungere a un elemento di lavoro e a quali tipi di elementi di lavoro o di oggetti possono collegarsi.È inoltre possibile definire le colonne predefinite che si desidera visualizzare per l'elenco di collegamenti in tale controllo.

Per un riepilogo delle limitazioni di collegamento definite per il modello di processo per Microsoft Solutions Framework (MSF) per Agile Software Development v5.0, vedere Collegamento di elementi di lavoro e restrizioni e controlli dei collegamenti.Per ulteriori informazioni sui tipi di collegamento, vedere Riferimento all'elemento tipo di collegamento.

In questo argomento

• Impostazione del Controllo dei collegamenti

• Controllo delle relazioni di collegamento

• Limitazione delle relazioni di collegamento agli elementi di lavoro

• Limitazione delle relazioni di collegamento a Insiemi di modifiche, Collegamenti ipertestuali e altri elementi diversi da elementi di lavoro

• Limitazione delle relazioni di collegamento ai tipi di elementi di lavoro

• Specifica delle colonne predefinite da visualizzare

Impostazione del Controllo dei collegamenti

È possibile utilizzare l'opzione LinksControl per consentire agli utenti di aggiungere, visualizzare e gestire relazioni di collegamento in un form elemento di lavoro.Tramite questo controllo è possibile aprire, modificare, aggiungere e rimuovere collegamenti.

È possibile personalizzare un form in modo che in una scheda vengano visualizzati solo i collegamenti padre e figlio mentre in un'altra scheda vengano visualizzati tutti gli altri tipi di collegamento.Nell'esempio riportato di seguito viene creata una scheda, a cui è assegnata l'etichetta "Tutti i collegamenti" che i membri del team possono utilizzare per aggiungere tutti i tipi di collegamento.Inoltre, le colonne predefinite che vengono visualizzate per i collegamenti corrispondono a ID, Tipo di elemento di lavoro, Titolo, Assegnato a, Stato e al campo Commento collegamento.

LinksControl

<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>

Torna all'inizio

Controllo delle relazioni di collegamento

Quando si aggiunge un controllo di collegamento a un form elemento di lavoro, è possibile specificare dei filtri che limitino i tipi di collegamenti e di elementi di lavoro che i membri del team possono aggiungere quando utilizzano il controllo.Nella tabella riportata di seguito vengono descritti gli elementi figlio facoltativi che controllano le relazioni di collegamento.

Torna all'inizio

Limitazione delle relazioni di collegamento agli elementi di lavoro

Si utilizzano gli elementi figlio WorkItemLinkFilters e Filter per definire quali tipi di collegamento devono essere inclusi o esclusi dal controllo collegamenti.Si utilizza questo elemento per limitare i tipi di collegamenti che possono essere selezionati dal controllo collegamenti per costituire relazioni agli elementi di lavoro definiti nello stesso progetto.La sintassi per questi elementi è la seguente:

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

Esempio: esclusione di due tipi di collegamento di elemento di lavoro

Utilizzando l'esempio di codice riportato di seguito, è possibile definire un controllo collegamenti che consenta relazioni del collegamento per tutti i tipi di collegamento a eccezione del tipo di collegamento requisito personalizzato e del tipo di collegamento gerarchia di sistema.

<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>

Torna all'inizio

Limitazione delle relazioni di collegamento a Insiemi di modifiche, Collegamenti ipertestuali e altri elementi diversi da elementi di lavoro

Si utilizzano gli elementi figlio ExternalLinkFilters e Filter per definire quali tipi di collegamento agli elementi esterni al progetto team devono essere inclusi o esclusi dal controllo collegamenti.La sintassi per questi elementi è la seguente:

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

Esempio: esclusione di tutti i collegamenti a elementi diversi da elementi di lavoro

Nell'esempio riportato di seguito viene definito un controllo collegamenti che include tutti i tipi di collegamento agli elementi di lavoro, quali correlato e padre/figlio, ma esclude i tipi di collegamento agli elementi diversi da elementi di lavoro, quali insiemi di modifiche, collegamenti ipertestuali e risultati di test.

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

Nell'esempio riportato di seguito viene definito un controllo collegamenti che consente agli utenti di specificare solo il tipo di collegamento insieme di modifiche e di collegarsi solo agli insiemi di modifiche.

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

Torna all'inizio

Limitazione delle relazioni di collegamento ai tipi di elementi di lavoro

Si utilizzando gli elementi figlio WorkItemTypeFilters e Filter per limitare i tipi di elementi di lavoro a cui un controllo collegamenti può collegarsi.È possibile limitare relazioni del collegamento in base al progetto team o al tipo di elemento di lavoro.La sintassi per questi elementi è la seguente:

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

Esempio: limitazione di relazioni di collegamento agli elementi di lavoro Attività

Nell'esempio riportato di seguito viene definito un controllo collegamenti che consente di costituire solo relazioni gerarchiche alle attività definite nel progetto team.

<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>

Torna all'inizio

Specifica delle colonne predefinite da visualizzare

Si utilizzano gli elementi figlio LinkColumns e LinkColumn per specificare le colonne predefinite da visualizzare nel controllo collegamenti.È possibile specificare il nome riferimento per un campo elemento di lavoro o un attributo di collegamento.La sintassi per questi elementi è la seguente:

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

L'ordine in cui vengono elencati gli elementi definisce l'ordine in cui i campi della colonna vengono visualizzati nel form elemento di lavoro.Per un elenco di nomi di riferimento e di attributi di collegamento, vedere Riferimento ai campi degli elementi di lavoro per ALM di Visual Studio.Nella sintassi seguente viene definita la visualizzazione di quattro colonne: ID, Stato, Titolo e l'attributo Commento del collegamento.

<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>

Torna all'inizio

Vedere anche

Riferimenti

Elementi LinksControlOptions

Concetti

Collegamento di elementi di lavoro e restrizioni e controlli dei collegamenti

Riferimento all'elemento tipo di collegamento

Specificare controlli dei form elemento di lavoro

Cronologia delle modifiche