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

Sintaxis

VBScript

entity.GetFieldRequiredness(field_name) 

Perl

$entity->GetFieldRequiredness(field_name); 
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).
field_name
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

' Change all mandatory fields to optional 
' Retrieve the collection of fields
fieldNameList = GetFieldNames 
For Each fieldName in fieldNameList 
' Find out if the selected field is mandatory 
	fieldReq = GetFieldRequiredness(fieldName) 
	if fieldReq = AD_MANDATORY 
	' Since it is, make it optional 
	Then SetFieldRequirednessForCurrentAction fieldName, AD_OPTIONAL 
	End If 
Next 

Perl

# Change all MANDATORY fields to OPTIONAL 
# Retrieve the collection of fields 
$fieldnamelist = $entity->GetFieldNames(); 
foreach $fieldname (@$fieldnamelist)
{ 
	# Find out if the selected field is mandatory 
	$fieldreq = $entity->GetFieldRequiredness($fieldname); 
	if ($fieldreq eq $CQPerlExt::CQ_MANDATORY) 
	{ 
		# Since it is, make it optional 
		$entity->SetFieldRequirednessForCurrentAction($fieldname, 
																		$CQPerlExt::CQ_OPTIONAL); 
	} 
}

Comentarios