SetFieldRequirednessForCurrentAction

Descripción

Establece el comportamiento de un campo para la duración de la acción actual.

Utilice este método para establecer el comportamiento del campo en obligatorio, opcional o de sólo lectura. Una vez que se haya confirmado la acción, el comportamiento del cambio vuelve a ser de sólo lectura. Para llamar a este método desde un script externo, el usuario debe tener privilegios de Administrador de ClearQuest. Además, sólo se puede llamar a este método si el objeto Entity se puede editar. Para convertir un objeto Entity existente en editable, llame al método EditEntity del objeto Session.

Nota: Después de que un enganche cambie un valor o propiedad de campo, es posible que necesite renovar las variables locales que correspondan al campo cambiado o a cualquier otro campo. El establecimiento de un valor de campo puede hacer que se lancen enganches que pueden cambiar el valor o los valores necesarios de cualquier campo del registro. Es posible que los enganches o los scripts deban renovar variables locales a fin de mantenerlas actualizadas con los valores del registro. Renueve las variables locales con valores actuales según sea necesario.

Dado que Record_script_alias no es una acción de entidad verdadera, el comportamiento de esta función no está definida cuando se utiliza en una acción Record_script_alias.

Para integraciones entre IBM® Rational ClearCase e IBM Rational ClearQuest, no puede asociar un registro de Rational ClearQuest a una incorporación de Rational ClearCase si el registro de Rational ClearQuest incluye campos necesarios (u obligatorios) que no tienen valores especificados. Los usuarios que intentan realizar esta operación reciben un error de excepción. En primer lugar, los usuarios deben entrar valores para los campos obligatorios del registro de Rational ClearQuest; o se puede cambiar el esquema para proporcionar un enganche que se ejecute en la acción de Modificar utilizando el método SetFieldRequirednessForCurrentAction para cambiar la obligatoriedad de un campo.

Sintaxis

VBScript

entity.SetFieldRequirednessForCurrentAction field_name, newValue 

Perl

$entity->SetFieldRequirednessForCurrentAction(field_name, newValue); 
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.
newValue
Valor Long que identifica el nuevo tipo de comportamiento del campo. Este valor corresponde a una de las constantes del tipo enumerado Behavior. (No se permite utilizar la constante USE_HOOK).
Valor de retorno
Ninguno.

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);
   }
} 

Feedback