Elementi LinksControlOptions

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 Definizione dei controlli dei collegamenti per limitare le relazioni di collegamento.

L'elemento LinksControlOptions è un elemento figlio di CONTROL.

Gerarchia dello schema

WITD

   WORKITEMTYPE

       FORM

           Layout

               Gruppo

               Column

               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 illustrati attributi, elementi figlio e padre.

Elementi figli e attributi

Elemento	Attribute	Oggetto di 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 l'insieme 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. Il tipo dell'attributo è typelib:ReferenceFieldName. Per ulteriori informazioni, vedere Utilizzo dei tipi 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. revserseName: 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 Utilizzo dei tipi 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 l'insieme 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 l'insieme di progetti team. Il tipo dell'attributo è typelib:ReferenceFieldName.

Elementi padre

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

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

Vedere anche

Concetti

Utilizzo dei tipi di collegamento

Specifica dei controlli dei form elemento di lavoro

Altre risorse

Personalizzazione della correlazione degli elementi di lavoro tramite tipi di collegamento

Definizione dei controlli dei collegamenti per limitare le relazioni di collegamento

Cronologia delle modifiche