---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ação - com escopo, global

# ação - com escopo, global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

A API de ação fornece métodos para lidar com dados para URLs em um script de ação de IU.
Use esta API para configurar ações de IU com as quais os usuários podem interagir. Use esses scripts na tabela Ação de IU \[sys_ui_action\]. Para obter informações, consulte [Ações de IU](https://www.servicenow.com/docs/access?context=t_EditingAUIAction&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

Os métodos para esta API são referenciados pelo nome de variável "ação" em qualquer JavaScript do lado do servidor. Para saber mais, consulte [Como criar interações com ações de IU](https://developer.servicenow.com/blog.do?p=/post/training-ui-action-101/).

## ação - getGlideURI() {#ariaid-title2}

Obtém um objeto GlideURI para determinar a exibição do usuário.
{#Action_getGlideURI__table_dxr_lfj_nkb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

{#Action_getGlideURI__table_dxr_lfj_nkb} {#Action_getGlideURI__table_exr_lfj_nkb__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Objeto GlideURI que representa o parâmetro URI da exibição do usuário. * [GlideURI - com escopo](https://servicenow-prod.fluidtopics.net/Ehj6XjrIV60ftyiV4ve7FA#c_GlideURIScopedAPI "A API GlideURI fornece métodos para lidar com parâmetros de URI em uma aplicação com escopo.") * [GlideURI - Global](https://servicenow-prod.fluidtopics.net/EliUGAa6aPiVmZAOTctOaQ#GlideURIGlobalAPI "A API GlideURI fornece métodos para lidar com parâmetros de URI em uma aplicação global.") {#Action_getGlideURI__ul_f4h_5lj_5mb} Nota: Qualquer outro valor retornado é considerado um erro, incluindo nulo. |
[Tabela 2. Retorna]

{#Action_getGlideURI__table_exr_lfj_nkb}  
O exemplo a seguir mostra como obter a exibição do usuário e definir o URL de redirecionamento para a página inicial do catálogo de serviços.

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

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

## ação - getReturnURL() {#ariaid-title3}

Obtém o URL da página de retorno na exibição após a conclusão de uma ação de IU.
{#Action_getReturnURL__table_db4_ffj_nkb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 3. Parâmetros]

{#Action_getReturnURL__table_db4_ffj_nkb} {#Action_getReturnURL__table_eb4_ffj_nkb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | URL da página de retorno na exibição após a conclusão de uma ação de IU. |
[Tabela 4. Retorna]

{#Action_getReturnURL__table_eb4_ffj_nkb}  

    action.getReturnURL();

## ação - getURLParameter(cadeia de caracteres parameterName) {#ariaid-title4}

Obtém o valor de um parâmetro de URL.
{#Action_getURLParameter_S__table_alv_y2j_nkb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| parameterName | Cadeia de caracteres | Nome do parâmetro de URL a ser consultado para o valor do parâmetro de URL. |
[Tabela 5. Parâmetros]

{#Action_getURLParameter_S__table_alv_y2j_nkb} {#Action_getURLParameter_S__table_blv_y2j_nkb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor do parâmetro de URL. |
[Tabela 6. Retorna]

{#Action_getURLParameter_S__table_blv_y2j_nkb}  

    action.getURLParameter('sysparm_query');

## ação - openGlideRecord(Object gr) {#ariaid-title5}

Abre uma página com um GlideRecord na exibição do usuário.
{#Action_openGlideRecord_O__table_sy5_bfj_nkb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| gr | [GlideRecord](https://servicenow-prod.fluidtopics.net/FBR_zQLvGAsgQtw7~4MAGA#c_GlideRecordScopedAPI "A API GlideRecord com escopo é usada para operações de banco de dados.") | GlideRecord da página a ser aberta na exibição do usuário. |
[Tabela 7. Parâmetros]

{#Action_openGlideRecord_O__table_sy5_bfj_nkb} {#Action_openGlideRecord_O__table_ty5_bfj_nkb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 8. Retorna]

{#Action_openGlideRecord_O__table_ty5_bfj_nkb}  
O exemplo a seguir mostra como incluir o nome do solicitante e a descrição do incidente criado a partir de um registro de interação. Para obter mais detalhes, consulte Configuração de ações de IU personalizadas no espaço.

    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);
    }

## ação - setNoPop(Booliano noPop) {#ariaid-title6}

Indica se as janelas pop-up devem ser habilitadas ou desabilitadas na página na exibição atual.
{#Action_setNoPop_B__table_mms_gfj_nkb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| sem pop | Booliano | Sinalizador que indica se as janelas pop-up devem ser habilitadas ou desabilitadas na página: * verdadeiro: desabilita janelas pop-up. * falso: padrão. Habilita janelas pop-up. {#Action_setNoPop_B__ul_qmz_fwj_nkb} |
[Tabela 9. Parâmetros]

{#Action_setNoPop_B__table_mms_gfj_nkb} {#Action_setNoPop_B__table_nms_gfj_nkb__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 10. Retorna]

{#Action_setNoPop_B__table_nms_gfj_nkb}  
O exemplo a seguir mostra como desabilitar janelas pop-up para uma ação de IU.


    action.setNoPop(true);

## ação - setRedirectURL(URL do objeto) {#ariaid-title7}

Define o URI de redirecionamento para esta transação, que determina a próxima página que o usuário vê.
Para casos de uso:

* [Criar uma ação de roteamento de IU](https://www.servicenow.com/docs/access?context=useful-client-side-scripts&version=xanadu&pubname=xanadu-application-development&section=t_CreateAUIRoutingAction&ft:locale=en-US)
* [Criar artigos de conhecimento a partir de casos de 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}

| Nome | Tipo | Descrição |
|-|-|-|
| URL | Objeto | URL a ser definido como o redirecionamento. Você pode fornecer o URL como uma cadeia de caracteres ou um [GlideRecord](https://servicenow-prod.fluidtopics.net/FBR_zQLvGAsgQtw7~4MAGA#c_GlideRecordScopedAPI "A API GlideRecord com escopo é usada para operações de banco de dados."). Se você passar o URL como um GlideRecord, esse valor colocará o foco no formulário desse registro. |
[Tabela 11. Parâmetros]

{#Action_setRedirectURL_O__table_bdm_2fj_nkb} {#Action_setRedirectURL_O__table_cdm_2fj_nkb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 12. Retorna]

{#Action_setRedirectURL_O__table_cdm_2fj_nkb}  
O exemplo a seguir mostra como redirecionar um usuário para um URL de uma ação de IU usando a variável [atual](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();}

O exemplo a seguir mostra como criar um novo registro de incidente e redirecionar para o novo incidente após a conclusão de uma ação de IU.

    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);
    }

## ação - setReturnURL(URL do objeto) {#ariaid-title8}

Define o URI de retorno para esta transação após a conclusão de uma ação de IU. Você pode usar este método para determinar qual página o usuário tem em exibição quando retorna do envio.
{#Action_setReturnURL_O__table_bdm_2fj_nkb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| URL | Objeto | URI a ser definido como o local de retorno após a conclusão de uma ação de IU. Você pode fornecer o URL como uma cadeia de caracteres ou um [GlideRecord](https://servicenow-prod.fluidtopics.net/FBR_zQLvGAsgQtw7~4MAGA#c_GlideRecordScopedAPI "A API GlideRecord com escopo é usada para operações de banco de dados."). |
[Tabela 13. Parâmetros]

{#Action_setReturnURL_O__table_bdm_2fj_nkb} {#Action_setReturnURL_O__table_cdm_2fj_nkb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 14. Retorna]

{#Action_setReturnURL_O__table_cdm_2fj_nkb}  
O exemplo a seguir permite que o usuário selecione a ação de IU para criar um registro de mudança usando informações do registro de problema e do modelo de mudança. Após a mudança, o usuário retorna à exibição [atual](https://www.servicenow.com/docs/access?context=c_ScriptableServiceCatalogVariables&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). Para obter mais informações, consulte [Modelos com script](https://www.servicenow.com/docs/access?context=r_ScriptedTemplates&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Para obter mais casos de uso, consulte [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);

## ação - setURLParameter(cadeia de caracteres parameterName, cadeia de caracteres parameterValue) {#ariaid-title9}

Define um nome e valor de parâmetro de URL.
{#Action_setURLParameter_S_S__table_elv_z2j_nkb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| parameterName | Cadeia de caracteres | Nome do parâmetro de URL. |
| valorDeParâmetro | Cadeia de caracteres | Valor do parâmetro. |
[Tabela 15. Parâmetros]

{#Action_setURLParameter_S_S__table_elv_z2j_nkb} {#Action_setURLParameter_S_S__table_flv_z2j_nkb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 16. Retorna]

{#Action_setURLParameter_S_S__table_flv_z2j_nkb}  

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