Riferimento agli elementi XML Link e Param

È possibile aggiungere un collegamento ipertestuale a un campo o a un'etichetta autonoma in un form dell'elemento di lavoro tramite l'elemento Link. L'elemento Link viene usato nelle istanze seguenti per:

• Aggiungere un collegamento ipertestuale a un'etichetta di campo

• Aggiungere un collegamento ipertestuale a un'etichetta autonoma o a parti di testo informativo

• Specificare l'URL per il contenuto da visualizzare all'interno di un form dell'elemento di lavoro

Per aggiungere elementi a un form, modificare la definizione per un tipo di elemento di lavoro. Vedere Modificare o aggiungere un tipo di elemento di lavoro personalizzato (WIT).

L'elemento Link è un elemento figlio dell'elemento Control o un elemento figlio degli elementi WebpageControlTarget o WebpageControlOptions. Per altre informazioni su questi elementi, vedere Riferimento all'elemento XML Control e Riferimento agli elementi XML WebpageControlOptions.

Gerarchia dello schema

WITD

   WORKITEMTYPE

       FORM

           Layout

               Gruppo

               Colonna

               Tab

                     Controllo

<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters">    <Param Index="IndexValue " Value="ParamValue " Type ="Original | Current"/> </Link>

Attributi ed elementi

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

Elementi figli e attributi

Elemento	Attributo	Descrizione
Link		Elemento Control facoltativo quando type="FieldControl". Elemento LabelText facoltativo. Elemento Text facoltativo. Elemento WebpageControlOptions facoltativo. Elemento del contenitore per la definizione di un collegamento ipertestuale o un URL. Il tipo di elemento è complesso: HyperLinkType.
	UrlRoot	Attributo Link obbligatorio. Specifica il protocollo e il nome del server dell'URL a cui viene collegata l'etichetta. I protocolli supportati sono HTTP, HTTPS e MAILTO. È possibile impostare come hardcoded il nome del server specificato o è possibile usare una delle macro seguenti e aggiungere facoltativamente altre informazioni sull'indirizzo a una macro: Nota Ogni macro viene collegata all'URL definito e abilitato per il progetto team del form dell'elemento di lavoro per il quale viene definito l'elemento Link.Se per il progetto team non viene abilitata alcuna risorsa o non ne viene eseguito il provisioning, verrà visualizzato l'errore "pagina non trovata". @PortalPage: URL del sito di SharePoint per il progetto team corrente (ad esempio, http://NomeServer/sites/NomeRaccolta/NomeProgettoTeam). @ProcessGuidance: URL del sito di SharePoint per le linee guida del processo per un progetto team. @ReportManagerUrl: URL del server che ospita Gestione report per il progetto team corrente. Fornisce un collegamento alla visualizzazione cartelle per i report (ad esempio, http://NomeServer/Reports/Pages/Folder.aspx?ItemPath=/NomeRaccolta/NomeProgettoTeam). @ReportServiceSiteUrl: URL del server che ospita SQL Server Reporting Services per il progetto team corrente più il percorso di base per il progetto team (ad esempio, http://NomeServer/Reports/Pages/reportservice.asmx?ItemPath=/NomeRaccolta/NomeProgettoTeam). Per determinare il valore hardcoded per le prime due macro, è possibile aprire le impostazioni del portale del progetto per un progetto team. Per altre informazioni, vedere Configurare o reindirizzare linee guida per il processo. Il tipo di attributo è semplice: NonBlankString.
	UrlPath	Attributo Link facoltativo. Specifica un percorso dell'URL per il collegamento ipertestuale. Usare questo attributo per specificare i parametri variabili determinati in fase di esecuzione. Il tipo di attributo è semplice: NonBlankString.
Param		Elemento Link facoltativo. Obbligatorio quando UrlPath è specificato. Specifica un valore da usare per determinare l'URL del collegamento ipertestuale quando UrlPath viene specificato. Il tipo di elemento è complesso: HyperLinkParamType.
	Index	Attributo Param obbligatorio. Specifica l'indice del parametro in cui è necessario formattare il valore nella stringa URL. Non è necessario ordinare in sequenza i valori di indice; tuttavia, devono corrispondere al numero dell'indice nella stringa URLPath. Il tipo dell'attributo è PositiveInteger. Il primo numero di indice deve essere 0.
	Value	Attributo Param obbligatorio. Specifica il numero associato al valore di un percorso URL per il collegamento ipertestuale. Specifica un valore che deve essere formattato nella stringa URLPath. I valori devono essere nomi di riferimento validi di campi usati nella definizione del tipo di elemento di lavoro. La variabile @Me è supportata. Viene sostituita con il nome del membro del team corrente che sta visualizzando il form dell'elemento di lavoro. Le voci del valore non fanno distinzione tra maiuscole e minuscole. Il tipo dell'attributo è xs:string.
	Type	Attributo Param facoltativo. Specifica che per il parametro deve essere usato il valore originale del campo. Il tipo di attributo è semplice: HyperLinkParamValueKind. I valori validi sono i seguenti: Original: specifica di usare il valore del parametro originale per determinare il percorso dell'URL. Current: specifica di usare il valore del parametro corrente per determinare il percorso dell'URL. Se questo attributo non viene specificato, viene usato il valore corrente del campo come parametro.

Elementi padre

Elemento	Descrizione
Controllo	Obbligatorio. Definisce un campo, un testo, un collegamento ipertestuale o un altro elemento di controllo da visualizzare nel form dell'elemento di lavoro.
LabelText	Elemento Control facoltativo. Elemento del contenitore per un'etichetta da visualizzare nel form dell'elemento di lavoro.
Text	Elemento LabelText facoltativo. Elemento del contenitore per le informazioni o l'etichetta da visualizzare nel form dell'elemento di lavoro.
WebpageControlOptions	Elemento Control facoltativo. Elemento del contenitore che specifica le opzioni per il controllo pagina Web. Per altre informazioni, vedere Displaying Web Content within a Work Item Form.

Note

Il comportamento predefinito dell'elemento Link è aprire il collegamento ipertestuale nel form dell'elemento di lavoro o nella pagina Web. Se il collegamento ipertestuale viene creato per essere aperto in una nuova finestra (target="_blank"), verrà aperto un browser esterno.

È possibile combinare testo con collegamento ipertestuale e testo normale aggiungendo più elementi Text in un elemento LabelText.

L'elemento LabelText viene riconosciuto solo dai client che eseguono la versione più recente di Team Explorer. Pertanto, è necessario specificare l'attributo Label in un elemento Control quando si specifica un elemento Link figlio. Per i client che eseguono l'ultima versione di Team Explorer, nel form dell'elemento di lavoro viene visualizzato il testo fornito da un elemento LabelText. Per i client che eseguono versioni precedenti di Team Explorer, nel form dell'elemento di lavoro viene visualizzato il testo specificato dall'attributo Label dell'elemento Control.

Esempio: specifica di un collegamento ipertestuale con i parametri

Descrizione

L'esempio seguente mostra come definire un collegamento ipertestuale che viene collegato alle linee guida del processo per l'argomento Iteration:

http://NomeServer/sites/NomeRaccolta/NomeProgetto/render.aspx?wit=bug&topic=Iteration

Il nome del progetto deriva dal valore assegnato al campo System.Project.

Codice

<Link UrlRoot="https://serverName" UrlPath="sites/{0}/render.aspx?wit=bug&amp;topic=Iteration">
   <Param Index="0" Value="System.Project" />
</Link>

Esempio: aggiunta di un collegamento ipertestuale a un'etichetta autonoma

Descrizione

L'esempio seguente mostra come assegnare un collegamento ipertestuale al testo "work item guidance" in un form dell'elemento di lavoro.

Codice

<Control type="LabelControl">
   <LabelText> 
      <Text>
         <Link UrlRoot="https://www.msn.com" />
      work item guidance
      </Text>
   </LabelText> 
</Control>

Esempio: aggiunta di un collegamento ipertestuale a un campo

Descrizione

L'esempio seguente mostra come aggiungere un collegamento ipertestuale all'etichetta per un campo in un form dell'elemento di lavoro.

Codice

<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="This text comes from the Label attribute:">
   <LabelText>
      <Text>
         <Link UrlRoot="http://www.live.com/" />
         This text comes from the inner Label Text
      </Text>
   </LabelText>
</Control>

Definizioni dello schema

• HyperLinkType

• NonBlankString

• HyperLinkParamType

• HyperLinkParamValueKind

Tipo complesso: HyperLinkType

<xs:complexType name="HyperLinkType" >
   <xs:sequence>
      <xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
   <xs:attribute name="UrlRoot"  type="NonBlankString" use="required" />
   <xs:attribute name="UrlPath"  type="NonBlankString" use="optional" />
</xs:complexType>

HyperLinkParamType

<xs:complexType name="HyperLinkParamType" >
   <xs:attribute name="Index"     type="PositiveInteger" use="required" />
   <xs:attribute name="Value"     type="xs:string" use="required" />
   <xs:attribute name="Type" type="HyperLinkParamValueKind" use="optional" />
</xs:complexType>

NonBlankString

<xs:simpleType name="NonBlankString">
   <xs:restriction  base="xs:string">
   <xs:pattern value=".*\S+.*"/>
   </xs:restriction>
</xs:simpleType>

HyperLinkParamValueKind

<xs:simpleType name="HyperLinkParamValueKind">
   <xs:restriction base="xs:string">
   <xs:enumeration value="Original"/>
   <xs:enumeration value="Current"/>
   </xs:restriction>
</xs:simpleType>   

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	HyperLinkType, HyperLinkParamType
Può essere vuoto	Non applicabile

Vedere anche

Concetti

Specificare i controlli dei form elemento di lavoro

Progettare il form elemento di lavoro