api : générateur d’IU

API : api.context.props.<page_property_name>

Les propriétés de la page peuvent être configurées dans Générateur d'IU. Les valeurs de configuration dépendent du contexte dans lequel la page est utilisée.

Tableau 1. Champ
Nom	Type	Description
<page_property_name>	N'importe lequel	Les valeurs disponibles dépendent de l’implémentation du script client. Pour accéder à ces propriétés, utilisez ce qui suit : `api.context.props.<page_property_name>`. Par exemple : `// A record page with property table could be accessed with function isActivityStreamVisible({api}) { return api.context.props.table === 'incident'; }` Remarque : Ces valeurs de propriété sont en lecture seule. La transformation de valeurs d’objets imbriqués à partir de scripts n’est pas prise en charge.

api : api.context.session.<session_property>

Propriétés de session de contexte associées à l’utilisateur actuel.

Tableau 2. Propriétés de session disponibles
Nom	Type	Description
isLoggedIn	Booléen	Marqueur indiquant si l’utilisateur actuel est connecté au système. Valeurs possibles : true : l’utilisateur actuel est connecté à false : l’utilisateur actuel n’est pas connecté.
properties.awaEnabled	Chaîne	La propriété système glide.awa.enabled qui indique si l’affectation automatique des éléments de travail pour Affectation de travail avancée (AWA) est activée pour l’utilisateur actuel. Valeurs possibles : vrai : AWA est activé pour l’utilisateur. false : AWA n’est pas activé pour l’utilisateur. Pour plus d’informations, reportez-vous à la section Composants installés avec Affectation de travail avancée.
propriétés.Moi-Oublier.value	Chaîne	La propriété glide.ui.forgetme qui indique s’il faut supprimer la case à cocher Se souvenir de moi de la page de connexion pour empêcher la mise en cache des informations de connexion. Valeurs possibles : vrai : décochez la case Se souvenir de moi . faux : affiche la case à cocher Se souvenir de moi . Pour plus d’informations, voir Supprimer Se souvenir de moi.
propriétés.sessionTimeLeft.value	Chaîne Nombre contraint à une chaîne	La propriété système glide.ui.session_timeleft qui détermine la durée de montage restante avant l’expiration de la session en cours. Utilisez cette propriété pour demander à l’utilisateur d’étendre la session en cours avant son expiration. Unité : Minutes
properties.sessionTimeout.value	Chaîne Nombre contraint à une chaîne	La propriété système glide.ui.session_timeout qui détermine la valeur du délai d’expiration de session initiale. Unité : Minutes : les valeurs supérieures à 1 440 minutes sont traitées comme une journée. Pour plus d’informations, voir Délai d’activité de la session
properties.trackingEnabled.value	Chaîne	La propriété système glide.uxbuilder.tracking.enabled qui indique s’il faut activer/désactiver le chargement et l’instanciation de la bibliothèque d’analyse web pour Générateur d'IU les applications basées. Valeurs possibles : vrai : activé pour l’utilisateur. faux : désactivé pour l’utilisateur.
utilisateur.avatar	Chaîne	URL de l’avatar de l’utilisateur actuel.
user.dateFormat	Chaîne	Format de date par défaut.
user.domain	Chaîne	Chemin de domaine de l’utilisateur actuel.
user.firstName	Chaîne	Prénom de l’utilisateur actuel.
user.fullName	Chaîne	Le prénom et le nom de famille de l’utilisateur actuel.
user.initials	Chaîne	Initiales de l’utilisateur actuel.
langue.utilisateur	Chaîne	Langue principale parlée par l’utilisateur actuel.
preferences.utilisateur	Tableau d’objets	Paires nom-valeur décrivant les préférences utilisateur. Ces préférences utilisateur sont stockées en tant qu’enregistrements dans la table Préférences utilisateur [sys_user_preference] et sont mises à jour chaque fois que l’utilisateur modifie ses paramètres. Pour en savoir plus, consultez Exploring user administration.
user.roles	Tableau	Liste de rôles séparés par des virgules affectés à l’utilisateur actuel. Remarque : Si aucun rôle n’est affecté à l’utilisateur, cette propriété de session contextuelle renvoie une valeur null plutôt qu’un tableau vide.
user.sys_id	Chaîne	Sys_id de l’utilisateur dans la table Utilisateur [sys_user].
user.timeFormat	Chaîne	Format d’heure par défaut à utiliser pour l’utilisateur.
user.timeZone	Chaîne	Fuseau horaire de l’utilisateur actuel.
user.timeZoneOffset	Chaîne	Décalage du fuseau horaire de l’utilisateur actuel.

api : api.data.<data_resource_id>.lifecycle.lastFetchSucceeded

Marqueur booléen qui indique si la dernière tentative d’extraction pour l’instance de ressource de données spécifiée s’est terminée avec succès.

Si la valeur est définie sur vrai, la dernière tentative d’extraction pour l’instance de ressource de données s’est terminée avec succès. sinon, faux.

Tableau 3. Champ
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.

api : api.data.<data_resource_id>.addErrorMessage(charge utile de l’objet)

Affiche le message d’erreur spécifié en haut du formulaire actuel.

Tableau 4. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet décrivant le message d’erreur à afficher. `"payload": { "message": "String" }`
charge.message utile	Chaîne	Message d’erreur à afficher.

Tableau 5. Renvoie
Type	Description
Aucun

api.data.gform.addErrorMessage({message: 'Error message'});

api -api.data.<data_resource_id>.addInfoMessage(charge utile de l’objet)

Affiche le message d’information spécifié en haut du formulaire actuel.

Tableau 6. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet décrivant le message d’information à afficher. `"payload": { "message": "String" }`
charge.message utile	Chaîne	Message d’information à afficher.

Tableau 7. Renvoie
Type	Description
Aucun

api.data.gform.addInfoMessage({message: 'Test message'});

api : api.data.<data_resource_id>.addOption(charge utile de l’objet)

Ajoute une option au champ de type de choix spécifié.

Tableau 8. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit la valeur de champ à mettre à jour. `"payload": { "choiceIndex": "String", "choiceLabel": "String", "choiceValue": "String", "fieldName": "String" }`
payload.choiceIndex	Chaîne	Facultatif. Index dans la liste de choix à laquelle insérer l’option. Par défaut : fin de la liste de choix.
payload.choiceLabel	Chaîne	Étiquette de l’option à ajouter au champ spécifié.
charge utile.valeurchoix	Chaîne	Valeur de l’option à ajouter au champ spécifié.
charge utile.fieldName	Chaîne	Nom du champ de formulaire de type de choix auquel ajouter l’option spécifiée.

Tableau 9. Renvoie
Type	Description
Aucun

api.data.gform.addOption({fieldName: 'priority', choiceLabel: 'Extremely High', choiceValue: '10'});

api : api.data.<data_resource_id>.addWarningMessage(charge utile de l’objet)

Affiche le message d’avertissement spécifié en haut du formulaire actuel.

Tableau 10. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet décrivant le message d’avertissement à afficher. `"payload": { "message": "String" }`
charge.message utile	Chaîne	Message d’avertissement à afficher.

Tableau 11. Renvoie
Type	Description
Aucun

api.data.gform.addWarningMessage({message: 'Test message'});

api : api.data.<data_resource_id>.clearMessage()

Supprime tous les messages d’information et d’erreur du haut du formulaire actuel.

Tableau 12. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.

Tableau 13. Renvoie
Type	Description
Aucun

api.data.gform.clearMessage();

api : api.data.<data_resource_id>.clearOptions(charge utile de l’objet)

Efface toutes les options du champ de type de choix spécifié.

Tableau 14. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit le champ de type choix dont les options doivent être effacées. `"payload": { "fieldName": "String" }`
charge utile.fieldName	Chaîne	Nom du champ de type choix dont les options doivent être effacées.

Tableau 15. Renvoie
Type	Description
Aucun

api.data.gform.clearOptions({fieldName: 'priority'});

api : api.data.<data_resource_id>.executeUiAction(charge utile de l’objet)

Exécute l’action d’interface utilisateur spécifiée.

Tableau 16. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit l’action d’interface utilisateur à exécuter. `"payload": { "actionSysId": "String" }`
payload.actionSysId	Chaîne	Sys_id de l’action d’interface utilisateur à exécuter. Situé dans la table Action d’interface utilisateur [sys_ui_action].

Tableau 17. Renvoie
Type	Description
Aucun

api.data.gform.executeUiAction({actionSysId: '60615ff90f730010ac7de6f8c4767e9a'});

api : api.data.<data_resource_id>.execute(Object inputValues)

Déclenche une opération d’exécution sur la ressource de données spécifiée.

Cette méthode n’est disponible que si la ressource de données est de l’un des types suivants :

Composite
GraphQL
REST
Scriptlet
Transformer

Remarque :

Cette méthode n’est exposée que si le mutates_server_data champ est défini sur vrai sur l’enregistrement de ressource de données correspondant (table sys_ux_data_broker_*). Il est accessible sous api.data.<data_resource_Id>.refresh().

Tableau 18. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
valeurs d’entrée	Objet	Objet à transmettre à la ressource de données spécifiée. Cet objet doit être conforme aux paramètres d’entrée de la ressource de données.

Tableau 19. Renvoie
Type	Description
Aucun

Cet exemple de code montre un script de page qui est appelé lorsque le bouton Envoyer de la page est cliqué. La page est configurée à l’aide d’une ressource de données de serveur qui crée un nouvel enregistrement.

function handler({api}) {
  if (api.state.movieYear === 2020) {
    // The data resource used in this case specifies two input parameters: name and year
    api.data.create_movie_record.execute({
      name: api.state.movieName,
      year: api.state.movieYear
    });
  }
}

api : api.data.<data_resource_id>.hideFieldMessage(charge utile de l’objet)

Masque le message le plus ancien en regard du champ spécifié ou efface tous les messages associés au champ.

Tableau 20. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit le message de champ à masquer. `"payload": { "clearAll": Boolean, "fieldName": "String" }`
charge utile.effacerTout	Booléen	Facultatif. Marqueur indiquant s’il faut effacer tous les messages associés au champ de formulaire spécifié. Valeurs valides : vrai : efface tous les messages associés au champ spécifié. faux : n’effacez pas tous les messages associés au champ spécifié. Valeur par défaut : false
charge utile.fieldName	Chaîne	Nom du champ de formulaire dont il faut masquer le message le plus ancien ou effacer tous les messages associés.

Tableau 21. Renvoie
Type	Description
Aucun

api.data.gform.hideFieldMessage({fieldName: 'short_description'});

api : api.data.<data_resource_id>.hideRelatedList(charge utile de l’objet)

Masque la liste connexe spécifiée sur le formulaire actuel.

Tableau 22. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit la liste connexe à masquer. `"payload": { "listTableName ": "String" }`
payload.listTableName	Chaîne	Nom de la liste connexe à masquer. Situé dans la table Liste connexe [sys_ui_related_list]. Si la liste à masquer correspond à une relation, indiquez le sys_id de la liste au lieu du nom.

Tableau 23. Renvoie
Type	Description
Aucun

api.data.gform.hideRelatedList({listTableName:'incident.parent_incident'});

api : api.data.<data_resource_id>.hideRelatedLists()

Masque toutes les listes connexes sur le formulaire actuel.

Tableau 24. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.

Tableau 25. Renvoie
Type	Description
Aucun

api.data.gform.hideRelatedLists();

API : api.data.<data_resource_id>.refresh()

Déclenche une opération d’actualisation pour l’instance de ressource de données non mutante spécifiée.

Appelez cette méthode si les données sous-jacentes extraites par la ressource de données changent. Une ressource de données est considérée comme non mutante si le mutates_server_data champ de l’enregistrement est défini sur false.

Cette méthode est asynchrone et émet un événement interne pour déclencher l’actualisation de l’instance de ressource de données spécifiée. Le Générateur d'IU vous permet de déclencher des scripts clients en réponse aux événements du cycle de vie des ressources de données, tels que DATA_FETCH_SUCCEEDED et DATA_FETCH_FAILED. Pour plus d’informations sur ces événements, consultez Mappage d’événements.

Cette méthode n’est disponible que si la ressource de données est de l’un des types suivants :

Composite
GraphQL
REST
Scriptlet
Transformer

Remarque :

Cette méthode n’est exposée que si le mutates_server_data champ est défini sur false sur l’enregistrement de ressource de données correspondant (table sys_ux_data_broker_*).

Tableau 26. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.

Tableau 27. Renvoie
Type	Description
Aucun

Cet exemple de code montre un script de page qui est invoqué lorsqu’un élément de liste déroulante est sélectionné dans une page. La page est configurée avec deux ressources de données serveur qui interrogent les tables de problèmes et d’incidents.

function handler({api, event}) {
  const value = event.payload.value[0];
  if (value === 'problem')
    api.data.problem_list_1.refresh();
  else if(value === 'incident')
    api.data.incident_list_1.refresh();
}

API : api.data.<data_resource_id>.reload()

Recharge le formulaire actuel à l’aide de la même table et de la même sys_id.

Tableau 28. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.

Tableau 29. Renvoie
Type	Description
Aucun

api.data.gform.reload();

api : api.data.<data_resource_id>.removeOption(charge utile de l’objet)

Supprime une option du champ de type de choix spécifié.

Tableau 30. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit le champ de type choix à mettre à jour. `"payload": { "choiceValue": "String", "fieldName": "String" }`
charge utile.valeurchoix	Chaîne	Valeur de l’option à supprimer du champ de type de choix spécifié.
charge utile.fieldName	Chaîne	Nom du champ de formulaire de type de choix duquel supprimer la valeur spécifiée.

Tableau 31. Renvoie
Type	Description
Aucun

api.data.gform.removeOption({fieldName: 'priority', choiceValue: '1'});

API : api.data.<data_resource_id>.save()

Déclenche la soumission du formulaire à l’aide de l’action d’interface utilisateur Enregistrer .

Tableau 32. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.

Tableau 33. Renvoie
Type	Description
Aucun

api.data.gform.save();

api : api.data.<data_resource_id>.setMandatory(charge utile de l’objet)

Définit si le champ de formulaire indiqué est obligatoire.

Tableau 34. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit le champ dont les informations obligatoires doivent être mises à jour. `"payload": { "fieldName": "String", "mandatory": Boolean }`
charge utile.fieldName	Chaîne	Nom du champ de formulaire dont la valeur obligatoire doit être définie.
charge utile.obligatoire	Booléen	Marqueur indiquant que le champ de formulaire spécifié est obligatoire, ce qui signifie que le formulaire ne peut pas être enregistré sans que ce champ ne contienne une valeur valide. Valeurs valides : true : le champ est obligatoire. false : le champ est facultatif.

Tableau 35. Renvoie
Type	Description
Aucun

api.data.gform.setMandatory({fieldName: 'short_description', mandatory: false});

api : api.data.<data_resource_id>.setReadOnly(charge utile de l’objet)

Définit les options de lecture/écriture du champ de formulaire spécifié.

Tableau 36. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit le champ dont les informations sur la lisibilité doivent être mises à jour. `"payload": { "fieldName": "String", "readonly": Boolean }`
charge utile.fieldName	Chaîne	Nom du champ de formulaire dont la lisibilité doit être définie.
charge utile.lecture seule	Booléen	Marqueur qui indique les options de lecture/écriture du champ de formulaire spécifié. Valeurs valides : true : le champ est en lecture seule. faux : le champ est en lecture/écriture.

Tableau 37. Renvoie
Type	Description
Aucun

api.data.gform.setReadOnly({fieldName: 'short_description', readonly: false});

api -api.data.<data_resource_id>.setValue(charge utile de l’objet)

Met à jour un champ GlideForm spécifié avec la valeur spécifiée. Si vous le souhaitez, vous pouvez également mettre à jour la valeur d’affichage avec la même valeur spécifiée.

Seule la valeur du formulaire est mise à jour. La valeur n’est pas enregistrée dans la base de données.

Tableau 38. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit le champ dont la valeur doit être mise à jour. `"payload": { "displayValue": "String", "fieldName": "String", "value": "String" }`
charge utile.displayValue	Chaîne	Facultatif. Nom de la valeur d’affichage à mettre à jour. Si ce champ est vide, la valeur d’affichage n’est pas modifiée.
charge utile.fieldName	Chaîne	Nom du champ de formulaire à mettre à jour.
charge utile.valeur	Chaîne	Valeur avec laquelle mettre à jour le champ.

Tableau 39. Renvoie
Type	Description
Aucun

api.data.gform.setValue({fieldName: 'short_description', value: 'short description'});

api : api.data.<data_resource_id>.setVisible(charge utile de l’objet)

Définit la visibilité du champ de formulaire spécifié.

Tableau 40. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit le champ sur lequel définir la visibilité. `"payload": { "fieldName": "String", "visibility": Boolean }`
charge utile.fieldName	Chaîne	Nom du champ de formulaire dont la visibilité doit être définie.
charge utile.visibilité	Booléen	Marqueur indiquant si le champ associé est visible sur le formulaire actuel. Valeurs valides : vrai : le champ s’affichera sur le formulaire. faux : le champ ne s’affichera pas sur le formulaire.

Tableau 41. Renvoie
Type	Description
Aucun

api.data.gform.setVisible({fieldName: 'short_description', visibility: false});

api : api.data.<data_resource_id>.showFieldMessage(charge utile de l’objet)

Affiche le message spécifié en regard du champ spécifié.

Tableau 42. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit le message du champ à afficher. `"payload": { "fieldName": "String", "message": "String", "type": "String"`
charge utile.fieldName	Chaîne	Nom du champ à côté duquel le message doit apparaître.
charge.message utile	Chaîne	Message à afficher.
payload.type	Chaîne	Facultatif. Type de message à afficher. Valeurs valides : erreur infos avertissement Par défaut : info

Tableau 43. Renvoie
Type	Description
Aucun

api.data.gform.showFieldMessage({fieldName: 'short_description', message: 'Error message', type: 'error'});

api : api.data.<data_resource_id>.showRelatedList(charge utile de l’objet)

Affiche la liste connexe spécifiée sur le formulaire actuel.

Tableau 44. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit la liste connexe à afficher. `"payload": { "listTableName ": "String" }`
payload.listTableName	Chaîne	Nom de la liste connexe à afficher. Situé dans la table Liste connexe [sys_ui_related_list]. Si la liste à afficher correspond à une relation, indiquez le sys_id de la liste au lieu du nom.

Tableau 45. Renvoie
Type	Description
Aucun

api.data.gform.showRelatedList({listTableName:'incident.parent_incident'});

api : api.data.<data_resource_id>.showRelatedLists()

Affiche toutes les listes connexes associées au formulaire actuel.

Tableau 46. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.

Tableau 47. Renvoie
Type	Description
Aucun

api.data.gform.showRelatedLists();

API : api.data.<data_resource_id>.submit()

Déclenche la soumission du formulaire à l’aide de l’action d’interface utilisateur spécifiée.

Tableau 48. Paramètres
Nom	Type	Description
data_resource_id	Chaîne	Identificateur unique de la ressource de données associée. Dans la plupart des cas, vous pouvez utiliser l’action Contrôleur de formulaire CTRL_RECORD#SAVE_FORM. Si la page d’enregistrement comporte le composant Onglets de la page d’enregistrement, la ressource de données pour cette méthode doit être basée sur GlideForm (g_form). Les instances de ressources de données disponibles dépendent de la configuration et sont définies lorsque vous ajoutez la ressource de données à votre page au format Générateur d'IU.
payload	Objet	Objet qui décrit l’action d’interface utilisateur à utiliser pour soumettre le formulaire actuel. `"payload": { "submitActionName": "String" }`
payload.submitActionName	Chaîne	Nom de l’action d’interface utilisateur à exécuter pour soumettre le formulaire actuel.

Tableau 49. Renvoie
Type	Description
Aucun

api.data.gform.submit({submitActionName:'sysverb_ws_save'});

api : api.emit(String eventName, charge utile de l’objet)

Émet un événement avec le nom et la charge utile spécifiés.

Le nom de l’événement émis doit faire partie de la liste d’événements répartis de la définition de page associée, qui est stockée dans la table Définition du macroponent UX [sys_ux_macroponent]. Tout appel api.emit qui répartit des événements non déclarés dans cette table est ignoré.

Pour plus d’informations sur les événements, voir Utiliser des événements.

Tableau 50. Paramètres
Nom	Type	Description
eventName	Chaîne	Nom de l’événement à émettre. Ce nom doit suivre les directives de dénomination des actions du cadre de travail de l’interface utilisateur : Doit être le cas de serpent supérieur, tel que ITEM_CHANGED. Toutes les lettres en majuscules et tous les espaces ont été remplacés par des traits de soulignement. Doit être au passé, comme BUTTON_CLICKED ou USER_SELECTED. Pour en savoir plus sur ces consignes de dénomination des actions, reportez-vous à la section https://developer.servicenow.com/dev.do#!/reference/now-experience/sandiego/ui-framework/main-concepts/dispatching-actions.
payload	Objet	Facultatif. Objet qui contient les données à envoyer avec l’événement émis. Cet objet est de forme libre et peut contenir toutes les données nécessaires à l’entité qui reçoit les données. Remarque : charges utiles du travail de type primitif, mais pourrait entraîner un comportement incohérent.

Tableau 51. Renvoie
Type	Description
Aucun

L’exemple de code suivant montre l’émission d’un événement appelé NOW_UXF_PAGE#ADD_NOTIFICATIONS avec une charge utile associée items .

function handler({api}) { 
  api.emit('NOW_UXF_PAGE#ADD_NOTIFICATIONS', { 
    items: [
      { 
        id: 'alert1', 
        status: 'positive', 
        icon: 'check-circle-outline', 
        content: 'Here is some information!', 
        textLinkProps: { 
          label: 'More info',
          href: 'https://www.servicenow.com' 
        }, 
      action: {type: 'acknowledge'} 
      } 
    ] 
  }); 
}

api : setState(String, stateParam, n’importe quelle valeur)

Définit la valeur du paramètre d’état du client spécifié.

Utilisez les paramètres de l’état du client pour gérer un état partagé sur une page. L’état partagé peut ensuite être transmis sous forme de valeurs aux propriétés des composants utilisés sur la page. Vous pouvez également accéder aux états du client et les mettre à jour dans des scripts de plusieurs pages. Un cas d’utilisation courant consiste à suivre les valeurs saisies par les utilisateurs dans plusieurs contrôles de formulaire sur une page. Lorsque le formulaire est soumis, un script client peut alors utiliser toutes les valeurs stockées dans les paramètres d’état du client pour créer un nouvel enregistrement auprès d’un courtier en données. Une page peut avoir un ou plusieurs paramètres d’état client, que vous pouvez déclarer pour une page via le générateur d’IU. Vous pouvez ensuite lier un paramètre d’état client à un ou plusieurs composants pour partager ou agir sur le paramètre d’état client.

Les appels api.setState() sont exécutés de manière asynchrone et ne mettent pas nécessairement à jour l’interface utilisateur immédiatement. Si la valeur à définir dépend currentValue du paramètre de l’état du client ou de l’une des propriétés fournies dans l’objet api, vous devez utiliser cette variante de la méthode api.setState() pour éviter d’utiliser des valeurs obsolètes.

Tableau 52. Paramètres
Nom	Type	Description
StateParm	Chaîne	Nom du paramètre d’état du client à mettre à jour. Ce nom doit être déclaré dans les paramètres d’état du client de la page associée. Pour plus d’informations sur la déclaration des paramètres de l’état du client, voir Utiliser les paramètres de l’état du client.
valide	N’importe lequel : doit être identique à la déclaration du paramètre de l’état du client.	Valeur sur laquelle définir le paramètre d’état du client spécifié.

Tableau 53. Renvoie
Type	Description
Aucun

Cet exemple montre un script qui peut être exécuté pour mettre à jour le paramètre d’état de Client de messagerie lorsqu’une valeur d’entrée est définie sur un composant now-input.

function handler({api, event}) {
    api.setState('email', event.payload.value);
}

api : setState(String stateParam, Function callbackFn)

Définit la valeur du paramètre d’état du client spécifié sur la valeur retournée par la fonction de rappel spécifiée.

La fonction de rappel est invoquée avec un objet qui possède deux propriétés : currentValue et api. La fonction ne doit jamais modifier directement la propriété ou l’objet currentValueapi .

Utilisez les paramètres de l’état du client pour gérer un état partagé sur une page. L’état partagé peut ensuite être transmis sous forme de valeurs aux propriétés des composants utilisés sur la page. Vous pouvez également accéder aux états du client et les mettre à jour dans des scripts de plusieurs pages. Un cas d’utilisation courant consiste à suivre les valeurs saisies par les utilisateurs dans plusieurs contrôles de formulaire sur une page. Lorsque le formulaire est soumis, un script client peut alors utiliser toutes les valeurs stockées dans les paramètres d’état du client pour créer un nouvel enregistrement auprès d’un courtier en données. Une page peut avoir un ou plusieurs paramètres d’état client, que vous pouvez déclarer pour une page via le générateur d’IU. Vous pouvez ensuite lier un paramètre d’état client à un ou plusieurs composants pour partager ou agir sur le paramètre d’état client.

Les appels api.setState() sont exécutés de manière asynchrone et ne mettent pas nécessairement à jour l’interface utilisateur immédiatement. Si la valeur à définir dépend currentValue du paramètre de l’état du client ou de l’une des propriétés fournies dans l’objet api, vous devez utiliser cette variante de la méthode api.setState() pour éviter d’utiliser des valeurs obsolètes.

Tableau 54. Paramètres
Nom	Type	Description
StateParm	Chaîne	Nom du paramètre d’état du client à mettre à jour. Ce nom doit être déclaré dans les paramètres d’état du client de la page associée. Pour plus d’informations sur la déclaration des paramètres de l’état du client, voir Utiliser les paramètres de l’état du client.
rappelFn	Fonction	Fonction de rappel à exécuter pour obtenir la valeur.

Tableau 55. Renvoie
Type	Description
Aucun

Cet exemple montre comment utiliser api.setState pour connecter les utilisateurs à une page.

function handler({api, event}) {
  const {name, value} = event.payload;
  if (name === 'username' || name === 'password') {
    // Update the loginParameters state object with the username/password value
    api.setState('loginParameters', ({currentValue}) => {
      return {
        ...currentValue,
        [name]: value
      };
    });
  }
}

API : api.state.<client_state_parameter_name>

Valeur actuelle du paramètre d’état du client spécifié.

Tableau 56. Champ
Nom	Type	Description
<client_state_parameter_name>	Peu importe Les paramètres d’état du client disponibles dépendent de la configuration de la page.	Nom du paramètre de l’état du client. Les états de client disponibles dépendent de l’implémentation du script client. Pour accéder aux états de client disponibles, utilisez ce qui suit : `api.state.<client_state_name>`. Par exemple : `function showRelatedLists({api}) { return !api.state.isCustomListSelected; }` Remarque : Ces valeurs de propriété sont en lecture seule. Pour mettre à jour un paramètre d’état client, utilisez api.setState(). La transformation de valeurs d’objets imbriqués à partir de scripts n’est pas prise en charge.