Eventos do componente do painel

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 2 min. de leitura

    • Selecione manipuladores de eventos para configurar as ações (eventos) fornecidas com o componente do painel.

    A guia Eventos mostra os eventos usados pelo componente do painel. Para exibir os eventos disponíveis, selecione - Adicionar mapeamento de evento . Selecione o evento na lista para adicionar um ou mais manipuladores de eventos.

    Manipuladores de eventos

    Os manipuladores de eventos trabalham com recursos de dados para vincular as ações do painel aos dados que você deseja exibir aos usuários. Selecione o evento na lista para adicionar um ou mais manipuladores de eventos.

    Descrições do evento

    Evento Descrição
    Navegue até a página de visão geral do painel Expedido quando o painel é fechado e redireciona para a biblioteca de painéis. Você pode personalizar esse comportamento alterando a rota e o título no script do cliente Redirecionar para lista de painel. Para abrir scripts de cliente, selecione o ícone na barra lateral da página.
    * @param {params} params
* @param {api} params.api
* @param {any} params.event
* @param {any} params.imports
* @param {ApiHelpers} params.helpers
*/
function handler({api}) {
    api.emit('SCREEN_STATUS_CHANGED', {status: 'closed'});
    api.emit('NAV_ITEM_SELECTED', {
        route: 'dashboard-library',
        title: 'Dashboard Library',
    });
}
    Widget do painel clicado
    Adicione este manipulador de eventos se quiser substituir o detalhamento padrão pelo comportamento personalizado quando uma visualização no painel for clicada. Ele usa o script do cliente clicado no Widget do painel. Para adicionar um detalhamento personalizado:
    1. Defina a propriedade defaultDrilldowns como falso.
    2. Adicione o manipulador de eventos clicado do widget do painel.
    3. Abra o script do cliente clicado no widget do painel. Para abrir scripts de cliente, selecione o ícone na barra lateral da página.
    4. Localize o código api.emit('NAV_ITEM_SELECTED', carga); e atualizar carga para alinhar com sua lógica de redirecionamento personalizada.
    Atualização de parâmetros de URL solicitada

    Expedido sempre que o componente do painel normalmente atualiza os parâmetros de URL e. delegateUrlParamsé verdadeiro . Este evento fornece dados de parâmetro estruturados que os scripts de cliente podem usar para implementar a lógica de navegação personalizada.

    Parâmetros de URL:
    • SYSID: O sys_id do painel que está sendo navegado. Presente quando o painel muda.
    • TabSysId: O sys_id da guia selecionada. Presente quando a guia muda.
    • Editar: Se o painel está no modo de edição. Presente quando o modo de edição muda.
    Todos os parâmetros têm os seguintes campos de objeto:
    • Valor (cadeia de caracteres | booliano): O valor do parâmetro
    • Descrição (cadeia de caracteres): Descrição legível do parâmetro
    O parâmetro SYSID também tem os seguintes campos de objeto:
    • Nome do painel (cadeia de caracteres): Título do painel
    • NewTab (booliano): verdadeiro Quando o usuário executou um Cmd/Ctrl pressionado ou clique com o botão do meio do mouse no seletor de painel, indicando a intenção de abrir em uma nova guia. Enviado somente para SYSID parâmetro.
    Exemplo:
    {
  "urlParams": {
    "sysId": {
      "value": "a1b2c3d4e5f6",
      "dashboardName": "Dashboard A",
      "description": "Dashboard sys_id",
      "isNewTab": false
    },
    "tabSysId": {
      "value": "f6e5d4c3b2a1",
      "description": "Tab sys_id"
    },
    "edit": {
      "value": true,
      "description": "Edit mode"
    }
  }
}

    Para obter mais informações, consulte Delegação de parâmetro de URL do painel.

    Nota:
    Esta funcionalidade requer a mais recente Experiência da Análise da plataforma aplicação do ServiceNow® Store.