Gerando tarefas no Composer de KPI

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura
  • Para cada KPI Composer em seu projeto, você pode gerar uma tarefa para criar um equivalente Performance Analytics elemento. Todas as tarefas são criadas com uma ação. As tarefas são atribuídas automaticamente ao grupo responsável pela implementação da análise.

    As tarefas podem ser geradas para criar o seguinte Performance Analytics e. Emissão de relatórios elementos com base nas definições em seu KPI Composer projeto. As tarefas são geradas para cada tipo de elemento nesta ordem:

    • Detalhamentos
    • Relatórios
    • Filtros interativos
    • Indicadores
    • Widgets
    • Grupos em destaque
    • Blocos de conteúdo
    • Painéis
    Importante:
    Para gerar uma tarefa para criar um elemento, o associado KPI Composer a definição de artefato deve incluir todas as informações necessárias. Por exemplo, para gerar uma tarefa para criar um detalhamento ou um indicador automatizado, o Nome e a Tabela de fatos devem ser especificados em suas definições.
    Figura 1. Definição do detalhamento de prioridade mostrando as informações necessárias para tarefas
    Definição do detalhamento de prioridade mostrando os valores da tabela Nome e fatos.

    Atribuir KPI Composer tarefas

    Atribua as tarefas em um KPI Composer projeto para um grupo. Por padrão, as tarefas são atribuídas ao grupo de atribuição Implementadores de análise. Você pode adicionar usuários e grupos a este grupo ou selecionar um grupo de atribuição diferente.

    Antes de Iniciar

    Função necessária: sn_kpi_composer.user, sn_kpi_composer.admin, admin

    Por Que e Quando Desempenhar Esta Tarefa

    Todas as tarefas em um KPI Composer o projeto está atribuído ao mesmo grupo de atribuição. Depois que você gerar tarefas, o grupo as manipula por meio de seu fluxo de trabalho normal.

    Por padrão, as tarefas são atribuídas ao grupo Implementadores de análise, que é fornecido com KPI Composer. Este grupo inclui a função pa_admin por padrão. Esta função é concedida a todos os usuários que você adicionar a este grupo. Acesse este grupo de Administração de usuários > Grupos, ou siga Implementadores de análise Link no bloco Tarefas na guia Revisão. Você precisa da função user_admin para editar este grupo. Para obter mais informações sobre como adicionar e remover usuários deste grupo, consulte Crie um grupo de usuários .

    Para mudar o grupo de atribuição, siga este procedimento:

    Procedimento

    1. Abra seu KPI Composer projeto.
    2. Abra o. Revisão .
    3. Localize o. Tarefas lado a lado.
    4. Localize e selecione o. Limpar ícone ao lado do nome do grupo de atribuição atual.
      Bloco de tarefas na guia Revisão de um projeto do Compositor de KPIs com o cursor no ícone Limpar.
    5. Confirme que você deseja limpar o grupo de atribuição.
    6. Comece a digitar o nome do grupo de atribuição desejado.
      KPI Composer fornece uma lista de correspondências previstas.

      Digitar parte do nome de um grupo de atribuição e receber correspondências.

    7. Selecione um grupo.

    O que Fazer Depois

    Gere tarefas para atribuí-las ao grupo selecionado.

    Gerar tarefas

    Gere tarefas para todas definidas suficientemente KPI Composer artefatos com uma única ação.

    Antes de Iniciar

    • Preencha o grupo Implementadores de análise com usuários.
    • Conclua o design do KPI Composer projeto. Todos os artefatos necessários devem ser definidos. No entanto, se você mudar algo mais tarde, poderá gerar novamente as tarefas. Regenerar tarefas é uma boa maneira de acompanhar sua conclusão.

    Função necessária: sn_kpi_composer.user, sn_kpi_composer.admin, admin

    Procedimento

    1. Navegue até KPI Composer e abra seu projeto totalmente definido.
    2. Abra a guia Revisar.
    3. Localize o bloco Tarefas.
    4. Selecione Gerar tarefas .

    Resultado

    Você gera tarefas para criar Performance Analytics e. Emissão de relatórios artefatos. Essas tarefas são atribuídas automaticamente ao grupo de atribuição de Implementadores de análise.

    O que Fazer Depois

    Exiba as tarefas que você criou. No bloco Tarefas, você tem links para tarefas ativas, tarefas em espera e tarefas concluídas. Os links levam você para a tabela Definições de tarefa [sn_kpi_composer_task_definition].

    Registros de definição de tarefa

    KPI Composer As tarefas são definidas nos registros de Definição de tarefa [sn_kpi_composer_task_definition]. Ao gerar tarefas, você cria esses registros ou atualiza seus status.

    Você pode acessar todos os registros de Definição de tarefa existentes nos links no bloco Tarefas da guia Revisão. Estes links levam você a uma lista filtrada de registros, da seguinte forma:
    Link Filtrar
    Tarefas ativas
    • O projeto CONTÉM o nome do seu projeto
    • Status em (Criar, Atualizar)
    • A espera nas dependências é falso
    Tarefas em espera
    • O projeto CONTÉM o nome do seu projeto
    • Status em (Criar, Atualizar)
    • Verdadeiro aguardando dependências
    Tarefas concluídas
    • O projeto CONTÉM o nome do seu projeto
    • Status: OK

    Status da tarefa

    Quando você executa o gerador de tarefas, ele determina o status de todas as tarefas. A geração de tarefas usa a seguinte lógica para criar tarefas e definir seus status:

    1. . KPI Composer o artefato ainda existe? Caso contrário, o status será Excluído.
    2. O existente KPI Composer o artefato tem uma definição válida? Caso contrário, o status será incompleto.
    3. O é válido KPI Composer link de definição de artefato para um existente ServiceNow AI Platform elemento, como um Performance Analytics Bloco de conteúdo do CMS ou indicador? Caso contrário, o status será Criar.
    4. Se o elemento vinculado existir e o status tiver sido definido anteriormente como OK, a definição do artefato foi atualizada posteriormente? Em caso afirmativo, o status será Atualizar.
    5. Caso contrário, se o elemento vinculado existir, o status será OK.

    A lógica do trabalho de geração de tarefa que resulta em um status de registro de definição de tarefa: Excluído, Incompleto, Criar, OK ou Atualizar.

    Acompanhamento de atualizações de artefato

    A geração de tarefas verifica todas as definições de tarefa, incluindo aquelas com o status OK. Se a definição do artefato tiver mudado desde que o status da tarefa foi definido como OK, o próximo trabalho de geração de tarefa mudará o status da tarefa para Atualizar. Os campos na definição de artefato que são verificados quanto a mudanças dependem do tipo de artefato. As mudanças em outros artefatos relacionados também podem resultar na mudança de status para Atualizar. A tabela a seguir lista os campos e os artefatos relacionados.
    Definições de artefatos Campos Mudanças de artefato relacionadas
    Detalhamento Condição
    Tabela de fatos
    Nome
    Indicador Agregação Detalhamento adicionado
    Condição Detalhamento removido
    Direção
    Tabela de fatos
    Fórmula
    Frequência
    Tipo de indicador
    Nome
    Relatório Agregação
    Condição
    Descrição
    Tabela de fatos
    Nome
    Fonte do relatório
    Tipo de Origem
    Filtro interativo Tipo de controle da IU
    Título
    Descrição
    Filtro interativo
    Widget de PA Tipo de Widget
    Tipo de visualização
    Título
    Descrição
    Acompanhar elemento
    Série temporal
    Artefatos
    Em Destaque Título
    Descrição
    Artefatos
    Painel Nome Detalhamento adicionado
    Descrição Detalhamento removido
    Layout da tela alterado - reordenar/excluir/adicionar tela

    Fluxos de tarefa

    KPI Composer as tarefas utilizam fluxos criados com o. ServiceNow AI Platform® Flow Designer.

    KPI Composer o fornece dois fluxos para gerenciar a transição entre estados de tarefa:
    • KPI Composer - Fluxo de tarefas de análise
    • Compositor de KPI - Fluxo de definição de tarefa

    Você pode modificar qualquer um desses fluxos no Flow Designer. No entanto, em vez de modificá-los diretamente, você deve copiar os fluxos e modificar as cópias. Ative as cópias e desative os fluxos fornecidos. O motivo para fazer isso é que as atualizações para KPI Composer pode incluir atualizações para os fluxos. Se você mudar os fluxos fornecidos, as atualizações para eles podem falhar. Em vez disso, após uma atualização, você pode examinar os fluxos fornecidos para mudanças. Incorpore essas mudanças em seus fluxos copiados.

    Os diagramas a seguir resumem os fluxos fornecidos:
    KPI Composer - Fluxo de tarefas de análise.

    Compositor de KPI - Fluxo de definição de tarefa