GetFieldRequiredness

Descripción

Identifica el comportamiento del campo especificado.

Un campo puede ser obligatorio, opcional o de sólo lectura. Si la entidad no es un objeto Entity editable, este método siempre devuelve el valor READONLY. Si el objeto Entity es editable, porque se ha iniciado una acción, el valor de retorno puede ser READONLY, MANDATORY u OPTIONAL.

Este método nunca devuelve el valor USE_HOOK. Si un enganche de permiso determina el comportamiento del campo, Rational ClearQuest ejecuta antes el enganche y almacena el valor resultante en antememoria. A continuación, este método devuelve el valor almacenado en antememoria.

Nota: Puesto que los enganches operan con privilegios de administrador (Superusuario), siempre pueden modificar el contenido de un campo, independientemente del valor del comportamiento actual. Si el campo es READONLY para un usuario de Rational ClearQuest, pero se puede modificar en el contexto de un enganche, el valor de retorno no es READONLY. Consulte el apartado sobre GetFieldRequiredness del objeto EntityDef para que se devuelva el comportamiento definido (READONLY) de los campos de un tipo de registro.

Puede utilizar el método GetFieldNames para obtener una lista de nombres válidos para el parámetro nombre_campo.

Sintaxis

VBScript

entity.GetFieldRequiredness(nombre_campo) 

Perl

$entity->GetFieldRequiredness(nombre_campo); 
Identificador
Descripción
entity
Un objeto Entity que representa un registro de datos de usuario. En un enganche, si se omite esta parte de la sintaxis, se presupone el objeto Entity correspondiente al registro de datos actual (sólo VBScript).
nombre_campo
Un valor String que identifica un nombre de campo válido de entidad.
Valor de retorno
Valor Long que identifica el comportamiento del campo denominado. El valor corresponde a una de las constantes de Behavior.

Ejemplos

VBScript

' Cambiar todos los campos obligatorios a opcionales 
' Recuperar la recopilación de campos
fieldNameList = GetFieldNames 
For Each fieldName in fieldNameList 
' Averiguar si el campo seleccionado es obligatorio 
	fieldReq = GetFieldRequiredness(fieldName) 
	if fieldReq = AD_MANDATORY 
	' Puesto que lo es, convertirlo en opcional 
	Then SetFieldRequirednessForCurrentAction fieldName, AD_OPTIONAL 
	End If 
Next 

Perl

# Cambiar todos los campos OBLIGATORIOS a OPCIONALES 
# Recuperar la recopilación de campos 
$fieldnamelist = $entity->GetFieldNames(); 
foreach $fieldname (@$fieldnamelist)
{ 
	# Averiguar si el campo seleccionado es obligatorio 
	$fieldreq = $entity->GetFieldRequiredness($fieldname); 
	if ($fieldreq eq $CQPerlExt::CQ_MANDATORY) 
	{ 
		# Puesto que lo es, convertirlo en opcional 
		$entity->SetFieldRequirednessForCurrentAction($fieldname, 
																		$CQPerlExt::CQ_OPTIONAL); 
	} 
}


Comentarios