p$TDV:SMPAPI:L_AdrEti
p$TDV:SMPAPI:L_AdrEti
Bestimmen eines Adressetiketts zu einer gegebenen Anschrift oder Person. Dieses Etikett kann z.B. bei der Erzeugung von Ausgabedokumenten im Briefkopf verwendet werden.
Diese Funktion entspricht der Funktion „Ablage" im Formular Anschrift des SalesManager NG. Wie dort kann auch bei dieser Funktion zwischen der Anschrift der Person und der Firma (Parameter ObjektArt) sowie zwischen Hausanschrift und Postfachadresse (Parameter Form) gewählt werden. Ist die gewünschte Ausgabeform nicht vorhanden oder nicht definiert, wird automatisch auf die jeweils andere Alternative umgeschaltet.
Die Gestaltung des Adressetiketts richtet sich nach dem der Adresse zugeordneten Land und kann in den SalesManager NG Systemeinstellungen für jedes Land frei definiert werden (siehe SalesManager NG Systemhandbuch).
Ein Adressetikett für Deutschland besteht beispielsweise aus folgenden Zeilen:
Firma (Zeile 1)
Firma (Zeile 2)
Person
Abteilung
Straße oder Postfach
<Leerzeile>
LKZ - PLZ Ort
Fehlen Informationen oder wurden nicht alle Informationen im SalesManager NG ausgefüllt (besteht die Firmenbezeichnung beispielsweise nur aus einer Zeile), so bleibt an dieser Stelle nicht etwa eine Leerzeile zurück, sondern die Zeile wird komplett entfernt, so dass eine ansprechende Optik gewahrt bleibt.
Hinweis: Wurden bei der Definition der Daten im SalesManager NG zusätzliche Zeilen erzeugt (Eingabe von umschalt+eingabe in einem Datenfeld), so kann das Etikett auch zusätzliche Zeilen enthalten.
Syntax: | Etikett = p$TDV:SMPAPI:L_AdrEti( ObjektArt, ObjektID, Form ) | ||
| Argument | Typ | Bedeutung |
| ObjektArt | Zeichenkette | Kennzeichen, für welches Objekt das Etikett ermittelt werden soll: |
| ObjektID | Zeichenkette | Identifikation des Objektes abhängig von der ObjektArt: |
| Form | Zeichenkette | Kennzeichen für die Ausgabeform: |
Ergebnis: | Zeichenkette | Das ermittelte Adressetikett | |
Beispiel: | mit oben angegebener Etikettform erhält man nach Etikett = p$TDV:SMPAPI:L_AdrEti('P', '4711', '1') → Etikett = 'Muster KG¶ | ||
Tipp:
Wenn es einfacher ist, das Etikett in getrennten Zeilen statt in einer Zeichenkette weiter zu bearbeiten, kann das Etikett mittels p$TDV:Allg:ZerlText in Einzelzeilen zerlegt werden.