Elementi LinksControlOptions

Articolo
11/18/2015

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 il controllo collegamento 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 elemento di lavoro per i quali gli utenti possono creare dei collegamenti. In particolare, gli elementi seguenti vengono usati come specificato di seguito:

WorkItemLinkFilters: per limitare i tipi di collegamento tra gli elementi di lavoro nel progetto team corrente.
ExternalLinkFilters: per limitare i tipi di collegamento che è possibile creare tra gli elementi di lavoro e gli altri oggetti, ad esempio insiemi di modifiche, collegamenti ipertestuali o file con controllo della versione.
WorkItemTypeFilters: per limitare le relazioni di collegamento usate dagli utenti in base al tipo di elemento di lavoro e per specificare se l'elemento di lavoro viene definito nel progetto team corrente.

In ogni elemento è possibile specificare gli elementi di Filter per indicare i tipi di collegamento o i tipi di elemento di lavoro da includere o escludere. Per altre informazioni su come usare questi elementi, vedere Definire i controlli dei collegamenti per limitare le relazioni di collegamento.

L'elemento LinksControlOptions è un elemento figlio dell'elemento CONTROL.

Gerarchia dello schema

<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 gli elementi che definiscono i collegamenti che è possibile aggiungere a un elemento di lavoro e le colonne predefinite da visualizzare per l'elenco di relazioni di collegamento in un elemento di lavoro. L'elemento è di tipo complesso: LinksControlOptionsType.
WorkItemLinkFilters		Elemento LinksControlOptions facoltativo. Fornisce un contenitore per uno o più elementi Filter che specificano i criteri di filtro del collegamento da usare per i tipi di collegamento definiti per la raccolta di progetti team e che creano le relazioni tra gli elementi di lavoro. L'elemento è di tipo complesso: WorkItemLinkFiltersType.
	FilterType	Attributo WorkItemLinkFilters obbligatorio. Definisce il metodo usato per filtrare il set di tipi di collegamento fornito nel set di elementi Filter. L'elemento è di tipo semplice: LinksControlFilterKind. Di seguito sono riportati i valori validi che è possibile usare. exclude: per impedire la creazione di collegamenti dai tipi di collegamento elencati negli elementi Filter. excludeAll: per impedire tutti i tipi di collegamento. include: per consentire solo i tipi di collegamento elencati negli elementi Filter. includeAll: per consentire la creazione di collegamenti da tutti i tipi di collegamento.
Filter		Elemento WorkItemLinkFilters richiesto quando FilterType è exclude o include. Quando FilterType è excludeAll o includeAll, non devono essere specificati elementi Filter. Specifica i tipi di collegamento da includere o escludere dal set di collegamenti che può essere creato per l'elemento di lavoro. L'elemento è di tipo 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 altre informazioni, vedere Riferimento all'elemento tipo di collegamento.
	FilterOn	Attributo Filter facoltativo. Specifica il tipo di filtro da applicare al tipo di collegamento. L'elemento è di tipo semplice: LinksControlFilterOnKind. I valori validi sono: forwardname: per filtrare il nome diretto definito per un tipo di collegamento. reversename: per filtrare il nome inverso definito per un tipo di collegamento. Se non viene specificato alcun valore, sia il nome diretto che quello inverso vengono usati per filtrare il tipo di collegamento. Nota Se la topologia del tipo di collegamento è Rete, il nomi diretto e quello inverso corrispondono.Per altre informazioni, vedere Riferimento all'elemento tipo di collegamento.
ExternalLinkFilters		Elemento LinksControlOptions facoltativo. Fornisce un contenitore per uno o più elementi Filter che specificano i tipi di collegamento che gli utenti possono specificare per creare relazioni con oggetti diversi dagli elementi di lavoro, ad esempio insiemi di modifiche, collegamenti ipertestuali e file nel controllo della versione. L'elemento è di tipo complesso: ExternalLinkFiltersType.
	FilterType	Attributo ExternalLinkFilters facoltativo. Definisce il metodo usato per filtrare l'elenco di tipi di collegamento fornito nel set di elementi Filter. Il tipo di elemento è semplice: LinksControlFilterKind. È possibile usare i seguenti valori: exclude: per impedire la creazione di collegamenti dai tipi di collegamento visualizzati negli elementi Filter. excludeAll: per impedire tutti i tipi di collegamento. include: per consentire solo i tipi di collegamento elencati negli elementi Filter. includeAll: per consentire la creazione di collegamenti da tutti i tipi di collegamento. Se non viene specificato alcun valore, tutti i collegamenti agli elementi di lavoro esterni vengono esclusi.
Filter		Elemento ExternalLinkFilters richiesto quando FilterType è exclude o include. Quando FilterType è excludeAll o includeAll, non devono essere specificati elementi Filter. L'elemento è di tipo complesso: ExternalLinkFilterElementType. Specifica il nome dei tipi di collegamento da includere o escludere 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 di attributo è semplice: ExternalLinkTypeName. È possibile specificare i seguenti tipi di collegamento: Corretto nell'insieme di modifiche Allegato risultati File del codice sorgente Risultato test Collegamento ipertestuale Workitem
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. L'elemento è di tipo complesso: LinksControlWorkItemTypeFiltersElementType.
	Scope	Attributo WorkItemTypeFilters facoltativo. Definisce l'ambito del filtro applicato al set di tipi di elemento di lavoro fornito nel set di elementi Filter. L'elemento è di tipo semplice: LinksControlWorkItemTypeFilterScopeKind. Di seguito sono riportati i valori validi che è possibile usare. all: per consentire la creazione di collegamenti in tutti i tipi di elemento di lavoro specificati nei tag Filter. project: per consentire la creazione di collegamenti solo nei tipi di elemento di lavoro definiti per il progetto corrente. Se non viene specificato alcun valore, vengono consentiti i collegamenti a tutti i tipi di elemento di lavoro.
	FilterType	Attributo WorkItemTypeFilters obbligatorio. Definisce il metodo usato per filtrare il set di tipi di elemento di lavoro fornito nel set di elementi Filter. Il tipo di elemento è semplice: LinksControlWorkItemTypeFilterKind. È possibile usare i seguenti valori: exclude: per impedire i tipi di elemento di lavoro negli elementi Filter. excludeAll: per impedire tutti i tipi di elemento di lavoro. include: per consentire i tipi di elemento di lavoro negli elementi Filter. includeAll: per consentire tutti i tipi di elemento di lavoro. Se non vengono specificati questi valori, vengono consentiti i collegamenti a tutti i tipi di elemento di lavoro.
Filter		Elemento WorkItemTypeFilters facoltativo quando FilterType è exclude o include. Quando FilterType è excludeAll o includeAll, non specificare alcun elemento Filter. Specifica i tipi di elemento di lavoro da includere o escludere dal set di tipi di elemento di lavoro a cui ci si può collegare. 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 di attributo è: typelib:NonEmptyPlainConstant. Lunghezza minima: 1; lunghezza massima: 255. Valore di schema: ^[^\\]*$ Esempio di valore del modello: attività
LinkColumns		Elemento LinksControlOptions facoltativo. Fornisce un contenitore per uno o più elementi LinkColumn. Il tipo di elemento è complesso: LinkColumnsType.
LinkColumn		Elemento LinkColumns obbligatorio. Specifica i campi elemento di lavoro e gli attributi del tipo di collegamento visualizzati per l'elenco di collegamenti definito per un elemento di lavoro. Il tipo di elemento è complesso: LinkColumnType. Questo elenco di colonne è la visualizzazione predefinita. L'utente può aggiungere e rimuovere le colonne dall'elenco dei collegamenti. L'ordine con cui vengono elencati gli elementi LinkColumn definisce l'ordine con cui vengono visualizzati i campi colonna nel form dell'elemento di lavoro.
	RefName	Attributo LinkColumn facoltativo. Specificare RefName o LinkAttribute, ma non entrambi. Specifica il nome di riferimento corrispondente 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 corrispondente agli attributi 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 usare l'elemento LinksControlOptions per supportare le seguenti azioni:

Specificare le restrizioni che regolano la creazione di relazioni con gli altri elementi di lavoro in base al tipo di collegamento e, facoltativamente, i nomi diretti e inversi dei tipi di collegamento.
Specificare le restrizioni che regolano la creazione di relazioni ad oggetti diversi dagli elementi di lavoro, ad esempio insiemi di modifiche, collegamenti ipertestuali e così via in base ai tipi di collegamento esterni.
Specificare le restrizioni che regolano la creazione di relazioni con gli altri elementi di lavoro in base al tipo di elemento di lavoro e, facoltativamente, il progetto team in cui sono definiti tali elementi di lavoro.
Specificare i campi colonna predefiniti dell'elenco dei collegamenti per i quali visualizzare le informazioni.

Esempio

L'esempio seguente specifica come abilitare la creazione di collegamenti di tipo Microsoft.VSTS.Common.TestedBy e visualizzare il 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 corrispondono ai nomi descrittivi seguenti: ID, Tipo di elemento di lavoro, Titolo, Assegnato a, Stato e campo Commento definiti per il collegamento. Per altri 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 LinksControl

Ogni elemento Control di Type=”LinksControl” fornisce una barra degli strumenti che contiene i pulsanti visualizzati nella figura seguente:

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

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

Il pulsante per la creazione di un elemento di lavoro collegato all'elemento di lavoro aperto () diventa disponibile solo dopo aver salvato tale elemento.
I pulsanti per l'apertura dell'elenco di elementi di lavoro in una query () e in un client di Microsoft Office () diventano disponibili solo quando almeno un elemento di lavoro è elencato nella scheda di controllo dei collegamenti.
I pulsanti per l'apertura di un elemento di lavoro (), la modifica di un collegamento () e l'eliminazione di un collegamento () diventano disponibili solo dopo aver fatto clic su uno o più elementi di lavoro elencati nella scheda di controllo dei collegamenti.

Il controllo dei collegamenti visualizzato è uguale per Team Web Access e Team Explorer, eccetto quando viene configurato per eseguire il rendering dei soli collegamenti Storyboard. In questo caso la barra degli strumenti contiene solo i controlli per l'apertura di un nuovo collegamento, l'apertura di un elemento collegato e l'eliminazione del collegamento. Inoltre, la versione Team Web Access visualizza il collegamento Avvia storyboard nel menu di sistema.

Controllo collegamenti storyboard

Definizioni dello schema

LinksControlOptionsType
WorkItemLinkFiltersType
WorkItemLinkFilterElementType
ExternalLinkFiltersType
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>

ExternalLinkFiltersType

<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

Condividi tramite