Establecer las condiciones en un campo Elemento de trabajo

Artículo
08/10/2011

Puede restringir los cambios que se realizan en un campo especificando una regla que lo califique, como los elementos CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, REQUIRED y READONLY. Por ejemplo, puede utilizar la regla NOTSAMEAS para evitar que dos campos tengan asignado el mismo valor o que se borren al mismo tiempo. Además, puede utilizar esa regla para evitar que al campo "revisor del código" se le asigne el mismo valor que al campo "asignado a".

Puede especificar estas reglas como elementos secundarios de FIELD (Definition), elementos FIELD (Workflow) o FIELD (Global workflow). Puede aplicar u omitir estas reglas basándose en quién está modificando el elemento de trabajo; para ello, especifique un usuario o grupo para los atributos for o not, respectivamente.

Nota

Para poder definir un flujo de trabajo global, la característica debe estar habilitada en el servidor de capa de aplicación. Por tanto, en el servidor debe ejecutarse una versión de Visual Studio Team Foundation Server, como puede ser Team Foundation Server 2010 con Service Pack 1 (SP1), compatible con dicha característica. Puede descargar el Service Pack en la siguiente página del sitio web de Microsoft: Service Pack 1 of Visual Studio Team Foundation Server 2010, Beta. Para obtener más información, vea Personalizar el flujo de trabajo.

Estructura de la sintaxis de los elementos de reglas para los valores de campo

Puede especificar la regla CANNOTLOSEVALUE para impedir que se borre un campo una vez especificado un valor. Si aplica esta regla a un campo, ese campo siempre debe contener un valor distinto de NULL cuando un usuario establezca el campo en cualquier valor.
```
<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />
```
La regla EMPTY se especifica para borrar el valor que contiene un campo. Esta regla también hace que un campo sea de solo lectura y no debe usarse con la regla READONLY. El valor del campo se borra cuando guarda el elemento de trabajo y no puede especificar ningún valor. Esta regla se usa principalmente durante la transición de estados para borrar los campos que se aplican al estado al que el elemento de trabajo realiza la transición.
```
<EMPTY for="userGroupName"not="userGroupName" />
```
Especifique la regla FROZEN para evitar que un usuario cambie el campo a un valor NULL después de guardar el elemento de trabajo. Tan pronto como el campo tenga un valor definido en la base de datos, el valor ya no se puede modificar.
```
<FROZEN for="userGroupName" not="userGroupName" />
```
Especifique la regla NOTSAMEAS para impedir que un campo tenga asignado el mismo valor que otro. El atributo field debe ser un nombre de referencia válido de un campo.
```
<NOTSAMEAS for="userGroupName" not="userGroupName" field="fieldReferenceName"/>
```
Por ejemplo, en el siguiente fragmento, se impide que un campo tenga el mismo valor que el campo MyCorp.Reviewer:
```
<NOTSAMEAS field="MyCorp.Reviewer" />
```
Utilice esta regla en los campos que son de un tipo similar. No puede utilizarlo para campos de texto sin formato o HTML.
Especifique la regla READONLY para evitar los cambios en el valor de un campo.

No utilice este elemento junto con el elemento EMPTY porque EMPTY crea también un campo de solo lectura. Si utiliza ambos elementos juntos, podría generar resultados incoherentes.
```
<READONLY for="userGroupName" not="userGroupName" />
```
Especifique la regla REQUIRED para requerir que los usuarios especifiquen un valor para el campo. Los campos obligatorios no pueden estar vacíos. Los usuarios no pueden guardar un elemento de trabajo hasta que hayan definido todos los campos obligatorios.
```
<REQUIRED for="userGroupName" not="userGroupName" />
```

Volver al principio

Atributos

Puede restringir a quién se aplican las reglas de calificación. En la siguiente tabla se describen los atributos a los que estos elementos hacen referencia:

Atributo	Descripción
for	Opcional. Especifica el nombre del usuario o grupo de Team Foundation al que se aplica esta regla. Los nombres válidos están compuestos de una cadena de texto que contiene entre 1 y 255 caracteres. Valor de modelo: ^[^\\]+\\[^\\]+$ Ejemplo de un valor de modelo: DomainUserID
not	Opcional. Especifica el nombre del usuario o grupo de Team Foundation al que no se aplica esta regla. Los nombres válidos están compuestos de una cadena de texto que contiene entre 1 y 255 caracteres. Valor de modelo: ^[^\\]+\\[^\\]+$ Ejemplo de un valor de modelo: DomainUserID
field	Requerido para el elemento NOTSAMEAS. Especifica el nombre de referencia del campo cuyo valor el campo actual no puede contener. El nombre de referencia debe coincidir con el nombre de referencia definido en el elemento FIELD (Definition). Para obtener más información, vea FIELD (Definición) (Elemento). Valor de modelo: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Ejemplo de un valor de modelo: Company.Division.IssueType

for

Opcional. Especifica el nombre del usuario o grupo de Team Foundation al que se aplica esta regla. Los nombres válidos están compuestos de una cadena de texto que contiene entre 1 y 255 caracteres.

Valor de modelo: ^[^\\]+\\[^\\]+$

Ejemplo de un valor de modelo: DomainUserID

not

Opcional. Especifica el nombre del usuario o grupo de Team Foundation al que no se aplica esta regla. Los nombres válidos están compuestos de una cadena de texto que contiene entre 1 y 255 caracteres.

Valor de modelo: ^[^\\]+\\[^\\]+$

Ejemplo de un valor de modelo: DomainUserID

field

Requerido para el elemento NOTSAMEAS. Especifica el nombre de referencia del campo cuyo valor el campo actual no puede contener.

El nombre de referencia debe coincidir con el nombre de referencia definido en el elemento FIELD (Definition). Para obtener más información, vea FIELD (Definición) (Elemento).

Valor de modelo: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$

Ejemplo de un valor de modelo: Company.Division.IssueType

Volver al principio