p$TDV:SMPAPI:L_PerAns

Lesen der Anschriftsdaten zu einer Person aus der Tabelle V_Anschrift sowie aller Merkmale, die zu dieser Anschrift gehören. Die Person muss bereits gelesen worden sein.

Übergeben wird eine Parametergruppe, die nach dem Aufruf die gelesenen Daten enthält. Siehe dazu auch den Datenaustausch mit SalesManager NG über Parametergruppen. Häufig wird eine gemeinsame PG für Personen- und Anschriftsdaten verwendet (siehe Beispiel).

Die zu lesende Anschrift wird bei dieser Funktion über den Parameter AnschriftID aus der übergebenen Parametergruppe bestimmt (bei Verwendung der - ansonsten austauschbaren - Funktion p$TDV:SMPAPI:L_Anschr wird die Anschriftsidentifikation separat übergeben).

Der Parameter AnschriftID kann sowohl als Zeichenkette wie auch als Ganzzahl definiert werden, allerdings werden in dieser Schnittstelle Identnummern häufiger als Zeichenkette verwendet.

Die evtl. zu dieser Anschrift gehörenden Merkmale werden automatisch gelesen. Dazu müssen die Parameter nur in dem Verbund, der diese Funktion aufruft, oder aber global innerhalb dieses Ablaufs definiert sein. Sollen ausschließlich die Merkmale gelesen werden, steht dazu die Funktion p$TDV:SMPAPI:L_MrkMal zur Verfügung.

Bitte beachten: Die Parametergruppe, die in AdressPG ü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:L_PerAns( AdressPG )
	Argument	Typ	Bedeutung
	AdressPG	Zeichenkette	Name der Parametergruppe mit zu lesenden Anschriftsdaten; bei indizierter PG muss der Index angegeben werden. Zur Identifikation der Anschrift muss ein Parameter namens AnschriftID vorhanden und belegt sein!
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: Lesen der Anschriftsdaten zu einer über ID gegebenen Person

Gegeben sei die Parametergruppe Adresse (global) mit folgenden Parametern (es könnten auch mehr oder andere Parameter definiert werden):

Parametername / Feldname	Datentyp
AnschriftID	Ganzzahl
Rufname	Zeichenkette
Firma1	Zeichenkette
Ort	Zeichenkette
PersonID	Zeichenkette
Briefanrede	Zeichenkette
Abteilung	Zeichenkette

Nach Lesen der Personendaten mittels

Status = p$TDV:SMPAPI:L_Person( ’Adresse’, ’815’ )

ist die Parametergruppe mit den Personendaten gefüllt:

Parameter	Wert
Adresse.AnschriftID	4711	→ die Anschriftsidentifikation der Person
Adresse.Rufname
Adresse.Firma1
Adresse.Ort
Adresse.PersonID	’815’	→ die IdentNr der Person wie übergeben
Adresse.Briefanrede	’Herr Dr. Muster’
Adresse.Abteilung	’Vertrieb’

Nun kann die Anschrift dazu gelesen werden:

Status = p$TDV:SMPAPI:L_PerAns(’Adresse’)

Danach enthält die Parametergruppe folgende Daten:

Parameter	Wert
Adresse.AnschriftID	4711
Adresse.Rufname	’Muster’	→ neu: Rufname der Anschrift
Adresse.Firma1	’Muster KG’	→ neu: Firmenname
Adresse.Ort	’Musterhausen’	→ neu: Firmensitz
Adresse.PersonID	’815’
Adresse.Briefanrede	’Herr Dr. Muster’
Adresse.Abteilung	’Vertrieb’