Pianificare e inviare

Un report disegnato è un report che qualcuno deve andare a prendere. Le pianificazioni risolvono il caso più comune senza scrivere una riga di codice: "il pipeline commerciale va alla direzione tutti i lunedì alle 8".

"Inviare questo report per email, da solo, all'ora stabilita." Questo, e niente di più — chi ha bisogno di più lo fa con uno script, e questa pagina spiega quando.

Restiamo nel report Oportunidades por conta dell'app Gestione Clienti, con la pianificazione Pipeline de segunda-feira.

#Le pianificazioni di un report

Le pianificazioni vivono dentro il report stesso: apri il report e guarda in fondo alla colonna di sinistra, nella sezione Pianificazioni. Ogni riga è un invio programmato, con il riepilogo sotto il nome — l'ora, il fuso, il formato e a chi va.

Una pianificazione spenta compare marcata come disattivato. Le icone a destra di ogni riga servono a modificare e a cancellare.

In un report che ancora non ne ha nessuna, l'elenco mostra "Nessuna pianificazione." e non resta che creare la prima:

#Creare una pianificazione

1. Apri il report e clicca sul + della sezione Pianificazioni (o sul pulsante Aggiungi pianificazione, in fondo all'elenco).
2. Compila la scheda.
3. Clicca su Salva.

#Quando

Campo	Note
Nome	Identifica la pianificazione. È con quello che compare nella cronologia.
Frequenza	Giornaliera, settimanale o mensile.
All'ora	L'ora dell'invio.
Giorni (frequenza giornaliera)	Tutti, Feriali o Fine settimana.
Giorno della settimana (frequenza settimanale)	Da Lun a Dom.
Giorno del mese (frequenza mensile)	Da 1 a 31.
Fuso orario	Per impostazione predefinita Europe/Lisbon. È in questo fuso che l'ora viene letta.

#Cosa

Campo	Note
Formato	PDF o Excel.
Parametri	Un campo per ogni parametro che il report dichiara. È con questi valori che viene eseguito.
Attivo	Disattivato, la pianificazione resta registrata ma non scatta.

Nell'esempio, il parametro Fase è compilato con Proposta e Fecho a partir de resta vuoto — lo stesso report serve più pianificazioni, ciascuna con il suo taglio.

#A chi

Ci sono tre modi di indicare la destinazione, e si possono usare tutti e tre insieme:

Campo	Note
A	"Indirizzi email separati da virgola." Per chi non ha un account nell'app.
Utenti	"Utenti dell'app. Va all'email del loro record; chi non ne ha resta fuori."
Ruoli	"Tutti gli utenti con questo ruolo. Scegliere il ruolo invece dell'indirizzo mantiene la pianificazione corretta quando qualcuno entra o esce."

#L'email

Oggetto è la riga dell'email; vuoto, usa il nome del report. Messaggio apre un editor apposito per il corpo:

Il report va in allegato, nel formato scelto, con il nome del documento. Il corpo è solo il messaggio che lo accompagna.

#Cosa succede all'ora stabilita

1. Il report viene generato sul server, con i parametri della pianificazione.
2. Il file viene allegato a un'email e inviato tramite il canale email dell'app.
3. Resta registrato quello che è successo: il file generato e quanti destinatari lo hanno accettato.

Se qualcosa va storto — il report fallisce, il canale email non è configurato, un destinatario non ha indirizzo — resta registrato e il pianificatore prosegue. Un invio che fallisce non blocca gli altri.

Anche una pianificazione senza destinatari non invia — resta registrato "senza destinatari" e non succede niente.

#Quando una pianificazione non basta

La scorciatoia copre il caso comune. Ti serve uno script Python quando vuoi:

• inviare solo se ci sono righe ("non mandare il prospetto dei ritardi se non ci sono ritardi");
• un'email per cliente, ciascuna con il suo taglio;
• salvare il file da un'altra parte invece di inviarlo;
• generare il documento a metà di un processo più grande.

L'SDK degli script fa esattamente questo:

from api_manager import reports, notify

r = reports.render("Oportunidades por conta", {"fase": "Proposta"})
notify.email(
    "Pipeline della settimana",
    to=["direccao@exemplo.pt"],
    attachments=[{"filename": r["filename"], "content": r["base64"]}],
)

reports.render(...) riceve il nome o l'identificatore del report, i parametri che esso dichiara e il formato ("pdf", per impostazione predefinita, oppure "xlsx"), e restituisce il file pronto da salvare o da allegare. Da lì in poi, la pianificazione è quella dello script — con tutte le opzioni che hanno le Pianificazioni degli script, incluso il recupero di quello che è rimasto da eseguire.

#Generare un report da altri punti

Oltre alle pianificazioni e agli script, un report può essere generato:

Da dove	Come
Una schermata dell'app	In un evento TypeScript, con l'SDK delle schermate — apre il PDF all'utente o restituisce i byte per dargli un'altra destinazione.
Un workflow	Il passaggio Email allega un report, generato al momento dell'invio per il record di quell'esecuzione. Vedi Passaggi, decisioni e attese.
Il disegno	I pulsanti Anteprima ed Excel, per controllare mentre si disegna.

In tutti i casi, il report viene eseguito con le autorizzazioni di chi lo chiede: un utente vede nel documento solo i record che vedrebbe nelle schermate. L'ambito dei dati viene applicato sul server, anche nei report.

#Domande frequenti

La pianificazione è attiva e non ho ricevuto niente. Controlla, in quest'ordine: il canale email dell'app è attivo e testato; la pianificazione ha destinatari; i destinatari hanno un'email nel loro record; il report viene eseguito senza errori (usa l'Anteprima con gli stessi parametri).

L'ora è giusta ma è arrivato un'ora dopo. Il Fuso orario della pianificazione è quello che comanda, non quello del server né quello di chi legge. Controlla che sia su Europe/Lisbon (o sul fuso che vuoi).

Posso mandare lo stesso report a due ore diverse? Sì — crea due pianificazioni nello stesso report, ciascuna con il suo nome, ora, destinatari e parametri.

Ho cancellato una pianificazione per sbaglio. Non si può tornare indietro. Ricreala: una pianificazione è solo una scheda con ora e destinatari, e ci vuole un minuto.