Geração de tarefas no KPI Composer

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura
  • Para cada artefato KPI Composer em seu projeto, você pode gerar uma tarefa para criar um elemento Performance Analytics equivalente. 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 os seguintes elementos Performance Analytics e Emissão de relatórios com base nas definições do seu projeto KPI Composer. 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, a definição de artefato KPI Composer associada 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 as tarefas
    Definição do detalhamento de Prioridade mostrando valores de Nome e Tabela de Fatos.

    Atribuir KPI Composer tarefas

    Atribua as tarefas em um projeto KPI Composer a um grupo. Por padrão, as tarefas são atribuídas ao grupo de atribuição de 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 projeto KPI Composer são atribuídas ao mesmo grupo de atribuição. Depois de gerar tarefas, o grupo lida com elas por meio do fluxo de trabalho normal.

    Por padrão, as tarefas são atribuídas ao grupo de Implementadores de análise, que é fornecido com KPI Composer. Este grupo inclui a função pa_admin por padrão. Todos os usuários que você adicionar a este grupo receberão esta função. Acessar este grupo de Administração de usuários > Gruposou siga o link Implementadores de análise 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 Criação de um grupo de usuários.

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

    Procedimento

    1. Abra seu projeto KPI Composer.
    2. Abra a guia Revisão.
    3. Localize o bloco Tarefas.
    4. Localize e selecione o ícone Limpar ao lado do nome do grupo de atribuição atual.
      Bloco de tarefas na guia Revisão de um projeto do KPI Composer 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 ofertas corresponde.

    7. Selecione um grupo.

    O que Fazer Depois

    Gere tarefas para atribuí-las ao grupo selecionado.

    Gerar tarefas

    Gere tarefas para todos os artefatos KPI Composer suficientemente definidos com uma única ação.

    Antes de Iniciar

    • Preencha o grupo de Implementadores de análise com usuários.
    • Conclua a criação do seu projeto KPI Composer. Todos os artefatos necessários devem ser definidos. No entanto, se você mudar algo posteriormente, poderá gerar novamente as tarefas. A regeneração de tarefas é uma boa maneira de rastrear 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 Revisão.
    3. Localize o bloco Tarefas.
    4. Selecione Gerar tarefas.

    Resultado

    Você gera tarefas para criar artefatos Performance Analytics e Emissão de relatórios. 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 tarefas são definidas em 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 qualquer registro de definição de tarefa existente a partir de links no bloco Tarefas da guia Revisão. Esses links levam você a uma lista filtrada de registros, da seguinte forma:
    Link Filtrar
    Tarefas ativas
    • Projeto CONTÉM<Your project name>
    • Status em (Criar, Atualizar)
    • Aguardando dependências = falso
    Tarefas em espera
    • Projeto CONTÉM<Your project name>
    • Status em (Criar, Atualizar)
    • Aguardando dependências = verdadeiro
    Tarefas concluídas
    • Projeto CONTÉM<Your project name>
    • 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. O artefato KPI Composer ainda existe? Caso contrário, o status será Excluído.
    2. O artefato KPI Composer existente tem uma definição válida? Caso contrário, o status será Incompleto.
    3. A definição de artefato KPI Composer válida está vinculada a um elemento Now Platform existente, como um indicador Performance Analytics ou bloco de conteúdo do CMS? 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 é Atualizar.
    5. Caso contrário, se o elemento vinculado existir, o status será OK.

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

    Acompanhamento de atualização 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. Mudanças em outros artefatos relacionados também podem resultar na mudança do status para Atualizar. A tabela a seguir lista os campos e os artefatos relacionados.
    Definições de artefato 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 de tempo
    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 tarefas

    KPI Composer tarefas utilizam fluxos criados com o Now Platform® Flow Designer.

    KPI Composer O fornece dois fluxos para gerenciar a transição entre os estados da tarefa:
    • KPI Composer - Fluxo de tarefa de análise
    • KPI Composer - 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 podem incluir atualizações para os fluxos. Se você alterar os fluxos fornecidos, as atualizações deles poderão falhar. Em vez disso, após uma atualização, você pode examinar os fluxos fornecidos quanto a mudanças. Incorpore essas mudanças nos fluxos copiados.

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

    KPI Composer - Fluxo de definição de tarefa