Cambiar el diseño del formulario del elemento de trabajo

Artículo
11/30/2021
5 minutos para leer

TFS 2017 | TFS 2015 | TFS 2013

Puede cambiar el diseño del formulario de elemento de trabajo exportando el archivo XML y modificando el contenido de la FORM sección. Después de modificar e importar el archivo XML, puede comprobar los cambios realizados en el tipo de elemento de trabajo actualizado. Entre los tipos de cambios de diseño que puede realizar se incluyen los siguientes, entre otros:

Cambiar la etiqueta o posición de un campo en el formulario
Mover grupos de campos de una pestaña a otra
Agregar nuevas pestañas o columnas

Importante

Este tema se aplica a la personalización de proyectos para los modelos de proceso XML local (TFS 2017 y versiones anteriores) mediante el diseño de formulario antiguo. Para TFS 2017 y versiones posteriores, vea Elementos WebLayout y Control.

Para el modelo de proceso de herencia, vea Personalizar un proceso. Para obtener información general sobre los modelos de proceso, consulte Personalización de la experiencia de seguimiento de trabajo.

Para obtener información general sobre los controles que puede colocar en un formulario de elemento de trabajo, vea Especificar controles de formulario de elemento de trabajo. Para obtener información general sobre los elementos estructurales de nivel superior de la FORM sección , vea. Diseñe el formulario de elemento de trabajo.

Actualización de la definición XML de un WIT

Si no está nuevo en la personalización de WIT, tenga en cuenta lo siguiente:

Para personalizar cualquier aspecto de un WIT, es necesario actualizar la definición XML del WIT. La definición DE XML de WIT se describe en Referencia de todos los elementos XML WITD
Si va a personalizar el formulario web que usa la nueva experiencia de elemento de trabajo, querrá hacer referencia a los elementos WebLayout y Control.
Si va a personalizar un formulario de cliente para su Visual Studio, querrá hacer referencia a la referencia del elemento XML de diseño.
Siga la secuencia de pasos que se describen en Personalización del formulario web de seguimiento de elementos de trabajo.

Exportar y abrir el archivo de definición WIT

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

Si va a modificar un tipo de elemento de trabajo para un único proyecto:

Ejecute witadmin exportwitd para exportar el archivo XML del tipo de elemento de trabajo que desea modificar. Para obtener más información, vea Importar, exportar y administrar tipos de elementos de trabajo.
Abra el archivo en Visual Studio.

Si va a modificar un WIT para personalizar una plantilla de proceso:

Desplácese a la ubicación donde descargó la plantilla de proceso.
Abra el archivo XML de WIT.

Cambiar el diseño de la sección FORM

Busque la <TabGroup> sección del archivo XML. Observe que hay elementos para elementos como Vínculos y Datos adjuntos de archivo en los que cada elemento contiene <Tab> un elemento que representa el control <Tab><Control> correspondiente.
```
<Tab Label="Links">  
      <Control Type="LinksControl" />  
</Tab>  
<Tab Label="File Attachments">  
      <Control Type="AttachmentsControl" />  
</Tab>  
```
Combine los dos elementos en un único elemento Links y Attachments que contenga ambos controles reemplazando el XML mostrado en el paso anterior por el nuevo XML que se muestra <Tab><Tab> en el ejemplo siguiente:
```
<Tab Label="Links and Attachments">  
      <Control Type="LinksControl" Label="Links" LabelPosition="Top" />  
      <Control Type="AttachmentsControl" Label="Attachments" LabelPosition="Top" />  
</Tab>  
```
Busque la sección de <FORM> la definición de , <Layout> que describe el grupo que desea modificar, como el grupo Clasificación.
```
<Group Label="Classification">  
      <Column PercentWidth="100">  
       <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />  
       <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />  
      </Column>  
</Group>  
```
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.

Seleccione y copie las líneas siguientes en el Portapapeles para utilizarlas más tarde.


<Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" /> <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />

Elimine las líneas que empiezan por y terminan en el siguiente XML para quitar el grupo <Group Label="Classification"> Clasificación de su posición actual en el <Group> formulario.

<Layout>  
      <Group>  
       <Column PercentWidth="70">  
      <Control Type="FieldControl" FieldName="System.Title" Label="&Title:" LabelPosition="Left" />  
       </Column>  
       <Column PercentWidth="30">  
      <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Discipline" Label="&Discipline:" LabelPosition="Left" />  
       </Column>  
      </Group>  
      <Group Label="Classification">       <Column PercentWidth="100">      <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="&Area:" LabelPosition="Left" />      <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="&Iteration:" LabelPosition="Left" />       </Column>      </Group>

En la <TabGroup> sección , busque las líneas siguientes que definen la <TabGroup> Detalles:

<Tab Label="Details">  
      <Group>  
       <Column PercentWidth="50">  
      <Group Label="General">  
       <Column PercentWidth="100">  
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&ue:" LabelPosition="Left" />  
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.ExitCriteria" Label="E&xit criteria:" LabelPosition="Left" />  
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Build.IntegrationBuild" Label="Integration &build:" LabelPosition="Left" />  
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.TaskHierarchy" Label="Task C&ontext:" LabelPosition="Left" ReadOnly="True" />  
       </Column>  
      </Group>  
       </Column>  
       <Column PercentWidth="50">  
      <Group Label="Schedule">  
       <Column PercentWidth="100">  
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Label="Remaining &work (hours):" LabelPosition="Left" />  
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Label="Com&pleted work (hours):" LabelPosition="Left" />  
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.StartDate" Label="Start Dat&e:" LabelPosition="Left" ReadOnly="True" />  
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.FinishDate" Label="&Finish Date:" LabelPosition="Left" ReadOnly="True" />  
       </Column>  
      </Group>  
       </Column>  
      </Group>  
</Tab>

Para mover estos controles a la pestaña Detalles, pegue el contenido del Portapapeles debajo del elemento .

<Tab Label="Details">  
      <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />      <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />  
      <Group>  
       <Column PercentWidth="50">  
      <Group Label="General">  
       <Column PercentWidth="100">  
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&ue:" LabelPosition="Left" />  
...

Realice los cambios siguientes para crear una agrupación alrededor de los campos que se han movido y dividirlos en dos columnas:

<Tab Label="Details">  
   <Group Label="Classification">
      <Column PercentWidth="50">
         <Group>
     <Column PercentWidth="100">
               <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />  
               <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />  
            </Column>
         </Group>
      </Column>
      <Column PercentWidth="50">
         <Group>
            <Column PercentWidth="100">
               <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" />  
            </Column>
         </Group>
      </Column>
   </Group>  
   <Group>  
       <Column PercentWidth="50">  
   <Group Label="General">  
        <Column PercentWidth="100">  
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&ue:" LabelPosition="Left" />  
...

Guarde los cambios.
Para importar el nuevo tipo de elemento de trabajo a un solo proyecto, vea Importar, exportar y administrar tipos de elemento de trabajo. Para agregar el tipo de elemento de trabajo a la plantilla de proceso, vea Agregar definiciones de tipo para elementos de trabajo.

Comprobar que la página web o el contenido HTML aparecen en el formulario de elemento de trabajo

En Team Explorer, elija Actualizar para descargar las actualizaciones más recientes del servidor.

Estas actualizaciones incluyen los cambios que acaba de importar. Espere varios segundos hasta que se cargue el nodo de elementos de trabajo. Los nodos que siguen cargando muestran la palabra working.
Cree un nuevo elemento de trabajo utilizando el tipo de elemento de trabajo que ha modificado.

Observe que el grupo Classification ya no está en el formulario principal. En la pestaña Vínculos y datos adjuntos, elija la pestaña Detalles para ver los resultados de los cambios realizados.

Cambiar el diseño del formulario del elemento de trabajo

Valore su experiencia

Actualización de la definición XML de un WIT

Exportar y abrir el archivo de definición WIT

Cambiar el diseño de la sección FORM

Comprobar que la página web o el contenido HTML aparecen en el formulario de elemento de trabajo

Artículos relacionados