ação - Com escopo, Global

A API de ação permite o tratamento de dados para URLs em um script de ação de IU.

Use a API de ação 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.

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.

ação - getGlideURI()

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

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 2. Retorna

Tipo	Descrição
Objeto	Objeto GlideURI que representa o parâmetro URI da exibição do usuário. GlideURI - com escopo GlideURI - Global Nota: Qualquer outro valor retornado é considerado um erro, incluindo nulo.

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

Obtém o URL da página de retorno exibida após a conclusão de uma ação de IU.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 4. Retorna

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.

action.getReturnURL();

ação - getURLParameter(cadeia de caracteres parameterName)

Obtém o valor de um parâmetro de URL.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
parameterName	Cadeia de caracteres	Nome do parâmetro da URL a ser consultado para o valor do parâmetro da URL.

Tabela 6. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor do parâmetro de URL.

action.getURLParameter('sysparm_query');

ação - openGlideRecord(Object gr)

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

Tabela 7. Parâmetros

Nome	Tipo	Descrição
gr	GlideRecord	GlideRecord da página a ser aberta na exibição do usuário.

Tabela 8. Retorna

Tipo	Descrição
vazio

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

action - setNoPop(Boolean noPop)

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

Tabela 9. Parâmetros

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.

Tabela 10. Retorna

Tipo	Descrição
Nenhum

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)

Define o URI de redirecionamento para esta transação, 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
• Criar artigos de conhecimento a partir de casos de RH
• Definir relacionamentos de tarefa com ações de IU

Tabela 11. Parâmetros

Nome	Tipo	Descrição
URL	Objeto	URL a ser definido como redirecionamento. Você pode fornecer o URL como uma cadeia de caracteres ou um GlideRecord. Se você passar o URL como um GlideRecord, este valor colocará o foco no formulário desse registro.

Tabela 12. Retorna

Tipo	Descrição
vazio

O exemplo a seguir mostra como redirecionar um usuário para um URL de uma ação de IU usando a variável atual.

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)

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.

Tabela 13. Parâmetros

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.

Tabela 14. Retorna

Tipo	Descrição
vazio

O exemplo a seguir permite que o usuário selecione a ação de IU para criar um registro de mudança usando as informações do registro do problema e o modelo de mudança. Após a mudança, o usuário retorna à exibição atual. Para obter mais informações, consulte Modelos com script. Para obter mais casos de uso, consulte Definir relacionamentos de tarefa com ações de IU.

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(cadeia de caracteres parameterName, cadeia de caracteres parameterValue)

Define um nome e um valor de parâmetro de URL.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
parameterName	Cadeia de caracteres	Nome do parâmetro de URL.
parâmetroValor	Cadeia de caracteres	Valor do parâmetro.

Tabela 16. Retorna

Tipo	Descrição
vazio

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