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 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 |