Compartir a través de


Referencias de todos los elementos FIELD de XML

Puede usar la información de este tema como referencia rápida para todos los elementos y los atributos principales que definen un campo de datos de un tipo de elemento de trabajo.Puede especificar estos elementos en el contenedor de elementos FIELD (Definition).Para agregar un campo a un tipo de elemento de trabajo, especifique un elemento FIELD (Definition) en el elemento FIELDS (Definition).Puede especificar estos elementos en la definición de un tipo de elemento de trabajo o como parte de un flujo de trabajo global.Puede crear los elementos secundarios que se describen en este tema para especificar el comportamiento de un campo, definir los valores predeterminados o establecer una lista de selección de valores.Puede usar elementos de reglas de campo y combinarlos con otros elementos.Puede limitar la mayor parte de las reglas para que se apliquen a uno o varios usuarios o grupos, o para que uno o varios usuarios o grupos las omitan.

Todos los elementos secundarios de FIELD son opcionales.Salvo por el elemento HELPTEXT, se pueden especificar todos los elementos como elementos secundarios de los elementos FIELD (Definition), FIELD (Workflow) y FIELD (Global Workflow).Puede usar el elemento FIELD (Definition) para definir un campo de elemento de trabajo y especificar las reglas y condiciones que se aplican a él.Puede especificar reglas para que un elemento FIELD (Workflow) defina el valor o aplique reglas a un campo como transiciones del elemento de trabajo de un estado a otro.Puede especificar las reglas de los campos en función del elemento STATE, TRANSITION, REASON o DEFAULTREASON del que el elemento FIELDS principal es un elemento secundario.Para obtener más información, vea Trabajar con campos de elementos de trabajo y Diseñar el flujo de trabajo.

En este tema

  • Elemento contenedor FIELD (Definition)

  • Elementos secundarios de FIELD

  • Elementos secundarios GLOBALLIST y LISTITEM

  • Atributos especificados mediante elementos secundarios de FIELD

Elemento contenedor FIELD (Definition)

Puede usar la siguiente sintaxis para definir los campos de datos de un tipo de elemento de trabajo.En este ejemplo se muestra el formato del elemento FIELD (Definition) y todos los elementos secundarios opcionales.Para obtener más información, vea FIELD (Definición) (Elemento).

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID "
syncnamechanges="true | false" reportingname="reportingDisplayName" reportingrefname="reportingReferenceName"
reportable="Dimension | Detail | Measure" formula="avg" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

Elementos secundarios de FIELD

En la tabla siguiente se describen los elementos secundarios que puede especificar para aplicar las reglas que asignan un valor a un campo.Todos los elementos secundarios son opcionales.La mayoría de los elementos secundarios se pueden limitar para que se apliquen solo a un único grupo o a todos excepto a los usuarios de un determinado grupo.

Elemento

Descripción y sintaxis

ALLOWEDVALUES

Define una lista de valores que los usuarios pueden especificar en una lista de campos de los formularios de elementos de trabajo y en el editor de consultas.Los usuarios deben especificar uno de los valores que se muestran.

<ALLOWEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</ALLOWEDVALUES>

Para obtener más información, vea Definir listas desplegables.

ALLOWEXISTINGVALUE

Especifica que un campo puede mantener un valor existente, aun cuando ya no esté en ninguna lista de selección.Todos los valores nuevos deben estar en la lista.

<ALLOWEXISTINGVALUE />

Para obtener más información, vea Definir listas desplegables.

CANNOTLOSEVALUE

Especifica que los usuarios no pueden borrar todos los valores de un campo después de establecer un valor.Una vez que el campo contiene un valor, ese campo debe tener siempre un valor que no sea NULL.

<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />

Para obtener más información, vea Establecer las condiciones de un campo de elemento de trabajo.

COPY

Copia un valor especificado en un campo cuando un usuario crea o modifica un elemento de trabajo.

<COPY for="userGroupName" not="userGroupName"  
from="value | field | clock | currentuser" 
value="valueToCopy" field="fieldReferenceName" />

Para obtener más información, vea Definir valores predeterminados o copiar valores en un campo.

DEFAULT

Especifica un valor para un campo que está vacío cuando un usuario crea o modifica un elemento de trabajo.Si un campo ya tiene un valor, se omite la regla default.

<DEFAULT for="userGroupName" not="userGroupName" 
from="value | field | clock | currentuser" 
value="value to copy" field="field reference name" />

Para obtener más información, vea Definir valores predeterminados o copiar valores en un campo.

EMPTY

Borra cualquier valor que contenga el campo.La regla EMPTY 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 un usuario 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 realiza la transición.

<EMPTY for="userGroupName" not=" userGroupName" />

Para obtener más información, vea Establecer las condiciones de un campo de elemento de trabajo.

FROZEN

Especifica que no se puede modificar el campo a un valor no vacío después de confirmar los cambios.En cuanto un usuario guarde el elemento de trabajo con un valor en ese campo, ese valor ya no se podrá modificar.

<FROZEN for="userGroupName" not="userGroupName" />

Para obtener más información, vea Establecer las condiciones de un campo de elemento de trabajo.

HELPTEXT

Define el texto que va a aparecer cuando un usuario señale el campo del formulario de elemento de trabajo.

tooltipText: cadena de texto que contiene entre 1 y 255 caracteres.

<HELPTEXT>tooltipText </HELPTEXT>

Para obtener más información, vea Definir el texto de ayuda de un campo de elemento de trabajo.

MATCH

Define un modelo con el que deben coincidir los valores de los campos de tipo cadena.

<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />

Para obtener más información, vea Lograr que un campo de cadena coincida con un modelo.

NOTSAMEAS

Especifica que un campo no tiene asignado el mismo valor que el que se ha asignado a otro campo especificado.El valor del atributo field debe ser un nombre de referencia de campo válido.

<NOTSAMEAS field="fieldReferenceName" for="userGroupName" not="userGroupName" />

Para obtener más información, vea Establecer las condiciones de un campo de elemento de trabajo.

PROHIBITEDVALUES

Define una lista de valores que un campo no puede contener.Los usuarios no pueden guardar un elemento de trabajo si el campo contiene un valor prohibido.

<PROHIBITEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</PROHIBITEDVALUES>

Para obtener más información, vea Definir listas desplegables.

READONLY

Especifica que no se puede modificar el valor que tiene asignado el campo.

<READONLY for="userGroupName" not="userGroupName" />
NotaNota
No utilice este elemento junto con el elemento EMPTY porque EMPTY crea también un campo de solo lectura.Si combina estos elementos, los resultados serán incoherentes.

Para obtener más información, vea Establecer las condiciones de un campo de elemento de trabajo.

REQUIRED

Especifica que los usuarios deben establecer un valor en el campo.Los campos obligatorios no pueden estar vacíos.Los usuarios no podrán guardar un elemento de trabajo hasta que hayan asignado valores a todos los campos obligatorios.

<REQUIRED for="userGroupName" not="userGroupName" />

Para obtener más información, vea Establecer las condiciones de un campo de elemento de trabajo.

SERVERDEFAULT

Copia un valor del servidor especificado en un campo cuando un usuario guarda un elemento de trabajo.Normalmente, estos campos aparecen como campos de solo lectura en el formulario.

<SERVERDEFAULT for="userGroupName" not="userGroupName" 
from="clock | currentuser" />

Para obtener más información, vea Definir valores predeterminados o copiar valores en un campo.

SUGGESTEDVALUES

Define una lista de valores sugeridos que los usuarios pueden especificar en una lista de campos de los formularios de elementos de trabajo y en el editor de consultas.Los usuarios pueden especificar valores distintos de los sugeridos.

<SUGGESTEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>    
</SUGGESTEDVALUES>

Para obtener más información, vea Definir listas desplegables.

VALIDUSER

Restringe los elementos de trabajo para que los usuarios que pertenezcan al grupo especificado no puedan modificarlo.El grupo predeterminado es el grupo Valid Users de Team Foundation.

Todos los atributos son opcionales.Todos los atributos deben estar compuestos de una cadena de texto que contenga entre 1 y 255 caracteres.Puede utilizar tokens para especificar los grupos.Para obtener más información, vea Utilizar tokens para hacer referencia a grupos y usuarios.

< VALIDUSER group="groupName" for="userName" not="userName" />

Para obtener más información, vea Administrar permisos para crear o modificar elementos de trabajo.

WHEN

Especifica una o más reglas que se aplicarán al campo actual cuando otro campo tenga un valor concreto.El elemento FIELD primario define el campo actual.

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

Para obtener más información, vea Asignar reglas y valores basados en condiciones

WHENNOT

Especifica una o varias reglas que se van a aplicar al campo actual cuando otro campo no tenga un valor concreto.El elemento FIELD primario define el campo actual.

<WHENNOT field="fieldReferenceName" value="value">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHENNOT>

Para obtener más información, vea Asignar reglas y valores basados en condiciones.

WHENCHANGED

Especifica una o varias reglas que se van a aplicar al campo actual cuando otro campo se modifique durante la revisión del elemento de trabajo.El elemento FIELD primario define el campo actual.

<WHENCHANGED field="fieldReferenceName" >
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>      
</WHENCHANGED>

Para obtener más información, vea Asignar reglas y valores basados en condiciones.

WHENNOTCHANGED

Especifica una o varias reglas que se van a aplicar al campo actual cuando otro campo no se modifique durante la revisión del elemento de trabajo.El elemento primario define el campo actual.

<WHENNOTCHANGED field="fieldReferenceName">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHENNOTCHANGED>

Para obtener más información, vea Asignar reglas y valores basados en condiciones.

Elementos secundarios GLOBALLIST y LISTITEM

En la tabla siguiente se describen los elementos GLOBALLIST y LISTITEM.Puede especificar estos elementos como elementos secundarios de ALLOWEDVALUES, SUGGESTEDVALUES y PROHIBITEDVALUES.Puede usar estos elementos para enumerar una lista de valores que se presenta como una lista de selección o un menú desplegable con elementos que un usuario puede especificar.Para obtener más información, vea Definir listas de usuario, listas desplegables y listas globales.

Elemento

Sintaxis

Descripción

GLOBALIST

<GLOBALLIST name="globalListName
">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST> 

Define un conjunto de los elementos LISTITEM que se almacenan en una colección de proyectos de equipo y que todos los proyectos de equipo de una colección pueden usar.

globalListName: cadena de texto que contiene entre 1 y 255 caracteres.

GLOBALLIST es un elemento secundario obligatorio del elemento GLOBALLISTS y un elemento secundario opcional de los elementos ALLOWEDVALUES, SUGGESTEDVALUES y PROHIBITEDVALUES.Puede definir una lista global dentro de una definición de elemento de trabajo, una definición de lista global o un flujo de trabajo global.

LISTITEM

<LISTITEM value="listName" />

Define un valor de lista válido.

LISTITEM es un elemento secundario necesario del elemento GLOBALLIST y un elemento secundario opcional de ALLOWEDVALUES, SUGGESTEDVALUES y PROHIBITEDVALUES.

Volver al principio

Atributos especificados mediante elementos secundarios de FIELD

Puede calificar la mayoría de las reglas de FIELD para que se apliquen o no a un conjunto de grupos o usuarios; para ello, deberá incluir los atributos for o not.Para obtener más información, vea Definir el ámbito de una regla de campo en un grupo.

Atributo

Sintaxis

Descripción

expanditems

expanditems="true | false"

Opcional.Especifica si un grupo que el elemento LISTITEM identifica debe expandirse para que se incluyan los grupos subordinados de la lista.El valor predeterminado de este atributo es true.

filteritems

filteritems="excluirGrupos"

Opcional.Especifica que en la lista solo se incluyan los miembros de los grupos y no los nombres de grupo.El único valor permitido para este atributo es excludegroups.

for

for="nombreGrupoUsuario"

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

not

not="nombreGrupoUsuario"

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

from

from="value | field | clock | currentuser"

Requerido.Especifica el origen del valor a partir del cual se va a copiar el valor o se va a establecer un valor predeterminado.Valores válidos son:

  • clock: Copia la fecha y hora actual del reloj del sistema en los campos DateTime. No se necesita ningún atributo adicional.En las reglas COPY y DEFAULT, este valor se toma del reloj del equipo local.En SERVERDEFAULT, el valor se toma del reloj del servidor cuando un usuario guarda el elemento de trabajo.

  • currentuser: Copia el nombre del usuario que está conectado actualmente.Usa como valor el nombre corto del usuario actual.No se necesita ningún atributo adicional.Se utiliza en los campos de cadena.

  • field: copia el valor del atributo field que se especifique.Requiere un atributo field="abc".De forma predeterminada, si el campo "from" especificado está vacío, no se realiza ninguna acción.El atributo field solo se usa en las reglas <COPY> y <DEFAULT>.

  • value: copia el valor del atributo value que se especifique.Utilice el valor de una constante de cadena especificada.Es necesario un atributo value="abc".value solo se usa para las reglas <COPY> y <DEFAULT>.

Si especifica "value" o "field", debe incluir también el atributo "value" o "field", respectivamente.

field

field="nombreReferenciaCampo"

Opcional.Establece el nombre del campo cuyo valor se va a copiar en el campo cuando se especifique field para el atributo from.

pattern

pattern= "patternValue”

Requerido.Fuerza únicamente la coincidencia de modelos básicos para las cadenas.patternValue es una cadena que consta de entre 1 y 255 caracteres, ambos incluidos.Esa cadena no debe contener un carácter de barra diagonal inversa (\).Cada carácter de la cadena se interpreta como literal, a menos que sea uno de los seis metacaracteres siguientes:

  • “A” o “a” representa un único carácter alfabético.

  • La “n” o “n” representa un único carácter numérico.

  • “X” o “x” representa un único carácter alfanumérico.

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

Por ejemplo, pattern="xxxxx.nn.nn" coincide con cualquier cinco caracteres alfanuméricos, entonces un punto, a dos caracteres numéricos, entonces un punto, a dos más caracteres numéricos.

value

value="valorQueSeVaAcopiar"

Opcional.Establece el valor que se va a copiar en el campo cuando value se especifica para el atributo from.

Volver al principio

Vea también

Conceptos

Definir listas de usuario, listas desplegables y listas globales

Trabajar con campos de elementos de trabajo

Diseñar el flujo de trabajo