Uso de gráficos em Comunicações interativas

Um gráfico ou um gráfico é uma representação visual de dados. Ela condensa grandes quantidades de informações em um formato visual fácil de entender, permitindo que os recipients da Comunicação interativa visualizem, interpretem e analisem melhor os dados complexos.

Ao criar uma Comunicação interativa, é possível adicionar gráficos para representar visualmente dados bidimensionais a partir do modelo de dados de formulário da Comunicação interativa. O componente Gráfico permite adicionar e configurar os seguintes tipos de gráficos: Pizza, Coluna, Rosca, Barra, Linha, Linha e Ponto, Ponto, Área e Quadrante.

Adicionar e configurar um gráfico em uma Comunicação Interativa

Execute as seguintes etapas para adicionar e configurar um gráfico em uma Comunicação interativa:

  1. Toque em Componentes no sidekick da Comunicação interativa.

  2. Arraste e solte o componente Chart para um dos seguintes componentes:

    • Canal de impressão: Área de destino ou campo de imagem
    • Canal da Web: Painel ou área de destino
  3. Toque no componente de gráfico no editor de Comunicação interativa e selecione Configurar ( configurar_icon) na barra de ferramentas Componente.

    As Propriedades do Gráfico são exibidas no painel esquerdo.

    Propriedades básicas de um gráfico de tipo de linha no canal de impressão

    Propriedades básicas de um gráfico de tipo de linha no canal de impressão

    Propriedades básicas de um gráfico de tipo de linha no canal da Web

    Propriedades básicas de um gráfico de tipo de linha no canal da Web

  4. Configure as propriedades do gráfico com base no tipo de canal.

  5. (Somente canal de impressão) Nas Configurações do Agente, especifique se é obrigatório que o agente use este gráfico. Se a opção i t Is Mandatory To the Agent To Use This Chart não estiver selecionada, o agente poderá tocar no ícone de olho do gráfico na guia Content da interface do usuário do agente para mostrar ou ocultar o gráfico.

    chart_agentproperties

  6. Toque em done_icon para salvar as propriedades do gráfico.

    Toque em Preview para exibir a aparência e os dados associados ao gráfico. Toque em Editar para reconfigurar as propriedades do gráfico.

Configurar propriedades do gráfico

Configure as seguintes propriedades ao criar gráficos para canais de impressão e da Web:

Texto Descrição Tipo de canal
Nome Identificador para o elemento do gráfico. O nome do gráfico especificado neste campo não está visível no gráfico. Ele é usado ao se referir ao elemento de outros componentes, scripts e expressões SOM. Impressão e Web
Tipo de gráfico Tipo de gráfico que você deseja gerar. As opções disponíveis são Pizza, Coluna, Rosca, Barra, Linha, Linha e Ponto, Ponto e Área. Impressão e Web
Série > Várias séries Selecione para adicionar várias séries para os itens de coleção do modelo de dados de formulário plotados no eixo X e no eixo Y. Impressão e Web
Série > Objeto do modelo de dados Nome do item de coleção do modelo de dados de formulário para adicionar várias séries ao gráfico.
Escolha uma propriedade de objeto de modelo de dados de formulário pai para as propriedades plotadas no eixo X e no eixo Y para formar uma série significativa. O objeto de modelo de dados que você vincula deve ser do tipo Número, String ou Data.
Impressão e Web
Mostrar empilhado Opte por empilhar os valores de cada séria, um sobre o outro. Impressão e Web
Eixo X > Título Título do eixo X. Impressão e Web
Eixo X > Objeto do modelo de dados

Nome do item de coleção do modelo de dados de formulário a ser plotado no eixo X.

Escolha duas propriedades de tipo de coleção/matriz do mesmo objeto de modelo de dados pai que sejam significativas em relação umas às outras para plotar no eixo X e Y de um gráfico. O objeto de modelo de dados que você vincula deve ser do tipo Número, String ou Data.

Impressão e Web
Eixo Y > Título Título do eixo Y. Impressão e Web
Eixo Y > Objeto do modelo de dados

Item de coleção do modelo de dados de formulário a ser plotado no eixo Y. No canal Impressão, o objeto de modelo de dados para o eixo Y deve ser do tipo Número.

Escolha duas propriedades de tipo de coleção/matriz do mesmo objeto de modelo de dados pai que sejam significativas em relação umas às outras para plotar no eixo X e Y de um gráfico.

Impressão e Web
Eixo Y > Função Função estatística/personalizada a ser usada para calcular os valores no eixo y. Impressão e Web
Ocultar objeto Selecione para ocultar o gráfico na saída final. Impressão e Web
Título Título do gráfico. Impressão
Altura Altura do gráfico em pixels. Impressão
Largura Largura do gráfico em pixels. É possível controlar a largura do gráfico no canal da Web usando a camada de estilo ou aplicando um tema. Impressão
Quebra de Página Obrigatória Antes Selecione para adicionar uma quebra de página obrigatória antes do gráfico e coloque o gráfico na parte superior de uma nova página. Impressão
Quebra obrigatória de página após Selecione para adicionar uma quebra de página obrigatória após o gráfico e coloque o conteúdo após o gráfico na parte superior de uma nova página. Impressão
Recuo Recuo do gráfico à esquerda da página. Impressão
Dica

Formato no qual a dica de ferramenta aparece ao passar o mouse sobre um ponto de dados no gráfico do canal da Web. O valor padrão é ${x}(${y}). Dependendo do tipo de gráfico, quando você aponta o mouse para um ponto, barra ou fatia no gráfico, as variáveis ${x}e ${y} são substituídas dinamicamente pelos valores correspondentes no eixo X e no eixo Y e exibidas na dica de ferramenta.

Para desativar a dica de ferramenta, deixe o campo Dica de ferramenta em branco. Essa opção não é aplicável para gráficos de linha e de área. Por exemplo, consulte Exemplo 1: Saída do gráfico em print e web.

Web
Configurações específicas do gráfico

Além de configurações comuns, a seguinte configuração específica do gráfico está disponível:

  • Mostrar legenda: Mostra uma legenda para o gráfico de pizza ou rosca quando ativado.
  • Posição da legenda: Especifica a posição da legenda em relação ao gráfico. As opções disponíveis são Direita, Esquerda, Superior e Inferior. É recomendável usar a legenda do lado direito no canal de impressão.
  • Raio interno: Disponível para gráficos de rosca para especificar o raio (em pixels) do círculo interno no gráfico.
  • Cor da linha: Disponível para gráficos de linha, ponto e área para especificar a cor da linha no gráfico.
  • Cor do ponto: Disponível para gráficos de Ponto e Linha e Ponto para especificar a cor dos pontos no gráfico.
  • Cor da área: Disponível para gráficos de área para especificar a cor da área sob a linha no gráfico.
  • Ponto de referência > Tipo de vínculo: Disponível para gráficos do Quadrante para especificar o tipo de vínculo para o ponto de referência. Use texto estático ou propriedade de objeto de modelo de dados para definir o valor do ponto de referência.
  • Ponto de referência > Eixo X: Disponível para gráficos de Quadrante se você selecionar Estático na lista suspensa Tipo de Vínculo para especificar o valor do eixo X para o ponto de referência.
  • Ponto de referência > Eixo Y: Disponível para gráficos de Quadrante se você selecionar Estático na lista suspensa Tipo de Vínculo para especificar o valor do eixo Y para o ponto de referência.
  • Ponto de referência > Objeto de modelo de dados para séries: Disponível para gráficos do Quadrante de várias séries, se você selecionar Objetos do Modelo de Dados na lista suspensa Tipo de Vínculo . Defina a propriedade do objeto de modelo de dados de formulário para identificar o conjunto do ponto de referência.
  • Ponto de referência > Valor do objeto do modelo de dados para séries: Disponível para gráficos do Quadrante de várias séries, se você selecionar Objetos do Modelo de Dados na lista suspensa Tipo de Vínculo . Use a propriedade de objeto de modelo de dados de formulário para a série e o valor definido neste campo para identificar a série para o ponto de referência.
  • Ponto de referência > Objeto do modelo de dados para o ponto de referência: Disponível para gráficos do Quadrante se você selecionar Objeto do Modelo de Dados na lista suspensa Tipo de Vínculo . Defina uma propriedade de objeto de modelo de dados de formulário que seja um irmão das propriedades plotadas no eixo X e no eixo Y. Além disso, para várias séries, defina uma propriedade de objeto de modelo de dados que seja uma entidade-filho da propriedade de objeto de modelo de dados definida para as séries.
  • Ponto de referência > Valor do objeto do modelo de dados para o ponto de referência: Disponível para gráficos do Quadrante se você selecionar Objeto do Modelo de Dados na lista suspensa Tipo de Vínculo . Use a propriedade de objeto de modelo de dados de formulário para o ponto de referência e o valor definido neste campo para identificar o ponto de referência do gráfico.
    Rótulos do quadrante > Superior esquerdo: Disponível para gráficos do quadrante para especificar o nome do quadrante superior esquerdo.
  • Rótulos do quadrante > Superior direito: disponível para gráficos do quadrante para especificar o nome do quadrante superior direito.
  • Rótulos do quadrante > Parte inferior direita: Disponível para gráficos de Quadros para especificar o nome do quadrante Inferior Direito.
  • Rótulos do quadrante > Parte inferior esquerda: Disponível para gráficos de Quadros para especificar o nome do quadrante Inferior Esquerdo.
Impressão e Web

Usar funções no gráfico

Você pode configurar um gráfico para usar funções estatísticas para calcular valores a partir dos dados de origem para plotar no gráfico. Ao aplicar funções em um gráfico, é possível plotar dados que não são fornecidos diretamente pelo modelo de dados do formulário.

Funções em gráficos

Embora o componente Gráfico seja fornecido com algumas funções incorporadas, você pode gravar funções personalizadas e disponibilizá-las para uso na configuração do gráfico no canal da Web.

As seguintes funções estão disponíveis por padrão com o componente Gráfico :

Média (Média) Retorna a média dos valores no eixo X ou Y para um determinado valor no outro eixo.

​SumRetorna a soma de todos os valores no eixo X ou Y para um determinado valor no outro eixo.

​MaximumRetorna o máximo dos valores no eixo X ou Y para um determinado valor no outro eixo.

​FrequencyRetorna o número de valores no eixo X ou Y para um determinado valor no outro eixo.

​RangeRetorna a diferença entre o máximo e o mínimo dos valores no eixo X ou Y para um determinado valor no outro eixo.

​MedianRetorna o valor que separa valores mais altos e mais baixos na metade no eixo X ou Y para um determinado valor no outro eixo.

​MinimumRetorna o mínimo dos valores no eixo X ou Y para um determinado valor no outro eixo.

​ModoRetorna o valor com a maioria das ocorrências no eixo X ou Y para um determinado valor no outro eixo.

Para obter mais informações, consulte Exemplo 2: Aplicação das funções Soma e Frequência em um gráfico de linhas.

Funções personalizadas no canal da Web

Além de usar as funções padrão em gráficos, você pode gravar funções personalizadas no JavaScript™ e disponibilizá-las na lista de funções no componente Gráfico do canal da Web.

Uma função pega uma matriz ou valores e um nome de categoria como entradas e retorna um valor. Por exemplo:

Multiply(valueArray, category) {
 var val = 1;
 _.each(valueArray, function(value) {
 val = val * value;
 });
 return val;
}

Depois de gravar uma função personalizada, faça o seguinte para disponibilizá-la para uso na configuração do gráfico:

  1. Adicione a função personalizada na biblioteca do cliente associada à Comunicação interativa relevante. Para obter mais informações, consulte Configuração da ação Enviar e Uso de bibliotecas do lado do cliente.

  2. Para exibir a função personalizada no menu suspenso Função , no CRXDe Lite, crie um nó nt:unstructured na pasta de aplicativos com as seguintes propriedades:

    • Adicione a propriedade guideComponentType com o valor como fd/af/reducer. (mandatory)

    • Adicione a propriedade value a um nome totalmente qualificado da função JavaScript™ personalizada. (obrigatório) e defina seu valor com o nome da função personalizada, como Multiply.

    • Adicione a propriedade jcr:description com o valor que você deseja exibir como o nome da função personalizada que aparece no menu suspenso Função . Por exemplo, Multiply.

    • Adicione a propriedade qtip com o valor que será uma breve descrição da função personalizada. Ele aparece como uma dica de ferramenta ao passar o ponteiro sobre o nome da função na lista suspensa Function.

  3. Clique em Salvar tudo para salvar a configuração.

A função agora está disponível para uso no Gráfico.

Exemplo 1: Saída do gráfico na impressão e na Web

Na guia Básico , é possível definir o tipo de gráfico, as propriedades do modelo de dados do formulário de origem que contêm dados, os rótulos a serem representados no eixo X e no eixo Y do gráfico e, como opção, a função estatística para calcular os valores para plotamento no gráfico.

Vamos entender em detalhes as informações mínimas necessárias nas propriedades básicas, com a ajuda de uma instrução de cartão gerada por meio de uma Comunicação interativa. Considere que você deseja gerar um gráfico para descrever a quantidade de diferentes despesas na instrução. Você deseja usar diferentes tipos de gráficos para impressão e saída da Web da Comunicação interativa.

Gráfico de colunas para Imprimir

Para fazer isso, especifique as seguintes propriedades:

  • Nome - Especifique o nome do gráfico.
  • Tipo de gráfico - Selecione ​Coluna na lista suspensa.
  • Título - Especifique o Tipo de Despesa para o eixo X e a Quantia da Transação para o eixo Y.
  • Objetos do Modelo de Dados - Selecione as propriedades do objeto do modelo de dados para criar vínculos de dados para o eixo X (Tipo de Despesa) e o eixo Y (Quantia da Transação).

Gráfico de colunas no canal de impressão de uma comunicação interativa

Gráfico de colunas no canal de impressão de uma comunicação interativa

Gráfico de rosca para web

Para fazer isso, especifique as seguintes propriedades:

  • Nome - Especifique o nome do gráfico.
  • Tipo de gráfico - Selecione ​Não na lista suspensa.
  • Objetos do Modelo de Dados - Selecione as propriedades do objeto do modelo de dados para criar vínculos de dados para o eixo X (Tipo de Despesa) e o eixo Y (Quantia da Transação).
  • Raio interno - Especifique o valor do Raio interno como 150 para especificar o raio (em pixels) do círculo interno no gráfico.
  • Dica de ferramenta - Use o formato padrão ${x}(${y}) para exibir a dica de ferramenta. A dica de ferramenta é exibida como: Tipo de Despesa (Quantia da Transação). Exemplo: Débito para Bitcurrency(10000).

Gráfico de rosca no canal Web de uma Comunicação Interativa

Gráfico de rosca no canal Web de uma Comunicação Interativa

Exemplo 2: Aplicação das funções Soma e Frequência em um gráfico de linhas

Ao aplicar funções em um gráfico, é possível plotar dados que não são fornecidos diretamente pelo modelo de dados do formulário. Neste exemplo, usamos um exemplo de declaração de cartão de crédito para entender como as funções Soma e Frequência podem ser aplicadas ao gráfico.

Gráfico de linhas sem uma função com duas transações "Débito para AirBnB"

Gráfico de linhas sem uma função com duas transações "Débito para AirBnB"

Função Sum

É possível aplicar a função sum para adicionar valores de várias instâncias da mesma propriedade de dados e exibi-la apenas uma vez. Por exemplo, no gráfico a seguir, a função Sum é aplicada no eixo Y para somar o valor das duas transações Debit for AirBnB (2050 e 1050) e mostrar apenas uma transação (3100).

A função Sum pode tornar o gráfico mais útil quando você deseja comparar e exibir a soma de várias instâncias da mesma propriedade de dados.

Soma do gráfico de linhas

Função de frequência

A função Frequency retorna o número de valores do eixo Y para um determinado valor no outro eixo. Com a aplicação da função Frequency no eixo Y (Quantia da Transação), o gráfico exibe que houve duas ocorrências de Débito para transações AirBnB e uma ocorrência do resto dos tipos de transações.

Frequência do gráfico de linhas

Exemplo 3: Gráfico Quadrante de Várias Séries na Web

O gráfico representa o valor das transações executadas em um determinado intervalo de datas. O Gráfico de quadrantes fornece a capacidade de dividir a área do gráfico em quatro seções rotuladas. O gráfico usa um ponto de referência estático para o eixo X e o eixo Y. Use o recurso de várias séries para segregar dados com base no nome do banco.

Para fazer isso, especifique as seguintes propriedades:

  • Nome: especifique o nome do gráfico.

  • Tipo de gráfico: selecione ​Quadrante na lista suspensa.

  • Marque a caixa de seleção Multiple Series.

  • Objeto do Modelo de Dados: Especifique a propriedade de objeto do modelo de dados para a série. A propriedade de objeto do modelo de dados para o nome do banco é um pai das propriedades de objetos do modelo de dados plotadas no eixo X e no eixo Y.

  • Objetos do Modelo de Dados: Selecione as propriedades do objeto do modelo de dados para criar vínculos de dados para o eixo X (Data da Transação) e o eixo Y (Quantia da Transação).

  • Na seção Ponto de referência, selecione Estático como o Tipo de Vínculo.

  • Especifique os valores para os pontos de referência do eixo X e do eixo Y.

  • Especifique os rótulos do quadrante para os quadrantes Superior Esquerdo, Superior Direito, Inferior Direito e Inferior Esquerdo.

  • Marque a caixa de seleção Show legends para exibir os códigos de cor dos nomes dos bancos.

Gráficos de quadrante

Nesta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now