GetValueAsList

Descripción

Devuelve una lista de valores de serie para el campo asociado a FieldInfo. Es útil para los campos que contienen más de un valor, incluidos los tipos de campo MULTILINE_STRING y los controles padre/hijo para tipos de lista de referencia (REFERENCE_LIST).

Se permite utilizar este método para un campo escalar (es decir, un campo que contenga un solo valor). Cuando se utiliza en un campo escalar, este método sólo devuelve un elemento en la matriz (a menos que el campo esté vacío, en cuyo caso, se devuelve un Empty Variant).

Para determinar si un campo puede contener varios valores, llame al método GetType del objeto FieldInfo correspondiente. Si el tipo del campo es REFERENCE_LIST, ATTACHMENT_LIST o JOURNAL, el campo puede contener varios valores.

Nota: Los campos cuyo tipo es ATTACHMENT_LIST o JOURNAL no se pueden modificar de modo programático.

Sintaxis

VBScript

fieldInfo.GetValueAsList 

Perl

$fieldInfo->GetValueAsList(); 
Identificador
Descripción
fieldInfo
Un objeto FieldInfo que contiene información sobre un campo de un registro de datos de usuario.
Valor de retorno
Para Visual Basic, devuelve un valor Variant Array. El valor Variant contiene la lista de valores, separados por vbLF (para campos escalares, devuelve Variant Array de 1 elemento). Si el campo no contiene ningún valor, este método devuelve un Empty Variant.

Para Perl, una referencia a una matriz de series que contiene los valores de la lista.

Ejemplos

VBScript

MyList = MyField.GetValueAsList

if not IsEmpty (MyList) then

   for each listItem in MyList

   '...

   next

end if

' Se puede separar la única variante que se devuelve en una matriz de 
' elementos de lista de serie utilizando la función Split:

av = GetFieldValue("multiline_string_field").GetValueAsList

if not IsEmpty(av) then

  array = Split(Cstr(av(0)),vbLF)

  u = UBound(array)

  for i = 0 to u

    ' ...

  next

end if

Perl

$asgs = $entity->GetFieldValue("Assignments")->GetValueAsList();

foreach my $asg (@$asgs) {

   # ...

   } 


Comentarios