Complemento de plantilla de procesos de control de versiones

Actualización: noviembre 2007

El complemento de control de versiones define los permisos de seguridad para el control de versiones iniciales de un proyecto de equipo, las notas de protección y si es necesaria la desprotección exclusiva. Este complemento se llama Microsoft.ProjectCreationWizard.VersionControl. El archivo XML de control de versiones se denomina VersionControl.xml y está ubicado en la carpeta Control de versiones de la jerarquía de carpetas de la plantilla de procesos. Puede cambiar el nombre de la carpeta y del archivo XML si es necesario.

En el archivo XML, especifique una o más tareas y sus dependencias. Por lo general, sólo se necesita una tarea para configurar el control de versiones. Para obtener un ejemplo de una tarea que realiza la configuración del control de versiones, vea el archivo VersionControl.xml en la plantilla de procesos de MSF for Agile Software Development.

Nota:
Team Foundation Server no incluye un mecanismo para la implementación de complementos de cliente, directivas u otras modificaciones. Si desea implementar complementos, directivas u otras modificaciones en Team Explorer, deberá utilizar un programa de instalación y distribución.

Notas de protección

El desarrollador proporciona las notas de protección cuando protege el código para describir de qué modo los cambios de código afectan a los procesos del equipo, en caso de que lo hagan. Por ejemplo, en una nota de protección se indica si el cambio se debe a una revisión de seguridad y se incluyen detalles sobre cambios relativos a la revisión de seguridad.

Utilice el elemento checkin_note para definir una nota de protección.

<checkin_note label="" required="" order=""/>

En la tabla siguiente se describen los atributos del elemento checkin_note.

Atributo	Descripción
label	Etiqueta que describe la nota de protección. La etiqueta se muestra en el cuadro de diálogo Protecciones pendientes cuando los usuarios realizan una protección.
required	Especifica si la nota de protección debe tener un valor. Si se establece como verdadero, la nota de protección debe tener un valor. Si se establece como falso, el valor es opcional.
order	Especifica un número ordinal que indica el orden en que se van a mostrar las notas de protección. Este atributo es opcional.

En el ejemplo siguiente se muestra cómo personalizar las notas de protección de MSF for Agile Software Development para proporcionar una nota de protección adicional denominada "Documentation Impact", que no requiere un valor.

<taskXml>
   <checkin_note label="Code Reviewer" required="false" order="1"/>
   <checkin_note label="Security Reviewer" required="false" order="2"/>
   <checkin_note label="Performance Reviewer" required="false" order="3"/> 
   <checkin_note label="Documentation Impact" required="false"/>
</taskXml>

Desprotección exclusiva

Es posible controlar si varios usuarios pueden desproteger un archivo al mismo tiempo. Utilice el elemento exclusive_checkout para especificar las propiedades de desprotección.

<exclusive_checkout required=""/>

Si el atributo required se establece como verdadero, sólo una persona podrá desproteger un archivo en cada ocasión. Si se establece como falso, varias personas podrán desproteger al mismo tiempo un archivo y deberán resolver las modificaciones realizadas cuando protejan el archivo.

En el ejemplo siguiente se muestra cómo especificar que es necesaria la desprotección exclusiva.

<exclusive_checkout required="true"/>

Obtener la última versión al desproteger

Puede configurar el comportamiento de desprotección predeterminado para el proyecto de equipo. Utilice el elemento get_latest_on_checkout para especificar el comportamiento de desprotección.

<get_latest_on_checkout required=""/>

Si el atributo necesario está establecido en true, la última versión de un elemento, o aviso, se descarga cada vez que se desprotege. Este comportamiento es similar al comportamiento de desprotección de Visual SourceSafe.

Si el atributo necesario está establecido en false, la operación de desprotección desprotegerá la versión local en el área de trabajo. Éste es el comportamiento predeterminado.

En el ejemplo siguiente se muestra cómo especificar que el comportamiento de desprotección predeterminado sea obtener la última versión al desproteger.

<get_latest_on_checkout required="true"/>

Permisos

El control de versiones tiene un conjunto concreto de permisos que puede configurar para una plantilla de procesos. Al especificar los permisos se definen las acciones que pueden realizar los individuos y grupos de seguridad en los elementos sujetos al control de versiones.

Utilice el elemento permission para conceder, negar, o conceder y negar permisos para una identidad.

<permission allow="" identity=""/>
<permission deny="" identity=""/>
<permission allow="" deny="" identity=""/>

En la tabla siguiente se describen los atributos del elemento permission.

Atributo	Descripción
allow	Identifica los permisos que se conceden. Los permisos se especifican como texto delimitado por comas.
deny	Identifica los permisos que se revocan. Los permisos se especifican como texto delimitado por comas. Nota: Los permisos denegados tienen prioridad sobre los permisos concedidos.
identity	Especifica el grupo de seguridad de Team Foundation Server, el grupo de Windows o identidad de Windows a los que se aplica este permiso.

En la tabla siguiente se describen los permisos que puede especificar para el control de versiones.

Permiso	Descripción
Read	Permite leer el contenido de un archivo o carpeta.
PendChange	Permite desproteger, agregar, eliminar, bifurcar, combinar, recuperar y realizar otras actividades asociadas a un conjunto de cambios.
Checkin	Permite proteger los cambios.
Label	Permite aplicar una etiqueta a los elementos.
Lock	Permite bloquear un elemento para que otros no puedan actualizarlo.
ReviseOther	Permite cambiar el contenido de los comentarios del conjunto de cambios y las notas de protección de otro usuario.
UnlockOther	Permite quitar el bloqueo de otro usuario.
UndoOther	Permite deshacer los cambios pendientes de otro usuario.
LabelOther	Permite modificar la etiqueta de otro usuario.
AdminProjectRights	Permite establecer la configuración de seguridad para el control de versiones.
CheckinOther	Permite realizar la protección como otro usuario. Este permiso es necesario con utilidades de conversión.

Nota:
En tiempo de ejecución, si no se encuentra un permiso para una identidad, se busca en otros grupos a los que ella pertenezca. Si no se encuentra, la acción predeterminada es denegar el permiso.

En el ejemplo siguiente se muestra cómo conceder permisos para que el grupo Contributors pueda modificar archivos sujetos al control de versiones.

<taskXml>
   <permission allow="Read, PendChange, Checkin, Label, Lock"
               identity="[$$PROJECTNAME$$]\Contributors"/>
</taskXml>

Vea también

Tareas

Cómo: Comprobar cambios del control de versiones

Conceptos

Complemento de plantilla de procesos de Windows SharePoint Services

Complemento de plantilla de procesos de informes

Complemento de plantilla de procesos de permisos y grupos

Configuración de desprotección de Team Foundation

Otros recursos

Complemento de plantilla de procesos de seguimiento de elementos de trabajo.