Editar una definición WIT para agregar contenido web a un formulario de elemento de trabajo

Artículo
06/10/2015

Puede agregar contenido web o contenido HTML a un formulario de elemento de trabajo exportando el archivo XML de la definición de tipo y agregando WebpageControl en la sección FORM. Después de modificar e importar el archivo XML, puede comprobar la presentación del contenido web en el tipo de elemento de trabajo actualizado.

El contenido web que muestra se puede especificar en una de las maneras siguientes:

Dirección URL de una página web
Una ruta de acceso de dirección URL que se determina dinámicamente en tiempo de ejecución basada en uno o más valores de campo definidos para el elemento de trabajo
Contenido HTML

Para obtener información sobre la estructura de sintaxis de los elementos utilizados para agregar el contenido web a un tipo de elemento de trabajo (WIT), vea WebpageControlOptions (Referencia de elementos de XML) y Referencia de los elementos Link y Param de XML.

Requisitos

Debe ser miembro del grupo Administradores de proyectos del proyecto de equipo. Vea Agregar usuarios a proyectos de equipo.

Exportar y abrir el archivo de definición WIT

Siga uno de estos pasos en función del ámbito de la personalización que desee realizar:

Si va a modificar un tipo de elemento de trabajo para un proyecto único:
1. Ejecute witadmin exportwitd para exportar el archivo XML correspondiente al tipo de elemento de trabajo que desea modificar. Para obtener más información, vea Importar, exportar y administrar tipos de elementos de trabajo [witadmin].
2. En Visual Studio, elija Archivo, Abrir, Archivo.
3. En Buscar en, cambie a la ubicación a la que ha exportado el archivo.
Si va a modificar un tipo de elemento de trabajo para personalizar una plantilla de proceso:
1. Busque la ubicación donde descargó la plantilla de proceso.
2. Seleccione el archivo XML del tipo de elemento de trabajo que desea actualizar y, a continuación, elija Abrir. Cuando se le pregunte sobre los finales de línea, haga clic en No.

Agregar contenido web a la sección FORM del archivo de definición

Busque la sección <TabGroup> del archivo XML. Observe que existen elementos <Tab> para elementos tales como vínculos y datos adjuntos, y que cada elemento <Tab> contiene un elemento <Control> que presenta el control respectivo.
```
<Tab Label="Links">
  <Control Type="LinksControl" />
</Tab>
<Tab Label="File Attachments">
  <Control Type="AttachmentsControl" />
</Tab>
```

Agregue un nuevo elemento <Tab> que incluirá el contenido web o HTML que desea mostrar en el formulario de elemento de trabajo. Copie el código siguiente en la sección <TabGroup> del archivo en función de cómo vaya a definir el contenido web.

Para especificar la dirección URL de una página 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>

Reemplace Etiqueta de ficha y Dirección URL de una página web por la información que desea que aparezca en el formulario de elemento de trabajo.

Para especificar una dirección URL dinámica que se determinará en tiempo de ejecución:

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

Reemplace Etiqueta de ficha, Dirección URL de una página web, ruta de acceso de la dirección URL con parámetros y Valor de parámetro 1, 2 y 3 por la información que desea que aparezca en el formulario de elemento de trabajo.

Para especificar el contenido HTML:
```
<Tab Label="Tab Label">
   <Group>
      <Column PercentWidth="100">
         <Control Type="WebpageControl">
            <Content>
               <![CDATA[HTML Content]]>
            </Content>
         </Control>
      </Column>
   </Group>
</Tab>
```
Reemplace Etiqueta de ficha y Contenido HTML por la información que desea que aparezca en el formulario de elemento de trabajo.

Nota

Para obtener los mejores resultados, cada control o grupo debe aparecer en una columna, aun cuando esta ocupe todo el ancho del formulario.A su vez, cada columna debe aparecer en un grupo, aun cuando este no tenga ninguna etiqueta ni límite visible.

Guarde sus cambios en el archivo XML.
Use witadmin importwitd para importar el nuevo tipo de elemento de trabajo a un proyecto único. Para agregar el tipo de elemento de trabajo a la plantilla de proceso, vea Agregar definiciones de tipo de elementos de trabajo a una plantilla de proceso.

Comprobar la página web o el contenido HTML que aparece en el formulario

En Team Explorer, abra Elementos de trabajo para el proyecto de equipo que contiene la definición de WIT que modificó y elija Actualizar.

Las últimas actualizaciones se descargan del servidor, incluso los cambios que acaba de importar. Espere varios segundos hasta que se actualice el nodo Elementos de trabajo. Los nodos que se están cargando muestran la palabra trabajando.
Cree un elemento de trabajo utilizando el WIT modificado.

Compruebe que la página web o contenido HTML aparezcan en el formulario como se espera.
Elija Cerrar para cerrar el nuevo elemento de trabajo.