1 Kurzbeschreibung
Diese Dokumentation beschreibt den Aufbau der virtuellen Tabelle „Ausgangsrechnungs-Belegzeilen“. Außerdem erfahren Sie, wie Sie die virtuelle Tabelle verwenden.
Allgemeine Informationen zur Programmierung von virtuellen Tabellen lesen Sie in der Dokumentation „Programmierung von virtuellen Tabellen, Funktionen und Beziehungsspalten“.
2 Begriffsbestimmung
Eine virtuelle Tabelle existiert nicht in der Datenbank, sondern wird vom SAS emuliert. Prinzipiell kann auf virtuelle Tabelle wie auf eine Datenbanktabelle zugegriffen werden. Der Inhalt einer virtuellen Tabelle wird zur Laufzeit der Abfrage bezüglich der Eingabewerte berechnet. Als Anfrageergebnis können beliebig viele Zeilen zurückgeben werden. Eine virtuelle Tabelle darf nur als einzige Tabelle in einem einfachen SQL-Statement verwendet werden.
Virtuelle Tabellen sollten verwendet werden, wenn das Anfrageergebnis mehr als eine Zeile umfassen kann. Wenn das Anfrageergebnis nur maximal eine Zeile enthält, bietet sich eine virtuelle Funktion an, da diese in Joins verwendet werden kann
3 Zielgruppe
Entwickler
4 Virtuelle Tabelle: Ausgangsrechnungs-Belegzeilen
Diese virtuelle Tabelle steuert den Aufbau des Belegs „Ausgangsrechnung“. Sie bestimmt die Reihenfolge der auszugebenden Informationen.
Jede Ergebniszeile repräsentiert einen Informationsblock, der in einer oder mehreren Belegzeilen der Ausgangsrechnung dargestellt wird. Die Reihenfolge der Informationsblöcke ist in der virtuellen Tabelle beliebig festlegbar. Die virtuelle Tabelle bestimmt so die Reihenfolge der Ausgaben im Belegdokument.
4.1 Tabellenname
Die virtuelle Tabelle können Sie über den Namen „app_sales_CustomerInvoiceDetailVirtualTable“ verwenden.
Die implementierende Java-Klasse ist com.cisag.app.purchasing.pricing.log.StandardPriceDiscountsVirtualTable.
4.2 Tabellenspalten
4.2.1 Ausgabeparameter
Die Tabelle hat folgende Spalten:
Spaltenname | Primitiver Datentyp | Beschreibung |
guid | GUID | Dieses Attribut identifiziert die Ergebniszeile eindeutig. Verwenden Sie dieses Attribut beispielsweise um den Wechsel von Ergebniszeilen gleichen Typs im Beleg zu erkennen oder um Operationen nur einmal pro Ergebniszeile durchzuführen.
Dieser Ausgabeparameter ist immer gefüllt. |
type | Valueset | Dieses Attribut typisiert die Ergebniszeile. Verwenden Sie dieses Attribut, um beispielsweise zu entscheiden, welche Zeilen des Ausgangsrechnungsbeleg für diesen Informationsblock dargestellt werden sollen. Der Zeilentyp bestimmt auch, welche der anderen Attribute gefüllt sind.
Dieser Ausgabeparameter ist immer gefüllt. Sie können aus folgenden Typen auswählen: · Vertriebsauftrag · Verteilauftrag · Beschaffungsauftrag · Lieferschein · Ausgangsrechnungs-Position · Positionsrabatt · Basisrabatt · Vertriebsauftrags-Position · Verteilauftrags-Position · Beschaffungsauftrags-Position · Lieferschein-Position |
salesOrder | GUID | Falls die Quelle der auszugebenden Ausgangsrechnung ein Vertriebsauftrag ist, so identifiziert dieses Attribut den Vertriebsauftrag. Verwenden Sie diesen Parameter, um die virtuelle Tabelle mit dem Business Object com.cisag.app.sales.obj.SalesOrder zu verknüpfen und weitere Informationen daraus darzustellen.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Vertriebsauftrag · Vertriebsauftrags-Position |
distributionOrder | GUID | Falls die Quelle der auszugebenden Ausgangsrechnung ein Verteilauftrag ist, so identifiziert dieses Attribut den Verteilauftrag. Verwenden Sie diesen Parameter, um die virtuelle Tabelle mit dem Business Object com.cisag.app.multiorg.obj.DistributionOrder zu verknüpfen und weitere Informationen daraus darzustellen.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Verteilauftrag · Verteilauftrags-Position |
purchaseOrder | GUID | Falls die Quelle der auszugebenden Ausgangsrechnung ein Beschaffungsauftrag ist, so identifiziert dieses Attribut den Beschaffungsauftrag. Verwenden Sie diesen Parameter, um die Virtuelle Tabelle mit dem Business Object com.cisag.app.purchasing.obj.PurchaseOrder zu verknüpfen und weitere Informationen daraus darzustellen.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Beschaffungs-Auftrag · Beschaffungsauftrags-Position |
shippingOrder | GUID | Falls die Ware einer Ausgangsrechnung bereits geliefert wurde, so identifiziert dieses Attribut den Lieferauftrag mit den Lieferschein-Informationen. Verwenden Sie diesen Parameter, um die Virtuelle Tabelle mit dem Business Object com.cisag.app.sales.obj.ShippingOrder zu verknüpfen und weitere Informationen daraus darzustellen.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Lieferschein · Lieferschein-Position |
invoiceDetail | GUID | Dieses Attribut identifiziert die Ausgangsrechnungs-Position eindeutig. Verwenden Sie diesen Parameter, um die Virtuelle Tabelle mit dem Business Object com.cisag.app.sales.obj.CustomerInvoiceDetail zu verknüpfen und weitere Informationen daraus darzustellen.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Ausgangsrechnungs-Position · Positionsrabatt |
salesOrderDetail | GUID | Falls die Quelle der auszugebenden Ausgangsrechnung ein Vertriebsauftrag ist, so identifiziert dieses Attribut die Vertriebsauftrags-Position. Verwenden Sie diesen Parameter, um die Virtuelle Tabelle mit dem Business Object com.cisag.app.sales.obj.SalesOrderDetail zu verknüpfen und weitere Informationen daraus darzustellen.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Vertriebsauftrags-Position |
distributionOrderDetail | GUID | Falls die Quelle der auszugebenden Ausgangsrechnung ein Verteilauftrag ist, so identifiziert dieses Attribut die Verteilauftrags-Position. Verwenden Sie diesen Parameter, um die Virtuelle Tabelle mit dem Business Object com.cisag.app.multiorg.obj.DistributionOrderDetail zu verknüpfen und weitere Informationen daraus darzustellen.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Verteilauftrags-Position |
purchaseOrderDetail | GUID | Falls die Quelle der auszugebenden Ausgangsrechnung ein Beschaffungsauftrag ist, so identifiziert dieses Attribut die Beschaffungsauftrags-Position. Verwenden Sie diesen Parameter, um die Virtuelle Tabelle mit dem Business Object com.cisag.app.purchasing.obj.PurchaseOrderDetail zu verknüpfen und weitere Informationen daraus darzustellen.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Beschaffungsauftrags-Position |
shippingOrderDetail | GUID | Falls die Ware einer Ausgangsrechnungs-Position bereits geliefert wurde, so identifiziert dieses Attribut die Lieferauftrags-Position mit den Lieferschein-Positions-Informationen. Verwenden Sie diesen Parameter, um die Virtuelle Tabelle mit dem Business Object com.cisag.app.sales.obj.ShippingOrderDetail zu verknüpfen und weitere Informationen daraus darzustellen.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Lieferschein-Position |
discountDiscountType | GUID | Dieses Attribut identifiziert die Vertriebspreis-Komponentenart für Positions- und Basisrabatte. Verwenden Sie diesen Parameter, um die Virtuelle Tabelle mit dem Business Object com.cisag.app.sales.obj.PriceDiscountType zu verknüpfen und weitere Informationen daraus darzustellen.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Vertriebsauftrags-Position |
discountPriceType | Valueset | Dieses Attribut bestimmt, ob es sich um einen prozentualen oder einen monetären Rabatt oder Zuschlag handelt. Quantitative Rabatte (Naturalrabatte) werden in einer separaten Unterposition angezeigt und kommen hier als Typ nicht vor.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Basisrabatt · Positionsrabatt |
discountValue | Dezimalzahl | Dieses Attribut enthält den definierten Wert des Rabatts oder Zuschlags abhängig vom Typ des Rabatts und Zuschlags:
· prozentuale Rabatte und Zuschläge · monetäre Rabatte und Zuschläge Dieses Attribut ist gefüllt für folgende Zeilentypen: · Basisrabatt · Positionsrabatt |
discountMeasure | GUID | Dieses Attribut enthält die definierte Einheit des Rabatts oder Zuschlags abhängig vom Typ des Rabatts oder Zuschlags:
· prozentuale Rabatte und Zuschläge · monetäre Rabatte und Zuschläge Dieses Attribut ist gefüllt für folgende Zeilentypen: · Basisrabatt · Positionsrabatt |
discountDefinition | GUID | Dieses Attribut identifiziert die Vertriebspreis-Komponente für Positions- und Basisrabatte und -Zuschläge. Aufgrund der Einschränkungen für Virtuelle Tabellen, können Sie die Virtuelle Tabelle nicht mit dem Business Object com.cisag.app.sales.obj.PriceDefinition verknüpfen. Sie können dieses Attribut daher nur zu Informations- oder Auswertungszwecken verwenden.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Basisrabatt · Positionsrabatt |
discountAppliedValue | Dezimalzahl | Dieses Attribut enthält den monetären Wert des Rabatts oder Zuschlags:
· prozentuale Rabatte und Zuschläge · monetäre Rabatte und Zuschläge · quantitative Rabatte und Zuschläge Dieses Attribut ist gefüllt für folgende Zeilentypen: · Basisrabatt · Positionsrabatt |
headerDiscount Classification |
GUID | Dieses Attribut identifiziert die Vertriebsartikel-Preisklassifikation für Basisrabatte. Verwenden Sie diesen Parameter, um die Virtuelle Tabelle mit dem Business Object com.cisag.app.sales.obj.SalesItemPriceHierarchy zu verknüpfen und weitere Informationen daraus darzustellen.
Dieses Attribut ist gefüllt für folgende Zeilentypen: · Basisrabatt |
Hinweis:
Weitere Ausgabespalten und detaillierte Informationen, wie mithilfe von virtuellen Tabellen auf den Inhalt von dynamischen Business Objects zugegriffen werden kann, finden Sie in den Dokumentationen Einführung: Zugriff auf dynamische Business Objects und Generische dynamische Business Objects.
4.2.2 Eingabeparameter
Spaltenname | Primitiver Datentyp | Beschreibung |
in_invoice | GUID | Dieser Eingabeparameter identifiziert die Ausgangsrechnung eindeutig, die mit dieser Belegausgabe dargestellt werden soll. Verwenden Sie diesen Parameter, um die Virtuelle Tabelle mit dem Business Object com.cisag.app.sales.obj.CustomerInvoice zu verknüpfen und weitere Informationen daraus darzustellen. |
4.3 Datenbanktyp
Die virtuelle Tabelle „app_sales_CustomerInvoiceDetailVirtualTable“ steht auf Datenbanken des Typs OLTP-Datenbank zur Verfügung.
4.4 Berechtigungen
Für die Nutzung des ODBC-Treibers wird folgendes Business Entity für die Berechtigungsermittlung herangezogen:
Ausgangsrechnung
com.cisag.app.sales.obj.CustomerInvoice