Ansicht
Dokumentation
ADDR_GET_NEXT_COMM_TYPE - Nächste Kommunikationsart für Sendestrategie zur Adresse bestimmen
SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up BAL_S_LOG - Application Log: Log header dataDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Aufgabe ist es, anhand einer anzugebenden Strategie zu einer Adresse/ Person eine gepflegte Kommunikationsart zu finden.
Eine solche Strategie ist eine Auflistung von Kommunikationsarten, für welche der Reihe nach
überprüft wird, ob eine dieser bei der angegebenen Adresse/ Person gepflegt ist. Beim
ersten Erfolg wird das entsprechende Status_Flag in der Strategie-Tabelle auf 'F' (found) gesetzt. Der
Export-Parameter Comm_Type erhält den Schlüssel der Kommunikationsart und der Parameter
Comm_Values die dazugehörigen Kommunikationsdaten (außer bei den Kommunikationsarten,
deren Daten nicht in einer Extra-Datenbanktabelle gespeichert werden. Im Standard ist das der Fall bei
'LET' und 'VIS'). Der Exportparameter Undeliver wird bei den Kommunikationsdaten ohne eigene Datenbank
gefüllt. Hiermit werden die Unzustellbarkeitskriterien der Straßen- und der Postfachadresse übergeben.
Mißerfolge werden mit 'X' gekennzeichnet, nicht überprüfte Kommunikationsarten mit ' '.
Als Eingabe wird entweder der Name einer schon angelegten Strategie erwartet, oder eine Strategie-Tabelle selber.
Als zusätzliche Funktionalität kann man in der Strategie-Tabelle ein Skip-Flag setzen. Einträge, bei denen dieses Flag gesetzt ist, werden ignoriert.
Obligatorisch ist die Angabe einer Adreßnummer und evtl. einer Personennummer. Falls bekannt, kann man den Adreßtyp ebenfalls mitgeben; dies ist jedoch nicht notwendig.
Beispiel
strategy enthalte den Namen einer schon angelegten Strategie-Tabelle mit Einträgen 'INT', 'FAX' und 'LET' als Kommunikationsarten.
address_number sei eine Adresse, bei der eine Faxnummer (FAX), aber keine Email (INT) gepflegt ist.
Aufruf:
CALL FUNCTION 'ADDR_GET_NEXT_COMM_TYPE'
EXPORTING
strategy = strategy
address_type = address_type
address_number = address_number
IMPORTING
comm_type = comm_type
Nach dem Aufruf steht in comm_type der Wert 'FAX'. In der Strategie- Tabelle ist bei 'INT' der Status auf 'X' gesetzt, bei 'FAX' auf 'F' und bei 'LET' auf ' '.
Hinweise
Bei den Kommunikationsarten ohne eigene Datenbank (im Standard: 'LET' und 'VIS') wird Comm_Values nicht
gefüllt. In diesen Fällen wird aber Undeliver gefüllt, damit die Unzustellbarkeitskriterien
von der Anwendung ausgewertet werden können. Bei den Kommunikationsarten mit eigener Datenbanktabelle wird Undeliver nicht gefüllt.
Werden sowohl der Name einer Strategie, als auch eine Strategie-Tabelle übergeben, so wird die Tabelle immer bevorzugt, d.h. der Name ignoriert.
Bei Verwendung dieses Bausteins in einer Schleife sollte deshalb Sorge dafür getragen werden,
daß die Strategie-Tabelle vorher gelöscht wird, es sei denn man will ausdrücklich diese benutzen.
Fehlt der Adreßtyp, so wird dieser anhand der Adreß-/ Personennummmer zu Lasten der Performance ermittelt.
Fehlerhafte Kombinationen aus Adreßtyp, Adreßnummer und Personennummer, sowie das
Fehlen von sowohl Strategie-Name als auch -Tabelle, werden als PARAMETER_ERROR zurückgegeben.
Ist bei der angegebenen Adresse/ Person keine der in der Strategie- Tabelle angegebenen Kommunkikationsarten gepflegt, so wird die Ausnahme NO_COMM_TYPE_FOUND ausgelöst.
Bei Angabe einer nicht angelegten Adreß-/ Personennummer wird ADDRESS_NOT_EXIST bzw. PERSON_NOT_EXIST zurückgegeben.
Weiterführende Informationen
Parameter
ADDRESS_NUMBERADDRESS_TYPE
BLK_EXCPT
COMM_TYPE
COMM_VALUES
IV_SEARCH_TIME
PERSON_NUMBER
STRATEGY
STRATEGY_TABLE
UNDELIVER
Ausnahmen
ADDRESS_BLOCKEDADDRESS_NOT_EXIST
CONTACT_PERSON_BLOCKED
INTERNAL_ERROR
NO_COMM_TYPE_FOUND
PARAMETER_ERROR
PERSON_BLOCKED
PERSON_NOT_EXIST
Funktionsgruppe
SZAFABAP Short Reference PERFORM Short Reference
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 4916 Date: 20240523 Time: 132122 sap01-206 ( 77 ms )