Personalización del formulario web de seguimiento de trabajo

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

Del mismo modo que ha podido personalizar el diseño del formulario para los tipos de elemento de trabajo, puede seguir haciendo esto con el nuevo formulario web. El nuevo formulario pone a disposición varias características que no están disponibles con el formulario anterior. El administrador de la colección de proyectos o la cuenta administra el cambio al nuevo formulario. Cuando el nuevo formulario está habilitado para la colección de cuentas o proyectos, la sección WebLayout se agrega a la definición XML para cada WIT definido en la colección.

Los WIT transformados se personalizan de la misma manera que antes. La ruta de acceso es ligeramente diferente según la plataforma y las opciones de personalización anteriores.

Importación y exportación de archivos de definición XML

Use esta secuencia cuando use el modelo de proceso XML local, es decir, administre la personalización del seguimiento de trabajo de TFS mediante la importación de archivos de definición XML individuales.

XML definition file Import WIT definition file Refresh and verify changes (Exportar archivo de definición WITImportar archivo deActualizar y comprobar los

Archivos ZIP de proceso de importación y exportación

Use esta secuencia cuando use el modelo de proceso XML hospedado, es decir, al administrar la personalización de seguimiento de trabajo mediante la importación de una plantilla de proceso o proceso.

Import process Refresh and verify changes (Editar archivo o archivos de definición XML)proceso de importación y comprobación de

La principal diferencia es que ahora hay dos secciones de diseño principales dentro del nodo FORM. La primera sección, incluida en el elemento Layout, define el diseño del formulario cuando se ve a través de un cliente como Visual Studio. La segunda sección, incluida en el elemento WebLayout, define el diseño del formulario cuando se ve a través de un explorador web.

<FORM>
   <Layout HideReadOnlyEmptyFields="true" HideControlBorders="true">
       . . .  
   </Layout>
   <WebLayout>
       . . .  
   </WebLayout>
</FORM>

Consulte los temas siguientes para realizar las personalizaciones indicadas:

• Para personalizar el formulario para el portal web(nodo WebLayout), vea Elementos XML WebLayout y Control.
• Para agregar un control de vínculos con ámbito al formulario para el portal web(LinksControlOptions),vea VínculosControlOpciones Elementos XML
• Para personalizar el formulario de cliente(nodo Diseño), vea Elementos XML de diseño.

Importación y exportación de archivos de definición de WIT

1. Si no tiene permisos de administración para el proyecto, obtenga .

2. Abra una ventana del símbolo del sistema según las instrucciones proporcionadas en witAdmin: Personalizar y administrar objetos para realizar el seguimiento del trabajo.

   Por ejemplo:

   %programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer 
   

3. Exporte el archivo de definición de WIT donde desea modificar o agregar un campo. Especifique el nombre del WIT y un nombre para el archivo.

   witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"  
   

   Un ejemplo de CollectionURL para una organización es OrganizationName.

4. Edite el archivo. Para obtener más información, vea Elementos XML de WebLayout.

5. Importe el archivo de definición de WIT.

   witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"  
   

6. Abra el portal web para ver los cambios. Si el cliente ya está abierto, actualice la página.

   Las últimas actualizaciones se descargan del servidor, incluso los cambios que acaba de importar. Espere varios segundos hasta que la actualización finalice.

   Para obtener más información sobre el uso de witadmin, vea Importar, exportar y administrar tipos de elementos de trabajo.

Diseño y tamaño

El nuevo formulario web cambia de tamaño en función del ancho disponible y del número de secciones definidas. En el ancho máximo, en la mayoría de los exploradores web, cada sección de una página se mostrará dentro de su propia columna. A medida que disminuye el ancho de pantalla, cada sección cambia de tamaño proporcionalmente como se muestra a continuación:

• Para cuatro secciones: 40 %, 20 %, 20 % y 20 %
• Para tres secciones: 50 %, 25 % y 25 %
• Para dos secciones: 66 % y 33 %
• Para una sección: 100 %.

Cuando el ancho de pantalla no admite la presentación en columnas de cada sección, las secciones aparecen apiladas dentro de una columna.

Listas globales

Las listas globales se administran de forma diferente en XML hospedado que en Azure DevOps Server (y TFS). Para empezar, no se admite witadmin, por lo que no existe un archivo de lista global independiente. En XML hospedado, se adjuntan a un tipo de elemento de trabajo existente. Este es un ejemplo...

<?xml version="1.0" encoding="utf-8"?>
<witd:WITD xmlns:witd="http://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef" application="Work item type editor" version="1.0">
  <WORKITEMTYPE name="Shared Steps" refname="Custom.SharedSteps">
    <DESCRIPTION>Server-side data for reusable set of test steps. Version: B.02</DESCRIPTION>
    <GLOBALLISTS>
      <GLOBALLIST name="Foo">
        <LISTITEM value="No" />
        <LISTITEM value="Yes" />
        <LISTITEM value="Maybe" />
        <LISTITEM value="Not Sure" />
      </GLOBALLIST>
      <GLOBALLIST name="Bar">
        <LISTITEM value="Open" />
        <LISTITEM value="Closed" />
      </GLOBALLIST>
     </GLOBALLISTS>  
     ...

De forma predeterminada, las listas globales se adjuntarán al tipo de elemento de trabajo Pasos compartidos.

Artículos relacionados

Si no está nuevo en la personalización de WIT, vea Agregar y modificar un WIT.

• Administración del nuevo lanzamiento de formularios
• Nueva experiencia de elemento de trabajo
• Elementos XML WebLayout y Control

Importación de advertencias y errores

Recibirá una advertencia al importar una definición de WIT modificada si agrega un elemento Control para un campo obligatorio solo en el nodo WebLayout o Layout, pero no en el otro.

Recibirá un error si habilita el nuevo formulario y, a continuación, modifica una definición wit en la que elimina el nodo WebLayout.