p$TDV:SMPAPI:L_WBauGr

Lesen einer kompletten Baugruppe aus einem Warenkorb inkl. der Merkmale. Die Beschreibung der Funktionsweise kann am besten der Beschreibung der Parametergruppe WKBauGrp Parametergruppe WKBauGrp entnommen werden, in der die Baugruppen-Struktur abgebildet wird.

Tip:

Die relativ komplex wirkende Beschreibung der Übergabeparameter kann weitgehend ignoriert werden. Für eine „normale" Anwendung reicht es durchaus aus, nachzuvollziehen, wo welche Informationen abgelegt sind. Nur falls während der ET-Ausführung Fehler auftreten sollten, kann ein genaueres Nachvollziehen der Funktionsweise notwendig sein.

Folgende Parameter und Parametergruppen werden „indirekt" als Name übergeben und daher i.d.R. in Anführungszeichen eingeschlossen. Außerdem müssen sie global sein:

BgrPGL	Name eines globalen Parametergruppen-Feldes
MatPGL	Name eines globalen Parametergruppen-Feldes
StlPGL	Name eines globalen Parametergruppen-Feldes
MerkmalPG	a) Name eines globalen Parametergruppen-Feldes b) Name eines globalen Zeichenketten-Feldes. Jeder Wert im Zeichenketten-Feld ist ein Name eines globalen Parametergruppen-Feldes c) ’’
DBMerkmPG	a) Name einer Parametergruppe aus der Datenbank (die PG muss nicht notwendigerweise deklariert sein) b) Name eines globalen Zeichenketten-Feldes Jeder Wert im Zeichenketten-Feld ist ein Name einer Parametergruppe aus der Datenbank (muss nicht deklariert sein)
NameAnzPos	Name eines globalen Ganzzahl-Parameters

Tip:

Zur Vereinfachung der folgenden Operationen kann davon ausgegangen werden, dass die Inhalte der Parameter MaterialIndex, StlIndex und MerkIndex nach Anwendung dieser Funktion immer mit einem identischen Wert gefüllt sind, und zwar mit dem Feldindex des Feldes BgrPGL.

Syntax:	Status = p$TDV:SMPAPI:L_WbauGr( MaterialID, BgrPGL, MatPGL, StlPGL, MerkmalPG, DBMerkmPG, NameAnzPos, MitKopfDaten )
	Argument	Typ	Bedeutung
	MaterialID	Zeichenkette	Identifikation der Warenkorbposition der Baugruppe in der Tabelle V_Warenpos
	BgrPGL	Zeichenkette	Name eines Parametergruppen-Feldes, das nach Aufruf die Warenkorb-Produktdaten enthält; die PG muss vom Typ WKBauGrp Parametergruppe WKBauGrpsein, sie muss indiziert sein und ohne Index übergeben werden.
	MatPGL	Zeichenkette	Name eines Parametergruppen-Feldes mit Materialdaten aus der Tabelle V_Warenpos. Die PG muss indiziert sein und ohne Index übergeben werden. Die Zuordnung der Daten zu einer Baugruppenposition ergibt sich aus dem Feld BgrPGL.
	StlPGL	Zeichenkette	Name eines Parametergruppen-Feldes mit weiteren Materialdaten aus der Tabelle V_Warenpos..Diese Parametergruppe ist nur aus Kompatibilitätsgründen enthalten Es sollte ein leerer Textes ('') verwendet werden.
	MerkmalPG	Zeichenkette	a) Name eines Parametergruppen-Feldes, das nach dem Aufruf je Index die Merkmale zu einer Position enthält b) Name eines (globalen) Feldes (Liste) mit den Namen der zu lesenden Merkmals-Parametergruppen. Jede einzelne Merkmals-PG muss indiziert sein und ohne Index angegeben werden. Das Listenende ist durch einen Eintrag mit LEER hinter der letzten PG gekennzeichnet. c) ein leerer Text (''), wenn keine Merkmale gewünscht sind (nur wenn die Baugruppe später nicht geändert oder kopiert werden soll) Die Zuordnung der Daten zu einer Baugruppenposition ergibt sich aus dem Feld BgrPGL.
	DBMerkmPG	Zeichenkette	Namen der in MerkmalPG übergebenen Parametergruppen in der Datenbank. Bitte beachten: Die Belegung dieses Parameters muss exakt der Belegung der Merkmalsdaten entsprechen - nur mit den PG-Namen, unter denen die Merkmale gespeichert wurden. Bitte beachten: Der Parameter muss übergeben werden, auch wenn die Namen identisch zu denen in MerkmalPG übergebenen Namen sind.
	NameAnzPos	Zeichenkette	Name eines (globalen) Ganzzahl-Parameters, der nach Aufruf der Funktion die Anzahl der gelesenen Positionen enthält. Der Parameter muss übergeben werden, ein Leertext ist nicht zulässig.
	MitKopfDaten	Ganzzahl	Kennzeichen, ob die Baugruppen-Position selbst gelesen werden soll 1: komplette Baugruppe (empfohlen, für eine spätere Änderung oder Kopie der Baugruppe sind die Kopfdaten erforderlich) 0: nur Positionen der Baugruppe
Ergebnis:	Ganzzahl		Status der Operation 0: Daten erfolgreich gelesen <0: Fehler gemäß ePOS-Fehler-Liste >0: Fehler gemäß SMP-Fehlerstatus-Liste Der Rückgabestatus in SalesManager NG-Funktionen
Beispiel:	siehe unter der Beschreibung der Parametergruppe WKBauGrp