Devuelve la lista de valores permitidos para el campo especificado.
El administrador especifica si los valores permitidos para un campo determinado se limitan al contenido de la lista de opciones. Si existe una restricción, al especificar un valor que no se encuentra en la lista de opciones se produce un error de validación. Si no existe ninguna restricción, se pueden especificar valores que no están en la lista de opciones. (Tenga en cuenta que todos los valores que especifique se deben validar).
Si este método devuelve un Empty Variant, no implica que estén permitidos todos los valores; sólo significa que el administrador no ha proporcionado ninguna sugerencia sobre los valores permitidos en el campo.
Si el administrador elige utilizar un enganche para determinar los valores de la lista de opciones, IBM Rational ClearQuest ejecuta previamente el enganche y almacena en antememoria los valores resultantes en un objeto HookChoices (sólo Visual Basic). Puede utilizar dicho objeto para recuperar los valores.
Si tiene un enganche de lista de opciones, que genera el conjunto de opciones para un campo, éste debe devolver los resultados al rellenar una recopilación que se pasa en el procedimiento de enganche.
Puede utilizar el método GetFieldNames para obtener una lista de nombres válidos para el parámetro nombre_campo.
VBScript
entity.GetFieldChoiceList nombre_campo
Perl
$entity->GetFieldChoiceList(nombre_campo);
VBScript
fieldValue = GetFieldValue("field1").GetValue
' Comprobar si el valor actual del campo está en la lista de opciones
fieldChoiceList = GetFieldChoiceList("field1")
For Each fieldChoice in fieldChoiceList
If fieldValue = fieldChoice Then
' Esta es una opción válida
End If
Next
Perl
# Si el campo debe tener un valor de una lista de opciones cerrada, por
# omisión, asignar el primer valor de la lista al campo.
$choicetype = $entity->GetFieldChoiceType("field1");
if ($choicetype eq $CQPerlExt::CQ_CLOSED_CHOICE)
{
# Establecer el campo en el primer elemento de la lista de opciones.
$fieldchoicelist = $entity->GetFieldChoiceList("field1");
$entity->SetFieldValue("field1",@$fieldchoicelist[0]);
}
#Ejemplo 2:
sub Dyn_choice_get_values
{
my $session;
my $fieldchoicelist;
$session=$entity->GetSession();
$fieldchoicelist = $entity->GetFieldChoiceList("Dyn_List_Example");
$session->OutputDebugString(" CHOICELIST @$fieldchoicelist \n");
return 0;
}