p$TDV:SMPAPI:A_S_Person
p$TDV:SMPAPI:A_S_Person
Anlegen einer Person oder ändern von Personendaten für eine über PersonID gegebene Person. Wenn die PersonID nicht belegt ist, so wird eine neue Person angelegt. Es können alle Felder der Sicht V_Person modifiziert werden. Zusätzlich können mit dieser Funktion die Telekommunikationsdaten der Person geändert/ angelegt werden. Beim Ändern von Personen wird für jede einzelne Zeile der übergebenen TelekomPG über die TelekomArt geprüft, ob diese geändert oder eingefügt wird. Ein Löschen ist mit dieser Funktion nicht möglich. Bei den Daten der TelekomPG muss der Parameter TelekomArt gefüllt sein. Ist dieser Parameter nicht belegt, gilt dies als Endekriterium für das Abarbeiten dieses Felds.
Die zu ändernden Daten werden in einer Parametergruppe übergeben, deren Parameternamen den Feldnamen in V_Person entsprechen müssen. Alle Parameter, die einen Wert haben, werden auf der Datenbank geändert (siehe dazu auch den Datenaustausch mit SalesManager NG über Parametergruppen).
Bitte beachten:
Über diese Funktion können alle Datenfelder aus der Sicht V_Person 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.
Bitte beachten: Die Parametergruppe, die in PersonPG ü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:A_S_Person( AnschriftID, PersonPG, TelekomPG ) | ||
| Argument | Typ | Bedeutung |
| AnschriftID | Zeichenkette | ID der Anschrift, der die Person zugeordnet werden soll. Diese ID muss übergeben werden. |
| PersonPG | Zeichenkette | Name der Parametergruppe mit den zu ändernden Personendaten; wenn die PGindiziert ist, muss ein fester Index angegeben werden. |
| TelekomPG | Zeichenkette | Name der Parametergruppe mit den Telekommunikationsdaten. Diese PG sollte indiziert sein. Falls keine Telekommunikationsdaten eingetragen werden sollen, kann auch ein Leerstring ('') übergeben werden. |
Ergebnis: | Ganzzahl | Status der Operation | |
Beispiel: | f$PGLeer( 'Person' ) | ||