Share via

Agregar, usar y administrar listas globales

  • Artículo

Puede compartir los elementos de lista entre varios tipos de elemento de trabajo incluyéndolos en uno o más elementos GLOBALLIST.

Cuando defina tipos de elemento de trabajo, puede que algunos campos compartan el mismo conjunto de valores. Con frecuencia, este conjunto de valores abarca varios tipos de elemento de trabajo e incluso varios proyectos de equipo. Algunas de estas listas pueden cambiar con frecuencia, como el número de compilación de las compilaciones nocturnas, que exige a un administrador que actualice a menudo estas listas en numerosas ubicaciones. Las listas globales ayudan a resolver este problema.

Nota

Las listas globales no deben incluir grupos de ámbito de proyecto porque no tienen el mismo ámbito que un proyecto. Las listas globales se administran para una colección de proyectos.

En los procedimientos siguientes se muestra cómo crear una lista global denominada Disciplines para el tipo de elemento de trabajo de tarea.

Permisos necesarios

Para exportar una lista global, debe ser miembro del grupo Usuarios válidos de Team Foundation para la colección de proyectos. Para importar una lista global, debe ser miembro del grupo Team Foundation Administrators o miembro del grupo Project Administrators de la colección de proyectos. Para obtener más información, vea Permisos de Team Foundation Server.

Para agregar una lista global a la colección de proyectos de equipo

  1. En Visual Studio, haga clic sucesivamente en Archivo, Nuevo y Archivo.

  2. En el recuadro Categorías, haga clic en General.

  3. En el recuadro Plantillas, haga clic en Archivo XML y, a continuación, en Abrir.

  4. En este nuevo archivo agregue el código XML siguiente que se muestra resaltado en el ejemplo siguiente. Este ejemplo define una lista global de disciplinas relevantes para su organización.

    <?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

  5. En la barra de herramientas, haga clic en Guardar para guardar los cambios realizados en el archivo XML.

    Aparece el cuadro de diálogo Guardar archivo como.

  6. En el cuadro de diálogo Guardar archivo como, en Guardar en, busque la ubicación en la que desea guardar el archivo. Asigne un nombre al archivo y haga clic en Guardar.

    Nota

    Si está ejecutando Windows Vista, podría no tener el conjunto de permisos para acceder a determinadas carpetas. Si intenta exportar el tipo de elemento de trabajo a una ubicación para la que no tiene permisos establecidos, la tecnología de virtualización del Registro redirige automáticamente el archivo exportado y lo guarda en el almacén virtual. Para evitar esta redirección, puede exportar el archivo a una ubicación en la que tenga permisos establecidos. Para obtener más información sobre la virtualización del Registro, vea el sitio web de Microsoft: Registry Virtualization y Common file and registry virtualization issues in Windows Vista.

  7. Abra una ventana de símbolo del sistema de Visual Studio 2010.

  8. Importe esta lista global a la colección de proyectos; para ello, escriba el siguiente comando y, a continuación, presione Entrar:

    witadmin importgloballist /collection:http://NombreServidor:Puerto/NombreDirectorioVirtual/NombreColección /f:"Ruta de acceso del archivo"

    Para obtener más información, vea Administrar listas globales para tipos de elemento de trabajo [witadmin].

  9. Muestre las listas globales del servidor de Team Foundation Server; para ello, escriba lo siguiente en el símbolo del sistema y, a continuación, presione Entrar:

    witadmin exportgloballist /collection:http://NombreServidor:Puerto/NombreDirectorioVirtual/NombreColección

    Observe que aparece la lista que se acaba de agregar.

Para utilizar listas globales en un tipo de elemento de trabajo

  1. Ejecute witadmin exportwitd para exportar Task.xml. Para obtener más información, vea Personalizar y administrar tipos de elemento de trabajo [witadmin].

  2. En Visual Studio, haga clic sucesivamente en Archivo, Abrir y Archivo.

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

    Nota

    Si está ejecutando Windows Vista, podría no tener el conjunto de permisos de acceso para determinadas carpetas. Si intenta exportar el tipo de elemento de trabajo a una ubicación para la que no tiene permisos establecidos, la tecnología de virtualización del Registro redirige automáticamente el archivo exportado y lo guarda en el almacén virtual. Para evitar esta redirección, puede exportar el archivo a una ubicación en la que tenga permisos establecidos. Para obtener más información sobre la virtualización del Registro, vea el sitio web de Microsoft: Registry Virtualization y Common file and registry virtualization issues in Windows Vista.

  4. Seleccione Task.xml y haga clic en Abrir. Cuando se le pregunte sobre los finales de línea, haga clic en No.

  5. Busque la sección siguiente del archivo XML que define el campo Discipline:

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String" reportable="dimension">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES expanditems="true">
    <LISTITEM value="Development" />
    <LISTITEM value="Test" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Architecture" />
    <LISTITEM value="Release Management" />
  </ALLOWEDVALUES>
</FIELD>

  6. Elimine la lista de valores permitidos quitando el código XML siguiente que aparece resaltado en el ejemplo siguiente:

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES expanditems="true">
    <LISTITEM value="Development" />
    <LISTITEM value="Test" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Architecture" />
    <LISTITEM value="Release Management" />
  </ALLOWEDVALUES>
</FIELD>

  7. Establezca los valores permitidos del campo Discipline en la lista global anteriormente definida; para ello, agregue el siguiente código XML al archivo:

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
    <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

  8. En la barra de herramientas, haga clic en Guardar para guardar los cambios realizados en el archivo XML.

  9. Importe la tarea modificada a Team Foundation Server. Para obtener más información, vea Personalizar y administrar tipos de elemento de trabajo [witadmin].

  10. En la ventana Team Explorer de 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 carguen todos los nodos. Los nodos que se están cargando muestran la etiqueta trabajando.

  11. Cree una tarea. 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.

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

  12. Seleccione el cuadro Discipline en el formulario del nuevo elemento de trabajo.

    Observe que los valores permitidos ahora son los valores de la lista global Disciplines.

  13. Haga clic en Cerrar para cerrar la nueva tarea. Haga clic en No cuando se le pida que guarde la tarea.

Para agregar valores a un campo sin editar ni importar un archivo XML de tipos de elementos de trabajo

  1. Para agregar valores al campo Discipline sin editar ni volver a importar el archivo de definición del tipo de elemento de trabajo, abra el archivo disciplines.xml mediante Visual Studio y agregue los nuevos valores siguientes que aparecen resaltados en el ejemplo siguiente:

    <GLOBALLIST name="Disciplines">
  <LISTITEM value="Architecture" />
  <LISTITEM value="Requirements" />
  <LISTITEM value="Development" />
  <LISTITEM value="Release Management" />
  <LISTITEM value="Project Management" />
  <LISTITEM value="Test" />
  <LISTITEM value="Marketing and Sales" />
  <LISTITEM value="General Management" />
  <LISTITEM value="Other" />
</GLOBALLIST>

  2. En la barra de herramientas, haga clic en Guardar para guardar los cambios realizados en el archivo XML.

  3. Abra una ventana de símbolo del sistema de Visual Studio.

  4. Importe esta lista global a la colección de proyectos; para ello, escriba lo siguiente en el símbolo del sistema y, a continuación, presione Entrar:

    witadmin importgloballist /collection:http://NombreServidor:Puerto/NombreDirectorioVirtual/NombreColección /f:"Ruta de acceso del archivo"

  5. 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 carguen todos los nodos. Los nodos que se están cargando muestran la etiqueta trabajando.

  6. Cree una tarea. 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.

  7. Seleccione el cuadro Discipline.

    Observe que los nuevos valores de la lista global aparecen ahora como opciones del cuadro.

    Nota

    Puede hacer referencia a las listas globales en los valores permitidos que se comparten entre varios tipos de elemento de trabajo o en varios proyectos de equipo. Esto permite que una única actualización de la lista global actualice automáticamente a su vez los valores permitidos de todos los tipos de elementos de trabajo que hacen referencia a la lista.

  8. Haga clic en Cerrar para cerrar la nueva tarea. Haga clic en No cuando se le pida que guarde la tarea.

Vea también

Referencia

Elemento GLOBALLISTS (Esquema Listas globales)

GLOBALLISTS Element (Work Item Type Definition Schema)

Conceptos

Personalizar datos de seguimiento, formularios, flujos de trabajo y otros objetos de proyecto

Definir listas globales

Definir y usar listas, listas de selección y listas globales

Otros recursos

Índice de definiciones de elementos XML para tipos de elementos de trabajo