Aggiungere contenuto Web a un form elemento di lavoro

  • Articolo

È 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 utilizzati per aggiungere contenuto Web a un form elemento di lavoro, vedere Riferimento agli elementi XML WebpageControlOptions e Riferimento agli elementi XML Link e Param.

Sommario degli argomenti

  • Esportare e aprire il file di definizione dei tipi di elemento di lavoro

  • Aggiungere contenuto Web alla sezione FORM del file di definizione

  • Verificare che la pagina Web o il contenuto HTML venga visualizzato nel form elemento di lavoro

Autorizzazioni necessarie

Per eseguire questa procedura, è necessario essere membro del gruppo Administrators di Team Foundation o del gruppo Project Administrators per il progetto. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

Esportare e aprire il file di definizione dei tipi di elemento di lavoro

Per esportare e aprire il file di definizione dei tipi 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 ulteriori informazioni, vedere Esportare e importare tipi di elementi di lavoro da un progetto esistente.

    2. In Visual Studio scegliere Apri dal menu File, quindi fare clic su File.

      Viene visualizzata la finestra di dialogo 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

Per aggiungere contenuto Web a un form elemento di lavoro

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

  2. 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" Dock="Fill">
            <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 che si desidera visualizzare nel form 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" Dock="Fill">
            <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 e 3 con le informazioni che si desidera visualizzare nel form 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 che si desidera visualizzare nel form 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.

  3. Fare clic su Salva sulla barra degli strumenti per salvare le modifiche apportate al file XML.

  4. Per importare il nuovo tipo di elemento di lavoro in un singolo progetto, vedere Esportare e importare tipi di elementi di lavoro da un progetto esistente. 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 elemento di lavoro

Per verificare le modifiche apportate al form elemento di lavoro

  1. In Team Explorer fare clic con il pulsante destro del mouse sul nodo del progetto team che contiene la definizione del tipo di elemento di lavoro modificato 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.

  2. Creare un elemento di lavoro basato sul tipo di elemento di lavoro modificato facendo clic con il pulsante destro del mouse sul nodo Elementi di lavoro, scegliendo Aggiungi elemento di lavoro e facendo quindi clic sul tipo di elemento di lavoro.

    L'elemento di lavoro viene creato dal tipo di elemento di lavoro modificato.

    Verificare che la pagina Web o il contenuto HTML venga visualizzato nella nuova scheda aggiunta.

  3. Scegliere Chiudi per chiudere il nuovo elemento di lavoro. Scegliere No quando viene visualizzata la richiesta di salvare l'elemento di lavoro.

Vedere anche

Attività

Aggiungere e personalizzare un tipo di elemento di lavoro

Riferimenti

Riferimento agli elementi XML WebpageControlOptions

Riferimento agli elementi XML Link e Param

Personalizzazione e gestione dei tipi di elemento di lavoro [witadmin]

Concetti

Specificare controlli dei form elemento di lavoro

Progettare e personalizzare un form elemento di lavoro