SetFieldChoiceList

Descrizione

Nota: Per richiamare questo metodo da uno script esterno, è necessario che l'utente abbia i privilegi di amministratore ClearQuest.

Imposta un elenco di valori accettabili per il campo. Reimposta un elenco selezioni dinamico. Può essere utilizzata con InvalidateFieldChoiceList per lo svuotamento di qualsiasi valore già memorizzato.

Utilizzare questa funzione per forzare il client Rational ClearQuest allo scopo di prelevare i nuovi valori dell'elenco selezioni per il campo.

È possibile progettare lo schema in modo che Rational ClearQuest ricalcoli un elenco selezioni ogni volta che un utente interagisce con esso (nessun valore memorizzato nella cache) oppure solo per la prima volta (valori memorizzati nella cache). Se si desidera aggiornare i valori memorizzati nella cache, richiamare InvalidateFieldChoiceList per svuotare qualsiasi valore memorizzato nella cache, quindi richiamare SetFieldChoiceList per inizializzare nuovamente i valori. (La prima volta che viene visualizzato l'elenco selezioni, non è necessario richiamare InvalidateFieldChoiceList poiché nessun valore è preesistente nella memoria cache).

Utilizzare questi due metodi in un hook di campo valore modificato. Ad esempio, se l'utente finale seleziona un nuovo elemento dall'elenco dei progetti, il tipo di record viene modificato e il modulo richiede un elenco selezioni dipendente aggiornato.

Sintassi

VBScript

entity.SetFieldChoiceList fieldName, (choiceList) 

Perl

$entity->SetFieldChoiceList(fieldName, choiceList); 
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).
nomeCampo
Una stringa che identifica un nome del campo valido di un'entità.
choiceList
Per VB, un valore Variant contenente un array di stringhe. Per Perl, un riferimento ad un array di stringhe.
Valore di ritorno
Nessuno.

Esempi

VBScript

fieldchoicelist3 = array("hello", "world", "goodbye")

SetFieldChoiceList "severity",  (fieldchoicelist3) 

Perl

$entity->SetFieldChoiceList($fieldname, \@choiceList);

# Add choices by adding strings to the array of field choices 

Feedback