Compartir a través de

Cómo: Utilizar una lista global

  • Artículo

Actualización: noviembre 2007

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, encontrará que algunos campos comparten el mismo conjunto de valores. Con frecuencia, este conjunto de valores se comparte entre varios tipos de elemento de trabajo e incluso entre varios proyectos de equipo. Algunas de estas listas pueden cambiar con frecuencia, como el número de versión de las generaciones nocturnas. No es lo más adecuado exigir a un administrador que actualice con frecuencia estas listas en muchas ubicaciones. Las listas globales ayudan a resolver este problema. Las listas globales no deben incluir grupos de ámbito de proyecto porque no tienen el mismo ámbito que un proyecto.

En los procedimientos siguientes se indica 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 importar una lista global, debe ser miembro del grupo Administradores de Team Foundation o miembro del grupo Project Administrators del proyecto. Para obtener más información, consulte Permisos de Team Foundation Server.

Para utilizar los comandos de Team Foundation en el 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 ejecute vsvars32 en la ruta de instalación de Visual Studio; esta ruta suele ser Unidad:\Archivos de programa\Microsoft Visual Studio 9.0\Common7\Tools.

    Nota:

    Debe tener Visual Studio 2008 instalado para utilizar el símbolo del sistema de Visual Studio 2008.

Para agregar una lista global al servidor de Team Foundation Server

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

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

  3. En el panel Plantillas, haga clic en Archivo XML y, a continuación, haga clic 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.

    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 ejecuta Windows Vista, es posible que no tenga permisos de acceso a determinadas carpetas. Si intenta guardar la lista global en una ubicación para la que no tiene derechos de acceso, la tecnología de virtualización del Registro redirige y guarda automáticamente el archivo 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 guardar el archivo en una ubicación en la que tenga permisos de acceso.

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

  7. Importe esta lista global en el servidor de Team Foundation Server; para ello, escriba el siguiente comando y presione ENTRAR:

    glimport /f "ruta de acceso del archivo" /t "nombre de Team Foundation Server"

    Nota:

    Dado que una lista global tiene un efecto global en el servidor de Team Foundation Server, no se especifica ningún proyecto de equipo al ejecutar el comando glimport. Para obtener más información, consulte glimport.

  8. 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:

    glexport /t "<Nombre del servidor de Team Foundation Server>"

    Observe que aparece la lista que se acaba de agregar.

Para utilizar listas globales en un tipo de elemento de trabajo

  1. Ejecute witexport para exportar Task.xml. Para obtener más información, consulte Cómo: Exportar un tipo de elemento de trabajo desde un proyecto existente.

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

  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, consulte Cómo: Importar un tipo de elemento de trabajo a un proyecto existente.

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

  11. Cree una nueva 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 en el servidor de Team Foundation Server; para ello, escriba lo siguiente en el símbolo del sistema y, a continuación, presione ENTRAR.

    glimport /f "ruta de acceso del archivo" /t "nombre de Team Foundation Server"

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

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

Conceptos

Listas globales

Referencia

Elemento GLOBALLISTS (Esquema Listas globales)

Elemento GLOBALLISTS (Esquema de definición de tipo de elemento de trabajo)

Otros recursos

Esquema de definición del tipo de elemento de trabajo