ScopedSessionDomain - Cliente

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura
  • A inclusão de script ScopedSessionDomain que contém métodos do lado do cliente que fornecem funcionalidade relacionada ao domínio da sessão atual.

    Esta API só estará disponível se o plug-in Domain Support - Domain Extensions Installer (com.glide.domain.msp_extensions) tiver sido ativado na instância. Além disso, o solicitante deve ter a função de administrador para acessar esta API.

    ScopedSessionDomain – getCurrentDomainID()

    Retorna o sys_id do domínio atual da sessão do usuário conectado.

    O identificador retornado depende do tipo de domínio e da instanciação desse domínio.
    • Se o usuário estiver configurado no domínio global e não usar o seletor de domínio para alternar os domínios, o método retornará nulo.
    • Se o usuário usar o seletor de domínio para alternar para o domínio global, o método retornará a cadeia de caracteres "global".
    • Para todos os outros domínios, o método retorna o sys_id desse domínio.
    Para acessar este método de um script do lado do cliente, você deve usar GlideAjax() para invocá-lo. Para invocar este método de um script do lado do servidor, use algo semelhante ao seguinte para instanciar o objeto e acessar o método.
    var ssg = new global.ScopedSessionDomain(); 
    domainID = ssg.getCurrentDomainID();
    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 2. Retorna
    Tipo Descrição
    Cadeia de caracteres Sys_id do domínio da sessão do usuário conectado no momento. Essas são as mesmas informações que aparecem no seletor de domínio.

    Este exemplo mostra como chamar o método getCurrentDomainID() a partir de um script do lado do cliente.

    // This example is calling the script include in a client script. 
    // This particular record is within the "Service Portal - Standard Ticket" scope. 
    // To reproduce this example: 
    //  1. Change application scope to "Service Portal - Standard Ticket" 
    //  2. Navigate to Client Script table and open a new form and name it anything 
    //  3. Set table=ticket_configuration (this table is within the same scope) 
    //  4. Set UI type=Desktop and Type=onLoad 
    //  5. Populate the script field with the script above 
    //  6. Navigate to the ticket_configuration table and open any form. 
    //
    // This will trigger the client script, invoke the API, and pop up a browser alert containing the sys_id of the user's current domain
    
    function onLoad() {	
      var ga = new GlideAjax("global.ScopedSessionDomain"); // Set the script include
      ga.addParam("sysparm_name", "getCurrentDomainID"); // Set the getCurrentDomainID method
      ga.getXML(getResponse);
    	
      function getResponse(response) {
         var answer = response.responseXML.documentElement.getAttribute('answer');
         alert(answer); // Pops up the sys_id of the domain record
      }
    }