--- sourceDocument: Yokohama Platform Analytics sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/now-intelligence Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Yokohama Platform Analytics ft:clusterId : - par bundleId : - par workflow : - Platform --- # Grupos de buckets para origens de detalhamento # Grupos de buckets para origens de detalhamento {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura Grupos de buckets são usados para recategorizar dados para que possam ser usados como um detalhamento, por exemplo, agrupando um intervalo de valores em buckets discretos. Na arquitetura de dados, os grupos de buckets são definidos nos registros de grupo de buckets \[pa_bucket_groups\] e buckets nos registros de buckets \[pa_buckets\]. Cada registro de bucket \[pa_buckets\] contém um campo de grupo de buckets que é uma referência a um registro de grupo de buckets \[pa_bucket_groups\]. Para trabalhar com um grupo de buckets, crie uma origem de detalhamento que use Bucket \[pa_buckets\] como a tabela de fatos e especifique o grupo de buckets em uma condição. Se um detalhamento criado nesta origem usar um mapeamento de detalhamento com um script, o detalhamento agrupará os valores que o script retorna em buckets. Se o mapeamento de detalhamento especificar um campo em vez de usar um script, o detalhamento agrupará os valores do campo mapeado em buckets. **Tarefas relacionadas** * [Crie um mapeamento de detalhamento em um registro de detalhamento](https://servicenow-prod.fluidtopics.net/vfQVOu0SZilSY7tReHuXdw "Especifique qual campo na origem do indicador faz referência à origem do detalhamento. Se nenhum campo apropriado estiver disponível, especifique um script para consultar a origem do indicador.") ## Agrupando valores de campo em buckets {#ariaid-title2} Você pode usar um grupo de buckets com um mapeamento de detalhamento que não usa um script para agrupar os valores de qualquer campo mapeado em buckets. O caso de uso pode ser tão simples quanto traduzir o. `verdadeiro `e. `falso `valores de um booliano em dois buckets com rótulos significativos. ### Classificando valores boolianos em buckets Uma base Performance AnalyticsA instalação inclui o detalhamento ativo como parte da Visão geral do uso da análise. Este detalhamento usa um mapeamento para o campo booliano job.active da tabela Log de trabalhos \[pa_jobs_logs\]. A origem de detalhamento usa um grupo de buckets em que `verdadeiro `Os valores de job.active são classificados no bucket Ativo, enquanto `falso `Os valores são classificados no bucket inativo. Observe isso `falso `os valores são numericamente considerados como um valor menor que um, enquanto `verdadeiro `os valores são numericamente um e acima. ## Agrupando resultados de script em buckets {#ariaid-title3} Quando você tem um script de mapeamento de detalhamento que coleta um intervalo de valores, você pode definir um grupo de buckets para dividir esses valores em buckets discretos. Depois de criar o grupo de buckets, você cria uma origem de detalhamento com base no grupo de buckets. Em seguida, você cria um detalhamento que usa essa origem de detalhamento. Ao criar o mapeamento de detalhamento para o detalhamento, defina ou selecione um script para o mapeamento. O detalhamento agrupa os resultados que o script retorna aos buckets do grupo de buckets. Para obter um exemplo, consulte [Exemplo: Mapeamento de script](https://servicenow-prod.fluidtopics.net/_MXbvn6pw3hUXmG3~Vftcg "O detalhamento por idade usa o script Incidente.Idade.Dias para calcular a idade dos incidentes em dias e mapear os valores para o grupo de buckets de faixas etárias do incidente."). Você pode gravar um grupo de buckets para um script existente ou pode primeiro gravar o grupo de buckets e, em seguida, gravar o script. Ambos devem existir antes que você possa criar o detalhamento. Nota: O mesmo script pode ser usado com qualquer número de grupos de buckets. Além disso, em princípio, todos os scripts que retornassem o mesmo tipo de dados podem ser usados com o mesmo grupo de buckets. ## Crie um grupo de buckets {#ariaid-title4} Especifique um grupo de buckets nos quais você deseja recategorizar os dados. ### Antes de Iniciar Função necessária: pa_data_collector ou admin ### Procedimento 1. Navegar até TudoDetalhamentosGrupos de Bucket. 2. Clique em Novo. 3. Insira um Nome que identifica claramente o grupo de buckets, como Faixas etárias em dias . 4. Clique duas vezes Insira uma nova linha para adicionar um novo bucket. 5. Insira um Nome Para o primeiro bucket, pressione Enter ou clique no ícone de verificação verde. 6. Clique duas vezes em Iniciar e. Fim colunas para inserir os valores iniciais e finais do intervalo. Os registros que correspondem ao valor final são excluídos do bucket. Portanto, defina o valor final de um bucket e o valor inicial do próximo bucket como o mesmo. Os registros que correspondem exatamente a esse valor são classificados no bucket que tem esse valor como o valor inicial. Aviso: Se o valor final de um bucket não corresponder ao valor inicial do próximo bucket, você terá um "buraco" em que os registros não são classificados em nenhum bucket. Por exemplo, se você tiver um bucket que termina em 20 e o próximo bucket começa em 21, os registros para os quais o script retorna um valor entre 20,0000 e 20,9999 não serão classificados em nenhum bucket. 7. Clique em Enviar após todos os intervalos de bucket terem sido definidos. ### Grupo de buckets de faixas etárias do incidente Considere o caso em que você deseja agrupar incidentes por idade, da seguinte forma: * Menos de um dia * 1 a 5 dias * 6 a 30 dias * 31 a 90 dias * Mais de 90 dias {#t_CreateABucketGroup__ul_hrj_str_3fb} Recebido(a) Performance AnalyticsScripts, Você já tem um script chamado Incidente.Idade.Dias. Este script deriva a idade em dias de um incidente a partir da data de abertura e da data mais recente em que uma pontuação foi coletada: 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); Você cria um novo grupo de buckets chamado Intervalos de idade do incidente (dias). Neste grupo de buckets, você define um conjunto de buckets que começam na data desejada e terminam no início do próximo bucket. Por exemplo, o bucket de 06 a 30 dias começa às 6 e termina às 31: Este bucket conterá incidentes desde a idade de precisamente 6 dias até a idade de 30 dias, 23 horas, 59 minutos e 59 segundos. No final, você tem um grupo de buckets com cinco buckets correspondentes às faixas etárias nas quais você deseja dividir incidentes. O exemplo de Mapeamento de script mostra um detalhamento que usa este grupo de buckets e script. ### O que Fazer Depois Crie uma origem de detalhamento que use a tabela de fatos de Bucket \[pa_buckets\], o campo SYS ID e a condição \[Grupo de buckets\]\[is\]\[O nome do grupo de buckets que você criou\>\]. Em seguida, crie um detalhamento que use esta origem de detalhamento e use o script relevante para o mapeamento de detalhamento. **Conceitos relacionados** * [Exemplo: Mapeamento de script](https://servicenow-prod.fluidtopics.net/_MXbvn6pw3hUXmG3~Vftcg "O detalhamento por idade usa o script Incidente.Idade.Dias para calcular a idade dos incidentes em dias e mapear os valores para o grupo de buckets de faixas etárias do incidente.") * [Script em Performance Analytics](https://servicenow-prod.fluidtopics.net/NoO~I4blf7Ub87bry3YelA#pa-scripts "Performance AnalyticsFornece vários objetos de script para uso em scripts e APIs para consulta Performance Analyticsdados. Os scripts servem como mapeamentos de detalhamento ou para calcular um valor de um indicador.")