Fornire testo della Guida, collegamenti ipertestuali o contenuto Web su un form elemento di lavoro

Quando si personalizza il form elemento di lavoro, è opportuno fornire informazioni o collegamenti a contenuto per consentire al team di definire i campi nel form. Se si incorporano informazioni nel form o le si rendono facilmente disponibili, i membri del team potranno tenere traccia più agevolmente dei dati utili.

Usando i controlli del form descritti in questo argomento è possibile aggiungere testo di descrizione comando per i singoli campi, testo autonomo, collegamenti ipertestuali a pagine Web, contenuto HTML incorporato o contenuto Web nel form.

Si modifica il form elemento di lavoro modificando la definizione per il tipo di elemento di lavoro. È possibile usare lo strumento da riga di comando witadmin (vedere Importare, esportare e gestire tipi di elemento di lavoro [witadmin]) o l'Editor di processo.

L'editor di processo è un componente aggiuntivo dello strumento avanzato per Visual Studio che è possibile scaricare e installare. Situato nel menu Strumenti, l'editor di processo fornisce un'interfaccia utente grafica per personalizzare gli oggetti usati per gestire gli elementi di lavoro in Team Foundation Server. Questo strumento consente di importare ed esportare tipi di elemento di lavoro e modificarne le definizioni. Per altre informazioni, vedere la pagina nel sito Web Microsoft Power Tools di Team Foundation Server.

Fornire il testo della Guida o il testo della descrizione comando

È possibile fornire testo della Guida in due modi. Nel primo metodo, si aggiunge l'elemento HELPTEXT come elemento figlio all'elemento FIELD nella sezione FIELDS della definizione del tipo. Tramite HELPTEXT si crea la descrizione comando per il campo. Con questo metodo il testo è limitato a 255 caratteri.

<FIELD name="Sub-Title" refname="ACME.ACE.ImpactStatement" type="HTML" >
<HELPTEXT>Provide information about the impact to the ACE organization. </HELPTEXT>
</FIELD>

Nel secondo metodo, si specifica testo autonomo usando gli elementi figlio LabelText e Text. Con questo metodo è possibile aggiungere quante informazioni si desiderano e il testo sarà sempre presente nel form. Non è necessaria alcuna azione da parte dell'utente. Usando l'elemento Link è possibile anche aggiungere un collegamento facoltativo a ulteriori informazioni, come mostrato nell'esempio seguente.

<Control FieldName=" ACME.ACE.ImpactStatement" Type="HTMLControl" Label="Impact" LabelPosition="Left"> 
   <LabelText>
      <Text>Provide information about the impact to the ACE organization. Specifically address the following: customer segment, target strategic opportunity, resources required, and time dependencies. For more detailed information, see the Impact Statement specification at:
         <Link OpenInNewWindow="true" UrlRoot=http://ACE.ImpactStatement.aspx />
      </Text>
   </LabelText>
</Control>

Aggiungere etichette di campo di collegamento ipertestuale e testo autonome

È possibile aggiungere testo a un form elemento di lavoro non associato ad alcun campo elemento di lavoro mediante l'opzione LabelControl per l'attributo Type dell'elemento Control. Il testo può essere normale o con collegamento ipertestuale. È anche possibile associare un collegamento ipertestuale a un'etichetta di campo aggiunta mediante l'opzione FieldControl.

Esempio: etichetta di testo normale

Nell'esempio seguente viene aggiunto il testo normale "Fill in the details of the bug here. Fields that are not required are recommended to be filled in." al campo elemento di lavoro.

<Control Type="LabelControl" Label="Fill in the details of the bug here. Fields that are not required are recommended to be filled in." />

Esempio: etichetta di campo con collegamento ipertestuale

L'esempio seguente mostra come aggiungere un collegamento ipertestuale a un'etichetta di campo.

<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="Title 1"
   <LabelText>
      <Text>
         <Link UrlRoot="http://www.live.com/" />
            Title 2
      </Text>
   </LabelText>
</Control>

Nota

Per i client Team Foundation in cui non è stato eseguito l'aggiornamento alla versione più recente, viene visualizzato il testo dell'attributo Label.Per i client Visual Studio 2012, il tag Text viene visualizzato come collegamento ipertestuale in cui l'URL è definito dal tag Link.

Esempio: etichetta di campo con collegamento ipertestuale per una parte del testo

L'esempio seguente mostra come aggiungere un collegamento ipertestuale a una parte di un'etichetta di campo. In questo esempio l'URL è determinato dai valori assegnati agli elementi Param in base all'elemento di lavoro specifico.

<Control Type="FieldControl" FieldName="System.IterationPath">
   <LabelText LabelPosition="Left">
      <Text>
         <Link UrlRoot="@ProcessGuidance" UrlPath="{0}.html">
            <Param Index="0" vValue"System.WorkItemType"/>         </Link>
            Iteration Path
      </Text>
      <Text> (must be 3 levels deep)</Text>
   </LabelText>
</Control>

Esempio: etichetta di testo con collegamento ipertestuale

Etichetta di testo con collegamento ipertestuale

L'esempio seguente mostra come aggiungere un collegamento ipertestuale al testo visualizzato in un form elemento di lavoro.

<Group>
   <Column PercentWidth="100">
      <!-- Standalone label control 2 -->
      <Control Type="LabelControl" Label="How do I use this work item?">
         <Link UrlRoot="http://www.live.com"></Link>
      </Control>
   </Column>
</Group>

Esempio: combinazione di testo e collegamenti ipertestuali in una singola etichetta

Combinazione di testo e collegamenti ipertestuali in una singola etichetta

L'esempio seguente mostra come aggiungere due collegamenti ipertestuali a parti di un'etichetta in un form elemento di lavoro.

<Group>
   <Column PercentWidth="100">
   <!-- Standalone label control 3 -->
      <Control Type="LabelControl" Name="Microsoft.VSTS.Common.GuidanceLabel3">
         <LabelText>
            <Text>Click here for </Text>
            <Text>
               <Link UrlRoot="https://www.msn.com"></Link>
               work item guidance</Text>
            <Text> or here for </Text>
            <Text>
               <Link UrlRoot="http://www.msdn.com"></Link>
               process guidance
            </Text>
         </LabelText>
      </Control>
   </Column>
</Group>

Esempio: etichetta di campo con collegamento ipertestuale generata da parametro

L'esempio seguente mostra come aggiungere un collegamento ipertestuale a un'etichetta di campo generata dai valori di parametro che vengono valutati per l'elemento di lavoro aperto.

<Control Type="FieldControl" FieldName="System.State" Label="&amp;State:" LabelPosition="Left">
   <Link OpenInNewWindow="true" UrlRoot="http://" UrlPath="myserver.com:8080/tfs/myproject/{0}/_workItems#_a=edit&id=">      <Param Index="0" Value="System.State" Type ="Original"/>
   </Link>
</Control>

Visualizzazione di contenuto Web

È possibile usare l'opzione WebpageControl dell'attributo Type per visualizzare il contenuto Web nel form elemento di lavoro come controllo anziché come collegamento a una pagina Web separata. Questa visualizzazione può essere utile per fornire metriche che consentono ai membri del team di visualizzare il contenuto di un report, di un dashboard o altro contenuto HTML. È possibile fornire un collegamento al contenuto o incorporare il contenuto HTML non elaborato in un tag CDATA.

Esempio: visualizzazione del contenuto fornito da un URI

L'esempio seguente mostra come incorporare il contenuto di una pagina Web fornendo l'URL alla pagina tramite gli elementi WebpageControlOptions e Link.

<Tab Label="Web">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="WssPortalPage" Label="WssPortalPage" LabelPosition="Top" >
            < WebpageControlOptions AllowScript="true">
               <Link UrlRoot="http://www.msdn.com" />
            </WebpageControlOptions >
         </Control>
      </Column>
   </Group>
</Tab>

Esempio: visualizzazione del contenuto fornito in un tag CDATA

L'esempio seguente mostra come aggiungere contenuto HTML a un form elemento di lavoro contenuto in un tag CDATA.

<Control Type="WebpageControl">
   <WebpageControlOptions>
      <Content>
      <![CDATA[Place HTML Formatted Content Here ]]
   </Content>
   </WebpageControlOptions >
</Control>

Incorporare le linee guida per il processo

Per rendere disponibili le linee guida per il processo nel form elemento di lavoro, è possibile aggiungere una scheda contenente informazioni sul flusso di lavoro e sull'uso del tipo di elemento di lavoro. Questo è possibile mediante l'opzione WebpageControl dell'attributo Type. Questa opzione fornisce supporto per incorporare testo formattato e immagini nel form tramite gli elementi figlio WebpageControlOptions e Content.

<FORM>
. . .
<TabGroup>
. . . 
   <Tab Label="Process Guidance">
      <Group>
         <Column PercentWidth="100">
            <Control Type="WebpageControl">
            <WebpageControlOptions >
            <Content>
               <![CDATA[Place HTML Formatted Process Guidance Content Here ]]>
            </Content>
            </WebpageControlOptions>
            </Control>
         </Column>
      </Group>
   </Tab>
. . .
</TabGroup>
. . .
</FORM>

Vedere anche

Concetti

Progettare il form elemento di lavoro

Personalizzare oggetti di rilevamento degli elementi di lavoro per supportare i processi del team