.. /* * 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: SafePages --------- .. contents:: Table of Contents :depth: 2 :local: Main View ~~~~~~~~~ This is the main view with the acquired SafePages since the last login. This view is also known as “inbox”. .. _ss-user-main-pages-0: .. figure:: ../images/manual/screenshots/user/sp-01-00-user-main.png :width: 400 User Web App: Main View The top bar holds the following items (from left to right): - An action button that opens a pop-up menu. For now, the |PRODUCT_NAME| logo with the |RST_BUTTON_GDPR| and |RST_BUTTON_ABOUT| button is available. See :ref:`GDPR Dialog `. - The name of your Organization, in our case "SavaPage Demo". - A button with the inline pagometer Pie-Chart followed by the id of the logged in user. The *blue* color in the chart represents the number of pages the user printed to |PRODUCT_NAME|. The *green* color represents the number of pages exported to PDF. The *red* color depicts the pages printed to Proxy Printers. The button opens a dialog with :ref:`User Details `, including pagometer details. - The |RST_BUTTON_HELP| button opens a custom URL in a new tab. The URL is set with configuration property "``webapp.user.help.url``" and is enabled with "``webapp.user.help.url.enable``" default value ``Y`` (disable with value ``N`` ). The two-line center bar holds buttons for the main work-flow. When no SafePages are present, the SavaPage logo is shown, and irrelevant buttons are disabled: see :ref:`screenshot `. By default, the center bar shows button text on mobile devices only: on desktops a hover text is shown. You can change this behavior by setting configuration property ``webapp.user.main.nav-button-text`` to value ``ON`` (button text is always shown), ``OFF`` (button text is never shown) or ``AUTO`` (button text is shown on mobile devices only). See |RST_LINK_CONFIG_EDITOR| on how to change configuration properties. .. important:: Depending on :ref:`User Privileges ` and :ref:`User Roles ` some buttons might not be shown or replaced (relocated). The |image1| Letterhead button brings you to a dialog where you can create, browse and select letterheads. See :ref:`Letterheads `. Press the |image2| Log button to see the Document :ref:`Log `. The |image3| Logout button brings you back to the login screen. Press the |image4| Refresh button when, due to whatever reason, the automatic detection of SavaPage changes fails. This will update the view with the latest state. .. note:: Each print to SavaPage is logged as :ref:`Document `. SafePages that do not match a logged Document are removed. This can happen when a database is restored, or when old documents are deleted after a :ref:`Database Backup `, or :ref:`Database Command `. .. _ss-user-main-pages-3: .. figure:: ../images/manual/screenshots/user/sp-01-01-user-main-3-pages.png :width: 400 User Web App: SafePages This screen shows the result of a user who printed 3 pages to the SavaPage printer. The following actions on thumbnails are defined: - You can scroll through the thumbnails by dragging them horizontally. - A *tap* on the transparent area "<" or ">" in the top corner of the thumbnail view port scrolls the view a single page to the left or right. A *taphold* brings the start or the end of the page range in view. - A *tap* (click) opens up a detailed view of the page in the Page Browser: see :ref:`screenshot `. - A *tap* on the page number underneath the thumbnail or a *taphold* on the thumbnail itself, opens the Document Details dialog with rotate, delete and undo actions: :ref:`Document Details `. The following sections describe the actions for the newly enabled buttons: - |image5| :ref:`PDF ` - |image6| :ref:`Print ` - If the user is a :ref:`Job Ticket Creator ` and *not* a :ref:`Print Job Creator `, or :ref:`Job Ticket Printers ` are the only available printers, a |image7| Ticket button is shown instead of a Print button. - |image8| :ref:`Delete ` - |image9| :ref:`Sort ` .. _ss-user-main-pages-8: .. figure:: ../images/manual/screenshots/user/sp-01-01-user-main-8-pages.png :alt: User Web App: SafePages - Aggregated :width: 400 User Web App: SafePages - Aggregated This screen shows the result of a user printing 8 pages to the SavaPage printer, and illustrates *thumbnail aggregation*. - Note that only 6 thumbnails are displayed, and that the first thumbnail tells by its numbering that it is the first of a (3) page aggregation. - A *tap* on the first thumbnail will bring the (3) aggregated thumbnails in view. As a side-effect an aggregate will appear at another location in the thumbnail sequence. - Thumbnail aggregation is a protection against information (and resource) overload. Imagine what would happen if you printed a 500 page document to the SavaPage printer and ended up with 500 thumbnails. Aggregation gives you the high-level means to easily zoom in and out. - A ✎ mark after the page number tells that the page was edited with :ref:`SavaPage Draw `. In case of an aggregated thumbnail, a ✎ mark is shown prefixed with the underlying number of edited pages. - As always, a *tap* on a single thumbnail will bring you to the Page Browser, where you can navigate to any page, sequentially or directly: see :ref:`screenshot `. .. _ch-webapp-user-main-document-expiration: Document Expiration ~~~~~~~~~~~~~~~~~~~ When the document expiration time signal is set and expiration for a document is due, every thumbnail of the document is marked with a clock icon in a colored (orange) footer. .. figure:: ../images/manual/screenshots/user/sp-01-01-user-main-document-thumbnail-expire.png :width: 150 When the document is auto-deleted after expiration a notification message us shown. .. figure:: ../images/manual/screenshots/user/sp-01-01-user-main-document-expiration-message.png :width: 300 See :ref:`SafePages `. .. _ch-webapp-user-main-footer: Footer ~~~~~~ The footer is positioned at the bottom of the main user panel. The base items are depicted in the figure below. .. figure:: ../images/manual/screenshots/user/sp-01-00-user-main-footer-base.png :width: 200 User Web App: Footer Base From left to right: - A *check-mark* icon as indication that the Web App is connected to the SavaPage server. Other icons are shown when the connection is being (re) established or lost. When the server is not down, this usually is a temporary condition due to a network hiccup. Don't worry, SavaPage will automatically restore the connection when the network permits. - The account balance of the logged in user. When you press the button a dialog with :ref:`User Details ` is shown, including pagometer details. This button might not show depending on :ref:`Financial User Privileges `. - The Upload button is shown if |RST_LINK_WEBPRINT| is enabled. A tap on the button shows the :ref:`Upload File ` dialog. This button may have moved to the center button bar, depending on :ref:`User Privileges `. .. note:: Depending on :ref:`User Privileges ` some buttons might changed, not shown or moved to the main button bar. .. _ch-webapp-user-main-footer-paper-size: Paper Size Indicator ^^^^^^^^^^^^^^^^^^^^ If SafePages are present the unique paper sizes of the jobs are depicted in the footer. The text color indicates if a paper size is supported by the selected printer or not. The examples below illustrate how this works. - .. figure:: ../images/manual/screenshots/user/sp-01-00-user-main-footer-paper-size-11.png :width: 70 - A4 and A3 jobs are present: a printer is selected that supports both paper sizes. - .. figure:: ../images/manual/screenshots/user/sp-01-00-user-main-footer-paper-size-10.png :width: 70 - A4 and A3 jobs are present: a printer is selected that supports solely the A4 paper size. The A3 page is *cropped* to A4. - .. figure:: ../images/manual/screenshots/user/sp-01-00-user-main-footer-paper-size-12.png :width: 70 - A4 and A3 jobs are present: a printer is selected that supports solely the A4 paper size. The A3 page is *shrinked* to A4. - .. figure:: ../images/manual/screenshots/user/sp-01-00-user-main-footer-paper-size-00.png :width: 70 - A4 and A3 jobs are present: a printer is selected that supports none of the paper sizes (or no printer is selected yet). .. _ch-webapp-user-main-footer-savapage-draw: SavaPage Draw Indicator ^^^^^^^^^^^^^^^^^^^^^^^ The number of pages edited with :ref:`SavaPage Draw ` are shown in the footer. The example below shows that 2 pages were edited. .. figure:: ../images/manual/screenshots/user/sp-01-00-user-main-footer-savapage-draw.png :width: 46 .. _ch-webapp-user-main-footer-hold-print-jobs: Hold Print Jobs ^^^^^^^^^^^^^^^ A summary of :ref:`Hold Print Mode ` jobs and :ref:`Job Tickets ` as a result of :ref:`Proxy Printing ` is shown in the footer. The example below explains the layout. .. figure:: ../images/manual/screenshots/user/sp-01-00-user-main-footer-hold-jobs.png :width: 150 From left to right: - The shortest remaining job release time. - The total number of hold jobs. - The total number of pages to be printed. - The total cost charged for printing. A tap on the summary show a dialog where all Hold Jobs are shown in detail. Each job has three button, from left to right: - Show invoicing information. - Preview the PDF document to be printed. - Cancel the job. And for all jobs: - |RST_BUTTON_CANCEL_n| all n jobs. - |RST_BUTTON_EXTEND| the expiry time of :ref:`Hold Print Mode ` jobs. - |RST_BUTTON_REFRESH| dialog content .. figure:: ../images/manual/screenshots/user/sp-01-00-user-main-footer-hold-jobs-dialog.png :width: 400 User Web App: Hold Print Jobs .. figure:: ../images/manual/screenshots/user/sp-01-00-user-main-footer-hold-jobs-dialog-copy.png :width: 400 User Web App: Hold Copy Job .. figure:: ../images/manual/screenshots/user/sp-01-00-user-main-footer-hold-jobs-dialog-copy-invoicing.png :width: 400 User Web App: Hold Job Transactions More information can be found at: - :ref:`Print Job Settings `. - :ref:`Job Ticket Print `. .. _ch-webapp-user-main-document-details: Document Details ~~~~~~~~~~~~~~~~ A *Tap* on the page numbering below the image pops up the Document Details dialog. .. figure:: ../images/manual/screenshots/user/sp-01-01-user-main-landscape-job-rotate.png :alt: User Web App: Document Details :width: 350px User Web App: Document Details In this example |RST_COLLAPSIBLE_HEADING_FONTS| shows that “+UnifontMedium” is an embedded font and “Helvetica”, as one of the :ref:`Standard PDF Fonts `, is rendered as “Nimbus Sans L Regular”. How fonts are resolved in SafePages Documents, depends on :ref:`Driverless PDF Transfer Processing ` and :ref:`PostScript Print Processing `. If the PDF document is transferred via HTTP (:ref:`Upload `), the details of the |RST_COLLAPSIBLE_HEADING_ORIGINAL| PDF are shown is a separate section. The same details are available in the corresponding item of the :ref:`Document List `. .. figure:: ../images/manual/screenshots/user/sp-01-01-user-main-document-original.png :width: 400 User Web App: Document Original Details If document expiration is set the expiration time is shown. See :ref:`SafePages `. .. figure:: ../images/manual/screenshots/user/sp-01-01-user-main-document-details-expire.png :width: 300 User Web App: Document Expiration .. note:: If :ref:`Inherit IPP options from print-in document ` is enabled for :ref:`Fast Print Mode ` the :ref:`IPP Options from PostScript ` Driver Print-in are displayed. .. _ch-webapp-user-main-document-delete-undo: Delete and Undo ^^^^^^^^^^^^^^^ Press the Delete document button in this dialog to *delete* all pages of a SafePages document, or check and apply Undo page delete to restore the full job in case document pages were deleted. See :ref:`Sort `. .. _ch-webapp-user-main-document-rotation: Rotation ^^^^^^^^ When a user prints to a printer and selects landscape orientation, the print manager of the originating application will translate and rotate the printed content to fit the dimensions of the hard copy target page. When doing so, it makes assumptions about the (0,0) origin of the logical space on this page. The SavaPage printer driver provides a hint to the print manager about the origin, so it can rotate and translate the pages in a way that is compatible with the |PRODUCT_NAME| printer. Contrary to real printers, where hard copies can easily be rotated by hand, pages produced by the virtual SavaPage printer need special attention, since it is possible that landscape oriented prints rotate the content to portrait oriented images and PDF pages. Probably this is not what you want, so you can ad-hoc rotate job pages in SavaPage to landscape display orientation. .. figure:: ../images/manual/screenshots/user/sp-01-01-user-main-landscape-job.png :width: 400 User Web App: Landscape Job - This what you might see when you print a job in landscape orientation. - Select the |RST_CHECKBOX_ROTATE| option and press the |RST_BUTTON_APPLY| button to rotate the page and all sibling pages belonging to the same job. - The result after rotation is shown in the screenshot below. .. _ss-user-landscape-job-rotated: .. figure:: ../images/manual/screenshots/user/sp-01-01-user-main-landscape-job-rotated.png :width: 400 User Web App: Rotated Pages .. note:: Although the Rotate dialog is triggered from a *single* SafePage, the rotation affects *all* SafePages within the same print job. .. warning:: When two WebApps are opened for the same user, the result of a page rotation performed in one Web App will not automatically be shown in the other. The user should do a manual refresh to update the SafePages preview. .. _ch-webapp-user-main-browser: Browser ~~~~~~~ A *tap* on a non-aggregated SafePage thumbnail image will show the page detail in the Browser. .. _ss-user-browser-4-of-8: .. figure:: ../images/manual/screenshots/user/sp-01-01-user-main-page-4-of-8.png :width: 400 User Web App: SafePage Browser (8 pages) Use the *slider* control to directly jump to the page of your choice. Extra actions are available by buttons at the bottom. From left to right: - The |RST_BUTTON_3_DOTS| button opens a menu where you can zoom-in, zoom-out and restore the zoom default: see :ref:`screenshot `. - Depending on SavaPage configuration and user permission you will see an Edit button to toggle the :ref:`SavaPage Draw ` panel. - The |RST_BUTTON_ARROW_ANTICLOCKWISE| button brings you back to the main :ref:`SafePages ` screen. - The |RST_BUTTON_CROSS_SYMBOL| button deletes the page in view. - The |RST_BUTTON_ARROW_LEFTWARDS| button selects the previous page. - The |RST_BUTTON_ARROW_RIGHTWARDS| button selects the next page. .. _ss-user-browser-4-of-8-detail: .. figure:: ../images/manual/screenshots/user/sp-01-01-user-main-page-4-of-8-detail.png :width: 400 User Web App: SafePage Browser - Page Options - This screen shows the Menu options with Zoom-in applied. Use the standard page scrolling of your browser to scroll the image up/down and left/right. - The optional Edit button toggles the :ref:`SavaPage Draw ` panel. .. _ch-webapp-user-main-browser-page-draw: SavaPage Draw ^^^^^^^^^^^^^ If :ref:`rsvg-convert ` is installed and a user has :ref:`SafePages Editor privileges ` they can draw lines, shapes and text on a SafePage as shown in the example below. .. figure:: ../images/manual/screenshots/user/sp-01-01-user-main-page-draw.png :width: 400 User Web App: SavaPage Draw Buttons at the left panel can be used to select properties and draw lines, shapes and text, as explained in the table below. .. list-table:: SavaPage Draw - Buttons (top to bottom) :width: 100% :header-rows: 1 * - Botton - Action * - Brush - | Toggles Brush (ON) or Shape (OFF) mode. Brush mode | draws a trail with Color, Size and Opacity under the | moving mouse pointer while pressing the left mouse | button. Shape mode enables the Shape and Text buttons. | A drawn Brush trail can be edited by selecting it in | Shape mode. * - | Line, Rectangle | Circle, Triangle, | Text - | Draws a standard size of the respective Shape or Text | at the top left of the page with Border, Fill and | Opacity. A Text object is initialized with two sample | text lines. The drawn object is selected by default so | it can immediately be edited, resized and moved. Note: | buttons are disabled when Brush mode is ON. * - Lock - | Toggles Lock mode for Border and Fill Color. When Lock | mode is ON, pressing a Color button does not open the | color selection dialog, but just applies the color to | the selected drawn objects. * - Brush \| Border Color - | Selects the Brush or Shape Color (depending on Brush | or Shape mode). The selection is applied to any selected | object. If Lock mode is ON, the color selection dialog | does not open, and the locked color is applied to any | selected object. * - Size \| Border - | Selects the Brush Size or Shape Border (depending on | Brush or Shape mode). The selection is applied to any | selected object. * - Fill Color - | Selects the Fill Color of a Shape. The selection is | applied to any selected object. If Lock mode is ON, | the color selection dialog does not open, and the | locked color is applied to any selected object. * - Opacity - | Select the Opacity of a Brush or Shape object. | The selection is applied to any selected object. * - Transparent - | Makes the Fill of any selected object Transparent. * - Select all - | Selects all drawn objects (Shape and Brush trails). * - Clear selection - | Clears (deletes) all selected objects. * - Clear all - | Clears (deletes) all drawn objects. * - Restore, Save - | Saves the drawing or restores the earlier saved | version. .. note:: The number of edited pages are shown in the SafePages :ref:`footer `. SavePages thumbnails of edited pages are marked with a small ✎ icon. .. note:: SavaPage Draw can be globally disabled by setting configuration property ``webapp.user.page-browser.draw.enable`` = ``N`` See |RST_LINK_CONFIG_EDITOR| on how to set this property. .. caution:: The alignment of the drawing does not adjust to a change in :ref:`Document Rotation `. .. warning:: Do not use SavaPage Draw as a tool to redact content in PDF exports. Redaction applies only to the visible surface: the underlying elements remain in the PDF and can be inspected with special tooling. .. /* * Images */ .. |image1| image:: ../images/manual/screenshots/user/sp-01-00-user-main-button-letterheads.png :width: 25px .. |image2| image:: ../images/manual/screenshots/user/sp-01-00-user-main-button-log.png :width: 25px .. |image3| image:: ../images/manual/screenshots/user/sp-01-00-user-main-button-logout.png :width: 25px .. |image4| image:: ../images/manual/screenshots/user/sp-01-00-user-main-button-refresh.png :width: 25px .. |image5| image:: ../images/manual/screenshots/user/sp-01-00-user-main-button-pdf.png :width: 25px .. |image6| image:: ../images/manual/screenshots/user/sp-01-00-user-main-button-printer.png :width: 25px .. |image7| image:: ../images/manual/screenshots/user/sp-01-00-user-main-button-jobticket.png :width: 25px .. |image8| image:: ../images/manual/screenshots/user/sp-01-00-user-main-button-delete.png :width: 25px .. |image9| image:: ../images/manual/screenshots/user/sp-01-00-user-main-button-sort.png :width: 25px