SetFieldValue

Descripción

Sitúa el valor especificado en el campo denominado.

Si el campo se puede cambiar, este método establece el nuevo valor, a pesar de que el valor sea válido, y devuelve un valor String vacío. Para determinar si un campo contiene un valor válido, obtenga el objeto FieldInfo para dicho campo y llame al método ValidityChangedThisSetValue del objeto FieldInfo para validar el campo.

Si el campo no se puede cambiar, el valor String devuelto indica el motivo por el que no se puede cambiar el campo. Los valores típicos incluyen, por ejemplo, "no existe tal campo", "el registro no se está editando" y "el campo es de sólo lectura".

Si el campo puede tener varios valores en lugar de sólo uno, utilice el método AddFieldValue para añadir cada nuevo valor. Aún se permite utilizar SetFieldValue; sin embargo, la utilización de SetFieldValue en un campo que ya contiene una lista de valores, reemplaza la lista completa con el único nuevo valor.

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 al método EditEntity del objeto Session.

Nota: Después de que un enganche cambie un valor o propiedad de campo, es posible que necesite renovar las variables locales que correspondan al campo cambiado o a cualquier otro campo. El establecimiento de un valor de campo puede hacer que se lancen enganches que pueden cambiar el valor o la obligatoriedad de cualquier campo del registro. Es posible que los enganches o los scripts deban renovar variables locales a fin de mantenerlas actualizadas con los valores del registro. Renueve las variables locales con valores actuales según sea necesario.

Sintaxis

VBScript

entity.SetFieldValue nombre_campo, nuevo_valor 

Perl

$entity->SetFieldValue(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 (sólo VBScript).
nombre_campo
Un valor String que contiene un nombre de campo válido de este objeto Entity.
nuevo_valor
Para VBScript, un valor Variant que contiene el nuevo valor para el 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

' Establecer dos valores de campo, pero comprobar sólo los errores 
' para el segundo campo. 
entity.SetFieldValue "field1", "new value" 
returnVal = SetFieldValue("field2", "100") 

Perl

# Establecer dos valores de campo para la entidad

# Realizar la comprobación de errores en el segundo campo

$entity->SetFieldValue("field1","new value");

$returnval = $entity->SetFieldValue("field2","100"); 


Comentarios