Exemple : création d'un modèle de rapport par e-mail à l'aide d'un modèle HTML intégré

Dans cet exemple, vous allez créer et envoyer un rapport en intégrant un modèle de rapport HTML directement dans un e-mail.

Conditions requises

• Fournisseur de messagerie configuré pour le client Qlik Cloud. Consultez : Configuration de la messagerie pour les rapports et les notifications

• Le rôle de sécurité Private Analytics Content Creator, ou rôle d'espace suffisant pour l'élaboration de rapports dans un espace partagé. Consultez : Autorisations

Étape 1 : télécharger des exemples de sources

Reportez-vous aux sources d'application de l'exemple ici : Ressources contenant des exemples - Génération de rapports dans l'application. Chargez les fichiers d'application et de données dans un espace, puis actualisez l'application. Vous êtes prêt à suivre l'exemple.

Étape 2 : développer le modèle

Créer un modèle

Ajouter des données tabulaires

C'est ici que vous ajoutez des données tabulaires au modèle.

Procédez comme suit :

1. Cliquez sur dans le panneau des objets.

2. Cliquez sur Ajouter une table. Une liste de feuilles disponibles apparaît.

3. Développez la feuille Sales Tables.

4. Cliquez sur l'icône à côté du graphique Yearly Regional Sales.

5. Dans le menu déroulant, sélectionnez Colonnes individuelles.

6. Sous Sélectionner des colonnes à ajouter, sélectionnez Toutes. Cliquez sur Ajouter.

   Le graphique est ajouté au modèle en tant que structure de table.

7. La nouvelle table étant sélectionnée, modifiez les propriétés suivantes pour la table dans le panneau des objets :

   • Sous Paramètres de la table, désactivez l'option Conserver les formats source.

   • Changez l'affichage des en-têtes pour les masquer.

8. Dans la table, ajoutez une nouvelle ligne au-dessus de la définition de ligne existante. Ajoutez une nouvelle ligne sous la ligne qui contient <tbody><tr>. Collez ce qui suit :

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

Style de la table

Ensuite, stylisez les éléments de la table en ajoutant des définitions de style dans la structure HTML head et un style inline dans la structure table elle-même.

Procédez comme suit :

1. Ajoutez une nouvelle ligne sous la définition de title pour le modèle.

2. Collez ce qui suit :

   <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. Emplacement de la ligne dans la structure table qui définit les données. Il doit ressembler à ceci :

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

4. Ajoutez style="text-align: center" à la balise d'ouverture du premier élément td. La ligne entière doit maintenant ressembler à ceci :

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

   Cela permet d'aligner le texte de la première colonne pour qu'il soit centré.

Ajouter un titre dynamique

Ensuite, créez une expression pour stocker le calcul de l'intervalle d'années pour vos ventes. Ensuite, incorporez cette expression dans le titre du rapport de manière à ce qu'elle soit intégrée comme objet de l'e-mail.

Procédez comme suit :

1. Cliquez sur dans le panneau des objets.

2. Cliquez sur Ajouter une expression.

3. Dans le champ Nom, tapez YearRange.

4. Collez l'expression suivante dans le champ Expression :

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

5. Cliquez sur Créer.

6. Sur la surface du dessin, trouvez l'élément title. Remplacez toute la ligne par ce qui suit :

   <title>Sales Report: </title>

7. Sur la ligne que vous venez de coller, placez votre curseur après Sales Report:

8. Dans le panneau des objets, cliquez sur Ajouter une balise d'expression.

9. La ligne devrait maintenant être :

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

Ajouter une phrase d'introduction au début et une formule de clôture à la fin

Ajoutez ensuite une formule de salutation et une phrase d'introduction, puis terminez le rapport par une formule de clôture de courtoisie.

Procédez comme suit :

1. Ajoutez une nouvelle ligne sous la balise d'ouverture body.

2. Collez ce qui suit :

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

3. Ajoutez une nouvelle ligne sous la ligne contenant la balise de fermeture de la table.

4. Collez ce qui suit :

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

Enregistrement et finalisation de votre travail

Cliquez sur Enregistrer le modèle pour enregistrer votre travail. Le code du modèle complété doit ressembler à ce qui suit.

<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>

Étape 3 : ajouter une liste de distribution

Ajoutez un fichier d'une liste de distribution sous l'onglet Destinataires ou Groupes dans la section Rapports de l'application. Assurez-vous que vous êtes ajouté par e-mail en tant que destinataire et que la liste de distribution ne contient pas de filtres ou de groupes.

Pour des informations sur les listes de distribution, voir Création d'une liste de distribution pour votre rapport.

Étape 4 : créer une tâche de rapport

Procédez comme suit :

1. Ouvrez l'onglet Tâches de rapport de la section Génération de rapports de l'application.

2. Cliquez sur Créer une tâche de rapport. La boîte de dialogue Tâche de rapport s'ouvre.

3. Saisissez un Titre pour la tâche de rapport.

4. Ajoutez éventuellement une Description.

   Dans l'onglet de la boîte de dialogue Modèle, cliquez sur Ajouter un modèle existant. Sélectionnez le modèle que vous avez développé ci-dessus.

5. Cliquez sur Next (Suivant). La boîte de dialogue passe à l'onglet Sortie.

6. Dans l'onglet de la boîte de dialogue Sortie, saisissez un Nom de fichier pour la sortie du rapport.

7. Cliquez sur Nouveau pour passer à l'onglet de boîte de dialogue Distribuer.

8. Ajoutez-vous en tant que destinataire de la sortie du rapport.

9. Sous E-mail, sélectionnez Rapport HTML. Cela permettra d'intégrer le rapport dans l'e-mail plutôt que de le joindre en tant que fichier.

10. Cliquez sur Suivant pour passer à l'onglet de boîte de dialogue Planification.

11. Sélectionnez les paramètres de planification par défaut et cliquez sur Enregistrer.

Étape 5 : envoyer le rapport

Procédez comme suit :

1. Restez dans l'onglet Tâches de rapport de la section Génération de rapports de l'application.

2. Cliquez sur à côté de la tâche de rapport.

3. Cliquez sur Envoyer maintenant.

Lorsque l'e-mail arrive, ouvrez-le pour voir le résultat.