Programmare un Report Settimanale

In questo tutorial programmi un report di manutenzione che si genera e si consegna ogni lunedì senza intervento umano.

Prerequisiti

Ti serve:

• Un account email verificato (o un numero WhatsApp connesso).
• Un branding salvato (opzionale ma consigliato) — vedi Brandings.
• Una lista di destinatari (email o telefoni).
• ~15 minuti.

Passo 1 — Preparare il branding

Se non l'hai già fatto:

1. Amministrazione → Marchi e Loghi → Nuovo.
2. Caricare il logo, definire i colori dell'header, impostare il testo del footer.
3. Marcarlo come default del tenant.
4. Salvare.

Se hai già un default, saltare al Passo 2.

Passo 2 — Creare il report programmato

1. Dati → Report Programmati → Nuovo.
2. Nome: "Manutenzione settimanale — Impianto Nord".
3. Frequenza: weekly.
4. Ora: 7 (UTC). Adattare al tuo fuso — 7 UTC = 8 in Italia (ora legale: 9).
5. Giorno: Lunedì (day_of_week=0).
6. Canale: email.
7. Account email: selezionare l'account verificato.
8. Destinatari: direzione@tua-azienda.com, manutenzione@tua-azienda.com.
9. Branding: selezionare quello del Passo 1 (o lasciare vuoto se ne hai già uno come default).

Passo 3 — Definire la struttura del report

Usare l'editor a blocchi. Struttura suggerita:

1. Blocco key-value
   - Impianto: Nord
   - Periodo: ultima settimana
   - Responsabile: Coordinatore manutenzione

2. Heading: "Attività completate questa settimana"

3. Tabella (fonte: collezione `tasks`, filtro: ultima settimana, status=completed)
   - Colonne: task_code, titolo, asset, tecnico, durata

4. Heading: "Allarmi critici"

5. Tabella (fonte: _alerts, filtro: ultima settimana, severity=critical)
   - Colonne: asset_id, first_seen_at, count, status

6. Heading: "KPI del periodo"

7. Key-value: disponibilità, MTTR, MTBF, attività completate

Passo 4 — Testare l'esecuzione

Prima di attivare, verificare che tutto funzioni:

1. Nel dettaglio del report programmato, clic su Esegui ora.
2. Aprire l'email che arriva ai destinatari di prova.
3. Controllare:
   • Il branding si applica correttamente (logo, colori).
   • Le tabelle hanno dati.
   • Il titolo e le date sono coerenti.

Se qualcosa va storto, modificare la struttura e rieseguire.

Passo 5 — Attivare

1. Toggle Abilitato su on.
2. Salvare.

Il prossimo lunedì alle 7 UTC il sistema genera il PDF e lo invia ai destinatari automaticamente.

Passo 6 — Verificare la cronologia

Una settimana dopo:

1. Dati → Report Programmati → aprire il report.
2. Scheda Esecuzioni.
3. Vedere:
   • L'esecuzione del lunedì passato con stato ok.
   • Il signed_url del PDF consegnato (click per ri-scaricare).
   • I destinatari effettivi.

Tips

• Se il report arriva con tabelle vuote, controllare i filtri della collezione — "ultima settimana" può comportarsi male se il sistema non ha timezone configurato.
• Per cambiare branding o destinatari: modificare il report programmato. La prossima esecuzione applica i cambiamenti automaticamente.
• Per mettere in pausa senza eliminare: toggle Abilitato su off. Riattivarlo riprende il calendario.

Vedi data/scheduled-reports per parametri completi e casi avanzati.