Exemplo – Criando um relatório de e-mail usando um modelo HTML incorporado

Neste exemplo, você criará e enviará um relatório incorporando um modelo de relatório HTML diretamente em uma mensagem de e-mail.

Requisitos

• Provedor de e-mail configurado para o locatário do Qlik Cloud. Consulte: Configurando e-mail para relatórios e notificações

• A função de segurança Private Analytics Content Creator, ou função de espaço suficiente para o desenvolvimento de relatórios em um espaço compartilhado. Consulte: Permissões

Etapa 1: Fazer upload de fontes de exemplo

Consulte os exemplos de fontes de aplicativos aqui: Exemplo de materiais - Relatórios no aplicativo. Carregue o aplicativo e os arquivos de dados em um espaço e, em seguida, recarregue o aplicativo. Está tudo pronto para concluir o exemplo.

Etapa 2: Desenvolver o modelo

Criar um novo modelo

Adicionar dados tabulares

Em seguida, adicione dados tabulares ao modelo.

Faça o seguinte:

1. Clique em no painel de objetos.

2. Clique em Adicionar tabela. Uma lista de pastas disponíveis é exibida.

3. Expanda a pasta Sales Tables.

4. Clique no ícone ao lado do gráfico Yearly Regional Sales.

5. No menu suspenso, selecione Colunas individuais.

6. Em Selecionar colunas para adicionar, selecione Tudo. Clique em Adicionar.

   O gráfico é adicionado ao modelo como uma estrutura de tabela.

7. Com a nova tabela selecionada, altere as seguintes propriedades da tabela no painel de objetos:

   • Em Configurações de tabela, desative Manter formatos de origem.

   • Altere Exibir cabeçalhos para Ocultar.

8. Na tabela, adicione uma nova linha acima da definição de linha existente. Adicione uma nova linha abaixo da linha que contém <tbody><tr>. Cole o seguinte:

   <th>Order year</th>
   <th>Region</th>
   <th>Sales</th>
   </tr>
   <tr>

Estilizar a tabela

Em seguida, estilize os elementos da tabela adicionando definições de estilo no HTML head e estilizando inline na estrutura de table em si.

Faça o seguinte:

1. Adicione uma nova linha abaixo da definição de title para o modelo.

2. Cole o seguinte:

   <style>html { font-family: sans-serif }
   table { border: 2px solid #000000 }
   tr, th, td { border: 1px solid #000000 }
   th { font-size: large }
   td { font-size: medium }</style>

3. Localize a linha na estrutura de table que define os dados. Deve ter a seguinte aparência:

   <td>%%OrderYear%%</td><td>%%Region%%</td><td>%%Sales%%</td>

4. Adicione style="text-align: center" à tag de abertura do primeiro elemento td. Agora, a linha inteira deve ter a seguinte aparência:

   <td style="text-align: center">%%OrderYear%%</td><td>%%Region%%</td><td>%%Sales%%</td>

   Isso alinha o texto na primeira coluna para que fique centralizado.

Adicionando um título dinâmico

Em seguida, crie uma expressão para armazenar o cálculo do intervalo de anos para suas vendas. Em seguida, incorpore essa expressão no título do relatório para que ela seja incorporada como o assunto do e-mail.

Faça o seguinte:

1. Clique em no painel de objetos.

2. Clique em Adicionar expressão.

3. No campo Nome, digite YearRange.

4. No campo Expressão, cole a seguinte expressão:

   = min(OrderYear)& ' - ' & max(OrderYear)

5. Clique em Criar.

6. Na superfície do design, encontre o elemento title. Substitua toda a linha pelo seguinte:

   <title>Sales Report: </title>

7. Na linha que você acabou de colar, coloque o cursor após Sales Report:

8. No painel de objetos, clique em Adicionar tag de expressão.

9. A linha agora deve ser:

   <title>Sales Report: %YearRange%%</title>

Adicionar instruções de abertura e fechamento

Em seguida, adicione uma saudação e uma instrução de abertura e finalize o relatório com uma saudação de encerramento.

Faça o seguinte:

1. Adicione uma nova linha abaixo da tag de abertura body.

2. Cole o seguinte:

       <p>Hello,</p>
       <p>The table below outlines regional sales details for the requested years.</p>
   

3. Adicione uma nova linha abaixo da linha que contém a tag de fechamento da tabela.

4. Cole o seguinte:

       <p>Regards,</p>
       <p>- Management</p>

Salvando e finalizando seu trabalho

Clique em Salvar modelo para salvar seu trabalho. O código do modelo concluído deve se parecer com o seguinte.

<html><head>
  <title>Sales Report: %%YearRange%%</title>
<style>html { font-family: sans-serif }
table { border: 2px solid #000000 }
tr, th, td { border: 1px solid #000000 }
th { font-size: large }
td { font-size: medium }</style>
  </head>
  <body>
    <p>Hello,</p>
    <p>The table below outlines regional sales details for the requested years.</p>
    <table cellspacing="0" style="border-collapse: collapse">
    <tbody><tr>
      <th>Order year</th>
      <th>Region</th>
      <th>Sales</th>
      </tr>
      <tr>
      <td style="text-align: center">%%OrderYear%%</td><td>%%Region%%</td><td>%%Sales%%</td></tr>
    </tbody></table>
    <p>Regards,</p>
    <p>- Management</p>
</body></html>

Etapa 3: Adicionar uma lista de distribuição

Adicione um arquivo de lista de distribuição na guia Destinatários ou Grupos na seção Relatórios do aplicativo. Verifique se você foi adicionado por e-mail como destinatário e se a lista de distribuição não contém nenhum filtro ou grupo.

Para obter informações sobre listas de distribuição, consulte Criando uma lista de distribuição para seu relatório.

Etapa 4: Criar uma tarefa de relatório

Faça o seguinte:

1. Abra a guia Tarefas de relatório na seção Relatórios do aplicativo.

2. Clique em Criar tarefa de relatório. O diálogo da tarefa de relatório é aberto.

3. Insira um Título para sua tarefa de relatório.

4. Como opção, adicione uma Descrição.

   Na guia do diálogo Modelo, clique em Adicionar modelo existente. Selecione o modelo que você desenvolveu acima.

5. Clique em Próximo. O diálogo passa para a guia Saída.

6. Na guia de diálogo Saída, digite um Nome de arquivo para a saída do relatório.

7. Clique em Avançar para prosseguir para a guia do diálogo Distribuir.

8. Adicione você como destinatário da saída do relatório.

9. Em E-mail, selecione Relatório HTML. Isso incorporará o relatório à mensagem de e-mail em vez de anexá-lo como um arquivo.

10. Clique em Avançar para prosseguir para a guia do diálogo Programar.

11. Selecione as configurações de agendamento padrão e clique em Salvar.

Etapa 5: Enviar o relatório

Faça o seguinte:

1. Permaneça na guia Tarefas de relatório na seção Relatórios do aplicativo.

2. Clique em ao lado da nova tarefa de relatório.

3. Clique em Enviar agora.

Quando o e-mail chegar, abra-o para ver o resultado.