Modificare una definizione WIT per aggiungere contenuto Web a un form elemento di lavoro

Articolo
06/10/2015

È possibile aggiungere contenuto Web o HTML a un form elemento di lavoro esportando il file XML di definizione del tipo e aggiungendo un oggetto WebpageControl nella sezione FORM. Dopo la modifica e l'importazione del file XML, è possibile verificare la visualizzazione del contenuto Web nel tipo di elemento di lavoro aggiornato.

È possibile specificare il contenuto Web visualizzato in uno dei due modi seguenti:

URL di una pagina Web
Percorso URL determinato dinamicamente in runtime in base a uno o più valori di campo definiti per l'elemento di lavoro
Contenuto HTML

Per informazioni sulla struttura della sintassi degli elementi usati per aggiungere contenuto Web a un tipo di elemento di lavoro (WIT), vedere Riferimento agli elementi XML WebpageControlOptions e Riferimento agli elementi XML Link e Param.

Requisiti

È necessario essere un membro del gruppo Project Administrators per il progetto team. Vedere Aggiungere utenti ai progetti team.

Esportare e aprire il file di definizione del tipo di elemento di lavoro

Eseguire uno dei passaggi seguenti in base all'ambito di personalizzazione che si desidera applicare:

Se si modifica un tipo di elemento di lavoro per un solo progetto:
1. Eseguire witadmin exportwitd per esportare il file XML per il tipo di elemento di lavoro che si desidera modificare. Per altre informazioni, vedere Importare, esportare e gestire tipi di elemento di lavoro [witadmin].
2. In Visual Studio scegliere File, Apri, File.
3. In Cerca in spostarsi nel percorso in cui è stato esportato il file.
Se si modifica un tipo di elemento di lavoro per personalizzare un modello di processo:
1. Individuare il percorso in cui è stato scaricato il modello di processo.
2. Selezionare il file XML del tipo di elemento di lavoro che si desidera aggiornare, quindi scegliere Apri. Quando viene visualizzata la richiesta relativa alle terminazioni di riga, scegliere No.

Aggiungere contenuto Web alla sezione FORM del file di definizione

Individuare la sezione <TabGroup> del file XML. Si noti che sono presenti elementi <Tab> per collegamenti e file allegati in cui ciascun elemento <Tab> contiene un elemento <Control> che esegue il rendering del rispettivo controllo.
```
<Tab Label="Links">
  <Control Type="LinksControl" />
</Tab>
<Tab Label="File Attachments">
  <Control Type="AttachmentsControl" />
</Tab>
```

Aggiungere un nuovo elemento <Tab> che includerà il contenuto Web o HTML che si desidera visualizzare nel form elemento di lavoro. Copiare il codice seguente nella sezione <TabGroup> del file in base alla modalità di definizione del contenuto Web.

Per specificare l'URL di una pagina Web:

<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" >
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="URL of Web Page" />
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>

Sostituire Tab Label e URL of Web Page con le informazioni da visualizzare nel form dell'elemento di lavoro.

Per specificare un URL dinamico da determinare in runtime:

<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl" Name="Webpage" Label=" Name of Web Page" LabelPosition="Top" >
            <WebpageControlOptions AllowScript="false">
               <Link UrlRoot="URL of Web Page" URLPath="URL path with parameters >
      <Param Index="0" Value="Param Value 0"/>
      <Param Index="1" Value="Param Value 1"/>
      <Param Index="2" Value="Param Value 2"/>
               </Link>
            </WebpageControlOptions>
         </Control>
      </Column>
   </Group>
</Tab>

Sostituire Tab Label, URL of Web Page, URL path with parameters e Param Value 1, 2, and 3 con le informazioni da visualizzare nel form dell'elemento di lavoro.

Per specificare contenuto HTML:
```
<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl">
            <Content>
               <![CDATA[HTML Content]]>
            </Content>
         </Control>
      </Column>
   </Group>
</Tab>
```
Sostituire Tab Label e HTML Content con le informazioni da visualizzare nel form dell'elemento di lavoro.

Nota

Per ottenere risultati ottimali, ciascun controllo o gruppo deve essere visualizzato in una colonna anche se questa si estende per l'intera larghezza del form.Ciascuna colonna, a sua volta, deve essere visualizzata in un gruppo anche se questo non dispone di un'etichetta o di un limite visibile.

Salvare le modifiche apportate al file XML.
Usare witadmin importwitd per importare il nuovo tipo di elemento di lavoro in un singolo progetto. Per aggiungere il tipo di elemento di lavoro al modello di processo, vedere Aggiungere definizioni di tipi per elementi di lavoro a un modello di processo.

Verificare che la pagina Web o il contenuto HTML venga visualizzato nel form

In Team Explorer, aprire Elementi di lavoro per il progetto team contenente la definizione del tipo di elemento di lavoro modificata e scegliere Aggiorna.

Gli ultimi aggiornamenti vengono scaricati dal server, incluse le modifiche appena importate. Attendere alcuni secondi che venga completato l'aggiornamento del nodo Elementi di lavoro. Nei nodi ancora in fase di caricamento, viene visualizzata la dicitura in corso.
Creare un elemento di lavoro usando il tipo di elemento di lavoro modificato.

Verificare che la pagina Web o il contenuto HTML venga visualizzato nel form come previsto.
Scegliere Chiudi per chiudere il nuovo elemento di lavoro.