api : générateur d’IU

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 27 minutes de lecture

    • L’API API fournit des méthodes que vous pouvez utiliser lors du développement de scripts clients dans le générateur d’IU.

    Cette API est exposée aux scripts clients, également appelés scripts de page. Les scripts clients sont exécutés en réponse à un événement sur une page, par exemple :
    • Événements/actions d’interaction de l’utilisateur, tels qu’un clic sur un bouton.
    • Événements de cycle de vie, tels qu’une exécution de courtier en données démarrée.
    Ces scripts n’ont pas besoin de renvoyer quoi que ce soit au framework et peuvent être écrits en tant que fonction asynchrone.
    Cette API est également exposée aux valeurs de propriété scriptées. Ces scripts sont exécutés chaque fois que le framework-runtime a besoin de calculer une valeur, par exemple :
    • Transmission à une propriété de composant.
    • Détermination de la visibilité du composant.
    • Émission d’un événement avec une charge utile.
    Ces scripts ne peuvent pas être écrits en tant que fonction asynchrone. Ils ne peuvent pas non plus appeler de méthodes à effet secondaire sur l’objet api, telles que api.emit(),api.setState() et api.data.<data_resource_id>.*().

    L’objet API contient à la fois des propriétés dépendantes de la configuration et indépendantes de la configuration auxquelles vous pouvez accéder dans le contexte de la page ou du composant associé. Vous ne pouvez pas modifier directement les propriétés de cet objet. La modification ne peut être effectuée qu’à l’aide des méthodes disponibles.

    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.