Condividi tramite

Elementi LinksControlOptions

  • Articolo

Si utilizza l'elemento LinksControlOptions per definire le opzioni per controllare quali collegamenti è possibile aggiungere a un elemento di lavoro e le colonne predefinite che si desidera visualizzare per l'elenco di collegamenti in un elemento di lavoro. Quando si aggiunge un controllo dei collegamenti a un form dell'elemento di lavoro, è possibile specificare dei filtri che limitino i tipi di collegamenti che gli utenti possono visualizzare e creare e i tipi di elementi di lavoro ai quali gli utenti possono creare dei collegamenti. In particolare, utilizzare i seguenti elementi come indicato:

  • WorkItemLinkFilters: utilizzare per limitare i tipi di collegamenti tra elementi di lavoro nel progetto team corrente.

  • ExternalLinkFilters: utilizzare per limitare i tipi di collegamenti che possono essere creati tra elementi di lavoro e altri oggetti, ad esempio insiemi di modifiche, collegamenti ipertestuali o file sottoposti al controllo della versione.

  • WorkItemTypeFilters: utilizzare per limitare le relazioni tra i collegamenti che gli utenti possono creare in base al tipo di elemento di lavoro e se l'elemento di lavoro è definito nel progetto team corrente.

In ognuno di questi elementi, è possibile specificare elementi Filter per specificare i tipi di collegamento o tipi di elemento di lavoro che si desidera includere o escludere. Per ulteriori informazioni su come utilizzare questi elementi, vedere Definire i controlli dei collegamenti per limitare le relazioni di collegamento.

L'elemento LinksControlOptions è un elemento figlio di CONTROL.

Gerarchia dello schema

WITD

   WORKITEMTYPE

       FORM

           Layout

               Raggruppare

               Colonna

               Tab

                     Controllo

<xs:element name="LinksControlOptions" type="LinksControlOptionsType" minOccurs="0"/>
<xs:element name="WorkItemLinkFilters" type="WorkItemLinkFiltersType" minOccurs="0" maxOccurs="1"/>
<xs:element name="Filter" type="WorkItemLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ExternalLinkFilters" type="ExternalLinkFiltersType" minOccurs="0" maxOccurs="1" />
<xs:element name="Filter" type="ExternalLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="WorkItemTypeFilters"   type="LinksControlWorkItemTypeFiltersElementType" minOccurs="0" maxOccurs="1" />
<xs:element name="Filter" type="LinksControlWorkItemTypeFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="LinkColumns" type="LinkColumnsType" minOccurs="0" maxOccurs="1" />
<xs:element name="LinkColumn" type="LinkColumnType" minOccurs="1" maxOccurs="unbounded"/>

<LinksControlOptions>
   <WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
       <Filter LinkType="linkTypeRefName" FilterOn="reversename | forwardname" />
   </WorkItemLinkFilters>
   <ExternalLinkFilters FilterType ="include | exclude | includeAll | excludeAll">
       <Filter LinkType="externalLinkName"/>
   </ExternalLinkFilters>
   <WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" />
       <Filter WorkItemType="workItemTypeReferenceName"/>
   </WorkItemTypeFilters>
   <LinkColumns>
      <LinkColumn RefName="reference name" | LinkAttribute="link attribute name"/>
   </LinkColumns>
</LinksControlOptions>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Elementi figli e attributi

Elemento

Attributo

Descrizione

LinksControlOptions

 

Elemento Control facoltativo quando type="LinksControl".

Fornisce un contenitore per elementi che definiscono quali collegamenti è possibile aggiungere a un elemento di lavoro e le colonne predefinite per l'elenco di collegamenti in un elemento di lavoro.

Il tipo di elemento è complesso: LinksControlOptionsType.

WorkItemLinkFilters

 

Elemento LinksControlOptions facoltativo.

Fornisce un contenitore per uno o più elementi Filter che specificano i criteri di filtro del collegamento da utilizzare per i tipi di collegamento definiti per la raccolta di progetti team e che consentono di creare relazioni tra gli elementi di lavoro.

Il tipo di elemento è complesso: WorkItemLinkFiltersType.

 

FilterType

Attributo WorkItemLinkFilters obbligatorio.

Definisce il metodo utilizzato per filtrare il set di tipi di collegamento fornito nel set di elementi Filter. Il tipo di elemento è semplice: LinksControlFilterKind.

I valori validi che si possono utilizzare:

  • exclude: Utilizzare per impedire che collegamenti vengano creati da quei 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 che i collegamenti possano essere creati da tutti i tipi di collegamento.

Filter

 

Elemento WorkItemLinkFilters necessario quando FilterType è exclude o include.

Quando FilterType è excludeAll o includeAll, nessun elemento Filter deve essere specificato.

Specifica i tipi di collegamenti che devono essere inclusi o esclusi dal set di collegamenti che possono essere creati per l'elemento di lavoro. Il tipo di elemento è semplice: WorkItemLinkFilterElementType.

 

LinkType

Attributo Filter obbligatorio.

Specifica il nome di riferimento per un tipo di collegamento. I tipi validi includono i seguenti tipi di collegamento definiti dal sistema:

  • Storyboard

  • System.LinkTypes.Dependency

  • System.LinkTypes.Hierarchy

  • System.LinkTypes.Related

Inoltre, è possibile specificare il nome di riferimento per i tipi di collegamento personalizzati definiti per la raccolta di progetti team. 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. Il tipo di elemento è semplice: LinksControlFilterKind.

I valori validi sono:

  • forwardname: Utilizzare per filtrare sul nome diretto definito per un tipo di collegamento.

  • reversename: Utilizzare per filtrare sul nome inverso definito per un tipo di collegamento.

Se non specificato, sia i nomi inversi che diretti vengono utilizzati per filtrare il tipo di collegamento.

Nota

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.

ExternalLinkFilters

 

Elemento LinksControlOptions facoltativo.

Consente di fornire un contenitore per uno o più elementi Filter che specificano i tipi di collegamento che gli utenti possono specificare per creare relazioni con oggetti che non sono elementi di lavoro, ad esempio insiemi di modifiche, collegamenti ipertestuali e file nel controllo della versione. Il tipo di elemento è complesso: ExternalLinkFiltersType.

 

FilterType

Attributo ExternalLinkFilters facoltativo.

Consente di definire il metodo utilizzato per filtrare il l'elenco di tipi di collegamento fornito nel set di elementi Filter. Il tipo di elemento è semplice: LinksControlFilterKind.

È possibile utilizzare i seguenti valori:

  • exclude: utilizzare per non consentire che vengano creati collegamenti dai tipi di collegamento visualizzati 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 che i collegamenti possano essere creati da tutti i tipi di collegamento.

Se non specificato, tutti i collegamenti agli elementi di lavoro esterni vengono esclusi.

Filter

 

Elemento ExternalLinkFilters necessario quando FilterType è exclude o include.

Quando FilterType è excludeAll o includeAll, nessun elemento Filter deve essere specificato.

Il tipo di elemento è complesso: ExternalLinkFilterElementType.

Specifica i nomi dei tipi di collegamento che devono essere inclusi o esclusi dal set di collegamenti che gli utenti possono creare per l'elemento di lavoro.

 

LinkType

Attributo Filter obbligatorio.

Specifica il nome di riferimento per un tipo di collegamento da escludere o includere. Il tipo dell'attributo è semplice: ExternalLinkTypeName. È 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

WorkItemTypeFilters

 

Elemento LinksControlOptions facoltativo.

Fornisce un contenitore per uno o più elementi Filter che specificano i criteri di filtro da applicare ai tipi di elemento di lavoro.

Il tipo di elemento è complesso: LinksControlWorkItemTypeFilterElementType.

 

Scope

Attributo WorkItemTypeFilters facoltativo.

Definisce lo scopo del filtro applicato al set di tipi di elementi di lavoro fornito nel set di elementi Filter. Il tipo di elemento è semplice: LinksControlFilterKind.

I valori validi che si possono utilizzare:

  • all: Utilizzare per consentire che i collegamenti possano essere creati in tutti i tipi di elementi di lavoro specificati nei tag Filter.

  • project: Utilizzare per consentire che i collegamenti siano creati solo nei tipi di elementi di lavoro definiti per il progetto corrente.

Se non specificato, vengono consentiti i collegamenti a tutti i tipi di elementi di lavoro.

 

FilterType

Attributo WorkItemTypeFilters obbligatorio.

Consente di definire il metodo utilizzato per filtrare il set di tipi di elementi di lavoro fornito nel set di elementi Filter. Il tipo di elemento è semplice: LinksControlFilterKind.

È possibile utilizzare i seguenti valori:

  • exclude: utilizzare per non consentire i tipi di elemento di lavoro negli elementi Filter.

  • excludeAll: da utilizzare per impedire tutti i tipi di elementi di lavoro.

  • include: utilizzare per consentire i tipi di elemento di lavoro negli elementi Filter.

  • includeAll: da utilizzare per consentire tutti i tipi di elementi di lavoro.

Se non si specifica nessuno di tali valori, vengono consentiti i collegamenti a tutti i tipi di elemento di lavoro.

Filter

 

Elemento WorkItemTypeFilters facoltativo quando l'attributo FilterType è exclude o include.

Quando FilterType è excludeAll o includeAll, non è necessario specificare alcun elemento Filter.

Specifica i tipi di elementi di lavoro da includere o escludere dal set di tipi di elementi di lavoro cui possono essere collegati. Il tipo di elemento è complesso: LinksControlWorkItemTypeFilterElementType.

 

WorkItemType

Attributo Filter obbligatorio.

Specifica il nome di riferimento di un tipo di elemento di lavoro da filtrare. Il tipo dell'attributo è: typelib:NonEmptyPlainConstant.

Lunghezza minima: 1; lunghezza massima: 255.

Valore di schema: ^[^\\]*$

Esempio di valore di schema: Attività

LinkColumns

 

Elemento LinksControlOptions facoltativo.

Viene fornito un contenitore per uno o più elementi LinkColumn. Il tipo di elemento è complesso: LinkColumnsType.

LinkColumn

 

Elemento LinkColumns obbligatorio

Specifica i campi dell'elemento di lavoro e gli attributi del tipo del collegamento visualizzati per l'elenco di collegamenti definiti per un'elemento di lavoro. Il tipo di elemento è complesso: LinkColumnType.

Per impostazione predefinita, viene visualizzato questo elenco di colonne. L'utente può aggiungere e rimuovere colonne dall'elenco di collegamenti.

L'ordine nel quale vengono elencati gli elementi LinkColumn definisce l'ordine in cui i campi della colonna vengono visualizzati nel form elemento di lavoro.

 

RefName

Attributo LinkColumn facoltativo. Specificare RefName o LinkAttribute ma non entrambi.

Specifica il nome di riferimento che corrisponde a un campo elemento di lavoro valido per la raccolta di progetti team. Il tipo dell'attributo è typelib:ReferenceFieldName.

 

LinkAttribute

Attributo LinkColumn facoltativo. Specificare RefName o LinkAttribute ma non entrambi.

Specifica il nome di riferimento che corrisponde a qualsiasi attributo per un tipo di collegamento valido per la raccolta di progetti team. Il tipo dell'attributo è typelib:ReferenceFieldName.

Elementi padre

Elemento

Descrizione

Controllo

Necessario. Definisce un campo, un testo, un collegamento ipertestuale o un altro elemento di controllo da visualizzare nel form dell'elemento di lavoro.

Note

LinksControlOptions è un elemento figlio facoltativo dell'elemento Control dove ControlType="LinksControl". È possibile utilizzare l'elemento LinksControlOptions per supportare le seguenti azioni:

  • Specificare le restrizioni che regolano la creazione di relazioni con altri elementi di lavoro in base al tipo di collegamento e, facoltativamente, i nomi inversi e diretti dei tipi di collegamento.

  • Specificare le restrizioni che regolano la creazione di relazioni con oggetti che non sono elementi di lavoro, ad esempio set di modifiche, collegamenti ipertestuali e così via, basati su tipi di collegamenti esterni.

  • Specificare le restrizioni che regolano la creazione di relazioni con altri elementi di lavoro in base al tipo di elemento di lavoro e, facoltativamente, i progetti team in cui vengono definiti tali elementi di lavoro.

  • Specificare i campi della colonna predefiniti di cui si desidera visualizzare informazioni per l'elenco di collegamenti.

Esempio

Nell'esempio seguente viene specificato come abilitare la creazione di collegamenti il cui tipo è Microsoft.VSTS.Common.TestedBy e mostra Forward Name per questo tipo di collegamento. Le opzioni di filtro impediscono la creazione di collegamenti a tutti i tipi di collegamento esterni. Inoltre, i campi colonna predefiniti visualizzati per i collegamenti elencati nei seguenti nomi descrittivi: ID, Tipo di elemento di lavoro, Titolo, Assegnato a, Stato e il campo Commento definito per il collegamento. Per ulteriori esempi, vedere Definire i controlli dei collegamenti per limitare le relazioni di collegamento.

<Control Type="LinksControl" Name="TestedBy" Label="&amp;Work items testing this bug:" LabelPosition="Top">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="Microsoft.VSTS.Common.TestedBy" FilterOn="forwardname" />
      </WorkItemLinkFilters>
      <WorkItemTypeFilters FilterType="include">
          <Filter WorkItemType="Test Case" />
      </WorkItemTypeFilters>
          <ExternalLinkFilters FilterType="excludeAll"/>
      <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>

Pulsanti della barra degli strumenti di LinksControl

Ogni elemento Control di Type=”LinksControl” fornisce una barra degli strumenti, contenente i pulsanti mostrati nell'illustrazione seguente:

Controlli della barra degli strumenti di collegamento per il form dell'elemento di lavoro

Questi pulsanti diventano disponibili solo dopo avere eseguito un'azione specifica:

  • Il pulsante per creare un elemento di lavoro collegato all'elemento di lavoro aperto (Icona Aggiungi nuovo elemento di lavoro collegato) diventa disponibile solo dopo avere salvato l'elemento di lavoro aperto.

  • I pulsanti per aprire l'elenco degli elementi di lavoro in una query (Apri nella query) e in un client di Microsoft Office (Apri in Office) diventano disponibili solo quando almeno un elemento di lavoro viene elencato nella scheda del controllo dei collegamenti.

  • I pulsanti per aprire un elemento di lavoro (Apri elemento di lavoro), modificare un collegamento (Modifica collegamento) ed eliminare un collegamento (Elimina collegamento) diventano disponibili solo dopo avere selezionato uno o più elementi di lavoro elencati nella scheda del controllo dei collegamenti.

Il controllo dei collegamenti visualizzato è lo stesso sia per Team Web Access che per Team Explorer, ad eccezione di quando è configurato solo per eseguire il rendering dei collegamenti Storyboard. In tal caso, la barra degli strumenti contiene solo i controlli per aggiungere un nuovo collegamento, aprire l'elemento collegato ed eliminare il collegamento. Inoltre, la versione Team Web Access visualizza il collegamento Avvia storyboard nel menu di sistema.

Controllo collegamenti storyboard in Team Web Access

Definizioni dello schema

  • LinksControlOptionsType

  • WorkItemLinkFiltersType

  • WorkItemLinkFilterElementType

  • ExternalLinkFilterType

  • ExternalLinkFilterElementType

  • LinksControlFilterKind

  • LinksControlFilterOnKind

  • ExternalLinkTypeName

  • LinksControlWorkItemTypeFiltersElementType

  • LinksControlWorkItemTypeFilterElementType

  • LinksControlWorkItemTypeFilterScopeKind

  • LinksControlWorkItemTypeFilterKind

  • LinkColumnsType

  • LinkColumnType

LinksControlOptionsType

<xs:complexType name="LinksControlOptionsType">
   <xs:all>
      <xs:element name="LinkColumns" type="LinkColumnsType" minOccurs="0" maxOccurs="1" />
      <xs:element name="WorkItemLinkFilters" type="WorkItemLinkFiltersType" minOccurs="0" maxOccurs="1"/>
      <xs:element name="ExternalLinkFilters" type="ExternalLinkFiltersType" minOccurs="0" maxOccurs="1" />
      <xs:element name="WorkItemTypeFilters" type="LinksControlWorkItemTypeFiltersElementType" minOccurs="0" maxOccurs="1" />
   </xs:all>
</xs:complexType>

WorkItemLinkFiltersType

<xs:complexType name="WorkItemLinkFiltersType" >
   <xs:sequence>
      <xs:element name="Filter" type="WorkItemLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="FilterType" type="LinksControlFilterKind" use="required" />
</xs:complexType>

WorkItemLinkFilterElementType

<xs:complexType name="WorkItemLinkFilterElementType" >
   <xs:attribute name="LinkType" type="typelib:ReferenceFieldName" use="required" />
   <xs:attribute name="FilterOn" type="LinksControlFilterOnKind" use="optional" />
</xs:complexType>

ExternalLinkFilterType

<xs:complexType name="ExternalLinkFiltersType" >
   <xs:sequence>
      <xs:element name="Filter" type="ExternalLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="FilterType" type="LinksControlFilterKind" use="required" />
</xs:complexType>

ExternalLinkFilterElementType

<xs:complexType name="ExternalLinkFilterElementType" >
   <xs:attribute name="LinkType" type="ExternalLinkTypeName" use="required" />
</xs:complexType>

LinksControlFilterKind

<xs:simpleType name="LinksControlFilterKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="include" />
      <xs:enumeration value="exclude" />
      <xs:enumeration value="includeAll" />
      <xs:enumeration value="excludeAll" />
   </xs:restriction>
</xs:simpleType>

LinksControlFilterOnKind

<xs:simpleType name="LinksControlFilterOnKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="forwardname" />
      <xs:enumeration value="reversename" />
   </xs:restriction>
</xs:simpleType>

ExternalLinkTypeName

<xs:simpleType name="ExternalLinkTypeName">
   <xs:restriction base="xs:string">
      <xs:minLength value="1"/>
      <xs:maxLength value="128"/>
   </xs:restriction>
</xs:simpleType>

LinksControlWorkItemTypeFiltersElementType

<xs:complexType name="LinksControlWorkItemTypeFiltersElementType" >
   <xs:sequence>
      <xs:element name="Filter" type="LinksControlWorkItemTypeFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="Scope" type="LinksControlWorkItemTypeFilterScopeKind" use="optional" />
      <xs:attribute name="FilterType" type="LinksControlWorkItemTypeFilterKind" use="required" />
</xs:complexType>

LinksControlWorkItemTypeFilterElementType

<xs:complexType name="LinksControlWorkItemTypeFilterElementType" >
   <xs:attribute name="WorkItemType" type="typelib:NonEmptyPlainConstant" use="required" />
</xs:complexType>

LinksControlWorkItemTypeFilterScopeKind

<xs:simpleType name="LinksControlWorkItemTypeFilterScopeKind">
   <xs:restriction base="xs:string">
   <xs:enumeration value="project" />
   <xs:enumeration value="all" />
</xs:restriction>
</xs:simpleType>

LinksControlWorkItemTypeFilterKind

<xs:simpleType name="LinksControlWorkItemTypeFilterKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="include" />
      <xs:enumeration value="exclude" />
      <xs:enumeration value="includeAll" />
   </xs:restriction>
</xs:simpleType>

LinkColumnsType

<xs:complexType name="LinkColumnsType" >
   <xs:sequence>
      <xs:element name="LinkColumn" type="LinkColumnType" minOccurs="1" maxOccurs="unbounded"/>
   </xs:sequence>
</xs:complexType>

LinkColumnType

<xs:complexType name="LinkColumnType" >
   <!-- Must be one or the other, but not both -->
      <xs:attribute name="LinkAttribute" type="typelib:ReferenceFieldName" use="optional" />
      <xs:attribute name="RefName" type="typelib:ReferenceFieldName" use="optional" />
</xs:complexType>

Informazioni sull'elemento

Spazio dei nomi

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef

Nome di schema

Definizione del tipo di elemento di lavoro

File di convalida

WorkItemTypeDefinition.xsd

Tipo di elemento

LinksControlOptionsType

Può essere vuoto

Non applicabile

Vedere anche

Concetti

Riferimento all'elemento tipo di collegamento

Specificare i controlli dei form elemento di lavoro

Definire i controlli dei collegamenti per limitare le relazioni di collegamento

Altre risorse

Definire un tipo di collegamento personalizzato