---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideModalForm : client

# GlideModalForm : client {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture

L'API GlideModalForm fournit des méthodes pour afficher un formulaire dans un GlideModal.  
L'utilisation générale de la classe GlideModalForm implique la création de l'objet, la définition des préférences, puis le rendu de GlideModalForm.

    var dialog = new GlideModalForm('dialog title', 'table_name_or_form_name', [callback on completion of submit])
      dialog.setPreference('name', 'value');
      dialog.render();

Spécifiez les paramètres de requête qui sont transmis au formulaire à l'aide de la méthode setPreference(). Toute paire nom/valeur que vous spécifiez à l'aide de setPreference() est envoyée avec la requête POST du formulaire pour afficher le formulaire.

Le formulaire GlideModalForm est défini pour remplir la hauteur de la fenêtre de document.

## GlideModalForm : GlideModalForm(titre de la chaîne, nom de table de chaîne, fonction onCompletionCallback, booléen readOnly) {#ariaid-title2}

Crée une instance de la classe GlideModalForm.
{#r_GMFV3-GlideModalForm_S_S_F_B__table_ikc_xjm_qv__entry__3}

| Nom | Type | Description |
|-|-|-|
| Titre | Chaîne | Titre du formulaire modal. |
| tableName | Chaîne | Table affichée. |
| onCompletionCallback | Fonction | Fonction à appeler une fois que le formulaire a été soumis et traité sur le serveur. La fonction de rappel se présente sous la forme`callbackFunction(String action_verb, String sys_id, String table, String displayValue)` où : * action_verb: nom de l'action d'interface utilisateur exécutée. Par exemple, sysverb_insert (bouton Soumettre), sysverb_cancel sysverb_save (bouton Enregistrer). * sys_id: Sys_id de l'enregistrement affecté. * table: nom de la table contenant l'enregistrement. * displayValue: valeur qui apparaît sur le formulaire. |
| readOnly | Booléen | Facultatif. Marqueur indiquant si le formulaire modal doit être défini sur lecture seule. Valeurs valides : * vrai : définir le formulaire sur lecture seule. * false : défini pour lecture/écriture. {#r_GMFV3-GlideModalForm_S_S_F_B__ul_rmh_jnx_p4b} Valeur par défaut : false |
[Tableau 1. Paramètres]

{#r_GMFV3-GlideModalForm_S_S_F_B__table_ikc_xjm_qv}  
Cet exemple montre comment instancier un objet GlideModalForm.

    function openDevice(deviceSysID, deviceName) {
      var uName = gel('hidden_user_name').value + "'s ";
      deviceName = new String(deviceName).escapeHTML();
      var gp = new GlideModalForm(uName + deviceName, "cmn_notif_device", refreshNotifPage);
      gp.addParm('sys_id', deviceSysID);
      gp.render();
    }

## GlideModalForm : addParm(nom de la chaîne, valeur de la chaîne) {#ariaid-title3}

Définit le champ de formulaire spécifié sur la valeur spécifiée.
{#r_GMFV3-addParm_S_S__table_tb2_xny_kv__entry__3}

| Nom | Type | Description |
|-|-|-|
| nom | Chaîne | Nom de champ de formulaire. Si le nom spécifié n'est pas un champ dans le formulaire modal associé, il est ignoré. |
| valide | Chaîne | Valeur sur laquelle définir le champ de formulaire spécifié. |
[Tableau 2. Paramètres]

{#r_GMFV3-addParm_S_S__table_tb2_xny_kv} {#r_GMFV3-addParm_S_S__table_ub2_xny_kv__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 3. Renvoie]

{#r_GMFV3-addParm_S_S__table_ub2_xny_kv}  
Cet exemple montre comment appeler addParm() pour définir la valeur du champ sys_id le formulaire modal.

    function openDevice(deviceSysID, deviceName) {
      var uName = gel('hidden_user_name').value + "'s ";
      deviceName = new String(deviceName).escapeHTML();
      var gp = new GlideModalForm(uName + deviceName, "cmn_notif_device", refreshNotifPage);
      gp.addParm('sys_id', deviceSysID);
      gp.render();
    }

## GlideModalForm : setSysID(String sys_id) {#ariaid-title4}

Définit la préférence sys_id de l'objet.
{#r_GMFV3-setSysID_S__table_krd_1ly_kv__entry__3}

| Nom | Type | Description |
|-|-|-|
| sys_id | Chaîne | La préférence en matière d'ID. Un des paramètres de requête transmis au formulaire. |
[Tableau 4. Paramètres]

{#r_GMFV3-setSysID_S__table_krd_1ly_kv} {#r_GMFV3-setSysID_S__table_lrd_1ly_kv__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 5. Renvoie]

{#r_GMFV3-setSysID_S__table_lrd_1ly_kv}  
Cet exemple montre comment utiliser la méthode setSysID() pour initialiser la valeur du sys_id.

    function(startDate, endDate) {
      var dialog = new GlideModalForm("Add Schedule Item", "cmn_schedule_span");
      dialog.setSysID("-1");
      dialog.addParm("sysparm_collection", "cmn_schedule");
      dialog.addParm("sysparm_collectionID", this.sysId);
      dialog.addParm("sysparm_collection_key", "schedule");
     
      var q = "schedule=" + this.sysId + "^start_date_time="
       + startDate.serializeInUserFormat() + "^end_date_time="
       + endDate.serializeInUserFormat() + "^";

      if (startDate.isAllDay(endDate))
        q += "^all_day=true^";
     
      dialog.addParm("sysparm_query", q);
      dialog.render();
    }

## GlideModalForm : setCompletionCallback(Function callbackFunction) {#ariaid-title5}

Définit la fonction à appeler lorsque le formulaire a été soumis et traité avec succès par le serveur.
{#r_GMFV3-setCompletionCallback_F__table_aqr_ply_kv__entry__3}

| Nom | Type | Description |
|-|-|-|
| callbackFunction | Fonction | Fonction de rappel à appeler lorsque le formulaire a été traité avec succès. La fonction de rappel se présente sous la forme `callbackFunction(String action_verb, String sys_id, String table, String displayValue)` où : * action_verb: action_name à partir d'un enregistrement sys_ui_action * sys_id: Sys_id de l'enregistrement affecté * table: nom de la table contenant l'enregistrement * displayValue: valeur qui apparaît sur le formulaire {#r_GMFV3-setCompletionCallback_F__ul_udl_4jy_kv} |
[Tableau 6. Paramètres]

{#r_GMFV3-setCompletionCallback_F__table_aqr_ply_kv} {#r_GMFV3-setCompletionCallback_F__table_bqr_ply_kv__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 7. Renvoie]

{#r_GMFV3-setCompletionCallback_F__table_bqr_ply_kv}  
Cet exemple montre comment définir la fonction de rappel onload du modal associé.

    function handleCreateOrEdit(targetFieldName, sourceFieldName, adapterRuleId, transformerSysId){
      dialog = new GlideModalForm('Edit Adapter Rule', "sys_adapter_rule");
      dialog.setSysID(adapterRuleId); //Pass in sys_id to edit existing record
      dialog.addParm('sysparm_form_only', 'true'); //Add or remove related lists
      dialog.setOnloadCallback(hideModalForm);
      dialog.setCompletionCallback(handleAdapterCreatedOrUpdated);
      dialog.render(); //Open the dialog
    }
    function handleAdapterCreatedOrUpdated(action_verb, sys_id, table, displayValue) {
      var draftRecordTransformer = g_form.getValue("draft_record_transformer");
      if(draftRecordTransformer == null || draftRecordTransformer.length == 0) {
        //sync Sticky Replications if it is enabled.
        var ajax = new GlideAjax('ReplicationPoolUtil');
        ajax.addParam('sysparm_name', 'syncStickyReplicationSet');
        ajax.addParam('sysparm_entry_set', g_form.getValue("entry_set"));
        ajax.getXMLWait();
      }
    }

## GlideModalForm : setOnloadCallback(Function callbackFunction) {#ariaid-title6}

Définit la fonction à appeler une fois que le formulaire a été chargé.
{#r_GMFV3-setOnloadCallback_F__table_uqr_qmy_kv__entry__3}

| Nom | Type | Description |
|-|-|-|
| callbackFunction | Fonction | Fonction à appeler une fois que le formulaire a été chargé. La fonction de rappel a la forme `callBackFunction(GlideModalForm obj)` |
[Tableau 8. Paramètres]

{#r_GMFV3-setOnloadCallback_F__table_uqr_qmy_kv} {#r_GMFV3-setOnloadCallback_F__table_vqr_qmy_kv__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 9. Renvoie]

{#r_GMFV3-setOnloadCallback_F__table_vqr_qmy_kv}  
Cet exemple montre comment définir la fonction de rappel de chargement de la fenêtre modale associée.

    function handleCreateOrEdit(targetFieldName, sourceFieldName, adapterRuleId, transformerSysId){
      dialog = new GlideModalForm('Edit Adapter Rule', "sys_adapter_rule");
      dialog.setSysID(adapterRuleId); //Pass in sys_id to edit existing record
      dialog.addParm('sysparm_form_only', 'true'); //Add or remove related lists
      dialog.setOnloadCallback(hideModalForm);
      dialog.setCompletionCallback(handleAdapterCreatedOrUpdated);
      dialog.render(); //Open the dialog
    }

## GlideModalForm - render() {#ariaid-title7}

Affiche le formulaire modal.
{#r_GMFV3-render__table_upp_jny_kv__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 10. Paramètres]

{#r_GMFV3-render__table_upp_jny_kv} {#r_GMFV3-render__table_vpp_jny_kv__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 11. Renvoie]

{#r_GMFV3-render__table_vpp_jny_kv}  
Cet exemple montre comment appeler render() pour afficher le modal.

    function openDevice(deviceSysID, deviceName) {
      var uName = gel('hidden_user_name').value + "'s ";
      deviceName = new String(deviceName).escapeHTML();
      var gp = new GlideModalForm(uName + deviceName, "cmn_notif_device", refreshNotifPage);
      gp.addParm('sys_id', deviceSysID);
      gp.render();
    }