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");