Personalizar y administrar tipos de vínculo
Al igual que en los tipos de elemento de trabajo, puede definir y modificar tipos de vínculo personalizados.Sin embargo, no puede realizar cambios en los tipos de vínculo definidos por el sistema.Antes de agregar un nuevo tipo de vínculo a la colección de proyectos de equipo, revise los tipos de vínculos disponibles para su propio uso.Vea Vincular elementos de trabajo y objetos para admitir rastreabilidad.
Administre los tipos de vínculo definidos para una colección de proyectos de equipo mediante los siguientes comandos witadmin:
deactivatelinktype: desactiva el tipo de vínculo especificado.Los usuarios ya no podrán crear vínculos de este tipo.Los vínculos de este tipo existentes seguirán funcionando correctamente.
deletelinktype: quita permanentemente el tipo de vínculo especificado de la base de datos.También se quitan todos los vínculos definidos con este tipo de vínculo.
exportlinktype: exporta las definiciones de tipos de vínculo.Puede exportar la definición de un único tipo de vínculo o de todos los tipos de vínculo definidos para el servidor.
importlinktype: importa las definiciones de los tipos de vínculo de un archivo XML.Si ya existe un tipo de vínculo con el mismo nombre de referencia, se actualizará para que coincida con el tipo de vínculo importado.Si el tipo de vínculo aún no existe, se creará uno nuevo.
listlinktypes: enumera el conjunto de tipos de vínculo disponibles en un servidor.
reactivatelinktype: reactiva el tipo de vínculo especificado, y opcionalmente le asigna un nuevo nombre.
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%\Microsoft Visual Studio 11.0\Common7\IDE
En una edición de 64 bits de Windows, reemplace %programfiles% con %programfiles(x86)%.
Requisitos
Para la colección de proyectos de equipo en la que se definen los tipos de vínculo, debe tener los siguientes permisos establecidos:
Para enumerar o exportar tipos de vínculos, debe tener el permiso Ver información del nivel de proyecto para un proyecto de equipo de la colección establecido en Permitir.
Para eliminar, importar o volver a activar tipos de vínculos, debe ser miembro del grupo de seguridad Project Collection Administrators o tener el permiso Administrar tipos de vínculos de elementos de trabajo establecido en Permitir.
Para obtener más información, vea Permisos de Team Foundation Server y Grupos predeterminados, permisos y roles de 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 para Símbolo del sistema y, a continuación, elija Ejecutar como administrador.Para obtener más información, vea el sitio web de Microsoft: Control de cuentas de usuario.
witadmin deactivatelinktype /collection:CollectionURL /n:LinkName
witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]
witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding]
witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]
witadmin listlinktypes /collection:CollectionURL
witadmin reactivatelinktype /collection:CollectionURL /n:LinkName
Parámetros
Parámetro |
Descripción |
|---|---|
/collection:CollectionURL |
Especifica el URI de la colección de proyectos de equipo.El formato del identificador URI es el siguiente: http://NombreServidor:Puerto/NombreDirectorioVirtual/NombreColección Por ejemplo: http://ServerName:8080/tfs/Collection0 Si no se utiliza un directorio virtual, el formato del identificador URI es el siguiente: http://NombreServidor:Puerto/NombreColección |
/n:LinkName |
El nombre o el nombre de referencia del tipo de vínculo que se desea desactivar o eliminar. |
/f:FileName |
El archivo XML de tipos de vínculo.Se requiere para la importación, es opcional para la exportación.Si omite este parámetro, el resultado del comando aparece en la presentación. |
/e:encoding |
Nombre de un formato de codificación de .NET Framework 2.0.La codificación especificada se utilizará 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 si se produce un error en la detección, witadmin utiliza UTF-8. |
/v |
Valida el tipo de vínculo XML sin importarlo. |
/noprompt |
Deshabilita el aviso para la confirmación. |
/? o help |
Muestra ayuda sobre el comando en la ventana del símbolo del sistema. |
Comentarios
Para la estructura del esquema de definición del tipo de vínculo, vea Referencia de elemento de tipo de vínculo.
Para obtener información acerca de cómo puede limitar los tipos de relaciones de vínculos que los miembros del equipo pueden crear, vea Vincular elementos de trabajo y controles y restricciones de vinculación y LinksControlOptions (Elementos).
Ejemplos
A menos que se especifique lo contrario, se aplican los siguientes valores en cada ejemplo:
Identificador URI de la colección de proyectos de equipo: http://AdventureWorksServer:8080/tfs/DefaultCollection
Nombre del servidor: AdventureWorksServer
Nombre del archivo de entrada o salida: myLinkTypes.xml
Nombre del tipo de vínculo: mylinktype
Codificación predeterminada: UTF-8
.gif "Dd273716.collapse_all(es-es,VS.110).gif")
Mostrar tipos de vínculo
El siguiente comando muestra los tipos de vínculo personalizados definidos para AdventureWorksServer de Team Foundation.
witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
Mostrar la definición de un tipo de vínculo
En el siguiente ejemplo se muestra la definición del tipo de vínculo en la ventana del símbolo del sistema:
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
Desactivar y, a continuación, reactivar un tipo de vínculo
Los siguientes ejemplos desactivan el tipo de vínculo mylinktype y, a continuación, lo reactivan:
witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
Exportar la definición de un tipo de vínculo
El siguiente comando exporta la definición de todos los tipos de vínculo al archivo, mylinktype.xml:
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml
Importar la definición de tipos de vínculo
En el siguiente ejemplo se importa la definición de los tipos de vínculo definidos en el archivo XML:
witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml
Vea también
Conceptos
Referencia de elemento de tipo de vínculo
Vincular elementos de trabajo y controles y restricciones de vinculación
Otros recursos
Vincular elementos de trabajo y objetos para admitir rastreabilidad
witAdmin: Personalizar y administrar objetos para el seguimiento de elementos de trabajo