1 Kurzbeschreibung
Diese Dokumentation beschreibt im Folgenden die virtuelle Funktion „Rechnungsbetrag in Worten“. Die Funktion wandelt den Endbetrag einer Rechnung in eine Zeile um, welche die einzelnen Ziffern des Betrages und die Währung in Worten enthält. Dies wird allerdings nur für polnische Finanzorganisationen durchgeführt. Die Funktion wird im Belegdokument „Ausgangsrechnung“ benötigt.
2 Zielgruppe
Entwickler
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 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 app_sales_CustomerInvoiceValueInWordsVirtualFunction angesprochen werden.
Die implementierende Java-Klasse ist com.cisag.app.sales.log.CustomerInvoiceValueInWordsVirtualFunction.
In dem Belegdokument „Ausgangsrechnung“ werden die Daten zu einer Ausgangsrechnung angezeigt. Wenn eine polnische Finanzorganisation übergeben wird, wandelt diese Funktion die Ziffern und die Währung des Rechnungsbetrages in Worte um. Ansonsten gibt sie null zurück. Die Funktion wird beim Erzeugen des Ausgangsrechnung-Belegs unbedingt aufgerufen.
4.1 Tabellenspalten
| app_sales_CustomerInvoiceValueInWordsVirtualFunction | |
| Spaltennamen | Beschreibung |
| in_ grossAmountAmount | Über diesen Eingabeparameter muss der Rechungsbetrag der Ausgangsrechnung angegeben werden, den die virtuelle Funktion umwandeln soll. Die Eingabe dieses Parameters ist Pflicht. |
| in_ financialsOrganization | Über diesen Eingabeparameter muss die Finanzorganisation angegeben werden, für die die virtuelle Funktion den Rechungsbetrag als Text ausgeben soll. Die Eingabe dieses Parameters ist Pflicht. |
| in_currency | Über diesen Eingabeparameter muss die Währung der Ausgangsrechnung angegeben werden. Die Eingabe dieses Parameters ist Pflicht. |
| customerInvoiceValueInWords | · Rechungsbetrag in Worten wenn eine polnische Finanzorganisation übergeben wird.
· null wenn eine Finanzorganisation eines anderen Landes übergeben wird |
4.2 Datenbanktyp
Die virtuelle Funktion „Rechnungsbetrag in Worten“ 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.