.. /* * This file is part of the SavaPage project . * Copyright (c) 2026 Datraverse B.V. * Author: Rijk Ravestein. * * SPDX-FileCopyrightText: (c) 2020 Datraverse B.V. * SPDX-License-Identifier: CC-BY-SA-4.0 * * For more information, please contact Datraverse B.V. at this * address: info@datraverse.com */ .. _ch-webapp-jobtickets-open: Open Tickets ------------ .. contents:: |RST_TABLE_OF_CONTENTS| :depth: 2 :local: .. _ch-webapp-jobticket-open-select-and-sort: Select and Sort ~~~~~~~~~~~~~~~ .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-select-and-sort.png :alt: Job Tickets: Open Tickets - Select and Sort :width: 400px Job Tickets: Open Tickets - Select and Sort A list of pending Job Tickets is shown that refreshes automatically every 60 seconds. The tiny progress bar at the bottom of the |RST_BUTTON_SELECT_AND_SORT| section shows when the refresh is due. - You can pause/resume the refresh by toggling the tiny button at the left of the progress bar. - You can Quick Search Job Tickets for a single |RST_GUILABEL_USER_ID|. Leave empty to select all users. - You can Quick Search for a single |RST_GUILABEL_TICKET| Number. When a User ID is selected, tickets of just this user are shown. Leave empty to select all tickets. - Tickets are sorted in the following way: 1. |RST_BUTTON_ASCENDING| or |RST_BUTTON_DESCENDING| on |RST_GUILABEL_EXPIRATION| time. 2. Ascending on Submit Date. 3. Ascending on Job Ticket Creator. 4. Ascending on “chunk-index”. Tickets that have identical values for 1, 2 and 3, are part of a single chunk, and are displayed together, even if this exceeds the |RST_GUILABEL_NUMBER| limit of tickets shown. When a chunk contains more than one (1) ticket, the “chunk-index” and “chunk-size” are displayed for each ticket in the chunk. For example, for a chunk-size of 3, tickets in the chunk are marked as: “1 / 3”, “2 / 3” and “3 / 3” . - The |RST_GUILABEL_NUMBER| of tickets shown in the list is limited, and can be controlled with a slider. The slider range and default can be set with :ref:`configuration properties `. - At the bottom right, a small printer and copier icon is shown with the total number of pending print/copy tickets and number of sheets to be printed. .. _ch-webapp-jobticket-open-select-and-sort-group: Job Ticket Group ^^^^^^^^^^^^^^^^ .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-select-and-sort-group.png :alt: Job Tickets: Open Tickets - Group :width: 400px Job Tickets: Open Tickets - Group If one or more Job Ticket printers are member of a :ref:`Proxy Printer Group `, these groups can be used to select tickets. When a |RST_GUILABEL_GROUP| is selected, just the tickets from printers that are member of this group are shown. If no groups are defined in Job Ticket printers, the Group selection is not visible. .. _ch-webapp-jobticket-open-list: Open Ticket List ~~~~~~~~~~~~~~~~ .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-list.png :alt: Job Tickets: Open Tickets - List :width: 400px Job Tickets: Open Tickets - List Each Job Ticket in the list shows a summary of options. Some are marked with outstanding colors. - For instance, paper size (media) that differs from :ref:`Default Paper Size ` (usually A4 or Letter) is marked with an orange-brown color. When the page size of the PDF document to be printed differs from the Media Size of the print, both sizes are displayed. For instance, “A3 > A4 • Scaled” means that the PDF A3 source is scaled down to an A4 print. Below the details there are buttons for further actions. From left to right: - |RST_BUTTON_INFO_SYMBOL| *Settings* : shows a dialog with a summary of printer settings. - |RST_BUTTON_PERSON_SYMBOL| *Transactions* : shows the :ref:`Transactions Dialog ` with accounting details where number of copies can be edited. - |RST_BUTTON_PEN_SYMBOL| *Edit* shows : the :ref:`Edit Dialog `, so job options can be changed. - |RST_BUTTON_EYE_SYMBOL| *Preview* : downloads the PDF document to be printed. - |RST_BUTTON_CANCEL_SYMBOL| *Cancel* : shows a dialog to confirm cancellation of the Ticket. A reason can be entered. After cancellation the user is optionally notified by email or a :ref:`Notification Plug-in `: see :ref:`Job Ticket Configuration Properties `. - |RST_BUTTON_SHOP_SYMBOL| *Settle* : shows the :ref:`Settle Dialog `, so the job can be charged, when not printed from the :ref:`Print Dialog `, but from the PDF viewer, after |RST_BUTTON_EYE_SYMBOL|. - |RST_BUTTON_EXIT_SYMBOL| *Print* : shows a :ref:`Print Dialog ` with compatible printers to redirect the job to. .. note:: When pop-up dialogs are visible, automatic list refresh is paused. .. note:: :ref:`Reopened Job Tickets ` are marked as such. .. _ch-webapp-jobticket-bulk-actions: Job Ticket Bulk Actions ~~~~~~~~~~~~~~~~~~~~~~~ The *scope* of the |RST_BUTTON_CANCEL_SYMBOL| *Cancel All*, |RST_BUTTON_EXIT_SYMBOL| *Print All* and |RST_BUTTON_CHECKMARK_SYMBOL| *Close All* actions is the *visible* list selection. This bulk action must be confirmed in a pop-up. .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-cancel-all.png :alt: Job Tickets: Cancel All :width: 350px Job Tickets: Cancel All .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-print-all.png :alt: Job Tickets: Print All :width: 350px Job Tickets: Print All .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-close-all.png :alt: Job Tickets: Close All :width: 350px Job Tickets: Close All The |RST_BUTTON_CANCEL_SYMBOL| *Cancel All* and |RST_BUTTON_CHECKMARK_SYMBOL| *Close All* actions are enabled by default and can be disabled by setting a :ref:`configuration property `. The |RST_BUTTON_EXIT_SYMBOL| *Print All* action selects a random compatible printer from the :ref:`Job Ticket Proxy Printer Group ` for each Job Ticket. - The selected printer *must* support automatic media source selection, since this option will be used for the print job. In this way, media (implicitly) selected through the job ticket media-source, will be printed from the intended tray. - The |RST_BUTTON_EXIT_SYMBOL| *Print All* is enabled by default and can be disabled by setting a :ref:`configuration property `. .. _ch-webapp-jobticket-transactions: Job Ticket Transactions ~~~~~~~~~~~~~~~~~~~~~~~ This dialog pops up after pressing the |RST_BUTTON_PERSON_SYMBOL| *Transactions* button in a :ref:`Job Ticket List Item `. .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-transactions.png :alt: Job Tickets: Transactions :width: 400px Job Tickets: Transactions The number of copies for each account can be edited. If a number is changed, its transaction cost is hidden and the |RST_BUTTON_APPLY| and |RST_BUTTON_RESET| buttons are enabled. .. note:: A single Personal account transaction is display only. Its copies can be edited in the Job Ticket :ref:`Edit Dialog ` as job option. .. _ch-webapp-jobticket-edit: Job Ticket Edit ~~~~~~~~~~~~~~~ This dialog pops up after pressing the |RST_BUTTON_PEN_SYMBOL| *Edit* button in a :ref:`Job Ticket List Item `. .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-edit.png :alt: Job Tickets: Edit Ticket :width: 350px Job Tickets: Edit Ticket Job Ticket Options can be changed (overruled) by the Job Ticket Operator. Costs are recalculated after |RST_BUTTON_SAVE|. .. note:: |RST_GUILABEL_DOCUMENT| displays the page size of the PDF source document. The number of |RST_GUILABEL_COPIES| can *not* be edited when :ref:`Print Delegation ` is applied for *more than one* account. So, as long as a single account is involved the number of copies can be edited. |RST_GUILABEL_PAGE_SCALING| displays the selected value of the :ref:`print-scaling ` option. .. important:: For :ref:`Reopened Job Tickets ` all options are read-only, except for the number of copies. .. _ch-webapp-jobticket-print: Job Ticket Print ~~~~~~~~~~~~~~~~ This dialog pops up after pressing the |RST_BUTTON_EXIT_SYMBOL| *Print* button in a :ref:`Job Ticket List Item `. .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-print.png :alt: Job Tickets: Print Ticket :width: 400px Job Tickets: Print Ticket Redirect printers are shown from the Job Ticket Proxy Printer Group, that are compatible with ticket options. See :ref:`Proxy Printer Identity `. A selected printer may support the following settings, from top to bottom: - :ref:`Job Sheet Media Source ` : pick a source that is configured on the printer to hold the job sheet media-type. - :ref:`media-type ` : This setting is taken from the Ticket. It is a fixed choice in this context and can only be changed in the Ticket :ref:`Edit Dialog `. It is displayed for the operator to verify that the correct media type is loaded in the target media source. - :ref:`media-source `: pick a source that is configured on the printer to hold the media-type. - :ref:`output-bin `: pick a suitable output bin. - :ref:`org.savapage-finishings-jog-offset ` : select a finishing that shifts “Each Set” in the :ref:`output-bin ` from the previous one by a small amount (or chose “none”). After pressing the |RST_BUTTON_EXIT_SYMBOL| *Print* button, :ref:`constraints ` are validated. When settings are valid, the dialog closes, and the status of the Ticket will be shown in the list as either :ref:`Pending, Processing `, or :ref:`Completed `. .. note:: Printer settings are saved in the Web Session, and used as default for next Job Ticket prints. - The last selected printer is used as default for the next print. - The last jog-offset choice is used as default for *all* printers. - The last media-source choice of a printer is used as default, if the requested media size can be assigned to this media-source. If not, the first (*preferred*) media-source that is compatible with the requested media size is used. See :ref:`Media Sources `. .. _ch-webapp-jobticket-print-pending: Job Ticket Print Pending ^^^^^^^^^^^^^^^^^^^^^^^^ .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-print-pending.png :alt: Job Tickets: Print Pending :width: 400px Job Tickets: Print Pending When status is |RST_GUILABEL_PENDING|, the job is waiting to be printed. By pressing |RST_BUTTON_CANCEL|, the job will be removed from the print queue and the Ticket will show status :ref:`Canceled ` in the list. Optionally the Print Job Supplier and Print Status Supplier are shown at the bottom. In the example below SavaPage supplied the job and PaperCut, as external print manager, supplied the status. When SavaPage supplies both Print Job and Status, this information is not shown. .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-print-pending-ext.png :alt: Job Tickets: Print Pending (external) :width: 200px Job Tickets: Print Pending (external) .. note:: The top right corner of the job ticket entry displays the elapsed time since the Print command was issued. .. _ch-webapp-jobticket-print-processing: Job Ticket Print Processing ^^^^^^^^^^^^^^^^^^^^^^^^^^^ When the job is actually printing, status |RST_GUILABEL_PENDING| changes to |RST_GUILABEL_PROCESSING|. By pressing |RST_BUTTON_CANCEL| printing is stopped, the job is removed from the print queue, and the Ticket will show status :ref:`Canceled ` in the list. .. _ch-webapp-jobticket-print-canceled: Job Ticket Print Canceled ^^^^^^^^^^^^^^^^^^^^^^^^^ .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-print-canceled.png :alt: Job Tickets: Print Canceled :width: 400px Job Tickets: Print Canceled The print job is canceled. By pressing |RST_BUTTON_CHECKMARK_SYMBOL| *Close*, the Ticket is closed and removed from the list, and the user is optionally notified by email or a :ref:`Notification Plug-in `. Press |RST_BUTTON_EXIT_SYMBOL| *Retry* to :ref:`Print ` again, optionally to another printer. .. _ch-webapp-jobticket-print-completed: Job Ticket Print Completed ^^^^^^^^^^^^^^^^^^^^^^^^^^ .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-print-completed.png :alt: Job Tickets: Print Completed :width: 400px Job Tickets: Print Completed When a ticket has been Completed, the proxy print succeeded and the print costs have been settled successfully with the relevant accounts. By pressing |RST_BUTTON_CHECKMARK_SYMBOL| *Close*, the Ticket is closed and removed from the list, and the user is optionally notified by email or a :ref:`Notification Plug-in `: see :ref:`Job Ticket Print `. Optionally the Print Job Supplier and Print Status Supplier are shown at the bottom. See remarks at :ref:`Job Ticket Print Pending `. .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-print-completed-ext.png :alt: Job Tickets: Print Completed (external) :width: 200px Job Tickets: Print Completed (external) .. _ch-webapp-jobticket-settle: Job Ticket Settle ~~~~~~~~~~~~~~~~~ This dialog pops up after pressing the |RST_BUTTON_SHOP_SYMBOL| *Settle* button in a :ref:`Job Ticket List Item `. .. figure:: ../images/manual/screenshots/admin/sp-00-jobtickets-settle.png :alt: Job Tickets: Settle Ticket :width: 400px Job Tickets: Settle Ticket After |RST_BUTTON_SHOP_SYMBOL| *Settle*, the ticket is effectuated without proxy printing. This implements the scenario where the Job Ticket Operator prints the attached PDF with an external program, and registers the printing occurrence (including financial cost) in |PRODUCT_NAME|. After settlement, the Ticket is automatically closed and removed from the list. And, the user is optionally notified by email or a :ref:`Notification Plug-in `: see :ref:`Job Ticket Print `. .. note:: Settle is the only option to charge a Copy Job Ticket.