Esempio: creazione di un report e-mail utilizzando un modello .html incorporato

In questo esempio, si mostra come creare e inviare un report incorporando un modello di report .html direttamente in un messaggio e-mail.

Requisiti

• Server SMTP connesso al tenant Qlik Cloud. Vedere: Configurazione dell'e-mail per i report e le notifiche

• Il ruolo di sicurezza Private Analytics Content Creator o il ruolo dello spazio sufficiente per lo sviluppo di report in uno spazio condiviso. Vedere: Autorizzazioni

Passaggio 1: caricamento delle sorgenti di esempio

Fare riferimento alle sorgenti delle app di esempio qui: Materiali di esempio: report in app. Caricare i file di app e dati in uno spazio, quindi ricaricare l'app; quindi, è possibile completare l'esempio.

Passaggio 2: sviluppo del modello

Creazione di un nuovo modello

Aggiunta di dati tabulari

Ora, aggiungere i dati tabulari al modello.

Procedere come indicato di seguito:

1. Fare clic su nel pannello degli oggetti.

2. Fare clic su Aggiungi tabella. Viene visualizzato un elenco dei fogli disponibili.

3. Espandere il foglio Sales Tables.

4. Fare clic sull'icona accanto al grafico Yearly Regional Sales.

5. Nel menu a discesa, selezionare Colonne individuali.

6. In Seleziona colonne da aggiungere, selezionare Tutte. Fare clic su Aggiungi.

   Il grafico viene aggiunto al modello come una struttura tabulare.

7. Dopo aver selezionato la nuova tabella, cambiare le seguenti proprietà della tabella nel pannello degli oggetti:

   • In Impostazioni tabella, disattivare Mantieni formati di origine.

   • Impostare l'opzione Visualizza intestazioni in Nascondi.

8. Nella tabella, aggiungere una nuova riga sopra la definizione della riga esistente. Aggiungere una nuova riga sotto la riga che contiene <tbody><tr>. Incollare i seguenti contenuti:

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

Applicazione di uno stile alla tabella

Successivamente, applicare uno stile agli elementi della tabella aggiungendo definizioni di stile in head .html, quindi applicare stili inline nella struttura table stessa.

Procedere come indicato di seguito:

1. Aggiungere una nuova riga sotto la definizione title per il modello.

2. Incollare i seguenti contenuti:

   <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. Posizionare la riga nella struttura table che definisce i dati. Dovrebbe apparire come segue:

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

4. Aggiungere style="text-align: center" al tag di apertura del primo elemento td. L'intera riga dovrebbe ora apparire come segue:

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

   In questo modo, il testo della prima colonna viene allineato in modo da essere al centro.

Aggiunta di un titolo dinamico

Quindi, creare un'espressione per memorizzare il calcolo dell'intervallo di anni per le vendite. Quindi, incorporare l'espressione nel titolo del report, in modo che venga incorporata come oggetto dell'e-mail.

Procedere come indicato di seguito:

1. Fare clic su nel pannello degli oggetti.

2. Fare clic su Aggiungi espressione.

3. Nel campo Nome, digitare YearRange.

4. Nel campo Espressione, Incollare la seguente espressione:

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

5. Fare clic su Crea.

6. Nell'area di progettazione, trovare l'elemento title. Sostituire l'intera riga con i seguenti elementi:

   <title>Sales Report: </title>

7. Nella riga appena incollata, posizionare il cursore dopo Sales Report:

8. Nel pannello degli oggetti, fare clic su Aggiungi tag espressione.

9. La riga dovrebbe ora essere:

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

Aggiungere istruzioni di apertura e di chiusura

Quindi, aggiungere un saluto e un'istruzione di apertura e concludere il report con degli ossequi di chiusura.

Procedere come indicato di seguito:

1. Aggiungere una nuova riga sotto il tag di apertura body.

2. Incollare i seguenti contenuti:

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

3. Aggiungere una nuova riga sotto la riga contenente il tag di chiusura della tabella.

4. Incollare i seguenti contenuti:

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

Salvataggio e finalizzazione del lavoro

Fare clic su Salva modello per salvare il proprio lavoro. Il codice del modello completato dovrebbe essere simile a quello riportato di seguito.

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

Passaggio 3: aggiunta di una lista di distribuzione

Aggiungere un file della lista di distribuzione nella scheda Destinatari o Gruppi della sezione Creazione di report nell'app. Assicurarsi di essere aggiunti tramite e-mail come destinatari e che la lista di distribuzione non contenga filtri o gruppi.

Per informazioni su come configurare le liste di distribuzione, vedere Creazione di una lista di distribuzione per il report.

Passaggio 4: creazione di un'attività di report

Procedere come indicato di seguito:

1. Aprire la scheda Attività di report nella sezione Creazione di report dell'app.

2. Fare clic su Crea attività di report. Viene visualizzata la finestra di dialogo dell'attività di report.

3. Inserire un Titolo per l'attività di report.

4. In via opzionale, aggiungere una Descrizione.

   Nella scheda della finestra di dialogo Modello, fare clic su Aggiungi modello esistente. Selezionare il modello sviluppato in precedenza.

5. Fare clic su Avanti. La finestra di dialogo visualizza la scheda Output.

6. Nella scheda della finestra di dialogo Output, digitare un Nome file per l'output del report.

7. Fare clic su Avanti per continuare fino alla scheda Distribuisci della finestra di dialogo.

8. Aggiungersi come destinatari all'output del report.

9. In E-mail, selezionare Report HTML. Questo incorporerà il report nel messaggio e-mail, anziché allegarlo come file.

10. Fare clic su Avanti per continuare fino alla scheda Pianifica della finestra di dialogo.

11. Selezionare le impostazioni di pianificazione predefinite e fare clic su Salva.

Passaggio 5: invii di report

Procedere come indicato di seguito:

1. Rimanere nella scheda Attività di report della sezione Creazione di report dell'app.

2. Fare clic su accanto all'attività del report.

3. Fare clic su Invia ora.

Quando arriva l'e-mail, aprirla per visualizzare il risultato.