Partager via


setValue (référence de l’API client)

Définit la valeur des données pour une colonne.

Types de colonne pris en charge

Tout

Syntaxe

formContext.getAttribute(arg).setValue(value)

Paramètres

Dépend du type de colonne.

Type de colonne Type de paramètres
booléen Boolean
datetime Date

Dans Unified Interface, les valeurs de date sont supposées être au format UTC.
Dans l’ancien client Web, les valeurs de date sont supposées être dans le fuseau horaire de l’utilisateur.
décimal Nombre
double Nombre
Entier Nombre
recherche Tableau Choix des objets de recherche.

Certaines recherches, connues sous le nom de recherches « partylist », permettent d’associer plusieurs enregistrements dans une recherche, comme la colonne À : pour un enregistrement de table d’e-mail. Par conséquent, toutes les valeurs de données de recherche utilisent un tableau d’objets de recherche, même lorsque la colonne de recherche ne prend pas en charge l’ajout de plusieurs références d’enregistrement.

Chaque recherche contient les propriétés suivantes :
- entityType : Chaîne. Le nom de la table affichée dans la recherche.
- id : Chaîne : représentation de la chaîne de la valeur GUID d’enregistrement affichée dans la recherche. La valeur doit correspondre au format suivant : {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}.
- name: Chaîne : texte représentant le texte à afficher dans la recherche.
memo String
devise Nombre
option Nombre
chaîne String
memo String
devise Nombre
option, options Nombre

La méthode getOptions renvoie des valeurs d’options en tant que chaînes. Vous devez utiliser parseInt pour les convertir en nombres avant de pouvoir utiliser ces valeurs pour définir la valeur d’une colonne d’option. Les options statuscode (Raison du statut) valides dépendent du code d’état actuel de l’enregistrement. La colonne Statecode (Statut) ne peut pas être définie dans les scripts de formulaire. Pour comprendre quelles valeurs de code d’état sont valides, reportez-vous aux définitions de colonne. Pour les tables personnalisées, utilisez le navigateur de définitions de table. Enfin, considérez également toutes les transitions d’état personnalisées qui ont été appliquées à la colonne. Plus d’informations : Définir les transitions de raison du statut pour l’instance ou les tables personnalisées.
String String

Une colonne String au format e-mail nécessite que la chaîne représente une adresse e-mail valide.

Notes

Mettre à jour une colonne à l’aide de setValue n’entraînera pas l’exécution des gestionnaires d’événements OnChange. Si vous souhaitez que les gestionnaires d’événement OnChange s’exécutent, vous devez utiliser fireOnChange en plus de setValue.

Article associé

getValue (référence de l’API client)

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).