Elemento WHENCHANGED (Esquema de definición de 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 cambia el valor de otro campo. El elemento primario define el campo actual.
<xs:element name="WHENCHANGED" type="FieldCondition"/>
Atributos y elementos
En las secciones siguientes se describe el atributo y los elementos secundarios que definen el elemento WHENCHANGED. También se describen los elementos primarios que definen cómo se aplica el elemento WHENCHANGED. Debe definir al menos un elemento secundario.
Atributos
Atributo |
Descripción |
|---|---|
field |
Atributo necesario. Identifica el campo que debe cambiar para que las reglas de este elemento se apliquen al campo actual (el campo que contiene el elemento WHENCHANGED). 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). |
Elementos secundarios
Elemento |
Descripción |
|---|---|
Elemento REQUIRED (Esquema de definición de tipo de elemento de trabajo) |
Elemento opcional. Especifica que cuando cambia el valor del campo identificado por el atributo field, el campo actual (el campo que contiene el elemento WHENCHANGED) debe tener un valor. |
Elemento READONLY (Esquema de definición de tipo de elemento de trabajo) |
Elemento opcional. Especifica que cuando cambia el valor del campo identificado por el atributo field, 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 cambia el valor del campo identificado por el atributo field, el campo actual debe estar vacío. |
Elemento FROZEN (Esquema de definición del tipo de elemento de trabajo) |
Elemento opcional. Especifica que cuando cambia el valor del campo identificado por el atributo field, 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 cambia el valor del campo identificado por el atributo field, 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 cambia el valor del campo identificado por el atributo field, 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 cambia el valor del campo identificado por el atributo field, 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 cambia el valor del campo identificado por el atributo field, 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 cambia el valor del campo identificado por el atributo field, el campo actual debe tener un valor que proceda de 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 cambia el valor del campo identificado por el atributo field, 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 cambia el valor del campo identificado por el atributo field, 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 cambia el valor del campo identificado por el atributo field, el valor especificado es el valor predeterminado del campo actual. |
Elemento COPY (Esquema de definición de tipo de elemento de trabajo) |
Elemento opcional. Especifica que cuando cambia el valor del campo identificado por el atributo field, 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 cambia el valor del campo identificado por el atributo field, 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 y a las reglas y condiciones que se aplican al campo. La referencia se basa en el elemento STATE, TRANSITION, DEFAULTREASON o en el elemento REASON del que su 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
WHENCHANGED es un elemento secundario opcional de FIELD (Esquema de definición de tipo de elemento de trabajo) y FIELD (elemento WORKITEMTYPE).
Ejemplo
<WHENCHANGED field="field reference name">
<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>
</WHENCHANGED>
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 |
FieldCondition, tipo complejo (Esquema de definición de tipo de elemento de trabajo) |
Puede estar vacío |
No |