Riferimento agli elementi XML Link e Param

È possibile aggiungere un collegamento ipertestuale a un campo o a un'etichetta autonoma su un form elemento di lavoro tramite l'elemento Link.Si utilizza l'elemento Link nelle seguenti istanze:

• Aggiungere un collegamento ipertestuale a un'etichetta di campo

• Aggiungere un collegamento ipertestuale a un etichetta autonoma o porzioni di testo informativo.

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

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

Gerarchia dello schema

WITD

   WORKITEMTYPE

       FORM

           Layout

               Raggruppare

               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 ai quali si collega l'etichetta.Protocolli supportati sono HTTP, HTTPS e MAILTO. Si può codificare il nome del server specificato o è possibile utilizzare una delle macro seguenti e aggiungere facoltativamente informazioni aggiuntive sull'indirizzo a una macro: Nota Ogni macro collega all'URL definito e abilitato per il progetto team del form dell'elemento di lavoro per il quale l'elemento Link viene definito.Se una risorsa qualsiasi non viene sottoposta a provisioning o non viene abilitata per il progetto team, sarà visualizzato un errore di "pagina non trovata". @PortalPage: URL del sito di SharePoint per il progetto team corrente (ad esempio, https://serverName/siti/collectionName/TeamProjectName). @ProcessGuidance: URL di SharePoint per le linee guida del progetto team. @ReportManagerUrl: URL del server che ospita Gestione rapporti per il progetto team corrente.Fornisce un collegamento alla visualizzazione della cartella per i rapporti (ad esempio, https://serverName/Reports/Pages/Folder.aspx? ItemPath =/collectionName/teamProjectName). @ReportServiceSiteUrl: URL del server che ospita il SQL Server Reporting Services per il progetto team corrente più il percorso di base per il progetto team (ad esempio, https://serverName/Reports/Pages/reportservice.asmx?ItemPath=/collectionName/teamProjectName). Per determinare il valore codificato per le prime due macro, è possibile aprire le impostazioni del portale del progetto per un progetto team.Per ulteriori informazioni, vedere Accedere a un portale del progetto team o alle linee guida per il processo. Il tipo dell'attributo è semplice: NonBlankString.
	UrlPath	Attributo Link facoltativo. Specifica un percorso dell'URL per il collegamento ipertestuale.Si utilizza questo attributo per specificare parametri variabili determinati in fase di esecuzione.Il tipo dell'attributo è semplice: NonBlankString.
Param		Elemento Link facoltativo.Obbligatorio quando UrlPath è specificato. Specifica un valore da utilizzare 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 dove è necessario formattare il valore nella stringa URL.Non è necessario per 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 relativo a un percorso URL per il collegamento ipertestuale. Specifica un valore che deve essere formattato nella stringa URLPath.I valori devono essere nomi riferimento validi di campi utilizzati nella definizione del tipo di elemento di lavoro. La variabile @Me è supportata.Viene sostituito con il nome del membro del team corrente che sta visualizzando il form elemento di lavoro.Le voci del valore non rilevano la distinzione tra maiuscole e minuscole. Il tipo dell'attributo è xs:string.
	Type	Attributo Param facoltativo. Specifica che il valore originale del campo deve essere utilizzato per il parametro.Il tipo dell'attributo è semplice:HyperLinkParamValueKind. È possibile impostare i seguenti valori: Original: specifica di utilizzare il valore del parametro originale per determinare il percorso dell'URL. Current: specifica di utilizzare il valore del parametro corrente per determinare il percorso dell'URL. Se non è specificato questo attributo, il valore corrente del campo viene utilizzato come un parametro

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.
LabelText	Elemento Control facoltativo. Elemento del contenitore per un'etichetta da visualizzare nel form dell'elemento di lavoro.
Testo	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 ulteriori informazioni, vedere Displaying Web Content within a Work Item Form.

Note

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

È possibile combinare testo con collegamento ipertestuale e 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 stanno eseguendo l'ultima versione di Team Explorer, il testo fornito dall'elemento LabelText viene visualizzato nel form elemento di lavoro.Per i client che stanno eseguendo precedenti versioni di Team Explorer, il testo specificato dall'elemento Control attributo Label viene visualizzato nel form elemento di lavoro.

Esempio: Specifica un collegamento ipertestuale con i parametri

Descrizione

L'esempio seguente mostra come è possibile definire un collegamento ipertestuale che collega alle linee guida del processo per l'argomento Iterazione:

https://serverName/sites/collectionName/projectName/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

Nel seguente esempio viene visualizzato come assegnare un collegamento ipertestuale al testo "linee guida per elemento di lavoro" in un form elemento di lavoro.

Codice

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

Esempio: Aggiungere un collegamento ipertestuale a un campo

Descrizione

Nel seguente esempio viene visualizzato come aggiungere un collegamento ipertestuale all'etichetta per un campo in un form 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 controlli dei form elemento di lavoro

Progettare e personalizzare un form elemento di lavoro

Altre risorse

Elements (Work Item Type Definition Schema)