Voorbeeld - een e-mailrapport maken met behulp van een ingesloten HTML-sjabloon

In dit voorbeeld maakt en verzendt u een rapport door een HTML-rapportsjabloon rechtstreeks in een e-mailbericht in te sluiten.

Vereisten

• E-mailprovider geconfigureerd voor de Qlik Cloud-tenant. Zie: E-mail configureren voor rapporten en meldingen

• De beveiligingsrol Private Analytics Content Creator of een geschikte ruimterol voor rapportontwikkeling in een gedeelde ruimte. Zie: Machtigingen

Stap 1: voorbeeldbronnen uploaden

Zie hier de voorbeeld-appbronnen: Voorbeeldmateriaal - In-app rapportage. Upload de app- en gegevensbestanden naar een ruimte en laad de app opnieuw. U bent klaar om het voorbeeld te voltooien.

Stap 2: de sjabloon ontwikkelen

Een nieuwe sjabloon maken

Tabelgegevens toevoegen

Voeg vervolgens tabelgegevens toe aan de sjabloon.

Doe het volgende:

1. Klik in het objectenvenster op .

2. Klik op Tabel toevoegen. Er wordt een lijst met beschikbare werkbladen weergegeven.

3. Vouw het werkblad Sales Tables uit.

4. Klik op het -pictogram naast het diagram Yearly Regional Sales.

5. Selecteer Afzonderlijke kolommen in het vervolgkeuzemenu.

6. Selecteer onder Kolommen selecteren om toe te voegen de optie Alles. Klik op Toevoegen.

   Het diagram wordt als een tabelstructuur toegevoegd aan de sjabloon.

7. Met de nieuwe tabel geselecteerd, wijzigt u de volgende eigenschappen voor de tabel in het objectenvenster:

   • Schakel onder Tabelinstellingen Bronformaten behouden uit.

   • Wijzig Kopteksten tonen in Verbergen.

8. Voeg in de tabel een nieuwe rij toe boven de bestaande rijdefinitie. Voeg een nieuwe regel toe onder de regel die <tbody><tr> bevat. Plak het volgende:

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

De tabel vormgeven

Stijl vervolgens de tabelelementen door stijldefinities toe te voegen in de HTML head en inline vormgeving in de table-structuur zelf.

Doe het volgende:

1. Voeg een nieuwe regel toe onder de title-definitie voor de sjabloon.

2. Plak het volgende:

   <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. Zoek de regel in de table-structuur die de gegevens definieert. Het zou er als volgt uit moeten zien:

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

4. Voeg style="text-align: center" toe aan de openingstag van het eerste td-element. De hele regel zou er nu zo uit moeten zien:

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

   Hiermee wordt de tekst in de eerste kolom gecentreerd.

Een dynamische titel toevoegen

Maak vervolgens een uitdrukking om de berekening van het jaarbereik voor uw verkopen op te slaan. Neem deze uitdrukking vervolgens op in de titel van het rapport, zodat deze als onderwerp in de e-mail wordt opgenomen.

Doe het volgende:

1. Klik in het objectenvenster op .

2. Klik op Uitdrukking toevoegen

3. Typ in het veld Naam YearRange.

4. Plak de volgende uitdrukking in het veld Uitdrukking:

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

5. Klik op Maken.

6. Zoek op het ontwerpoppervlak het title-element. Vervang de hele regel door het volgende:

   <title>Sales Report: </title>

7. Op de regel die u zojuist hebt geplakt, plaatst u uw cursor achter Sales Report:

8. Klik in het objectenvenster op Uitdrukkingstag toevoegen.

9. De regel zou nu als volgt moeten zijn:

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

Openings- en slotverklaringen toevoegen

Voeg vervolgens een slot- en openingsverklaring toe, en sluit het rapport af met een afsluitend compliment.

Doe het volgende:

1. Voeg een nieuwe regel toe onder de openingstag body.

2. Plak het volgende:

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

3. Voeg een nieuwe regel toe onder de regel met de eindtag voor de tabel.

4. Plak het volgende:

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

Uw werk opslaan en voltooien

Klik op Sjabloon opslaan om uw werk op te slaan. De voltooide sjablooncode zou er als volgt uit moeten zien.

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

Stap 3: een distributielijst toevoegen

Voeg een distributielijstbestand toe onder het tabblad Ontvangers of Groepen in de sectie Rapportage van de app. Zorg ervoor dat u per e-mail bent toegevoegd als ontvanger en dat de distributielijst geen filters of groepen bevat.

Zie Maak een distributielijst voor uw rapport voor informatie over distributielijsten.

Stap 4: een rapporttaak maken

Doe het volgende:

1. Open het tabblad Rapporttaken in de sectie Rapportage van de app.

2. Klik op Rapporttaak maken. Het dialoogvenster Rapporttaak wordt geopend.

3. Voer een titel in voor uw rapporttaak.

4. Voer desgewenst een beschrijving in.

   Op het tabblad Sjabloon klikt u op Bestaande sjabloon toevoegen. Selecteer de sjabloon die u hierboven hebt ontwikkeld.

5. Klik op Volgende. Het dialoogvenster gaat naar het tabblad Uitvoer.

6. Op het tabblad Uitvoer typt u een bestandsnaam voor de rapportuitvoer.

7. Klik op Volgende om verder te gaan naar het dialoogtabblad Distribueren.

8. Voeg uzelf als ontvanger toe aan de rapportuitvoer.

9. Selecteer onder E-mail HTML‑rapport. Hierdoor wordt het rapport in het e-mailbericht ingesloten in plaats van als bestand bijgevoegd.

10. Klik op Volgende om verder te gaan naar het dialoogvenster Planning.

11. Selecteer de standaard planningsinstellingen en klik op Opslaan.

Stap 5: het rapport verzenden

Doe het volgende:

1. Blijf op het tabblad Rapporttaken in de sectie Rapportage van de app.

2. Klik op naast de nieuwe rapporttaak.

3. Klik op Nu verzenden.

Wanneer de e-mail aankomt, opent u deze om het resultaat te zien.