Ausgangsrechnungs-Belegzeilen (virtuelle Tabelle)

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

Virtuelle Tabelle

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
das Attribut enthält den Prozentwert

·         monetäre Rabatte und Zuschläge
das Attribut enthält den monetären Wert.

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
das Attribut ist nicht gefüllt

·         monetäre Rabatte und Zuschläge
das Attribut enthält die Währung in der der Rabatt oder Zuschlag erfasst wurde.

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
das Attribut enthält den monetären Wert des prozentualen Rabatts oder Zuschlags

·         monetäre Rabatte und Zuschläge
das Attribut enthält den monetären Wert des monetären Rabatts oder Zuschlags

·         quantitative Rabatte und Zuschläge
das Attribut enthält den Wert der Rabatt- oder Zuschlagsmenge.

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

 

Czy ten artykuł był pomocny?