Compartir a través de

Importar y exportar un flujo de trabajo global [witadmin]

  • Artículo

Si usa un flujo de trabajo global, puede minimizar el trabajo necesario para definir y actualizar los campos de los elementos de trabajo y las listas globales que comparten varios proyectos de equipo y tipos de elemento de trabajo. Con un flujo de trabajo global, puede definir y actualizar campos y listas globales. Puede administrar el flujo de trabajo global para una colección de proyectos de equipo o un proyecto de equipo utilizando los comandos siguientes en la herramienta de línea de comandos de witadmin:

  • exportglobalworkflow:  Exporta el flujo de trabajo global a un archivo XML o la ventana de símbolo del sistema.

  • importglobalworkflow:  Importa flujo de trabajo global desde un archivo XML.

Para ejecutar la herramienta de la línea de comandos witadmin, abra una ventana de símbolo del sistema donde se haya instalado Visual Studio o Team Explorer y escriba:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

En una edición de 32 bits de Windows, reemplace %programfiles(x86)% por %programfiles%.

Para obtener más información acerca de los flujos de trabajo globales, consulte Personalizar el flujo de trabajo global.

Requisitos

  • Para exportar un flujo de trabajo global, debe ser un usuario válido del proyecto de equipo o de la colección de proyectos de equipo.

  • Para importar un flujo de trabajo global a un proyecto de equipo, debe ser miembro de los siguientes grupos de seguridad: Administradores de Team Foundation, Administradores de la colección de proyectos o Administradores de proyectos.

  • Para importar un flujo de trabajo global a una colección de proyectos de equipo, debe ser miembro de los Administradores de Team Foundation o de los Administradores de la colección de proyectos.

Vea Referencia de permisos para Team Foundation Server.

Nota

Incluso si ha iniciado sesión con permisos administrativos, debe abrir una ventana de símbolo del sistema con privilegios elevados para ejecutar esta función en un servidor que ejecute Windows Server 2008.Para abrir una ventana del símbolo del sistema con privilegios elevados, elija Inicio, abra el menú contextual de Símbolo del sistema y, a continuación, elija Ejecutar como administrador.Para más información, vea la siguiente página del sitio web de Microsoft: Control de cuentas de usuario.

witadmin exportglobalworkflow /collection:CollectionURL [/p:ProjectName] [/f:FileName] [/e:Encoding] [/exportgloballists] 

witadmin importglobalworkflow /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:Encoding] [/v]

Parámetros

Parámetro

Descripción

/collection:CollectionURL

Especifica la dirección URI de una colección. Debe especificar el URI con el formato siguiente: http://nombreDeServidor:Puerto/nombreDeDirectorioVirtual/nombreDeColección

Si no especifica un directorio virtual, especifique el URI con el siguiente formato:

http://NombreDeServidor:Puerto/NombreDeColección.

/p:ProjectName

Opcional. El proyecto de equipo en el que quiere exportar o importar el flujo de trabajo global. Este proyecto de equipo se debe definir en la colección especificada por el parámetro /collection. Si no especifica el proyecto de equipo, el flujo de trabajo global se importa o exporta para la colección.

/f:FileName

La ruta y el nombre del archivo de definición XML del flujo de trabajo global que se exportará o importará.

Nota

Si el equipo cliente está ejecutando Windows Vista, puede que no tenga permisos para determinadas carpetas.Si intenta exportar la lista global a una ubicación para la que no tiene permisos, 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 las siguientes páginas del sitio web de Microsoft: Virtualización del Registro y problemas comunes de virtualización de archivos y del Registro en Windows Vista.Para evitar esta redirección, puede exportar el archivo a una ubicación en la que tenga permisos.

/e:Encoding

Opcional. El nombre de un formato de codificación de .NET Framework 2,0. La codificación especificada se usará para exportar o importar los datos XML. Por ejemplo, /e utf-7 especifica la codificación Unicode (UTF-7). Si omite este parámetro, witadmin intenta detectar la codificación y utiliza UTF-8 si se produce un error en la detección.

/v

Opcional. Valida el código XML que define el flujo de trabajo global, pero no importa el archivo de definición.

/exportgloballists

Opcional. Exporta las definiciones de listas globales a las que hace referencia el flujo de trabajo global. Las definiciones de listas globales se incrustarán en la definición XML del flujo de trabajo global. Si no especifica este parámetro, se omiten las definiciones de listas globales.

/? o help

Muestra ayuda sobre el comando en la ventana del símbolo del sistema.

Comentarios

Puede definir los campos de los elementos de trabajo importándolos a través de un flujo de trabajo global. Sin embargo, no puede cambiar las propiedades de los campos existentes utilizando el flujo de trabajo global. Si importa un flujo de trabajo global que no contiene un elemento de FIELDS, todas las reglas importadas previamente para el flujo de trabajo global se eliminarán. Las definiciones de campo no se verán afectadas.

Ejemplos

A menos que se especifique lo contrario, se aplican los siguientes valores en cada ejemplo:

  • URI para la colección: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Proyecto de equipo: Contoso

  • Número de puerto del sitio web del servidor: 8080

Exporte la definición de un flujo de trabajo global para un proyecto de equipo

El ejemplo siguiente exporta el flujo de trabajo global para un proyecto de equipo:

witadmin exportglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:Contoso /f:C:myGlobalWorkflow.xml

Importe la definición de un flujo de trabajo global a un proyecto de equipo

El ejemplo siguiente importa el flujo de trabajo global al proyecto de equipo Contoso:

witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:Contoso /f:C:collectionGlobalWorkflow.xml

Importe la definición de un flujo de trabajo global a una colección

El ejemplo siguiente importa el flujo de trabajo global a la colección:

witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:collectionGlobalWorkflow.xml

Vea también

Conceptos

Definir listas globales

Otros recursos

Personalizar el flujo de trabajo global

witAdmin: Personalizar y administrar objetos para el seguimiento de elementos de trabajo