.. /* * 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-user-main-log: Log --- .. contents:: Table of Contents :depth: 2 :local: A *tap* on the |RST_BUTTON_LOG| button in the main SafePages view shows the Document Log. See :ref:`SafePages `. .. _ch-webapp-user-main-log-documents: Documents ~~~~~~~~~ The Document Log shows all documents the user printed to PRODUCT_NAME, and which were subsequently exported or Proxy-Printed. For a detailed description of this screen see :ref:`Documents ` in the Admin Web App chapter. Some Document |RST_BUTTON_TYPE| selections are *hidden*, depending on user :ref:`role `, :ref:`privileges ` and resource (Queue, Printer) availability. - Type |RST_BUTTON_PDF| is hidden when user has no privileges to Send and Download SafePages. - Type |RST_BUTTON_TICKET| is hidden when user is not a Job Ticket Creator. - Type |RST_BUTTON_PRINT| is hidden when user is not a Print Job Creator, or has no access to a printer. The following configuration property applies: .. _tbl-config-props-user-doclog-select: .. list-table:: Document Type Select: Configuration Property :width: 100% :widths: 46 54 :header-rows: 1 * - Configuration property - Description * - webapp.user.doclog.select.type.default-order - A comma separated priority list of enum values ``ALL``, ``IN``, ``OUT``, ``PDF``, ``PRINT``, ``TICKET``, that correspond to Document Type selection options. When this list is empty, ``ALL`` is assumed. |br| |br| The default |RST_BUTTON_TYPE| selection is the first value from the list that corresponds to a visible select option. |br| |br| To comply to 🇪🇺 EU GDPR ("Right for a data subject to receive personal data concerning them"), ``IN`` and ``OUT`` types are always available, so full history can be queried regardless of current status. See |RST_LINK_CONFIG_EDITOR| on how to set these items. The |RST_BUTTON_LETTERHEAD| selection is hidden when user has no Letterhead privileges. The |RST_BUTTON_QUEUE| selection does not hold disabled or inactive (reserved) queues (/mailprint, /webprint). The |RST_BUTTON_PRINTER| selection holds accessible Printers only (Job Ticket "Printers" are not shown). .. _ss-user-log-documents: .. figure:: ../images/manual/screenshots/user/sp-01-06-user-documents.png :alt: User Web App: Log - Documents :width: 400px User Web App: Log - Documents .. figure:: ../images/manual/screenshots/user/sp-01-06-user-document-transactions.png :alt: User Web App: Log - Document Transactions :width: 400px User Web App: Log - Document Transactions Press the transaction button in the document item to see invoicing details. Press the Transactions button in the footer bar to view the :ref:`Transaction List `, and the |RST_BUTTON_GDPR| button to view the :ref:`GDPR Dialog `. .. note:: Depending on :ref:`User Privileges ` the Transactions button might not be present. .. _ch-webapp-user-main-log-documents-queue-journal: |QUEUE_JOURNAL| ^^^^^^^^^^^^^^^ If the |QUEUE_JOURNAL| function is enabled a print-in document is journaled, as indicated by a small icon at the left of the document title. See :ref:`Document Store ` and :ref:`Edit Queue `. .. figure:: ../images/manual/screenshots/user/sp-01-06-user-document-queue-journal.png :alt: User Web App: Log - Queue Journal :width: 400px User Web App: Log - Queue Journal Depending on :ref:`User Privileges ` buttons are displayed to Download, Select (add to or replace the SafePages) and Delete the journal. .. note:: When viewed in the :ref:`Admin Web App ` the journal can *not* be Selected. .. _ch-webapp-user-main-log-transactions: Transactions ~~~~~~~~~~~~ The Transaction Log shows the financial transactions on the user's account. .. figure:: ../images/manual/screenshots/user/sp-01-06-user-transactions.png :alt: User Web App: Log - Transactions :width: 400px User Web App: Log - Transactions Each entry in the list has the following lines. - A header with the transaction type. - The resulting account balance with the transaction amount. - Extra information is added depending on the transaction type. - A Manual Transaction denotes the Receipt Number in the header and has a |RST_BUTTON_RECEIPT| button to download the receipt as PDF. Some samples of other transactions: .. _ss-user-log-transaction-savapage-user-account: .. figure:: ../images/manual/screenshots/user/sp-01-06-user-transaction-savapage-user-account.png :alt: User Web App: Log - SavaPage User Account Transaction :width: 400px User Web App: Log - SavaPage User Account Transaction - If :ref:`PaperCut Personal User Account ` is enabled, the amount is prefixed with a SavaPage icon. .. _ss-user-log-transaction-proxy-print-papercut: .. figure:: ../images/manual/screenshots/user/sp-01-06-user-transaction-proxy-print-papercut.png :alt: User Web App: Log - Proxy Print PaperCut Transaction :width: 400px User Web App: Log - Proxy Print PaperCut Transaction - A |PROXYPRINT| to a PaperCut managed printer where PaperCut :ref:`Printer Costs ` were leading. - Note the SavaPage (print supplier) and PaperCut (third-party print manager) icons. - For a sample screenshot of the document log, see :ref:`Admin Web App: Document - Proxy Print PaperCut Costs `. .. _ss-user-log-transaction-ipp-routing: .. figure:: ../images/manual/screenshots/user/sp-01-06-user-transaction-ipp-routing.png :alt: User Web App: Log - IPP Routing Transaction :width: 400px User Web App: Log - IPP Routing Transaction - A Printer Usage transaction due to :ref:`IPP Routing `, with QR code “1fa51673-...” delivered by an :ref:`IPP Routing Plug-in `. - Note that in this case :ref:`PaperCut Personal User Account ` is enabled, since the amount is prefixed with a SavaPage icon. .. _ss-user-log-transaction-voucher: .. figure:: ../images/manual/screenshots/user/sp-01-06-user-transaction-voucher.png :alt: User Web App: Log - Voucher Transaction :width: 400px User Web App: Log - Voucher Transaction .. _ss-user-log-transactions-payment-gateway: .. figure:: ../images/manual/screenshots/user/sp-01-06-user-transaction-creditcard.png :alt: User Web App: Log - Payment Gateway Transactions (creditcard) :width: 400px User Web App: Log - Payment Gateway Transactions (creditcard) .. figure:: ../images/manual/screenshots/user/sp-01-06-user-transaction-ideal.png :alt: User Web App: Log - Payment Gateway Transactions (ideal) :width: 400px User Web App: Log - Payment Gateway Transactions (ideal) .. figure:: ../images/manual/screenshots/user/sp-01-06-user-transaction-mistercash.png :alt: User Web App: Log - Payment Gateway Transactions (mistercash) :width: 400px User Web App: Log - Payment Gateway Transactions (mistercash) .. _ss-user-log-transaction-transfer: .. figure:: ../images/manual/screenshots/user/sp-01-06-user-transaction-transfer-to.png :alt: User Web App: Log - User Transfer Transaction (to) :width: 400px User Web App: Log - User Transfer Transaction (to) .. figure:: ../images/manual/screenshots/user/sp-01-06-user-transaction-transfer-from.png :alt: User Web App: Log - User Transfer Transaction (from) :width: 400px User Web App: Log - User Transfer Transaction (from) Push the |RST_BUTTON_DOCUMENTS| button in the footer bar to view the :ref:`Document List `, and the |RST_BUTTON_GDPR| button to view the :ref:`GDPR Dialog `. .. _ss-user-log-transactions-select-and-sort: .. figure:: ../images/manual/screenshots/user/sp-01-06-user-transactions-select-and-sort.png :alt: User Web App: Log - Transactions :width: 400px User Web App: Log - Transactions Transactions can be filtered and sorted as follows: - |RST_GUILABEL_COMMENT_CONTAINING_TEXT| : selects transactions with comments containing a text snippet. - |RST_GUILABEL_TYPE| : selects |RST_BUTTON_MINUS_SYMBOL| (all) or a single one of the following transaction types: - |RST_BUTTON_INITIAL| : Balance allocated when account was created. - |RST_BUTTON_ADJUSTMENT| : Manual adjustment by an administrator. See :ref:`Financial `. - |RST_BUTTON_DEPOSIT| : Adjustment of balance at a :ref:`Point-of-Sale `. - |RST_BUTTON_EXTERNAL| : Increment of balance by transferring funds from an external account. See :ref:`Transfer Money `. - |RST_BUTTON_TRANSFER| : Increment or decrement of balance by transferring credit to another user. See :ref:`Transfer Credit `. - |RST_BUTTON_VOUCHER| : Increment of balance by :ref:`redeeming a voucher `. - |RST_BUTTON_QUEUE| : A delegator transaction as part of a :ref:`delegated Print ` where the document and delegate info is retrieved from an *External Supplier* and printed to a Proxy Printer managed by a *Third Party Print Management System* (TPPMS). The transaction appears as |RST_GUILABEL_QUEUE_USAGE| item in the list. Print status and cost are retrieved from the TPPMS. The cost will be 0.00 when the status is “Pending (external)”, “Expired” or “Canceled”. When status is “Completed” the cost will be known. Currently External Supplier TPPMS :ref:`PaperCut ` is supported. - |RST_BUTTON_PRINTER| : A transaction for proxy printing. When the Proxy Printer is solely managed by SavaPage the costs are according to the specified :ref:`Printer Costs `. If the Proxy Printer is additionally managed by a *Third Party Print Management System*, status and cost are retrieved from that system and displayed just like the previously discussed |RST_GUILABEL_QUEUE_USAGE| item. - Select a creation |RST_GUILABEL_PERIOD| by entering a |RST_BUTTON_FROM| and |RST_BUTTON_TO| date. Tap the |RST_BUTTON_X_CLEAR| button after a date to clear it. See this example :ref:`Data Selection Dialog `. - Transactions can be sorted |RST_BUTTON_ASCENDING| or |RST_BUTTON_DESCENDING| by creation |RST_BUTTON_DATE| or |RST_BUTTON_TYPE|. - The list is refreshed, and the selection applied, after you push the |RST_BUTTON_APPLY| button. - The |RST_BUTTON_DEFAULT| button resets the selection items to their default values. - The |RST_BUTTON_PDF| and |RST_BUTTON_CSV| buttons download the Transaction List in their respective formats, using the selection item values. - See :ref:`POST /reports/accounttrx ` on how to download these lists with the RESTful Admin Service. - The |RST_BUTTON_MINUS_SYMBOL| icon at the top collapses the Select and Sort section.