p$TDV:SMPAPI:S_WakPos
p$TDV:SMPAPI:S_WakPos
Ändern der Daten einer bestehenden Warenkorbposition. Die Merkmale der Position können über p$TDV:SMPAPI:S_MrkPos geändert bzw. geschrieben werden. Diese Funktion kann beispielsweise bei der Übernahme einer konfigurierbaren Position in den Warenkorb eingesetzt werden, um die Daten der Warenkorbposition zu schreiben. Untergeordnete Positionen können über p$TDV:SMPAPI:X_Baugrpp$TDV:SMPAPI:X_BauGrp angelegt werden.
Der Warenkorb wird über die Warenkorb-Positionsidentifikation (Parameter MaterialID) aus der Tabelle V_Warenpos identifiziert. Diese MaterialID steht beispielsweise bei der Funktion „Position bearbeiten" aus dem SalesManager NG-Warenkorb-Formular im Parameter Auftrag.ObjektID direkt zur Verfügung. Weitere Informationen dazu können dem SalesManager NG Systemhandbuch entnommen werden.
Die Positionsdaten werden in einer Parametergruppe übergeben. Es werden nur diejenigen Datenbankfelder aus der Tabelle V_Warenpos, deren Parametern in dieser Parametergruppe entsprechen und die nicht LEER sind, geändert. Siehe dazu auch den Datenaustausch mit SalesManager NG über Parametergruppen.
Über diese Funktion können alle Datenfelder aus der Tabelle V_Warenpos geändert und auch gelöscht werden Dadurch kann u.U. die interne logische Integrität der SalesManager NG-Datenbank gefährdet werden. Alle Änderungen sollten daher sehr bedacht durchgeführt werden - im Zweifelsfall sollte eine Freigabe für bestimmte Modifikationen bei ACBIS eingeholt werden.
Auf jeden Fall sollte die in PosPG übergebene Parametergruppe vor dem Füllen mit f$PGLeer initialisiert werden, da versucht wird, alle Parameter im Zustand UNDEF im SalesManager NG zu löschen. Im Falle einer nicht belegten MaterialId (in PosPG) führt dies zu einem Fehler.
Bitte beachten: Die Parametergruppe, die in PosPG übergeben wird, wird indirekt in einer Zeichenkette übergeben, also in Anführungszeichen eingeschlossen. Außerdem muss die PG global sein!
Syntax: | Status = p$TDV:SMPAPI:S_WakPos( PosPG, MaterialID ) | ||
| Argument | Typ | Bedeutung |
| PosPG | Zeichenkette | Name der Parametergruppe mit den zu schreibenden Warenkorb-Positionsdaten; die PG darf nicht indiziert sein |
| MaterialID | Zeichenkette | Identifikation der Warenkorbposition in der Tabelle V_Warenpos |
Ergebnis: | Ganzzahl | Status der Operation | |
Beispiel: | Status = p$TDV:SMPAPI:S_WakPos( 'pos', Auftrag.ObjektID ) | ||