Fornitura di Testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro

Articolo
08/11/2011

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

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.

In questo argomento

Fornitura di Testo della guida o di Testo di descrizione comando
Aggiunta di etichette autonome dei campi Testo e Collegamento ipertestuale
Visualizzazione di contenuto Web
Incorporamento di linee guida per il processo

Fornitura di Testo della guida o di 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>

Aggiunta di 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 2010, il tag Text viene visualizzato come collegamento ipertestuale nel quale l'URL è definito dal tag Link.

Esempio: etichetta di campo con collegamento ipertestuale di 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 UrlPath="http://{0}/sites/{1}/render.aspx?wit=bug&amp;topic=Iteration">
            <Param value="@Server"/>
            <Param value="System.Project"/>
         </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

Esempio di collegamento ipertestuale applicato a un'etichetta autonoma

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

Esempio di due collegamenti ipertestuali applicati al testo

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 in base al parametro

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://{0}/sites/{1}/render.aspx?wit=bug&amp;state={2}">
      <Param value="@Server"/>
      <Param value="System.Project"/>
      <Param 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: visualizzazione del contenuto fornito con 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="false">
               <Link UrlRoot="http://www.msdn.com" />
            </WebpageControlOptions >
         </Control>
      </Column>
   </Group>
</Tab>

Esempio: visualizzazione del 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>

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

Cronologia delle modifiche

Data	Cronologia	Motivo
Maggio 2011	Corretta la distinzione tra maiuscole e minuscole di vari 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 tutti gli altri elementi come tutto scritto in maiuscolo.	Correzione di bug nel contenuto.

Maggio 2011

Corretta la distinzione tra maiuscole e minuscole di vari 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 tutti gli altri elementi come tutto scritto in maiuscolo.

Correzione di bug nel contenuto.

Condividi tramite