---
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


---

# action - champ d'application, global

# action - champ d'application, global {#ariaid-title1}

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

L'API d'action fournit des méthodes pour traiter les données des URL dans un script d'action d'interface utilisateur.
Utilisez cette API pour configurer les actions d'interface utilisateur avec lesquelles les utilisateurs peuvent interagir. Utilisez ces scripts dans la table Action d'interface utilisateur \[sys_ui_action\]. Pour en savoir plus, [reportez-vous à la section Actions d'interface utilisateur](https://www.servicenow.com/docs/access?context=t_EditingAUIAction&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

Les méthodes de cette API sont désignées par le nom de variable \<\< action \>\> dans tout JavaScript côté serveur. Pour en savoir plus, reportez-vous [à la section Création d'interactions à l'aide d'actions d'interface utilisateur](https://developer.servicenow.com/blog.do?p=/post/training-ui-action-101/).

## action : getGlideURI() {#ariaid-title2}

Obtient un objet GlideURI pour déterminer la vue utilisateur.
{#Action_getGlideURI__table_dxr_lfj_nkb__entry__3}

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

{#Action_getGlideURI__table_dxr_lfj_nkb} {#Action_getGlideURI__table_exr_lfj_nkb__entry__2}

| Type | Description |
|-|-|
| Objet | Objet GlideURI représentant le paramètre URI de la vue utilisateur. * [GlideURI - Dans le champ d'application](https://servicenow-prod.fluidtopics.net/BOWKZdsARJ6o8h~0fckOsA#c_GlideURIScopedAPI "L’API GlideURI fournit des méthodes pour gérer les paramètres d’URI dans une application incluse dans le périmètre.") * [GlideURI : global](https://servicenow-prod.fluidtopics.net/zZhQ~~Uas82tMEzLtHpfUQ#GlideURIGlobalAPI "L’API GlideURI fournit des méthodes pour gérer les paramètres d’URI dans une application globale.") {#Action_getGlideURI__ul_f4h_5lj_5mb} Remarque : Toute autre valeur renvoyée est considérée comme une erreur, y compris nulle. |
[Tableau 2. Renvoie]

{#Action_getGlideURI__table_exr_lfj_nkb}  
L'exemple suivant montre comment obtenir la vue utilisateur et définir l'URL de redirection vers la page d'accueil du catalogue de services.

    var uri = action.getGlideURI();
    var path = 'catalog_home.do';

    uri.set('sysparm_view', 'catalog_default');
    action.setRedirectURL(uri.toString(path));

## action : getReturnURL() {#ariaid-title3}

Obtient l'URL de la page de retour en vue lorsqu'une action d'interface utilisateur est terminée.
{#Action_getReturnURL__table_db4_ffj_nkb__entry__3}

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

{#Action_getReturnURL__table_db4_ffj_nkb} {#Action_getReturnURL__table_eb4_ffj_nkb__entry__2}

| Type | Description |
|-|-|
| Chaîne | URL de la page de retour affichée après l'achèvement d'une action d'interface utilisateur. |
[Tableau 4. Renvoie]

{#Action_getReturnURL__table_eb4_ffj_nkb}  

    action.getReturnURL();

## action : getURLParameter(String parameterName) {#ariaid-title4}

Obtient la valeur d'un paramètre d'URL.
{#Action_getURLParameter_S__table_alv_y2j_nkb__entry__3}

| Nom | Type | Description |
|-|-|-|
| parameterName | Chaîne | Nom du nom du paramètre d'URL dont la valeur du paramètre d'URL doit être interrogée. |
[Tableau 5. Paramètres]

{#Action_getURLParameter_S__table_alv_y2j_nkb} {#Action_getURLParameter_S__table_blv_y2j_nkb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur du paramètre d'URL. |
[Tableau 6. Renvoie]

{#Action_getURLParameter_S__table_blv_y2j_nkb}  

    action.getURLParameter('sysparm_query');

## action : openGlideRecord(Object gr) {#ariaid-title5}

Ouvre une page avec un GlideRecord dans la vue utilisateur.
{#Action_openGlideRecord_O__table_sy5_bfj_nkb__entry__3}

| Nom | Type | Description |
|-|-|-|
| gr | [GlideRecord](https://servicenow-prod.fluidtopics.net/2WySz5FCvQHHbdfx6_dFUg#c_GlideRecordScopedAPI "L’API GlideRecord incluse dans le périmètre d’application est utilisée pour les opérations de base de données.") | GlideRecord de la page à ouvrir dans la vue utilisateur. |
[Tableau 7. Paramètres]

{#Action_openGlideRecord_O__table_sy5_bfj_nkb} {#Action_openGlideRecord_O__table_ty5_bfj_nkb__entry__2}

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

{#Action_openGlideRecord_O__table_ty5_bfj_nkb}  
L'exemple suivant montre comment inclure le nom de l'appelant et la description de l'incident créés à partir d'un enregistrement d'interaction. Pour plus d'informations, voir Configurer des actions d'interface utilisateur personnalisées dans Workspace.

    if(current.update()){
      var inc = new GlideRecord("incident");
      inc.newRecord();
      inc.caller_id = current.opened_for;
      inc.short_description = current.short_description;
      action.openGlideRecord(inc);
    }

## action : setNoPop(booléen noPop) {#ariaid-title6}

Indique s'il faut activer ou désactiver les fenêtres contextuelles sur la page dans la vue actuelle.
{#Action_setNoPop_B__table_mms_gfj_nkb__entry__3}

| Nom | Type | Description |
|-|-|-|
| noPop (en anglais seulement) | Booléen | Marqueur indiquant s'il faut activer ou désactiver les fenêtres contextuelles sur la page : * true : désactive les fenêtres contextuelles. * false : valeur par défaut. Active les fenêtres contextuelles. {#Action_setNoPop_B__ul_qmz_fwj_nkb} |
[Tableau 9. Paramètres]

{#Action_setNoPop_B__table_mms_gfj_nkb} {#Action_setNoPop_B__table_nms_gfj_nkb__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 10. Renvoie]

{#Action_setNoPop_B__table_nms_gfj_nkb}  
L'exemple suivant montre comment désactiver les fenêtres contextuelles pour une action d'interface utilisateur.


    action.setNoPop(true);

## action : setRedirectURL(URL de l'objet) {#ariaid-title7}

Définit l'URI de redirection pour cette transaction, qui détermine la page suivante que l'utilisateur verra.
Pour les cas d'utilisation :

* [Créer une action d'acheminement d'interface utilisateur](https://www.servicenow.com/docs/access?context=useful-client-side-scripts&version=xanadu&pubname=xanadu-application-development&section=t_CreateAUIRoutingAction&ft:locale=en-US)
* [Créer des articles de la base de connaissances à partir de tickets RH](https://www.servicenow.com/docs/access?context=ui-action-hrcase-article&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
* [Task relationships with UI actions](https://www.servicenow.com/docs/access?context=r_UIActions&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)
{#Action_setRedirectURL_O__ul_i1s_2qk_lmb}
{#Action_setRedirectURL_O__table_bdm_2fj_nkb__entry__3}

| Nom | Type | Description |
|-|-|-|
| URL | Objet | URL à définir comme redirection. Vous pouvez fournir l'URL sous forme de chaîne ou de [GlideRecord](https://servicenow-prod.fluidtopics.net/2WySz5FCvQHHbdfx6_dFUg#c_GlideRecordScopedAPI "L’API GlideRecord incluse dans le périmètre d’application est utilisée pour les opérations de base de données."). Si vous transmettez l'URL en tant que GlideRecord, cette valeur met l'accent sur le formulaire de cet enregistrement. |
[Tableau 11. Paramètres]

{#Action_setRedirectURL_O__table_bdm_2fj_nkb} {#Action_setRedirectURL_O__table_cdm_2fj_nkb__entry__2}

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

{#Action_setRedirectURL_O__table_cdm_2fj_nkb}  
L'exemple suivant montre comment rediriger un utilisateur vers une URL à partir d'une action d'interface utilisateur à l'aide de la variable [actuelle](https://www.servicenow.com/docs/access?context=c_ScriptableServiceCatalogVariables&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) .

    var fixchg = new GlideRecord("change_request");
    fixchg.short_description= current.short_description;
    fixchg.comments= current.comments.getHTMLValue();
    // fixchg.parent = current.sys_id;
    fixchg.insert();
    FixChange();
     
    gs.addInfoMessage("Change "+ fixchg.number+" created");
    action.setRedirectURL(current);
    action.setReturnURL(fixchg);
     
    function FixChange(){
    var m2m = new GlideRecord('task_rel_task');
    m2m.initialize();
    m2m.child= current.sys_id;
    m2m.parent= fixchg.sys_id;
    m2m.type.setDisplayValue("Fixes::Fixed by");
    m2m.insert();}

L'exemple suivant montre comment créer un nouvel enregistrement d'incident et le rediriger vers le nouvel incident une fois l'action d'interface utilisateur terminée.

    var reqItem = current.u_item;
    var requestedFor = current.u_requested_for;
    var location = current.location;

    if(current.u_incident_request == 'Incident'){
      //Create a new incident record and redirect to the new incident
      var rec = new GlideRecord('incident');
      rec.initialize();
      rec.caller_id = requestedFor;
      rec.location = location;
      rec.insert();
      action.setRedirectURL(rec);
    }

    if(current.u_incident_request == 'Request'){
      //Build the url and route the user to the request item
      var url = '';
      if(current.u_item.sys_class_name == 'sc_cat_item_guide'){
        url = 'com.glideapp.servicecatalog_cat_item_guide_view.do?sysparm_initial=true&sysparm_guide=' + 
          reqItem + '&sysparm_user=' + requestedFor + '&sysparm_location=' + location;
      }
      else{
        url = 'com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=' + reqItem + '&sysparm_user=' +  
          requestedFor + '&sysparm_location=' + location;
      }
      action.setRedirectURL(url);
    }

## action : setReturnURL(URL de l'objet) {#ariaid-title8}

Définit l'URI de retour pour cette transaction une fois qu'une action d'interface utilisateur est terminée. Vous pouvez utiliser cette méthode pour déterminer la page affichée par l'utilisateur lorsqu'il revient de l'envoi.
{#Action_setReturnURL_O__table_bdm_2fj_nkb__entry__3}

| Nom | Type | Description |
|-|-|-|
| URL | Objet | URI à définir comme emplacement de retour après l'achèvement d'une action d'interface utilisateur. Vous pouvez fournir l'URL sous forme de chaîne ou de [GlideRecord](https://servicenow-prod.fluidtopics.net/2WySz5FCvQHHbdfx6_dFUg#c_GlideRecordScopedAPI "L’API GlideRecord incluse dans le périmètre d’application est utilisée pour les opérations de base de données."). |
[Tableau 13. Paramètres]

{#Action_setReturnURL_O__table_bdm_2fj_nkb} {#Action_setReturnURL_O__table_cdm_2fj_nkb__entry__2}

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

{#Action_setReturnURL_O__table_cdm_2fj_nkb}  
L'exemple suivant permet à l'utilisateur de sélectionner l'action d'interface utilisateur pour créer un enregistrement de changement à l'aide des informations tirées de l'enregistrement de problème et du modèle de changement. Après le changement, l'utilisateur revient à la vue [actuelle](https://www.servicenow.com/docs/access?context=c_ScriptableServiceCatalogVariables&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) . Pour plus d'informations, consultez [Modèles scriptés](https://www.servicenow.com/docs/access?context=r_ScriptedTemplates&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Pour plus de cas d'utilisation, reportez-vous à [Task relationships with UI actions](https://www.servicenow.com/docs/access?context=r_UIActions&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

    var change = new GlideRecord("change_request");
    change.initialize();
    change.short_description = current.short_description;
    change.description = current.u_details;
    change.cmdb_ci = current.u_service;
    change.priority = current.priority;
    change.requested_by = current.caller_id;
    change.assignment_group.setDisplayValue('Change & Release');
    change.u_status = 'New';
    change.parent = current.number;
    change.applyTemplate("standard_rfc");
    current.rfc = change.insert();
    current.comments = 'Change ' + change.number + ' created.';

    var mySysID = current.update();

    gs.addInfoMessage("Change " + change.number + " created");
    action.setRedirectURL(change);
    action.setReturnURL(current);

## action : setURLParameter(String parameterName, String parameterValue) {#ariaid-title9}

Définit un nom et une valeur de paramètre d'URL.
{#Action_setURLParameter_S_S__table_elv_z2j_nkb__entry__3}

| Nom | Type | Description |
|-|-|-|
| parameterName | Chaîne | Nom du paramètre d'URL. |
| parameterValue | Chaîne | Valeur du paramètre. |
[Tableau 15. Paramètres]

{#Action_setURLParameter_S_S__table_elv_z2j_nkb} {#Action_setURLParameter_S_S__table_flv_z2j_nkb__entry__2}

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

{#Action_setURLParameter_S_S__table_flv_z2j_nkb}  

    action.setURLParameter('sysparm_query', 'priority=2^active=true');