Fornire il testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in 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 la rendono facilmente disponibili, i membri del team potranno tenere traccia più agevolmente di dati utili.

Utilizzando 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.

Modifica il form elemento di lavoro modificando la definizione per il tipo di elemento di lavoro.È possibile utilizzare lo strumento da riga di comando witadmin, vedere Personalizzare e gestore i 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.Trova sotto il menu strumenti, l'editor di processo fornisce un'interfaccia utente grafica per personalizzare gli oggetti utilizzati per gestire gli elementi di lavoro in Team Foundation Server.È possibile utilizzare questo strumento per importare ed esportare i tipi di elemento di lavoro e modificare le definizioni.Per ulteriori informazioni, vedere la pagina seguente sul sito Web Microsoft: Power Tool di Team Foundation Server.

Fornire testo della Guida o il testo di descrizione comando

È possibile fornire testo della guida in una delle due modalità seguenti.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.Utilizzando 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 utilizzando 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.Utilizzando l'elemento Link, è inoltre possibile aggiungere un collegamento facoltativo a ulteriori informazioni, come illustrato 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 le etichette autonome dei campi testo e collegamento ipertestuale

È possibile aggiungere testo a un form elemento di lavoro non associato ad alcun campo elemento di lavoro utilizzando l'opzione LabelControl per l'attributo Type dell'elemento Control.Il testo può essere normale o di tipo collegamento ipertestuale.È inoltre 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 "Inserire i dettagli del bug qui.È consigliabile completare anche i campi che non sono obbligatori." 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

Nell'esempio riportato di seguito viene illustrato 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 nel quale l'URL è definito dal tag Link.

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

Nell'esempio riportato di seguito viene illustrato come aggiungere un collegamento ipertestuale a un'etichetta di campo.In questo esempio, l'URL viene 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

Nell'esempio riportato di seguito viene illustrato 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: utilizzo di testo e collegamenti ipertestuali in una singola etichetta

Utilizzo di testo e collegamenti ipertestuali in una singola etichetta

Nell'esempio riportato di seguito viene illustrato come aggiungere due collegamenti ipertestuali a un'etichetta di 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 collegamento ipertestuale generata

Nell'esempio riportato di seguito viene illustrato come aggiungere un collegamento ipertestuale a un'etichetta di campo generata dai valori del parametro 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 utilizzare 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 rapporto, 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: il contenuto fornito da un URI

Nell'esempio seguente viene illustrato 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" Dock="Fill">
            < WebpageControlOptions AllowScript="true">
               <Link UrlRoot="http://www.msdn.com" />
            </WebpageControlOptions >
         </Control>
      </Column>
   </Group>
</Tab>

Esempio: contenuto fornito in un tag CDATA

Nell'esempio seguente viene illustrato 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>

Importare le linee guida per il processo

Per rendere disponibili le linee guida per il processo nel form elemento di lavoro, è necessario aggiungere una scheda contenente informazioni sul flusso di lavoro e sull'utilizzo del tipo di elemento di lavoro.Questo è possibile utilizzando l'opzione WebpageControl dell'attributo Type.Questa opzione fornisce supporto per incorporare testo in formato dettagliato 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 layout del form elemento di lavoro

Personalizzare dati di rilevamento, form, flusso di lavoro e altri oggetti del progetto