Skip to main content

xSuite Invoice Cube User Guide

The PNG Viewer in SAP Fiori

PNG Viewer: xSuite Monitors in SAP Fiori

The PNG Viewer is available in the following xSuite monitors:

xSuite monitor

SAP Fiori tile

Documents handled

Invoice Monitor

Invoice Monitor

  • Invoices

  • Credit notes

  • Down payment requests

Order Confirmation Monitor

OC Monitor

Order confirmations

Sales Document Monitor

Sales Document Monitor

Orders

PNG Viewer: Main Overview in SAP Fiori

beschriftung_fiori_png_viewer_aufbau.png

Section

Information and comments

1

The PNG Viewer toolbar

Contains the buttons of the PNG Viewer.

For more information, see PNG Viewer: Buttons in the Toolbar in SAP Fiori.

2

Image display

This is where the individual pages of the image are displayed.

3

Highlighting

In the PNG Viewer, found field values are highlighted in green.

4

Fields tab

Shows the properties of the image in the form of fields. 

5

Training tab

Here, you can train the vendor or the fields of a vendor.

For more information, see PNG Viewer: Creditor and Field Training in SAP Fiori.

Note: When using xSuite Capture Helix, this tab is hidden, because xSuite Capture Helix always runs an implicit training when posting or parking an SAP document.

6

Pages tab

A gallery view of all individual pages is displayed here.

Clicking on a single page will open that page in the Viewer pane.

7

Pageview tab

This is where the preview of the current page is displayed.

The section of the page displayed in the displayed area is highlighted. The size of the area displayed will vary depending on how far you have zoomed in and how large your browser window is.

You can move the highlighted page section by holding down the left mouse button and dragging it. The page view in the display area will adjust accordingly.

PNG Viewer: Buttons in the Toolbar in SAP Fiori

Button

Name

Description

fiori_viewer_download.png

Download document

Downloads the image.

fiori_viewer_einstellungen.png

Settings

Opens the display settings of the PNG Viewer.

Here the user can configure the display the settings for displaying a new document or a new page.

If the settings have been changed, these changes will apply to the current session.

If the changes are to be applied permanently, the app settings must be saved.

The settings apply to the PNG Viewer regardless of which xSuite monitor is being used.

fiori_icon_vergroessern.png

Zoom in

Zooms in on the page.

fiori_icon_verkleinern.png

Zoom out

Zooms out of the page.

fiori_viewer_zoomoptionen.png

Zoom options

Opens the zoom options of the PNG Viewer.

You can select different zoom values to expand or shrink the image displayed, or one of the following settings:

  • Show whole page: The full page is displayed.

  • Adjust to page height: Display of the image is adjusted to fill the available space in height.

  • Fit to page width: Display of the image is adjusted to fill the available space in width.

fiori_viewer_erste_seite.png

First page

Brings you straight to the first page.

fiori_viewer_vorherige_seite.png

Page back

Scrolls one page back.

fiori_viewer_naechste_seite.png

Page forward

Brings you forward a page.

fiori_viewer_letzte_seite.png

Last page

Brings you straight to the last page.

fiori_viewer_auswahlmodus.png
fiori_viewer_navigationsmodus.png

Activate selection mode

Activate navigation mode

Switches between navigation and selection mode.

In navigation mode, the user can move the page by holding down the left mouse button.

In selection mode, the user can select a page range by holding down the left mouse button.

Notice

More options for marking an area of the page (regardless of the mode selected):

  • Press and hold the right mouse button

  • Press and hold the Shift key and the left mouse button

fiori_viewer_highlighting.png

Show all recognized fields

Highlights all field values found.

fiori_viewer_highlighting_entfernen.png

Remove all highlights

Removes all highlighting.

fiori_viewer_links.png

Rotate 90° to the left

Turns the page 90° to the left.

fiori_viewer_rechts.png

Rotate 90° to the right

Turns the page 90° to the right.

fiori_icon_viewer_tabs_einblenden.jpg

Restore the default splitter size distribution

Displays the tabs and restores the default size of the image display in relation to the tabs.

fiori_icon_viewer_tabs_ausblenden.jpg

Hide tabs

Hides the tabs.

PNG Viewer: Field Values in the Image in SAP Fiori

All field values extracted from the image during data extraction are displayed in the Fields tab. These field values also include ones which are not found in the image. An example of a preset field value is a company code.

"Fields" Tab: Columns in SAP Fiori

Column

Description

State

Shows the status of a field.

For information on field status, see PNG Viewer: Field Status in SAP Fiori.

Field

Shows the name of a field.

If a field relates to items, the field will be output by item, e.g. Item Quantity.

Value

Shows the value of a field.

Field values are identified in the document extraction.

If a field value in the image has a format other than the corresponding field value in SAP, the field value in the document extraction will be adjusted to the SAP format. The adjusted field value is located in the column Value.

Example: In the document, the amount of the order is specified with two decimal places. In SAP it is specified without any decimal places. The document would contain 10.00 and the column Value would contain 10.

Page

Shows the page number on which an identified field value was found.

Visible

Indicates whether an identified field value has been found in the document.

Alternatives

Indicates whether an identified field value has been found multiple times in the document.

Alternative field values can be highlighted in the document.

For more information, see PNG Viewers: Highlighting Alternative Field Values in the Image in SAP Fiori.

PNG Viewer: Field Status in SAP Fiori

Status

Color

Explanatory notes

fiori_viewer_feldstatus_grau.png

Gray

This field is neither a mandatory field nor part of a rule.

For this reason, the field value identified will not be checked.

If all fields are gray, the completeness check for the document is considered fulfilled.

fiori_viewer_feldstatus_gruen.png

Green

This field is mandatory.

The field value identified has been found in the image.

If all fields are green or gray, the completeness check for the document is considered fulfilled.

fiori_viewer_feldstatus_orange.png

Orange

This field is mandatory.

The field value identified has not been found in the image.

If one or more fields is orange, the completeness check for the document will be considered not fulfilled.

fiori_viewer_feldstatus_rot.png

Red

This field is part of a rule.

The field value identified goes against a rule.

Example of rules:

  • The document date is allowed to be a maximum of 90 days in the past.

  • The total of the net amounts and the VAT amounts must correspond to the total amount.

If one or more fields is red, the completeness check for the document is considered not fulfilled.

PNG Viewer: Highlighting Header or Item Data Fields in the Image in SAP Fiori
  1. Open a document in the associated xSuite monitor. For more information, see PNG Viewer: xSuite Monitors in the SAP GUI.

    ➣ The image of the document will be displayed in the PNG Viewer.

  2. Click the button fiori_highlighting_aktivieren.png Activate highlighting in the page header.

    beschriftung_fiori_png_viewer_highlighting_aktivieren.png
  3. In the Header Data section or in the Item Data section, click in a field that contains a value.

    ➤ If the field value belonging to it is found in the image, it will be highlighted in green.

PNG Viewers: Highlighting Alternative Field Values in the Image in SAP Fiori
  1. Open a document via the associated xSuite monitor. For more information, see PNG Viewer: xSuite Monitors in SAP Fiori.

    ➣ The image of the document will be displayed in the PNG Viewer.

  2. Select the Fields tab.

    Notice

    The number of alternative field values appears in the column Alternatives.

  3. Click on the button in the column Alternatives.

    fiori_viewer_alternativen.png

    ➣ A list of alternative values for the field will open in a new window.

  4. In the line of an alternative value, click on the button fiori_vorschau.png Visible.

    Notice

    To copy a value to the clipboard, click on the button fiori_zeile_kopieren.png Copy.

    beschriftung_fiori_viewer_alternativen_dialog.png

    ➤ The alternate field value will be highlighted in the image.

Selecting values and transferring them to the document – the PNG Viewer in SAP Fiori
Selecting and adopting a recognized value
  1. Open a document in the associated xSuite monitor. For more information, see PNG Viewer: xSuite Monitors in the SAP GUI.

    ➣ The image of the document will be displayed in the PNG Viewer.

  2. In the PNG Viewer toolbar, click the button fiori_viewer_highlighting.png Show all recognized fields.

    ➣ All field values identified in the document will now be highlighted.

    fiori_viewer_feldwert_auswaehlen.png
  3. Drag and drop the selected field value into a header or item field of the document.

    fiori_viewer_feldwert_einfuegen.png

    ➤ If the data type of the selected field value and the data type of the header or item field are identical, the selected value will be adopted.

    fiori_viewer_feldwert_uebernommen.png

    ➤ If the data types are different, you will receive an error message.

    ➤ If you drag the value into a comment field, the value will be transferred unformatted.

    Notice

    As an alternative, you can left-click directly on a recognized field value.

    In the dialog Selection that then appears, you can select whether the field value is to be copied to the clipboard or whether it is to be transferred to the respective field.

    fiori_png_viewer_dialog_wert_uebernehmen.jpg
Selecting and adopting a value
  1. Open a document in the associated xSuite monitor. For more information, see PNG Viewer: xSuite Monitors in the SAP GUI.

    ➣ The image of the document will be displayed in the PNG Viewer.

  2. Holding down the right mouse button, drag the mouse over a field value that you want to apply.

    fiori_viewer_feldwert_auswaehlen02.png
  3. Drag and drop the field value into a header or item field in the document.

    fiori_viewer_ausgwaehlten_feldwert_einfuegen.png

    ➤ If the data type of the selected field value and the data type of the header or item field are identical, the selected value will be adopted.

    fiori_viewer_feldwert_uebernommen.png

    ➤ If the data types are different, you will receive an error message.

    ➤ If you drag the value into a comment field, the value will be transferred unformatted.

PNG Viewer: Creditor and Field Training in SAP Fiori

The document extraction function will attempt to determine the vendor of a document as well as the properties of a document.

If it was not possible to determine the vendor, you can train the vendor.

If it was possible to determine the vendor but not the properties, you can train the properties in the form of fields for the vendor.

Training will improve the results of future document extraction and reduce manual post-processing work.

"Training" Tab: Columns in SAP Fiori

Column

Description

State

Shows the status of a training.

For information on training status, see PNG Viewer: Training Status in the SAP GUI.

Display training area

If you click on the fiori_vorschau.png button in this column, the training area will appear on the page.

Delete

If you click on the fiori_tabelle__massenloeschung.png button in this column, the field training will be deleted.

Training (area + text)

If you click on the fiori_viewer_icon_bereich_text.png button in this column, the selected area will be adopted, including full text.

The text is displayed in the Value column.

Training (only area)

If you click on the fiori_viewer_icon_bereich.png button in this column, only the selected area will be adopted.

Field

Shows the field name.

Value

Shows the value that you selected when creating the training.

Type

Shows the data type of the field, e.g. String or Decimal.

Index

Depending on the status of a training, displays one of the following values:

  • (Empty): The training status is Initial.

  • 0: The training status is New.

  • Zero: The training status is Trained.

Note: This column is only relevant for training item data.

Page

Shows the page number to which the training refers.

Visible

Shows whether a field value was found in the image.

A field value is considered not found if there is either no field value in the trained position or the field value has a data type that is not identical to the data type trained.

PNG Viewer: Training Status in SAP Fiori

Status

Explanatory notes

Initial

There are no associated trainings for this field.

New

The training has just been created.

Processing has not been started yet (fiori_viewer_icon_speichern.png Save training button).

Training has not yet been used for document extraction.

Trained

Creation of the training has been successfully processed.

Training is used for document extraction.

ToDelete

The training was deleted (fiori_tabelle__massenloeschung.png Delete button).

Processing has not been started yet (fiori_viewer_icon_speichern.png Save training button).

Training continues to be used for document extraction.

PNG Viewer: Training the Vendor without a Safeguard in SAP Fiori

Caution

When you replace an existing vendor training with a new vendor training, the associated field training will be deleted.

  1. Open a document via the associated xSuite monitor. For more information, see PNG Viewer: xSuite Monitors in SAP Fiori.

    ➣ The image of the document will be displayed in the PNG Viewer.

  2. Select the Training tab.

  3. Enter the creditor ID in the column Value of the line Creditor ID.

    beschriftung_fiori_viewer_training_kreditor.png

    Notice

    The system always uses the entire first page of the document as the area to be trained.

  4. Click on fiori_viewer_icon_speichern.png Save training.

    ➣ The new training will be processed.

    ➤ After processing is complete, the status will switch to Trained.

PNG Viewer: Training the Vendor with a Safeguard in SAP Fiori

Caution

When you replace an existing vendor training with a new vendor training, the associated field training will be deleted.

  1. Open a document via the associated xSuite monitor. For more information, see PNG Viewer: xSuite Monitors in SAP Fiori.

    ➣ The image of the document will be displayed in the PNG Viewer.

  2. Select the Training tab.

  3. Enter the creditor ID in the column Value of the line Creditor ID.

    beschriftung_fiori_viewer_training_kreditor.png

    Notice

    The system always uses the entire first page of the document as the area to be trained.

  4. Holding down the right mouse button, drag a frame around the fields that uniquely identify the vendor, e.g. the postal code, the IBAN or the sender line.

  5. In the line Creditor ID (Safe Guard), click on fiori_viewer_icon_speichern.png Training (Area + Text).

    ➣ The text of the selected area will now be displayed in the Value field.

    beschriftung_fiori_viewer_training_kreditor_absicherung.png
  6. Click on fiori_viewer_icon_speichern.png Save training.

    ➣ The new training will be processed.

    ➤ After processing is complete, the status will switch to Trained.

PNG Viewer: Training a Field of a Vendor in SAP Fiori
  1. Open a document via the associated xSuite monitor. For more information, see PNG Viewer: xSuite Monitors in SAP Fiori.

    ➣ The image of the document will be displayed in the PNG Viewer.

  2. Select the Training tab.

  3. Holding down the right mouse button, drag a frame around the value of the field to be trained.

    Notice

    The field will only be adopted if the frame around it is large enough.

  4. Perform one of the following steps:

    • In the field to be trained, click on fiori_viewer_icon_bereich_text.png Training (Area + Text).

      ➣ The selected area will be adopted with full text. The text will be displayed in the Value column.

      ➣ The status will change to New.

      beschriftung_fiori_viewer_training_bereich_text.png
    • In the field to be trained, click on fiori_viewer_icon_bereich.png Training (only area).

      ➣ The selected area will be adopted.

      ➣ The status will change to New.

      beschriftung_fiori_viewer_training_bereich.png
  5. Click on fiori_viewer_icon_speichern.png Save training.

    Notice

    The training is always saved for all fields simultaneously.

    ➣ The new training will be processed.

    ➤ After processing is complete, the status will switch to Trained.

PNG Viewer: Deleting a Training in SAP Fiori
  1. Open a document via the associated xSuite monitor. For more information, see PNG Viewer: xSuite Monitors in SAP Fiori.

    ➣ The image of the document will be displayed in the PNG Viewer.

  2. Select the Training tab.

  3. In the line of a training, click on fiori_tabelle__massenloeschung.png Delete.

    beschriftung_fiori_viewer_training_loeschen.png

    ➣ The status of the training will change to ToDelete.

    beschriftung_fiori_viewer_training_to_delete.png
  4. Click on fiori_viewer_icon_speichern.png Save training.

    ➣ The deletion process will now start.

    ➤ After the deletion process is complete, the training will be removed. The status of the training will now be Initial.