Imposta il funzionamento di un campo per la durata dell'azione corrente.
Utilizzare questo metodo per impostare il funzionamento di un campo come obbligatorio, facoltativo o di sola lettura. Dopo aver eseguito il commit dell'azione, il funzionamento del campo torna ad essere in sola lettura. Per richiamare questo metodo da uno script esterno, è necessario disporre dei privilegi di amministratore ClearQuest. Inoltre, è possibile richiamare questo metodo solo se l'oggetto Entity è modificabile. Per rendere un oggetto Entity esistente modificabile, richiamare il metodo EditEntity dell'oggetto Session.
Poiché un Record_script_alias non è un'azione entità true, il funzionamento di questa funzione non viene definito quando utilizzata in un'azione Record_script_alias.
Per le integrazioni tra IBM® Rational ClearCase e IBM Rational ClearQuest di base, non è possibile associare un record Rational ClearQuest ad un check in Rational ClearCase se il record Rational ClearQuest include campi richiesti (o obbligatori) che non possiedono valori specificati. Gli utenti che tentano di eseguire questa operazione ricevono un errore di eccezione. Gli utenti devono prima immettere i valori per i campi obbligatori del record Rational ClearQuest; o lo schema può essere modificato per fornire un hook da eseguire sull'azione Modify utilizzando il metodo SetFieldRequirednessForCurrentAction per modificare l'obbligatorietà di un campo.
VBScript
entity.SetFieldRequirednessForCurrentAction field_name, newValue
Perl
$entity->SetFieldRequirednessForCurrentAction(field_name, newValue);
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);
}
}