p$TDV:SMPAPI:D_Tabell
p$TDV:SMPAPI:D_Tabell
Löschen eines oder mehrerer Datensatzes aus einer beliebigen SalesManager NG- oder Anwender-Datenbanktabelle (siehe auch den Datenaustausch mit Anwender-Datenbanken über den SalesManager NG).
Bitte beachten:
Mit dieser Funktion können Datensätze aus einer beliebigen Tabelle des SalesManager NG gelöscht werden. Dadurch kann u.U. die interne logische Integrität der SalesManager NG-Datenbank gefährdet werden, da der Datensatz evtl. noch aus anderen Tabellen referenziert wird. Alle Änderungen sollten daher sehr bedacht durchgeführt werden - im Zweifelsfall sollte eine Freigabe für bestimmte Modifikationen bei ACBIS eingeholt werden.
Die Bestimmung der zu ändernden Datensätze erfolgt über eine Parametergruppe mit Suchvorgaben (SuchPG). Diese Parametergruppe muss mit dem Typnamen der Parametergruppe, die die Datenbanktabelle beschreibt, definiert sein.Die Werte indieser Parametergruppe werden als Suchvorgabe (mit „gleich") verwendet. Ein Parameter im Zustand LEER bewirkt keine Einschränkung der Suche.
Abhängig von den Suchkriterien können ein oder mehrere Datensätze gefunden werden, z.B. wenn nur ein Ort angegeben wurde. Diese Datensätze werden sämtlich gelöscht.
Um zu verhindern, dass aus Versehen alle Datensätze gelöscht werden, muss eine Suchvorgabe mitgegeben werden.
Bitte beachten: Die Parametergruppe, die in SuchPG übergeben wird, wird indirekt in einer Zeichenkette übergeben, also in Anführungszeichen eingeschlossen. Außerdem muss die Parametergruppe global sein!
Syntax: | Status = p$TDV:SMPAPI:D_Tabell( Tabelle, SuchPG ) | ||
| Argument | Typ | Bedeutung |
| Tabelle | Zeichenkette | Name der Datenbanktabelle |
| SuchPG | Zeichenkette | Name einer Parametergruppe mit der Suchvorgabe. Wenn SuchPG indiziert ist, muss ein fester Index angegeben werden. |
Ergebnis: | Ganzzahl | Status der Operation | |
Beispiel: Löschen aller Datensätze einer Kalkulationstabelle, in denen als Land "DDR" eingetragen ist:
ET "LandLoeschen":
|
| R 01 | SONST |
B 01 |
|
|
|
A 01 | f$PGLeer( ’Kalk’ ) | X |
|
A 02 | Kalk.Land = ’DDR’ | X |
|
A 03 | Status = p$TDV:SMPAPI:D_Tabell( ’KalkTabelle’, ’Kalk’ ) | X |
|
|
|
|
|