Agregar o quitar un campo de un tipo de elemento de trabajo

Artículo
08/10/2011

Para agregar o quitar un campo de datos de un tipo de elemento de trabajo, modifique el archivo de definición del tipo de elemento de trabajo. Debe agregar o quitar los elementos FIELD de la sección FIELDS así como el diseño y controles definidos en la sección FORM. Una vez que haya modificado el tipo de elemento de trabajo, puede importar el archivo XML y empezar a utilizar el tipo de elemento de trabajo actualizado.

Importante
Los campos de tipo de elemento de trabajo se administran para una colección de proyectos de equipo. Para obtener más información, vea Administrar campos de elemento de trabajo [witadmin].

En este tema

Exportar y abrir el archivo de definición del tipo de elemento de trabajo
Agregar un campo
Quitar un campo
Importar el archivo de definición del tipo de elemento de trabajo
Comprobar que los cambios aparecen en el formulario de Elemento de trabajo

Permisos necesarios

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

Exportar y abrir el archivo de definición del tipo de elemento de trabajo

Para exportar y abrir el archivo de definición del tipo de elemento de trabajo

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. Escriba el siguiente comando, sustituyendo los argumentos mostrados por sus datos:
```
witadmin exportwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
```
  Para obtener más información, vea Exportar e importar tipos de elemento de trabajo desde un proyecto existente.
2. En Visual Studio, haga clic sucesivamente en Archivo, Abrir y Archivo.
  
  Aparece el cuadro de diálogo 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, haga clic en Abrir. Cuando se le pregunte sobre los finales de línea, haga clic en No.

Agregar un campo

Agregar un campo a un tipo de elemento de trabajo

Busque la siguiente sección del archivo XML:
```
<FIELDS>
```
Cree un nuevo campo de cadena escribiendo el código XML que se muestra resaltado en el ejemplo siguiente:
```
<FIELDS>
<FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="Dimension">
</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 Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo.
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 escribiendo el código XML que se muestra resaltado en el ejemplo siguiente:

<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.IssueLevel" Label="Issue Level" LabelPosition="Left" />
  </Column>
</Group>

En el menú Archivo, haga clic en Guardar <nombre de archivo>.xml para guardar los cambios realizados en el archivo XML.
Para importar el nuevo tipo de elemento de trabajo en un proyecto único, vea Importar el archivo de definición de tipos de elemento de trabajo. 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 procesos.

Quitar un campo

Para quitar un campo de un formulario de elemento de trabajo

Busque y elimine la definición del campo que desea quitar del tipo de elemento de trabajo. En el ejemplo siguiente se muestra un campo denominado "Issue Level". Para quitar este campo, elimine la siguiente sección de campo:

Nota

La sección correspondiente al campo en el archivo XML no puede contener todos los elementos del código siguiente. Sin embargo, si ha personalizado el campo de tipo de elemento de trabajo de modo que incluya estos elementos, también deberá eliminarlos.

<FIELDS>
. . .
<FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="dimension">
<HELPTEXT>Describes the issue level to which this special task belongs.</HELPTEXT>
  <WHEN field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">
    <ALLOWEDVALUES>
      <LISTITEM value="Planning" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHEN>
  <WHENNOT field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">
    <ALLOWEDVALUES>
      <LISTITEM value="Process Management" />
      <LISTITEM value="Planning" />
      <LISTITEM value="Execution" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHENNOT>
</FIELD>
…
</FIELDS>

Busque la sección <Layout> donde se define el control para el campo de elemento de trabajo y elimine las secciones adecuadas para quitar el campo. Las siguientes secciones resaltadas son ejemplos de lo que debería buscar.

<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.IssueLevel" Label="IssueLevel" LabelPosition="Left" />
      </Column>
    </Group>
  </Column>
</Group>

En el menú Archivo, haga clic en Guardar <nombre de archivo> para guardar los cambios realizados en el archivo XML.

Importar el archivo de definición del tipo de elemento de trabajo

Para importar el archivo de definición del tipo de elemento de trabajo

Ejecute witadmin importwitd para importar el archivo XML correspondiente al tipo de elemento de trabajo que modificó. Escriba el siguiente comando, sustituyendo los argumentos mostrados por sus datos:
```
witadmin importwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
```
Para obtener más información, vea Exportar e importar tipos de elemento de trabajo desde un proyecto existente.

Comprobar que los cambios aparecen en el formulario de Elemento de trabajo

Para comprobar los cambios importados a un proyecto único

En Team Explorer, haga clic con el botón secundario en el nodo del proyecto de equipo que contiene la definición del tipo de elemento de trabajo que modificó y haga clic en 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.
Para crear un elemento de trabajo mediante el tipo de elemento de trabajo que modificó, haga clic con el botón secundario en el nodo Elementos de trabajo, apunte a Agregar elemento de trabajo y, a continuación, haga clic en el tipo de elemento de trabajo.

El elemento de trabajo se crea a partir del tipo de elemento de trabajo que ha modificado.
Compruebe que los cambios realizados aparecen en el formulario de elemento de trabajo.
Haga clic en Cerrar para cerrar el nuevo elemento de trabajo. Haga clic en No cuando se le pida que guarde el elemento de trabajo.

Vea también

Compartir a través de