AddFieldValue

Descripción

Añade el valor especificado a la lista de valores del campo denominado.

Este método es similar a SetFieldValue, excepto que añade un elemento a la lista de valores, en lugar de proporcionar un valor exclusivo. Este método está previsto para campos que pueden aceptar una lista de valores. Si un campo no contiene un valor, puede utilizar este método para establecer el valor de un campo que toma un único valor.

Nota: El método AddFieldValue se ha diseñado para trabajar con campos de lista. No se ha diseñado para trabajar con campos escalonados (por ejemplo, una serie, una serie de varias líneas y referencia).

Para determinar si un campo contiene un valor válido, obtenga el objeto FieldInfo para el campo y llame a ValidityChangedThisSetValue del objeto FieldInfo para validar el campo.

Sólo se puede llamar a este método si el objeto Entity se puede editar. Para convertir un objeto Entity existente en editable, llame a EditEntity del objeto Session.

Sintaxis

VBScript

entity.AddFieldValue nombre_campo, nuevo_valor 

Perl

$entity->AddFieldValue(nombre_campo, nuevo_valor); 
Identificador
Descripción
entity
Un objeto Entity que representa un registro de datos de usuario. En un enganche, si se omite esta parte de la sintaxis, se presupone el objeto Entity correspondiente al registro de datos actual.
nombre_campo
Un valor String que contiene un nombre de campo válido de este objeto Entity.
nuevo_valor
Para Visual Basic, un valor Variant que contiene el nuevo valor que añadir al campo. Para Perl, un valor String que contiene el nuevo valor.
Valor de retorno
Si se permiten cambios en el campo, este método devuelve un valor String vacío; de lo contrario, este método devuelve un String que contiene una explicación del error.

Ejemplos

VBScript

AddFieldValue "field1", "option 1" 
AddFieldValue "field1", "option 2" 
AddFieldValua "field1", "option 3" 

Perl $entity->AddFieldValue("field1", "option 1"); $entity->AddFieldValue("field1", "option 2"); $entity->AddFieldValue("field1", "option 3");



Comentarios