SetFieldValue

Description

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 field_name, new_value 

Perl

$entity->SetFieldValue(field_name, ); 
Identificador
Description
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).
field_name
Un valor String que contiene un nombre de campo válido de este objeto Entity.
new_value
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

' Set two field values, but only check errors for 
' the second field. 
entity.SetFieldValue "field1", "new value" 
returnVal = SetFieldValue("field2", "100") 

Perl

# Set two field values for the entity

# Perform error checking on the second field

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

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

Comentarios