Nyomtatás és exportálás a háttérben¶

Több száz számla egyszerre történő nyomtatása vagy több tízezer sor exportálása tovább tarthat, mint amennyit egy weboldal várakozhat: a böngésző ilyenkor hibát jelez, holott a kiszolgáló még dolgozik. Ennek elkerülésére a nagy nyomtatási és exportálási kérések a háttérben futnak: a felhasználó tovább dolgozhat, és értesítést kap, amikor a fájl letölthető.

Ezt a működést két modul biztosítja:

Asynchronous Report Printing (report_async_print) a PDF-riportokhoz;
Asynchronous List Export (export_async) a listanézetek exportjaihoz.

A feladatok végrehajtásához mindkettő a Job Queue modulra (queue_job) támaszkodik.

Nyomtatás a háttérben¶

A szokott módon jelölje ki a rekordokat egy listanézetben, és nyomtasson riportot a Nyomtatás menüből. Ha a kijelölt rekordok száma eléri a küszöbértéket (alapértelmezés szerint 20), a riport nem töltődik le közvetlenül. Ehelyett:

egy értesítés megerősíti, hogy a dokumentumok a háttérben készülnek;
amint a PDF elkészült, egy rögzített értesítés jelenik meg Letöltés gombbal, a felhasználó beérkező üzenetei közé pedig egy Report ready üzenet érkezik a fájlra mutató hivatkozással. Ha a generálás sikertelen volt, az értesítés és az üzenet a hibát tartalmazza.

A fájl később is letölthető a Nyomtatási feladatok ‣ Nyomtatási feladataim menüpontból, ahol minden feladatnál látható a riport, a modell, a rekordok száma és az állapot (Státusz: Sorban áll, Feldolgozás alatt, Kész vagy Sikertelen). Egy kész feladaton kattintson a Letöltés gombra a fájl letöltéséhez.

Megjegyzés

Ez csak a PDF-riportokat érinti. A kisebb kijelölések és a más típusú riportok a korábbiakhoz hasonlóan közvetlenül töltődnek le.
A riport annak a felhasználónak a hozzáférési jogaival készül, aki kérte.
A felhasználók csak a saját feladataikat látják; az adminisztrátorok (Adminisztráció: Beállítások) minden felhasználó feladatait látják.
A feladatok és fájljaik hét nap elteltével automatikusan törlődnek. Ha később is szükség van a fájlra, töltse le újra, vagy nyomtasson ismét.

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.

Konfiguráció¶

Lépjen a Beállítások ‣ Általános beállítások menüpontra, és görgessen le a Háttérben történő nyomtatás szakaszhoz. A Tömeges nyomtatás küszöbértéke mezőben adja meg azt a rekordszámot, amelytől a nyomtatás a háttérben fut. A háttérnyomtatás kikapcsolásához írjon be 0 értéket.

A küszöbérték riportonként felülbírálható: fejlesztői módban lépjen a Beállítások ‣ Technikai ‣ Akciók ‣ Kimutatások menüpontra, nyissa meg a riportot, és állítsa be az Aszinkron nyomtatási küszöbérték mezőt:

0: a globális küszöbérték használata;
pozitív szám: ennél a riportnál ez a küszöbérték érvényes, pl. alacsonyabb érték egy lassan elkészülő riporthoz;
-1: ez a riport soha ne nyomtatódjon a háttérben.

Megjegyzés

A globális küszöbértéket a böngésző az oldal betöltésekor olvassa be. Módosítása után a felhasználóknak újra kell tölteniük az oldalt, hogy az új érték érvénybe lépjen.

Exportálás a háttérben¶

A szokott módon exportálja egy listanézet rekordjait: jelölje ki a rekordokat (vagy a keresés összes rekordját), kattintson a Művelet ‣ Exportálás menüpontra, válassza ki a mezőket és a formátumot, majd kattintson az Exportálás gombra. Ha a rekordok száma eléri a küszöbértéket (alapértelmezés szerint 2000), az export a háttérben fut:

egy értesítés megerősíti, hogy az export készül;
a rekordok egymást követő kötegekben kerülnek exportálásra. Amikor a fájl elkészült, egy rögzített értesítés jelenik meg Letöltés gombbal, a felhasználó beérkező üzenetei közé pedig egy Export ready üzenet érkezik a fájlra mutató hivatkozással.

Az export előrehaladása az Exportok ‣ Exportjaim menüpontban követhető: a Feldolgozott rekordok oszlop mutatja, hogy a Rekordok közül eddig mennyi került exportálásra. Egy kész feladaton kattintson a Letöltés gombra a fájl letöltéséhez.

Megjegyzés

Az XLSX és a CSV formátum egyaránt támogatott, csakúgy, mint az Adatokat szeretnék frissíteni (importálással kompatibilis exportálás) lehetőség.
A csoportosított lista exportja a rekordok számától függetlenül mindig közvetlenül fut, kivéve, ha az import-kompatibilis lehetőség be van jelölve.
A feladatok láthatóságára és hét nap utáni automatikus törlésére ugyanazok a szabályok vonatkoznak, mint a nyomtatási feladatoknál.

Konfiguráció¶

Lépjen a Beállítások ‣ Általános beállítások menüpontra, és görgessen le a Háttér-export szakaszhoz:

Tömeges export küszöb: az a rekordszám, amelytől az export a háttérben fut (alapértelmezés szerint 2000). A háttérexport kikapcsolásához írjon be 0 értéket;
Chunk batch méret: a kötegenként feldolgozott rekordok száma (alapértelmezés szerint 200). Csökkentse, ha a nagy számítási igényű oszlopokat (például árlistaárakat) tartalmazó exportok meghiúsulnak vagy túl sokáig tartanak.

A nyomtatáshoz hasonlóan a küszöbérték módosítása után a felhasználóknak újra kell tölteniük az oldalt.

Feladatsor¶

A háttérfeladatokat a Job Queue modul (queue_job) hajtja végre; ez egy technikai modul, amelyet más funkciók is használnak a hosszú műveletek késleltetett végrehajtására.

A Job Queue Manager csoportba tartozó felhasználók hozzáférnek a Job Queue ‣ Queue ‣ Jobs menühöz, amely az adatbázis összes feladatát felsorolja az állapotukkal, a végrehajtási idejükkel és – sikertelen feladat esetén – a hibával együtt. Egy feladaton a Requeue Job, a Set to «Done» és a Cancel job gombbal lehet a sikertelen feladatot újra futtatni, illetve elvetni.

Fontos

A feladatok csak akkor hajtódnak végre, ha a feladatfuttató (job runner) engedélyezve van a kiszolgáló konfigurációjában. Ha a nyomtatási vagy exportálási feladatok Sorban áll állapotban maradnak, forduljon a rendszergazdához vagy a tárhelyszolgáltatóhoz.

Lásd még