Tipos de Insight

O objeto do tipo de insight contém toda a configuração detalhada para exibir um ou mais alertas ou informações importantes de um registro no contexto. As seções a seguir contêm mais informações a respeito de toda a configuração gerenciada pelo tipo de insight.

Algoritmo de Insight

Cada tipo de insight é usado para exibir algumas informações, geralmente relacionadas a um objeto no contexto. É responsabilidade do algoritmo do tipo de insight receber os valores de contexto, determinar se há informações que devem ser mostradas para esse contexto e retornar o texto a ser exibido.

Os pontos a seguir destacam informações opcionais adicionais que podem ser retornadas pelo algoritmo:

  • Uma mensagem secundária. Isso só se aplica a algumas estruturas visuais em que mais de uma linha de informações pode ser exibida.

  • Valor de gravidade. É usado para substituir a configuração de exibição visual se for necessário usar ênfase diferente para valores de gravidade diferentes. Para obter mais informações, consulte Substituir Configuração.

  • Informações da entidade. Se o insight estiver relacionado a uma entidade específica, o código-objeto de manutenção e os valores de chave primária poderão ser retornados. Será útil se o tipo de insight configurar um BPA ou algoritmos de ação do usuário que possam executar a lógica para essa entidade.

  • Informações de Navegação e Ação do Usuário. Isso só se aplica a estruturas visuais compatíveis com ações do usuário. O algoritmo deve retornar a lista de todas as ações que devem ser ficar visíveis nas informações. Se a ação incluir navegação, o algoritmo deverá retornar a opção de navegação e os pares de chave e valor do contexto de navegação. Além disso, é preciso definir uma configuração para cada ação. Para obter mais informações, consulte Ações do Usuário.

Cada algoritmo pode retornar vários insights, se aplicável. Por exemplo, se o insight for sobre entradas de Atividade relacionadas ao objeto exibido, é possível poderá projetar seu algoritmo de insight para retornar um único insight que resuma todas as informações relacionadas à Atividade. Ou é possível optar por retornar insights separados com base nas informações de Atividade para oferecer informações mais detalhadas e personalizar ações ou a navegação com base nas diferentes condições. Por exemplo, se houver Entradas de Atividade nas quais o usuário atual possa executar ações e outras que o usuário atual não possa atualizar, o algoritmo poderá retornar dois insights separados: um com ações e outro sem ações.

Observação: Modo de visualização. A página de manutenção do tipo de insight inclui uma seção de Visualização de Insight que mostra a saída do algoritmo de insight quando chamado com um modo de insight de "Visualização". Cada algoritmo deve incluir uma lógica que retorne o texto apropriado quando chamado nesse modo para que algo seja exibido nessa seção.

Estruturas Visuais

Cada tipo de insight define uma estrutura visual que determina que tipo de informação pode ser mostrada. O sistema tem algumas expectativas de layout fixo para cada tipo de estrutura visual. A configuração do tipo de insight é usada para fornecer a origem do possível layout.

Observação: todos os insights usam opções de cor como parte da configuração. Para obter mais informações, consulte Opção de Cor.

Insight da Placa

A estrutura visual mais simples é a placa. É usada para exibir uma única linha de texto rápido com um segundo plano sólido (por questões de visibilidade) que visa alertar o usuário para informações resumidas ou atributos importantes.

Exemplo de Insight da Placa

Insight em Linha

O insight em linha define um ícone e uma única mensagem. O objetivo é que ele seja mais descritivo do que uma placa. Para esse tipo de insight, um fundo claro padrão é usado para que a recomendação seja selecionar uma opção de cor para o texto e para o ícone que tenha apenas uma cor de primeiro plano definida ou que tenha uma cor de fundo clara.

Exemplo de Insight em Linha

Insights da Lista

Os insights da lista têm o objetivo de existir em uma lista de insights do objeto. Eles definem um ícone e são compatíveis com duas linhas de texto. Além disso, esse tipo de insight é compatível com botões ou ações do usuário. Para obter mais informações, consulte Ações do Usuário. Observe que, no caso de insights da lista, se houver uma ou duas ações válidas, os botões de ação serão mostrados. Se houver três ou mais ações válidas, uma ação será mostrada e um botão 'Outras Ações' ficará visível. Clicar nesse botão mostra as outras ações disponíveis.

Observe que a cor de fundo do insight é usada como a cor do snippet completo do insight. O texto e o ícone são mostrados nesse segundo plano. A cor de fundo do ícone é ignorada.

Exemplo de Insights da Lista

Cartão

O insight do cartão é a informação mais importante, com até duas linhas de texto, ações do usuário, um ícone grande para chamar atenção e texto do cabeçalho. O texto do cabeçalho é escolhido em uma lista suspensa de opções válidas. O produto fornece o texto do cabeçalho da caixa "Informações", "Aviso" e "Erro". As implementações podem adicionar valores adicionais a isso usando o campo de consulta HEADER_​CAT_​FLG.

Observe o seguinte sobre o tratamento dos vários componentes do insight do cartão:

  • O texto do cabeçalho é renderizado como um insight de emblema.

  • Para o texto da mensagem exibido no cartão, a cor do segundo plano é ignorada, portanto, uma opção de cor sem cor de segundo plano ou uma cor de segundo plano clara deve ser escolhida.

  • Para o ícone, a cor de fundo é usada para criar uma área quadrada para exibição e o ícone é renderizado na cor de primeiro plano.

Exemplo de Insight do Cartão

Substituir Configuração

Cada insight oferece suporte à configuração visual padrão para os vários componentes do insight. Isso inclui a opção de cor para os componentes aplicáveis, juntamente com ícones e texto do cabeçalho, quando aplicável. Em cada caso, as definições visuais de substituição podem ser definidas para um determinado número de gravidade.

Por exemplo, imagine o algoritmo para uma visão de emblema que retorna uma mensagem com a contagem de entradas de Atividade relacionadas usa uma opção de cor diferente se houver mais de 10 registros relacionados. Para isso, o algoritmo pode retornar um número de gravidade e, em seguida, o usuário de configuração pode definir a opção de cor de substituição para esse número de gravidade.

Exemplo de Informações do Emblema com cor de substituição

Ações do Usuário

Os insights da lista e do cartão suportam a definição de ações do usuário que podem ser apresentadas como botões ao exibir as informações. As ações podem executar uma ou mais das seguintes ações:

  • Executar lógica de algoritmo. Um ou mais algoritmos de ação do usuário podem estar associados a um botão de ação. Deve ser usado para executar a lógica do servidor que não requer nenhuma interação do usuário. Por exemplo, é possível fornecer uma ação para atualizar o status de um registro relacionado às informações. Esses algoritmos são configurados no Tipo de Insight.

  • Navegar até outra página. Para esse tipo de ação, o algoritmo de insight deve fornecer o contexto de navegação e a opção de navegação a serem iniciados ao clicar no botão. É possível configurar a navegação e configurar algoritmos de ação do usuário. Nesse caso, os algoritmos são executados primeiro e, em seguida, a navegação ocorre.

  • Iniciar um BPA. Isso será usado se houver interação do usuário necessária para executar lógica adicional e/ou se houver navegação condicional de modo que a lógica seja necessária antes da navegação. É possível configurar um BPA e configurar algoritmos de ação do usuário. Nesse caso, os algoritmos serão executados primeiro e o BPA será iniciado. Se o algoritmo de insight também fornecer navegação para essa ação, ele será ignorado em favor do BPA. O BPA é configurado no Tipo de Insight.

A lista de ações válidas a serem exibidas no tempo de execução deve ser retornada pelo algoritmo de insight. Isso permite que o algoritmo tenha controle sobre quais ações exibir, caso haja algumas ações condicionais. Além disso, cada botão possível requer configuração relacionada ao texto a ser exibido e ao estilo do botão.

Texto do Botão

O texto do botão a ser exibido é escolhido em uma pesquisa de texto do botão. O nome da consulta é INSIGHT_​ACT_​FLD_​FLG. As implementações podem adicionar valores adicionais a esta consulta para incluir um novo texto de botão. Além disso, se quiser alterar o texto do botão em qualquer botão fornecido pelo produto, você poderá substituir a descrição do valor de consulta.

Classe de Ação

Cada botão de ação define uma classe de ação. Qualquer ação configurada com o valor da classe de ação do valor Positivo é mostrada primeiro e estilo diferente para ênfase. Outros valores de classe de ação são para fins informativos.

Tipos de Informações Base Entregues

Os tipos de informações são dados do sistema e o produto pode já fornecer vários tipos de informações predefinidos. É possível optar por incluir um ou mais tipos de informações em um Grupo de Insights.

Renderizando um Insight

Para apresentar uma visão geral de um tipo de visão geral, você incluiria o componente da Web de ou-insights em um mapa da interface do usuário que faz referência a esse tipo de visão geral. É assim que a seção Visualização de Informações da página de manutenção do tipo de informações renderiza a visualização.

Observação: Para obter mais informações, consulte Incluir um Componente Web.