Tipărire și export în fundal

Tipărirea a sute de facturi simultan sau exportul a zeci de mii de linii poate dura mai mult decât are voie să aștepte o pagină web: browserul afișează atunci o eroare, deși serverul încă lucrează. Pentru a evita acest lucru, cererile mari de tipărire și export sunt executate în fundal: utilizatorul poate continua să lucreze și este notificat când fișierul este gata de descărcare.

Două module asigură acest comportament:

  • Asynchronous Report Printing (report_async_print), pentru rapoartele PDF;

  • Asynchronous List Export (export_async), pentru exporturile vizualizărilor de tip listă.

Ambele se bazează pe modulul Job Queue (queue_job) pentru executarea sarcinilor.

Tipărire în fundal

Selectați înregistrările într-o vizualizare listă și tipăriți un raport din meniul Tipărește, ca de obicei. Când numărul de înregistrări selectate atinge pragul (20 în mod implicit), raportul nu este descărcat direct. În schimb:

  1. o notificare confirmă că documentele sunt pregătite în fundal;

  2. când PDF-ul este gata, este afișată o notificare persistentă cu un buton Descarcă, iar un mesaj Raport gata cu un link către fișier este trimis în inbox-ul utilizatorului. Dacă generarea a eșuat, notificarea și mesajul conțin în schimb eroarea.

Fișierul poate fi descărcat și mai târziu de la Sarcini de tipărire ‣ Sarcinile mele de tipărire, unde fiecare sarcină afișează raportul, modelul, numărul de înregistrări și Stare (În așteptare, Procesare, Efectuat sau Eșuat). Faceți clic pe Descarcă la o sarcină efectuată pentru a obține fișierul.

Notă

  • Sunt vizate doar rapoartele PDF. Selecțiile mai mici și celelalte tipuri de rapoarte sunt descărcate direct, ca înainte.

  • Raportul este generat cu drepturile de acces ale utilizatorului care l-a solicitat.

  • Utilizatorii văd doar propriile sarcini; administratorii (Administrare: Setări) văd sarcinile tuturor utilizatorilor.

  • Sarcinile și fișierele lor sunt șterse automat după șapte zile. Descărcați din nou fișierul sau tipăriți din nou, dacă este necesar mai târziu.

screenshot: essentials-background-jobs-print-notification
menu
Accounting ‣ Customers ‣ Invoices (30 invoices selected, Print ‣ Invoices)
shows
The invoice list with the green sticky notification "Your document … is ready." and its Download button in the top-right corner.
highlight
The notification (red frame).
data
30 posted customer invoices selected.
module
report_async_print
notes
English UI, light theme, 1440px width.

Configurare

Accesați Setări ‣ Setări generale și derulați până la secțiunea Tipărire în fundal. În câmpul Prag de tipărire în masă, introduceți numărul de înregistrări de la care tipărirea se execută în fundal. Introduceți 0 pentru a dezactiva tipărirea în fundal.

Pragul poate fi suprascris pentru fiecare raport în parte: în modul dezvoltator, accesați Setări ‣ Tehnic ‣ Acțiuni ‣ Rapoarte, deschideți raportul și setați câmpul Prag de tipărire asincronă:

  • 0: se utilizează pragul global;

  • un număr pozitiv: se utilizează acest prag pentru acest raport, de ex. unul mai mic pentru un raport a cărui generare este lentă;

  • -1: acest raport nu este niciodată tipărit în fundal.

Notă

Pragul global este citit de browser la încărcarea paginii. După modificarea lui, utilizatorii trebuie să reîncarce pagina pentru ca noua valoare să fie luată în considerare.

Export în fundal

Exportați înregistrările unei vizualizări listă ca de obicei: selectați înregistrările (sau toate înregistrările căutării), faceți clic pe Acțiune ‣ Exportă, alegeți câmpurile și formatul și faceți clic pe Exportă. Când numărul de înregistrări atinge pragul (2.000 în mod implicit), exportul se execută în fundal:

  1. o notificare confirmă că exportul este în curs de pregătire;

  2. înregistrările sunt exportate în loturi succesive. Când fișierul este complet, este afișată o notificare persistentă cu un buton Descarcă, iar un mesaj Export gata cu un link către fișier este trimis în inbox-ul utilizatorului.

Progresul unui export poate fi urmărit la Joburi de export ‣ Joburile mele de export: coloana Decalaj progres arată câte dintre Înregistrări au fost exportate până în prezent. Faceți clic pe Descarcă la un job efectuat pentru a obține fișierul.

Notă

  • Sunt acceptate atât formatele XLSX, cât și CSV, precum și opțiunea Vreau să actualizez datele (export compatibil cu importul).

  • Exportul unei liste grupate se execută întotdeauna direct, indiferent de numărul de înregistrări, cu excepția cazului în care este bifată opțiunea compatibilă cu importul.

  • Vizibilitatea sarcinilor și ștergerea lor automată după șapte zile respectă aceleași reguli ca în cazul sarcinilor de tipărire.

Configurare

Accesați Setări ‣ Setări generale și derulați până la secțiunea Export în fundal:

  • Prag export în masă: numărul de înregistrări de la care un export se execută în fundal (2.000 în mod implicit). Introduceți 0 pentru a dezactiva exportul în fundal;

  • Dimensiune lot de fragmente: numărul de înregistrări procesate per lot (200 în mod implicit). Reduceți-l dacă exporturile care conțin coloane calculate complexe, precum prețurile din listele de prețuri, eșuează sau durează prea mult.

La fel ca la tipărire, utilizatorii trebuie să reîncarce pagina după modificarea pragului.

Coadă de sarcini

Sarcinile în fundal sunt executate de modulul Job Queue (queue_job), un modul tehnic utilizat și de alte funcționalități pentru a amâna operațiunile lungi.

Utilizatorii care aparțin grupului Manager coadă de sarcini au acces la meniul Coadă de joburi ‣ Coadă ‣ Joburi, care listează toate sarcinile din baza de date cu starea, timpul de execuție și, pentru o sarcină eșuată, eroarea. Dintr-o sarcină, butoanele Repune în coadă sarcina, Setează ca „Finalizat” și Anulează jobul permit rularea din nou a unei sarcini eșuate sau renunțarea la ea.

Important

Sarcinile sunt executate numai dacă runner-ul de sarcini este activat în configurația serverului. Dacă sarcinile de tipărire sau de export rămân în starea În așteptare, contactați administratorul de sistem sau furnizorul de găzduire.

Vezi și