1 Kurzbeschreibung
Diese Dokumentation beschreibt die virtuelle Funktion „QR-Codes“. Die Funktion fügt eine QR-Rechnung mit einem „Swiss QR Code“ in einen Bericht ein. Dies wird im Belegdokument „Ausgangsrechnung“ für die Schweiz benötigt.
2 Zielgruppe
Programmierer
3 Begriffsbestimmung
Eine virtuelle Funktion ist eine spezielle Tabelle, die zu einer Menge von Eingabewerten eine Ergebniszeile zurückgibt, welche zur Laufzeit der Abfrage berechnet wird. Sie existiert nicht auf der Datenbank, sondern wird vom System-Application-Server (SAS) emuliert.
Eine virtuelle Funktion wird normalerweise über einen Join vom Typ LEFT OUTER an eine andere Datenbanktabelle verbunden. Über die Join-Bedingung oder über die WHERE-Klausel wird die Zuordnung der Werte für die Eingabeparameter der virtuellen Funktion angegeben. Wenn eine Abfrage einen Join enthält, dann wird das Abfrageergebnis zuerst ohne Berücksichtigung der virtuellen Funktion in der Datenbank ermittelt. Anschließend werden für jede Ergebniszeile die Werte der Spalten der virtuellen Funktion berechnet. Dabei berechnet der SAS für die durch die Join-Bedingung festgelegte Wertebelegung der Eingangsparameter die Werte der Ausgabe-Spalten der virtuellen Funktion.
4 Funktionsbeschreibung
In einem Bericht kann die virtuelle Funktion über den Namen sem_ext_app_erp4ch_QRCode angesprochen werden. Die Funktion sollte in der Fußzeile des Berichts eingebunden werden.
Die implementierende Java-Klasse ist com.sem.ext.app.erp4ch.log.CustomerInvoiceQRCodeVirtualFunction.
Wenn für die Firma des Rechnungsstellers das Einzahlungsscheinverfahren „QR-Rechnung mit QR-Referenz“ oder „QR-Rechnung mit Kreditor-Referenz“ festgelegt ist, dann fügt die Funktion ein Bild im PNG-Format ein, das die QR-Rechnung enthält. Andernfalls gibt sie null zurück.
Für die Erzeugung des Bildes im PNG-Format, das die QR-Rechnung enthält, wird die Java-Bibliothek „SwissQRBill.jar“ verwendet, die mit der App „Comarch ERP Enterprise für die Schweiz“ bereitgestellt wird. Die Bibliothek muss im Ordner lib/ext abgelegt sein.
4.1 Tabellenspalten
| com.sem.ext.app.erp4ch.log.CustomerInvoiceQRCodeVirtualFunction | |
| Spaltenname | Erläuterung |
| in_invoice | Über diesen Eingabeparameter muss die GUID der Ausgangsrechnung angegeben werden. Die Eingabe dieses Parameters ist Pflicht. |
| content | Über diesen Ausgabeparameter wird ein Bild im PNG-Format ausgegeben, das die QR-Rechnung mit Empfangsschein und Zahlteil samt Swiss QR Code enthält. |
4.2 Datenbanktyp
Die virtuelle Funktion „QR-Codes“ steht auf den OLTP-Datenbanken zur Verfügung.
5 Berechtigungen
Für die Nutzung des ODBC-Treibers wird folgendes Business Entity für die Berechtigungsermittlung herangezogen:
Ausgangsrechnung
com.cisag.app.sales.obj.CustomerInvoice