GetFieldRequiredness

Descrizione

Identifica il funzionamento del campo specificato.

Un campo può essere obbligatorio, facoltativo o di sola lettura. Se l'entità non è un oggetto Entity modificabile, questo metodo restituisce sempre il valore READONLY. Se l'oggetto Entity è modificabile, poiché è stata avviata un'azione, il valore di ritorno può essere READONLY, MANDATORY o OPTIONAL.

Questo metodo non restituisce mai il valore USE_HOOK. Se il funzionamento del campo è determinato da un hook di autorizzazione, Rational ClearQuest avrà già eseguito tale hook e individuato il valore risultante. Questo metodo restituisce quindi il valore individuato.

Nota: poiché gli hook operano con i privilegi (Super utente) di amministratore, possono sempre modificare il contenuto di un campo, a prescindere dalla relativa impostazione del funzionamento corrente. Se il campo è READONLY per un utente Rational ClearQuest ma è modificabile nel contenuto di un hook, il valore di ritorno non è READONLY. Consultare GetFieldRequiredness dell'oggetto EntityDef per restituire il funzionamento (READONLY) definito dei campi di un tipo di record.

È possibile utilizzare il metodo GetFieldNames per ottenere un elenco di nomi validi per il parametro field_name.

Sintassi

VBScript

entity.GetFieldRequiredness(field_name) 

Perl

$entity->GetFieldRequiredness(field_name); 
Identificativo
Descrizione
entity
Un oggetto Entity che rappresenta un record di dati dell'utente. All'interno di un hook, se si omette questa parte della sintassi, viene utilizzato l'oggetto Entity corrispondente al record di dati corrente (solo VBScript).
field_name
Una stringa che identifica un nome del campo valido dell'entità.
Valore di ritorno
Un valore Long che identifica il funzionamento del campo denominato. Il valore corrisponde ad un valore delle Costanti del funzionamento.

Esempi

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