Condividi tramite


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

               Gruppo

               Column

               Tab

                     Controllo

<xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
<xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>

<LINK URLRoot="URLRoot" URLPath ="URLPathWithParameters">
   <Param index="IndexValue " value="ParamValue " type ="Original | Current"/>
</LINK>

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Elementi figli e attributi

Elemento

Attribute

Oggetto di 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:

NotaNota
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).

  • @ProcessGuidanceUrl: 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 e 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 1.

 

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

Oggetto di descrizione

Controllo

Obbligatoria. 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: WebpageControlOptions Elements.

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

Oggetto di 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&amp;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="1 " value="System.Project"/>
</Link>

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

Oggetto di 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

Oggetto di 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

Specifica dei controlli dei form elemento di lavoro

Progettazione e personalizzazione di un form elemento di lavoro

Altre risorse

Elements (Work Item Type Definition Schema)

Cronologia delle modifiche

Data

Cronologia

Motivo

Maggio 2011

Sono state corrette le maiuscole/minuscole di diversi elementi e attributi della sintassi XML. La definizione dello schema per la gestione degli elementi di lavoro definisce tutti gli elementi figlio dell'elemento FORM come maiuscole-minuscole camel e porta in maiuscolo tutte le lettere nei nomi degli altri elementi.

Correzione di bug nel contenuto.

Gennaio 2011

Rimosso collegamenti a argomenti rimossi.

Miglioramento delle informazioni.