Tutorial: Realizar personalizaciones básicas en un tipo de elemento de trabajo

Actualización: noviembre 2007

En este tutorial, realizará las funciones de personalización más comunes para un tipo de elemento de trabajo existente. Obtendrá información sobre las herramientas utilizadas para personalizar tipos de elementos de trabajo y el lenguaje XML que define dichos tipos.

Estas personalizaciones se muestran en los procedimientos siguientes:

Crear un proyecto de equipo En este procedimiento, creará el proyecto de equipo que contiene los tipos de elementos de trabajo con los que trabajará en los procedimientos posteriores.
Ver un tipo de elemento de trabajo En este procedimiento, mostrará el formulario de un tipo de elemento de trabajo existente.
Exportar un tipo de elemento de trabajo En este procedimiento, exportará la definición del tipo de elemento de trabajo a un archivo XML.
Cambiar el nombre del tipo En este procedimiento, va a cambiar el archivo XML que contiene la definición del tipo de elemento de trabajo para cambiar el nombre del tipo de elemento de trabajo de Task a Special Task.
Importar cambios En este procedimiento, importará en el servidor de Team Foundation Server el tipo de elemento de trabajo que ha modificado en el procedimiento anterior.
Agregar un campo En este procedimiento, va a agregar un nuevo campo, denominado Category, a un tipo de elemento de trabajo existente.
Agregar reglas a un campo En este procedimiento, agregará una regla que convierte el nuevo campo Category en un campo obligatorio.
Crear una lista de selección En este procedimiento, agregará una lista de valores permitidos para el campo Category. Los nuevos valores aparecerán como opciones en un elemento de trabajo que se creará a partir del tipo de elemento de trabajo.
Cambiar el flujo de trabajo En este procedimiento, agregará nuevos estados y transiciones al tipo de elemento de trabajo.
Cambiar el diseño del formulario En este procedimiento, cambiará la posición de los campos en el formulario del elemento de trabajo.

Requisitos previos

Para completar los pasos descritos en estos tutoriales, necesitará lo siguiente:

Una copia de Visual Studio Team System o una copia de Visual Studio que tenga instalado Team Explorer y conexión con Team Foundation Server. Para obtener más información, vea Cómo: Conectarse a Team Foundation Server.

Si puede establecer una conexión con un servidor de Team Foundation Server y dispone de los permisos necesarios, puede realizar personalizaciones básicas en un tipo de elemento de trabajo en un símbolo del sistema, un archivo por lotes o un archivo de script. Para ello, deberá usar la utilidad Símbolo del sistema de Visual Studio 2008 o bien establecer varias variables de entorno en el símbolo del sistema actual utilizando vsvars32 como se describe en el ejemplo siguiente. Para obtener más información sobre cómo unirse a un proyecto de equipo, vea Tutorial: Unirse a un proyecto de equipo.

Para habilitar los comandos de Team Foundation en un símbolo del sistema

Haga clic en Inicio, en Todos los programas, elija Microsoft Visual Studio 2008, Visual Studio Tools y haga clic en Símbolo del sistema de Visual Studio 2008.

O bien puede ejecutar vsvars32 en la ruta de acceso de instalación de Visual Studio, que suele ser Unidad:\Archivos de programa\Microsoft Visual Studio 9.0\Common7\Tools.

Permisos necesarios

Debe ser miembro del grupo Administradores de Team Foundation o miembro del grupo Project Administrators del proyecto para poder llevar a cabo este procedimiento. Para obtener más información, vea Permisos de Team Foundation Server.

Crear un proyecto de equipo

Para crear un proyecto de equipo

Inicie Visual Studio.
Abra Team Explorer; para ello, haga clic en Ver y, a continuación, haga clic en Team Explorer.
En Team Explorer, haga clic con el botón secundario del mouse en el nombre del servidor de Team Foundation Server al que está conectado y, a continuación, haga clic en Nuevo proyecto de equipo.
En el cuadro de diálogo Nuevo proyecto de equipo en <nombre de servidor Team Foundation Server>, en ¿Cuál es el nombre del proyecto de equipo?, escriba WITLab y haga clic en Siguiente.
En la página Seleccione una plantilla de procesos, en ¿Qué plantilla de procesos debe utilizarse para crear el proyecto de equipo?, haga clic en MSF for Agile Software Development - <número de versión> y, a continuación, en Finalizar.

La creación del proyecto de equipo tardará varios minutos.
Cuando aparezca la página Proyecto de equipo creado, anule la selección del cuadro Inicie la guía de procesos y, a continuación, haga clic en Cerrar.

Se crea el nuevo proyecto de equipo, denominado "WITLab" y aparecerá en un nodo debajo del servidor de Team Foundation Server en Team Explorer.

Ver un tipo de elemento de trabajo

Requisito previo: Se ha finalizado Crear un proyecto de equipo. El proyecto de equipo "WITLab" está disponible.

Para ver un tipo de elemento de trabajo

Inicie Visual Studio y abra Team Explorer.
En Team Explorer, expanda el proyecto de equipo WITLab y espere varios segundos hasta que se carguen sus carpetas.
En el proyecto de equipo, haga clic con el botón secundario del mouse en el nodo Elementos de trabajo, elija Agregar elemento de trabajo y, a continuación, haga clic en Tarea.

Aparecerá un formulario que representa un nuevo elemento de trabajo de Tarea. Algunos de sus campos contienen valores predeterminados. En este tutorial, personalizará el tipo de elemento de trabajo de Tarea a partir del que se ha creado este elemento de trabajo.

Exportar un tipo de elemento de trabajo

Requisito previo: Se ha finalizado Crear un proyecto de equipo. El proyecto de equipo "WITLab" está disponible.

Para exportar un tipo de elemento de trabajo

Abra un símbolo del sistema de Visual Studio.
En el símbolo del sistema, escriba el siguiente comando y, a continuación, presione ENTRAR:

witexport /f "ruta de acceso del archivo\task.xml" /t "nombre de Team Foundation Server" /p WITLab /n Task

Esta operación exporta el tipo de elemento de trabajo Tarea de Team Foundation Server a un archivo XML. Al finalizar la operación de exportación, aparecerá el siguiente mensaje:

Work item type export complete.
(Opcional) Para ver la definición XML del tipo de elemento de trabajo de Tarea, escriba task.xml en el símbolo del sistema y, a continuación, presione ENTRAR.

Cambiar el nombre del tipo

Requisito previo: Se ha finalizado el procedimiento Exportar un tipo de elemento de trabajo.

Para cambiar el nombre del tipo

En Visual Studio, haga clic en Archivo y luego en Abrir archivo.

Aparecerá el cuadro de diálogo Abrir archivo.

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, desplácese a la ubicación en la que descargó la plantilla de proceso.

Nota:
Si ejecuta Windows Vista, es posible que no tenga permisos de acceso a determinadas carpetas. Si intenta exportar el tipo de elemento de trabajo a una ubicación para la que no tiene derechos de acceso, la tecnología de virtualización del Registro redirige automáticamente el archivo exportado y lo guarda en el almacén virtual. Para obtener más información, vea https://go.microsoft.com/fwlink/?LinkId=92325 y https://go.microsoft.com/fwlink/?LinkId=92323. Para evitar esta redirección, puede exportar el archivo a una ubicación en la que tenga permisos de acceso.

Si ejecuta Windows Vista, es posible que no tenga permisos de acceso a determinadas carpetas. Si intenta exportar el tipo de elemento de trabajo a una ubicación para la que no tiene derechos de acceso, la tecnología de virtualización del Registro redirige automáticamente el archivo exportado y lo guarda en el almacén virtual. Para obtener más información, vea https://go.microsoft.com/fwlink/?LinkId=92325 y https://go.microsoft.com/fwlink/?LinkId=92323. Para evitar esta redirección, puede exportar el archivo a una ubicación en la que tenga permisos de acceso.

Haga clic en el archivo task.xml y, a continuación, en Abrir. Cuando se le pregunte sobre los finales de línea, haga clic en No.

Se abrirá task.xml, el archivo XML que contiene la definición para el tipo de elemento de trabajo de Tarea.
Localice el siguiente elemento en dicho archivo.
```
<WORKITEMTYPE name="Task">
```
Cambie el valor del atributo de nombre a Special Task.
```
<WORKITEMTYPE name="Special Task">
```
Guarde los cambios en un nuevo archivo XML. Para ello, en el menú Archivo de Visual Studio, haga clic en Guardar task.xml como.

Aparece el cuadro de diálogo Guardar archivo como.
En Nombre de archivo, escriba specialtask.xml y, a continuación, haga clic en Guardar.

Importar cambios

Prerequisite: Se ha finalizado el procedimiento Cambiar el nombre del tipo.

Para importar los cambios

Abra un símbolo del sistema de Visual Studio.
Importe el tipo de elemento de trabajo modificado en el servidor de Team Foundation Server. Para ello, en el símbolo del sistema de Visual Studio, escriba lo siguiente y, a continuación, presione ENTRAR:

witimport /f "ruta de acceso del archivo\specialtask.xml" /t "nombre de Team Foundation Server" /p WITLab

Esta operación importa el tipo de elemento de trabajo specialtask al servidor de Team Foundation Server. Al finalizar la operación de importación, aparecerá el siguiente mensaje:

Work item type import complete.
Seleccione el proyecto de equipo y, a continuación, en el menú Ver, haga clic en Actualizar para descargar las últimas actualizaciones desde el servidor.

Estas actualizaciones incluyen los cambios que acaba de importar. Espere varios segundos hasta que se hayan cargado todos los nodos. Los nodos que se están cargando muestran la palabra trabajando.
Cree un nuevo elemento de trabajo de Tarea especial. Para ello, haga clic con el botón secundario del mouse en el nodo Elementos de trabajo, elija Agregar elemento de trabajo y, a continuación, haga clic en Tarea especial.

Este elemento de trabajo se crea a partir del tipo de elemento de trabajo que ha cambiado e importado.

Agregar un campo

Prerequisite: Se ha finalizado el procedimiento Cambiar el nombre del tipo.

Para agregar un campo

Abra el archivo que contiene la definición de tipo de elemento de trabajo de Tarea especial. Para ello, en Visual Studio, haga clic en la ficha con la etiqueta SpecialTask.xml.
Busque la siguiente sección del archivo XML.
```
<FIELDS>
```

Cree un nuevo campo de cadena denominado Category, así como texto de ayuda para la información sobre herramientas; para ello, escriba el siguiente código XML, que se muestra en negrita.

<FIELDS>
<FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String">    <HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT></FIELD>

Nota:
El nombre de la referencia, o refname, es el nombre de programación para el campo. Las demás reglas deberían hacer referencia a este refname. Para obtener más información, vea Nombres de referencia de campos.

Busque la sección del archivo XML que describe el formulario del elemento de trabajo.
```
<FORM>
```

Busque las siguientes líneas en la sección <FORM>.

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

Inserte un nuevo control para mostrar el campo Category; para ello, escriba el código XML que se muestra en negrita:

<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" />
    <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" />  </Column>
</Group>

En el menú Archivo, haga clic en Guardar para guardar los cambios en el archivo XML.
Importe el tipo de elemento de trabajo de Tarea especial modificado a Team Foundation Server. Para ello, en el símbolo del sistema de Visual Studio, escriba lo siguiente y, a continuación, presione ENTRAR:

witimport /f "ruta de acceso del archivo\specialtask.xml" /t "nombre de Team Foundation Server" /p WITLab

Nota Como método abreviado, puede presionar FLECHA ARRIBA en la línea de comandos para mostrar el último comando especificado.

Esta operación importa el tipo de elemento de trabajo specialtask al servidor de Team Foundation Server. Al finalizar la operación de importación, aparecerá el siguiente mensaje:

Work item type import complete.
En Team Explorer, haga clic en Actualizar para descargar las últimas actualizaciones desde el 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 se están cargando muestran la palabra trabajando.
Cree un nuevo elemento de trabajo de Tarea especial. Para ello, haga clic con el botón secundario del mouse en el nodo Elementos de trabajo, elija Agregar elemento de trabajo y, a continuación, haga clic en Tarea especial.

Este elemento de trabajo se crea a partir del tipo de elemento de trabajo que ha cambiado e importado.

Observe el nuevo campo Category en el formulario. Mueva el puntero del mouse sobre la etiqueta del campo para ver la información sobre herramientas.
Haga clic en Cerrar para cerrar la nueva Tarea especial. Haga clic en No cuando se le pida que guarde el elemento de trabajo.

Agregar reglas a un campo

Requisito previo: Se ha finalizado el procedimiento Agregar un campo.

Para agregar reglas a un campo

Abra el archivo que contiene la definición de tipo de elemento de trabajo de Tarea especial. Para ello, en Visual Studio, haga clic en la ficha con la etiqueta specialtask.xml.
Busque la sección <FIELDS> del archivo XML, y en ella, el campo Category.

Convierta el campo Category en un campo obligatorio; para ello, agregue la siguiente regla al archivo XML. La regla se muestra en negrita.

<FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String" reportable="dimension">
<HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT>
<REQUIRED />
</FIELD>

En el menú Archivo, haga clic en Guardar para guardar los cambios en el archivo XML.
Importe el tipo de elemento de trabajo de Tarea especial modificado a Team Foundation Server. Para ello, en el símbolo del sistema de Visual Studio, escriba lo siguiente y, a continuación, presione ENTRAR:

witimport /f "ruta de acceso del archivo\specialtask.xml" /t "nombre de Team Foundation Server" /p WITLab

Esta operación importa el tipo de elemento de trabajo specialtask al servidor de Team Foundation Server. Al finalizar la operación de importación, aparecerá el siguiente mensaje:

Work item type import complete.
En Team Explorer, haga clic en Actualizar para descargar las últimas actualizaciones desde el 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 se están cargando muestran la palabra trabajando.
Cree un nuevo elemento de trabajo de Tarea especial. Para ello, haga clic con el botón secundario del mouse en el nodo Elementos de trabajo, elija Agregar elemento de trabajo y, a continuación, haga clic en Tarea especial.

Este elemento de trabajo se crea a partir del tipo de elemento de trabajo que ha cambiado e importado.

Observe que ahora el campo Category está resaltado. Esto indica que es obligatorio.
Seleccione el campo Title en el elemento de trabajo Special Task y escriba "Tarea de ejemplo".
En la barra de herramientas, haga clic en Guardar para guardar el elemento de trabajo.

Se muestra un cuadro de diálogo de error que indica que el campo Category no puede estar vacío. Haga clic en Aceptar para cerrar el cuadro de diálogo.
En el campo Category del elemento de trabajo Special Task, escriba Una categoría.
Haga clic en Guardar para guardar el elemento de trabajo.

Observe que ahora sí puede guardar el elemento de trabajo.
Haga clic en Cerrar para cerrar la nueva Tarea especial.

Crear una lista de selección

Requisito previo: Se ha finalizado el procedimiento Agregar reglas a un campo.

Para crear una lista de selección

Abra el archivo que contiene la definición de tipo de elemento de trabajo de Tarea especial. Para ello, en Visual Studio, haga clic en la ficha con la etiqueta specialtask.xml.
Busque la sección <FIELDS> del archivo XML, y en ella, el campo Category.

Agregue una lista de valores permitidos para el campo Category; para ello, inserte una regla ALLOWEDVALUES. La nueva regla se muestra en negrita en el siguiente código XML.

<FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String" reportable="dimension">
<HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT>
<REQUIRED />
<ALLOWEDVALUES>
    <LISTITEM value="Process Management" />
    <LISTITEM value="Planning" />
    <LISTITEM value="Execution" />
    <LISTITEM value="Review" /></ALLOWEDVALUES>
</FIELD>

Convierta el campo Category en un campo opcional; para ello, elimine la regla REQUIRED, que se muestra en negrita.

<FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String" reportable="dimension">
<HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT>
<REQUIRED />
<ALLOWEDVALUES>
    <LISTITEM value="Process Management" />
    <LISTITEM value="Planning" />
    <LISTITEM value="Execution" />
    <LISTITEM value="Review" />
</ALLOWEDVALUES>
</FIELD>

Haga clic en Guardar para guardar los cambios en el archivo XML.
Importe el tipo de elemento de trabajo de Tarea especial modificado a Team Foundation Server. Para ello, en el símbolo del sistema de Visual Studio, escriba lo siguiente y, a continuación, presione ENTRAR:

witimport /f "ruta de acceso del archivo\specialtask.xml" /t "nombre de Team Foundation Server" /p WITLab

Esta operación importa el tipo de elemento de trabajo specialtask al servidor de Team Foundation Server. Al finalizar la operación de importación, aparecerá el siguiente mensaje:

Work item type import complete.
En la ventana de Team Explorer en Visual Studio, haga clic en Actualizar para descargar las últimas actualizaciones desde el 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 se están cargando muestran la palabra trabajando.
Cree un nuevo elemento de trabajo de Tarea especial. Para ello, haga clic con el botón secundario del mouse en el nodo Elementos de trabajo, elija Agregar elemento de trabajo y, a continuación, haga clic en Tarea especial.

Este elemento de trabajo se crea a partir del tipo de elemento de trabajo que ha cambiado e importado.
Haga clic en el cuadro de lista del campo Category.

Observe que el campo ahora sólo admite los valores especificados por la regla ALLOWEDVALUES.

Nota:

Los valores permitidos en la lista desplegable siempre aparecen en orden alfabético, sin tener en cuenta el orden de los elementos LISTITEM en el archivo XML.
Haga clic en Cerrar para cerrar la nueva Tarea especial. Haga clic en No cuando se le pida que guarde el elemento de trabajo.

Nota:
Los valores permitidos en la lista desplegable siempre aparecen en orden alfabético, sin tener en cuenta el orden de los elementos LISTITEM en el archivo XML.

Cambiar el flujo de trabajo

Requisito previo: Se ha finalizado el procedimiento Crear una lista de selección.

Para cambiar el flujo de trabajo

Abra el archivo que contiene la definición de tipo de elemento de trabajo de Tarea especial. Para ello, en Visual Studio, haga clic en la ficha con la etiqueta specialtask.xml.
Busque la definición del flujo de trabajo del tipo de elemento de trabajo, en la sección <WORKFLOW> del archivo XML, como se muestra en el siguiente código XML:
```
<WORKFLOW>
  <STATES>
    <STATE value="Active">
      <FIELDS>
        <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
          <EMPTY />
        </FIELD>
        <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
...
```
Observe que sólo se han definido dos estados, Active y Closed. También se han definido las transiciones entre ambos estados, así como una transición de apertura desde el estado null, que se utiliza cuando se crea el elemento de trabajo por primera vez.

Agregue un estado Unapproved a la definición de tipo insertando otro elemento <STATE>. El nuevo estado se muestra en negrita.

<WORKFLOW>
  <STATES>
    <STATE value="Unapproved">    </STATE>    <STATE value="Active">
      <FIELDS>
        <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
          <EMPTY />
        </FIELD>
        <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
...

Cree una transición entre el estado null y el estado Unapproved. Para ello, localice primero la sección de la definición del flujo de trabajo para las transiciones. A continuación, inserte el siguiente código XML que se muestra en negrita. Debido a este cambio, todos los elementos de trabajo nuevos de este tipo comenzarán en el estado Unapproved con el motivo predeterminado New.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">    <REASONS>      <DEFAULTREASON value="New" />    </REASONS>  </TRANSITION>  <TRANSITION from="" to="Active">
    <REASONS>
      <DEFAULTREASON value="New" />
    </REASONS>
    <FIELDS>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
        <COPY from="currentuser" />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
        <COPY from="clock" />
      </FIELD>
      <FIELD refname="System.AssignedTo">
        <COPY from="currentuser" />
      </FIELD>
    </FIELDS>
  </TRANSITION>

Elimine la transición to Active mostrada en negrita en el siguiente código XML. Hágalo así porque sólo puede haber una transición de apertura, y usted desea utilizar una denominada "Ported", que definirá en el siguiente paso.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
    </REASONS>
  </TRANSITION>
  <TRANSITION from="" to="Active">    <REASONS>      <DEFAULTREASON value="New" />    </REASONS>    <FIELDS>      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">        <COPY from="currentuser" />      </FIELD>      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">        <COPY from="clock" />      </FIELD>      <FIELD refname="System.AssignedTo">        <COPY from="currentuser" />      </FIELD>    </FIELDS>  </TRANSITION>

Agregue un motivo "Ported" para la transición de apertura; para ello, inserte el siguiente código XML que se muestra en negrita. De esta forma, los usuarios pueden saber si el elemento de trabajo es nuevo o se ha trasladado desde otro sistema de seguimiento.
```
<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
     <REASON value="Ported" />    </REASONS>
  </TRANSITION>
...
```
Inserte la siguiente regla COPY que se muestra en negrita. Esta regla asigna como valor predeterminado al campo Assigned To el usuario que ha creado el elemento de trabajo. Además, sólo se va a evaluar durante la transición de apertura.
```
<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
     <REASON value="Ported" />
    </REASONS>
    <FIELDS>       <FIELD refname="System.AssignedTo">         <COPY from="currentuser" />       </FIELD>    </FIELDS>
  </TRANSITION>
...
```
Nota:

Si se inserta esta regla debajo de otros elementos <TRANSITION> o <STATE>, su ámbito se aplicará a otras transiciones o estados.

Nota:
Si se inserta esta regla debajo de otros elementos <TRANSITION> o <STATE>, su ámbito se aplicará a otras transiciones o estados.

Cree una transición desde el estado Unapproved al estado Active; para ello, inserte el siguiente código XML, que se muestra en negrita. Debido a este cambio, cuando se aprueba una Special Task, ésta puede pasar por esta transición.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
     <REASON value="Ported" />
    </REASONS>
    <FIELDS>
       <FIELD refname="System.AssignedTo">
         <COPY from="currentuser" />
       </FIELD>
    </FIELDS>
  </TRANSITION>
  <TRANSITION from="Unapproved" to="Active">    <REASONS>      <DEFAULTREASON value="Approved" />    </REASONS>  </TRANSITION>  <TRANSITION from="Active" to="Closed">
    <REASONS>
      <DEFAULTREASON value="Completed" />
      <REASON value="Deferred" />
      <REASON value="Obsolete" />
      <REASON value="Cut" />
    </REASONS>
...

Haga clic en Guardar para guardar los cambios en el archivo XML.
Importe el tipo de elemento de trabajo de Tarea especial modificado a Team Foundation Server. Para ello, en el símbolo del sistema de Visual Studio, escriba lo siguiente y, a continuación, presione ENTRAR:

witimport /f "ruta de acceso del archivo\specialtask.xml" /t "nombre de Team Foundation Server" /p WITLab

Esta operación importa el tipo de elemento de trabajo specialtask al servidor de Team Foundation Server. Al finalizar la operación de importación, aparecerá el siguiente mensaje:

Work item type import complete.
En Team Explorer, haga clic en Actualizar para descargar las últimas actualizaciones desde el 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 se están cargando muestran la palabra trabajando.
Cree un nuevo elemento de trabajo de Tarea especial. Para ello, haga clic con el botón secundario del mouse en el nodo Elementos de trabajo, elija Agregar elemento de trabajo y, a continuación, haga clic en Tarea especial.

Este elemento de trabajo se crea a partir del tipo de elemento de trabajo que ha cambiado e importado.
Observe que el Estado inicial ahora es Unapproved y que Reason tiene el valor predeterminado New. Además, AssignedTo tiene como valor predeterminado su nombre de cuenta. Haga clic en el campo Reason para ver el cuadro de lista que incluye los motivos New y Ported.
En el campo Título, escriba un título y, a continuación, haga clic en Guardar para guardar el elemento de trabajo. Espere hasta que finalice la operación, de acuerdo con lo que se indica en Elementos guardados en la barra de estado.
En el campo Estado, seleccione el valor Active para aprobar el elemento de trabajo y volver a efectuar su transición. Observe que el campo Reason tiene como valor predeterminado Approved.
Haga clic en Guardar para guardar esta transición.
Haga clic en Cerrar para cerrar la Special Task.

Cambiar el diseño del formulario

Requisito previo: Se ha finalizado el procedimiento Cambiar el flujo de trabajo.

Para cambiar el diseño del formulario

Abra el archivo que contiene la definición de tipo de elemento de trabajo de Tarea especial. Para ello, en Visual Studio, haga clic en la ficha con la etiqueta specialtask.xml.
Busque la sección <TabGroup> del archivo XML. Observe que existen elementos <Tab> para Links y para File Attachments, cada elemento <Tab> contiene un elemento <Control> que representa el control respectivo.
```
<Tab Label="Links">
  <Control Type="LinksControl" />
</Tab>
<Tab Label="File Attachments">
  <Control Type="AttachmentsControl" />
</Tab>
```

Combine los dos elementos <Tab> en una única <Tab> Links y Attachments que contenga ambos controles; para ello, reemplace el código XML mostrado en el paso anterior por el siguiente código XML.

<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 la definición <FORM>, <Layout> que describe los grupos Classification y Status.

<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" />
    <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" />
  </Column>
</Group>

Nota:
Para obtener los mejores resultados, cada ficha Control o Group debería aparecer en una ficha Column, aun cuando ésta ocupe todo el ancho del formulario. A su vez, cada ficha Column debería aparecer en una ficha Group, aun cuando ésta no tenga ningún rótulo ni límite visible.

Seleccione las siguientes líneas que se muestran en negrita y, a continuación, haga clic en Copiar en el menú Edición para copiar este contenido al Portapapeles para un uso posterior.

  <Column PercentWidth="70">
    <Group>
      <Column PercentWidth="100">
        <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" />            <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" />          </Column>
        </Group>

Elimine las líneas que se muestran en negrita en el siguiente código XML para quitar el grupo Classification de su posición actual en el formulario.

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

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

<Tab Label="Details">
  <Group>
    <Column PercentWidth="50">
      <Group Label="General">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.ExitCriteria" Label="E&amp;xit criteria:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Build.IntegrationBuild" Label="Integration &amp;build:" LabelPosition="Left" />
        </Column>
      </Group>
    </Column>
    <Column PercentWidth="50">
      <Group Label="Schedule">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Label="Remaining &amp;work (hours):" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Label="Com&amp;pleted work (hours):" LabelPosition="Left" />
        </Column>
      </Group>
    </Column>
  </Group>
</Tab>

Pegue el contenido del Portapapeles en la siguiente ubicación para mover estos controles a la ficha Details.

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

Realice los cambios siguientes, mostrados en negrita, 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>
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Issue" LabelPosition="Left" />
...

Haga clic en Guardar para guardar los cambios en el archivo XML.
Importe el tipo de elemento de trabajo de Tarea especial modificado a Team Foundation Server. Para ello, en el símbolo del sistema de Visual Studio, escriba lo siguiente y, a continuación, presione ENTRAR:

witimport /f "ruta de acceso del archivo\specialtask.xml" /t "nombre de Team Foundation Server" /p WITLab

Esta operación importa el tipo de elemento de trabajo specialtask al servidor de Team Foundation Server. Al finalizar la operación de importación, aparecerá el siguiente mensaje:

Work item type import complete.
En Team Explorer, haga clic en Actualizar para descargar las últimas actualizaciones desde el 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 se están cargando muestran la palabra trabajando.
Cree un nuevo elemento de trabajo de Tarea especial. Para ello, haga clic con el botón secundario del mouse en el nodo Elementos de trabajo, elija Agregar elemento de trabajo y, a continuación, haga clic en Tarea especial.

Este elemento de trabajo se crea a partir del tipo de elemento de trabajo que ha modificado.

Observe que el grupo Classification ya no está en el formulario principal. Haga clic en la ficha Vínculos y datos adjuntos y en la ficha Detalles para ver los resultados de los cambios realizados.
Haga clic en Cerrar para cerrar la nueva Tarea especial. Haga clic en No cuando se le pida que guarde el elemento de trabajo.

Pasos siguientes

Si desea obtener instrucciones paso a paso sobre cómo realizar personalizaciones adicionales de un tipo de elemento de trabajo, vea Tutorial: Realizar personalizaciones avanzadas en un tipo de elemento de trabajo.

Vea también

Tareas

Tutorial: Administrar campos de un tipo de elemento de trabajo

Otros recursos

Personalizar tipos de elemento de trabajo

Personalizar tipos de elementos de trabajo para Team Foundation

Last updated on 2008-10-07