Opzioni di stampa¶
Ogni risorsa di stampa ha delle opzioni di stampa, che vengono mostrate di default a prescindere o meno dalla presenza di un table_script_parameters_pane
al lancio della stampa:
Queste opzioni permettono di determinare il comportamento della stampa:
lanciando la stampa dal primo bottone
PDF
verrà infatti generato il pdf del documento, corredato da eventuali note, rinominato secondo quanto definito nel Nome del file, ed eventualmente restituito compresso in formato zipda
Server di stampa
è invece possibile lanciare fisicamente la stampa su una stampante di rete preventivamente configurataDa
PDF via e-mail
è possibile inviare ai destinatari desiderati la stampa in pdf come allegato a un’e-mailDall’ultimo bottone
Consegna Posta
, infine, è possibile inviare automaticamente il pdf al destinatario «oggetto» del record. Si noti che non è presente un campo «A», in quanto il destinatario verrà automaticamente individuato dal sistema. Per ogni destinatario, quindi, verrà inviato un pdf personalizzato contenente i dati del suo record.
Per sfruttare a pieno la potenzialità della Consegna Posta è sufficiente indicare come parametro della classe Main un mail_address
legato al record di cui si sta effettuando la stampa:
class Main(BaseResourcePrint):
mail_address='@anagrafica_id.email'
batch_print_modes = ['pdf','mail_deliver']
Si noti che nella seconda riga che abbiamo inserito stiamo personalizzando la lista delle opzioni di stampa: è infatti possibile personalizzare a piacere questa lista (in questo caso stiamo rimuovendo mail_pdf
e server_print
, mostrando quindi solo la stampa PDF di default e la Consegna Posta)
Suggerimento
È possibile effettuare ulteriori personalizzazioni ridefinendo nella propria risorsa print i metodi di hook:
table_script_options_pdf
,table_script_options_server_print
,table_script_options_mail_pdf
etable_script_options_mail_deliver
per specificare i parametri da inserire nel pane delle opzioniresult_handler_pdf
,result_handler_print
,result_handler_mail_pdf
eresult_handler_mail_deliver
per specificare il comportamento da tenere una volta eseguita la stampa
Parametri:
Nome parametro |
Tipo |
Descrizione |
---|---|---|
caption |
T |
Variabile globale OBBLIGATORIA, serve a fornire il nome con cui questo batch di stampa verrà mostrato dal menu delle stampe disponibili |
tags |
T |
Variabile globale facoltativa, serve a indicare i tag utente che potranno lanciare la stampe |
description |
T |
Variabile globale facoltativa, serve per fornire una descrizione ulteriore del batch |
batch_title |
T |
Attributo facoltativo, indica il titolo che sarà attribuito al batch nel monitor laterale dei batch in esecuzione. |
html_res |
T |
Attributo OBBLIGATORIO (a meno che la risorsa non venga indicata diversamente), indica la risorsa definizione di stampa associata. |
templates |
T |
Attributo facoltativo, permette di specificare il template che deve essere associato alla stampa (id o nome, es: con templates=”carta_intestata” mi riferisco al nome che è stato dato al template) |
batch_print_modes |
T |
Attributo facoltativo, permette di passare in una lista le modalità di stampa ammesse. Di default vengono offerte tutte quelle che è possibile specificare nelle preferenze dell’applicazione (es: batch_print_modes = [«pdf», «server_print», «mail_pdf»,»mail_deliver»]) |
batch_prefix |
T |
Attributo facoltativo, permette di assegnare un prefisso al batch |
batch_cancellable |
B |
Attributo facoltativo, di default False, permette di consentire l’interruzione del batch cliccando su «Stop» nella barra laterale durante l’esecuzione |
batch_immediate |
B |
Attributo facoltativo, se impostato uguale a “print” verrà immediatamente aperta la stampa una volta completata, se impostato uguale a “download” verrà automaticamente avviato il download del file, se infine impostato a True verrà invece identificata la modalità tra le due precedenti sulla base dei parametri inseriti all’avvio della stampa. |
mail_address |
T |
Permette di indicare la colonna del record da utilizzare per l’invio mail automatico in modalità mail_deliver (es: mail_address = “@anagrafica_id.email”) |
Table script parameters pane Parametri |
||
localize_to |
T |
Permette di indicare una lingua nella quale tradurre tutte le etichette delle griglie (colonne, subtotali, tutti i campi espressi con «!![en]Nome campo»). Es: localize_to=”en” |
translate_to |
T |
Permette di indicare una lingua nella quale tradurre tutti i valori della stampa. Es: translate_to=”en”. Richiede un service di traduzione esterno appositamente configurato |
use_current_selection |
B |
Permette di scegliere se usare o meno la selezione corrente |