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.

Elemento	Descrizione
WorkItemLinkFilters	Limita i tipi di collegamento che è possibile utilizzare per collegarsi agli elementi di lavoro.
ExternalLinkFilters	Limita i tipi di collegamenti che possono essere utilizzati per collegarsi a un oggetto che non sia un tipo di elemento di lavoro, quali un insieme di modifiche, un collegamento ipertestuale o elemento del controllo della versione.
WorkItemTypeFilters	Limita i tipi di elementi di lavoro ai quali un utente può collegarsi e i progetti team in cui tali elementi di lavoro sono definiti.
Filter	Specifica i tipi di collegamento o tipi di elemento di lavoro che si desidera includere o escludere.

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>

Attributo	Descrizione
FilterType	Attributo WorkItemLinkFilters obbligatorio. Definisce il metodo utilizzato per filtrare il set di tipi di collegamento fornito nel set di elementi Filter.È possibile utilizzare i seguenti valori validi: exclude: da utilizzare per impedire la creazione di collegamenti dai tipi di collegamento elencati negli elementi Filter. excludeAll: da utilizzare per impedire tutti i tipi di collegamento. include: da utilizzare per consentire solo i tipi di collegamento elencati negli elementi Filter. includeAll: da utilizzare per consentire la creazione di collegamenti da tutti i tipi di collegamento.
LinkType	Attributo Filter obbligatorio. Specifica il nome di riferimento per un tipo di collegamento.Per ulteriori informazioni, vedere Riferimento all'elemento tipo di collegamento.
FilterOn	Attributo Filter facoltativo. Specifica il tipo di filtro da applicare al tipo di collegamento.È possibile utilizzare i seguenti valori validi: forwardname: da utilizzare per filtrare in base al nome diretto definito per un tipo di collegamento. reversename: da utilizzare per filtrare in base al nome inverso definito per un tipo di collegamento. Se non specificato, vengono utilizzati entrambi i nomi diretto e inverso per filtrare il tipo di collegamento.Se la topologia del tipo di collegamento è Rete, i nomi diretto e inverso sono uguali.Per ulteriori informazioni, vedere Riferimento all'elemento tipo di collegamento.

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>

Attributo	Descrizione
FilterType	Attributo ExternalLinkFilters facoltativo. Definisce il metodo utilizzato per filtrare il set di tipi di collegamento forniti nel set di elementi Filter.È possibile utilizzare i seguenti valori validi: exclude: da utilizzare per impedire la creazione di collegamenti dai tipi di collegamento elencati negli elementi Filter. excludeAll: da utilizzare per impedire tutti i tipi di collegamento. include: da utilizzare per consentire solo i tipi di collegamento elencati negli elementi Filter. includeAll: da utilizzare per consentire la creazione di collegamenti da tutti i tipi di collegamento. Se non specificato, tutti i collegamenti agli elementi di lavoro esterni vengono esclusi.
LinkType	Attributo Filter obbligatorio. Specifica il nome di riferimento per un tipo di collegamento da escludere o includere.È possibile specificare i tipi di collegamento riportati di seguito: Corretto nell'insieme di modifiche Allegato del risultato File di codice sorgente Risultato del test Collegamento ipertestuale all'elemento di lavoro

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>

Attributo	Descrizione
Scope	Attributo WorkItemTypeFilters facoltativo. Definisce l'ambito del filtro applicato al set di tipi di elemento di lavoro fornito nel set di elementi Filter.È possibile utilizzare i seguenti valori validi: all: da utilizzare per consentire la creazione di collegamenti a tutti i tipi di elemento di lavoro specificati negli elementi Filter. project: da utilizzare per consentire la creazione di collegamenti solo ai tipi di elementi di lavoro definiti per il progetto corrente. Se non specificato, sono consentiti collegamenti a tutti i tipi di elemento di lavoro.
FilterType	Attributo WorkItemTypeFilters obbligatorio. Definisce il metodo utilizzato per filtrare il set di tipi di collegamento fornito nel set di elementi Filter.È possibile utilizzare i seguenti valori validi: exclude: da utilizzare per impedire i tipi di elemento di lavoro elencati negli elementi Filter. excludeAll: da utilizzare per impedire tutti i tipi di elementi di lavoro. include: da utilizzare per consentire i tipi di elemento di lavoro elencati negli elementi Filter. includeAll: da utilizzare per consentire tutti i tipi di elementi di lavoro.
WorkItemType	Attributo Filter obbligatorio. Specifica il nome di riferimento per un tipo di elemento di lavoro.

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

Data	Cronologia	Motivo
Settembre 2012	Corretta la struttura del caso di sintassi.Tutti i valori enumerati viene fatta distinzione tra maiuscole e minuscole.	Correzione di bug nel contenuto.