Script em Performance Analytics

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura

    • Performance Analytics Fornece vários objetos de script para uso em scripts e APIs para consulta Performance Analytics dados. Os scripts servem como mapeamentos de detalhamento ou para calcular um valor de um indicador.

    Dicas sobre scripts

    • Em geral, use scripts somente para oferecer suporte a indicadores como Idade com processamento de data, usando score_start e. score_end variáveis.
    • Limite campos desnecessários. Sempre que você incluir um campo com pontos extra, você adiciona uma junção extra à consulta.
    • Tente substituir detalhamentos manuais por exibições do banco de dadospara um melhor desempenho.
    • Tente usar inclusões de script para funções comuns. Para obter mais informações, consulte Inclusões de script .
    • Se os dados não estiverem estruturados da forma necessária para a emissão de relatórios, tente adicionar "campos de relatório" às tabelas operacionais em vez de criar scripts. Para obter mais informações, consulte Publicação da comunidade .
    • Se você estiver executando um script em segundo plano que consulta o. Performance Analytics tabelas de pontuações ou snapshots, você não pode acessar dados sobre uma aplicação com escopo, a menos que tenha uma função apropriada para essa aplicação.
    Aviso:
    Tente não usar GlideRecords ou GlideAggregates em scripts Performance Analytics ou indicadores de fórmula. Embora às vezes você precise usar essas operações para obter o que deseja, elas são caras e podem ser executadas centenas de milhares de vezes. Certifique-se de que não há alternativas antes de usá-las.

    Mapeamento de detalhamento e scripts de indicador

    R mapeamento de detalhamentoo script normalmente retorna um sys_id de um elemento de detalhamento ou um número inteiro para colocar a pontuação em um bucket. Os scripts de indicador retornam uma pontuação calculada a partir de um ou mais campos. O mesmo script pode servir como script de mapeamento de detalhamento e como script de indicador.

    Script de detalhamento

    Por exemplo, considere o script Incident.Age.Days fornecido, que usa o. aberto_em campo da tabela de incidentes. Este script serve como um mapeamento de detalhamento para o detalhamento de idade, que usa os intervalos de idade do incidente (dias) grupo de bucketscomo a origem do detalhamento.

    var diff=function(x,y){return y.dateNumericValue() - x.dateNumericValue();};
var days=function(x,y){return diff(x,y)/(24*60*60*1000);};
days(current.opened_at, score_end);

    Neste exemplo, opened_at.opened_at obtém o carimbo de data/hora de quando o registro avaliado no momento foi aberto. . score_end variável de script vem de coletor de dadose está vinculado ao período que está sendo coletado. Por exemplo, se um indicador mensal estiver sendo coletado, o. score_end é o fim do mês. Aqui, o carimbo de data/hora de quando o incidente foi aberto é subtraído do carimbo de data/hora do término do período de coleta e o resultado é convertido em dias.

    Este exemplo inclui o. Incident.opened_at , que é especificado em Campos campo para este script. Você pode usar score_start e. score_end sem defini-los em Campos campo.

    Crie um script na Análise de desempenho

    Para criar um script, primeiro selecione a tabela de fatos à qual o script se aplica e selecione explicitamente todos os campos.

    Antes de Iniciar

    Função necessária: admin, pa_admin. Para acessar dados de aplicações com escopo em Performance Analytics você também precisa da função de administrador apropriada para essa aplicação.

    Procedimento

    1. Navegar até Tudo > Performance Analytics > Scripts e clique em Novo .
    2. Forneça um script descritivo Nome .
    3. Selecione Tabela de fatos a que o script se aplica.
      Somente indicadores que usam a mesma tabela de fatos podem usar este script.
    4. Selecione a tabela de fatos Campos , se houver, que será usado no script.
      Você seleciona campos por seus rótulos.
    5. Escreva o script.
      O script deve estar em conformidade com os seguintes relacionamentos e restrições:
      • Você pode incluir somente os campos selecionados neste formulário e variáveis de script. Para obter mais informações, consulte a seção sobre Variáveis da Análise de desempenho.
      • Ao usar um campo no script, você usa o nome da coluna. Se necessário, procure o nome da coluna na tabela de fatos.
      • Ao usar um campo de uma exibição de banco de dados, você deve incluir o prefixo. Por exemplo, a exibição do banco de dados incident_sla inclui a tabela task_sla, com o prefixo taskslatable. Task_sla inclui a coluna business_duration. Para usar o campo business_duration da exibição do banco de dados incident_sla, escreva-o como taskslatable_business_duration . Se você não tiver acesso à exibição do banco de dados, peça ao administrador do sistema para encontrar o prefixo para você.

    O que Fazer Depois

    Depois de criar o script, crie um mapeamento de detalhamento ou indicador que use o script. Você pode abrir um mapeamento de detalhamento ou formulário de indicador clicando em Novo na guia de mapeamento de detalhamento ou indicador. Os mapeamentos de detalhamento e indicadores que usam este script estão listados nessas guias.

    Variáveis do Performance Analytics

    Várias variáveis estão disponíveis para uso em Performance Analytics indicadores de fórmulas e scripts.

    Você pode usar as seguintes variáveis em Performance Analytics scripts e fórmulas.

    • score_start : Primeiro segundo do dia da primeira coleta de pontuação do indicador. Para scripts, a hora é calculada com base na diferença entre o fuso horário do usuário Executar como para o trabalho de coleta e o fuso horário do banco de dados, que é GMT. Para fórmulas, a hora é calculada com base na diferença entre o fuso horário do usuário que executa a fórmula e o GMT. Um usuário executa uma fórmula exibindo o indicador de fórmula em um widget de painel ou no Hub de análise.
    • score_end : Último segundo do dia da última coleta de pontuação do indicador. O tempo é calculado da mesma forma que para score_start .
    • pa : Uma variável de fórmula, não utilizável em scripts, que fornece um conjunto de Hub de análise atributos e métodos.

    Em scripts, as variáveis de início e término da coleção de pontuação são GlideElementGlideObject objetos. Você pode obter um GlideDateTime objeto dessas variáveis chamando GetGlideObject() , como neste exemplo: .GetGlideObject().getDayOfWeek());

    Em fórmulas, as variáveis de início e término da coleção de pontuação já são GlideDateTime objetos. Portanto, você pode usar as variáveis diretamente sem chamar GetGlideObject() , como neste exemplo: Pontuação principal: Pontuação_end.getDayOfWeek();

    Os valores das variáveis de início e término são vinculados ao período que está sendo coletado. Por exemplo, se um indicador mensal estiver sendo coletado, o. score_end é o fim do mês.

    . score_start e. score_end os valores são calculados com base no fuso horário do usuário relevante. Para Performance Analytics Scripts, este é o fuso horário Executar como para o trabalho de coleta. Para fórmulas, este é o fuso horário do usuário que exibe o indicador de fórmula em um widget de painel ou o. Hub de análise. Portanto, usuários em fusos horários diferentes podem ter datas diferentes para score_start e. score_end em uma fórmula.