Compartir a través de


Elemento WHEN (Esquema de definición del tipo de elemento de trabajo)

Actualización: noviembre 2007

Especifica una condición según la cual se aplican una o varias reglas al campo actual. Las reglas se aplican al campo actual cuando otro campo contiene un valor concreto. El elemento primario define el campo actual.

<xs:element name="WHEN" type="FieldValueCondition"/>

Atributos y elementos

En las secciones siguientes se describen los atributos y los elementos secundarios que definen el elemento WHEN. También se describen los elementos primarios que definen cómo se aplica el elemento WHEN. Debe definir al menos un elemento secundario.

Atributos

Atributo

Descripción

field

Atributo obligatorio.

Identifica un campo que debe tener un valor especificado para que se apliquen las reglas de este elemento al campo actual.

Este atributo se especifica mediante el nombre de referencia del campo. Para obtener más información acerca de nombres de referencia, vea Elemento FIELD (Elemento WORKITEMTYPE).

value

Atributo obligatorio.

Especifica el valor que debe tener el campo identificado por el atributo field para que se apliquen las reglas de este elemento al campo actual.

Elementos secundarios

Elemento

Descripción

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

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, el campo actual (el campo que contiene el elemento WHEN) debe tener un valor.

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

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, el campo actual es de sólo lectura.

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

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, el campo actual no debe tener un valor.

Elemento FROZEN (Esquema de definición del tipo de elemento de trabajo)

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, el campo actual está inmovilizado. Un campo inmovilizado no puede cambiarse a un valor no vacío después de confirmar los cambios. Sin embargo, se puede borrar manualmente el campo, guardar el elemento de trabajo y, a continuación, especificar un valor diferente.

Elemento CANNOTLOSEVALUE (Esquema de definición del tipo de elemento de trabajo)

Elemento opcional.

Especifica que cuando el valor del campo identificado por el atributo field no cambia, no se puede borrar ni vaciar el campo actual después de que obtenga un valor.

Elemento NOTSAMEAS (Esquema de definición del tipo de elemento de trabajo)

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, el valor del campo actual no puede coincidir con el valor de un tercer campo. El tercer campo se especifica en el elemento NOTSAMEAS.

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

Elemento opcional.

Especifica que cuando el valor del campo identificado por el atributo field tiene el valor especificado, la lista de valores permitidos sólo debe incluir usuarios válidos del sistema.

Elemento ALLOWEXISTINGVALUE (Esquema de definición del tipo de elemento de trabajo)

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, se permitirá el valor del campo actual existente, aunque infrinja otras reglas. Si se cambia el valor del campo actual, este elemento no se aplica.

Elemento MATCH (Esquema de definición del tipo de elemento de trabajo)

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, el valor del campo actual debe coincidir con el modelo especificado.

Elemento ALLOWEDVALUES (Esquema de definición del tipo de elemento de trabajo)

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, el campo actual debe tener un valor proporcionado por la lista especificada de valores. Los valores permitidos son los valores que están disponibles para su selección en una lista de campos de los formularios de elementos de trabajo y en el generador de consultas. Debe seleccionar uno de estos valores.

Elemento SUGGESTEDVALUES (Esquema de definición del tipo de elemento de trabajo)

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, la lista especificada contiene los valores sugeridos para el campo actual. Los valores sugeridos son los valores que están disponibles para su selección en una lista de campos de los formularios de elementos de trabajo y en el generador de consultas. Además de los valores que figuran en la lista, puede agregar otros valores.

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

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, el valor del campo actual no puede contener ninguno de los valores de esta lista.

Elemento DEFAULT (Esquema de definición del tipo de elemento de trabajo)

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, este elemento especifica el valor predeterminado del campo actual.

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

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, el valor de un tercer campo se copia automáticamente en el campo actual. El tercer campo se especifica en el elemento COPY.

Elemento SERVERDEFAULT (Esquema de definición del tipo de elemento de trabajo)

Elemento opcional.

Especifica que cuando el campo identificado por el atributo field tiene el valor especificado, el campo actual utiliza el valor del componente de servidor especificado. Los componentes de servidor son clock, que es la hora a la que se actualiza el elemento de trabajo y currentuser, que es la identidad que actualiza el elemento de trabajo.

Elementos primarios

Elemento

Descripción

Elemento FIELD (Esquema de definición del tipo de elemento de trabajo)

Elemento necesario.

Hace referencia a una definición de campo de elemento de trabajo, así como a las reglas y condiciones que se aplican al campo. La referencia se basa en el elemento STATE, TRANSITION, DEFAULTREASON o REASON de cuyo elemento principal FIELDS es un elemento secundario.

Elemento FIELD (Elemento WORKITEMTYPE)

Elemento necesario.

Define un campo de elemento de trabajo, y especifica las reglas y condiciones que se le aplican.

Comentarios

WHEN es un elemento secundario opcional de FIELD (Esquema de definición del tipo de elemento de trabajo) y FIELD (elemento WORKITEMTYPE).

Ejemplo

<WHEN field="field reference name" value="value">
    <REQUIRED>…</REQUIRED>
    <READONLY>…</READONLY>
    <EMPTY>…</EMPTY>
    <FROZEN>…</FROZEN>
    <CANNOTLOSEVALUE>…</CANNOTLOSEVALUE>
    <NOTSAMEAS>…</NOTSAMEAS>
    <VALIDUSER>…</VALIDUSER>
    <ALLOWEXISTINGVALUE>…<ALLOWEXISTINGVALUE>
    <MATCH>…</MATCH>
    <ALLOWEDVALUES>…</ALLOWEDVALUES>
    <SUGGESTEDVALUES>…</SUGGESTEDVALUES>
    <PROHIBITEDVALUES>…</PROHIBITEDVALUES>
    <DEFAULT>…</DEFAULT>
    <COPY>…</COPY>
    <SERVERDEFAULT>…</SERVERDEFAULT>
</WHEN>

Información de elemento

Espacio de nombres

https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef

Nombre de esquema

Definición del tipo de elemento de trabajo

Archivo de validación

WorkItemTypeDefinition.xsd

Tipo de elemento

FieldValueCondition, tipo complejo (Esquema de definición de tipo de elemento de trabajo)

Puede estar vacío

No

Vea también

Otros recursos

Esquema de definición del tipo de elemento de trabajo

Condiciones de campo