Klasse CL_BSP_MODEL_ACCESS_ADDRESS
Diese Klasse ist eine abstrakte Superklasse für die eigentliche anwendungsspezifische Model-Access-Klasse der Anwendung. Die meisten Methoden sind bereits implementiert. Es gibt jedoch noch einige Methoden, die die Anwendung implementieren muss, da sie anwendungsspezifische Logik benötigen.
IV_OBJECT_KEY |
Import |
TYPE |
CRMT_BSP_OBJECTKEY |
IV_SCREEN_STRUCTURE_NAME |
Import |
TYPE |
CRMT_BSP_SCRSTRUCNAME |
ES_ADDR_KEY |
Export |
TYPE |
CRMT_BSP_ADDR_KEY |
EV_CONTEXT |
Export |
TYPE |
CRMT_CONTEXT_ID |
ER_PARAMETERS |
Export |
TYPE REF TO |
CL_BSP_ADDRESS_PARAMETERS |
ADDRESS_NOT_EXIST |
Ausnahme |
Der Address Controller erhält nur den anwendungsspezifischen Objektschlüssel vom Haupt-Controller. Der Address Controller selbst hat keine Möglichkeit, die Adressen-ID aus dem Objektschlüssel zu bestimmen. Daher wird diese Methode aufgerufen. Je nach Objektschlüssel und Bildstruktur muss die Anwendung die Adressen-ID in der Struktur ES_ADDR_KEY und den Kontext des Address Controller in EV_CONTEXT zurückgeben.
Die Bildstruktur und der Kontext werden nur benötigt, wenn mehr als ein Address Controller in derselben Anwendung verwendet wird.
Zusätzliche Informationen müssen mit dem Parameter ER_PARAMETERS zurückgegeben werden. Weitere Informationen zu diesen Zusatzparametern finden Sie unter Klasse CL_BSP_ADDRESS_PARAMETERS.
IV_OBJECT_KEY |
Import |
TYPE |
CRMT_BSP_OBJECTKEY |
IV_ADDR_KEY |
Import |
TYPE |
CRMT_BSP_ADDR_KEY |
Diese Methode wird aufgerufen, um die Anwendung zu informieren, dass eine neu angelegte Adresse zum ersten Mal ins lokale BAS-Memory geschrieben wurde. Das heißt, dass die Anwendung sich eine Adressennummer und/oder Personennummer holen muss, ehe die Adresse gesichert werden kann. Weitere Einzelheiten dazu finden Sie unter Adresse anlegen.
IV_SCREEN_STRUCTURE_NAME |
Import |
TYPE |
CRMT_BSP_SCRSTRUCNAME |
ER_GLOBAL_PARAM |
Export |
TYPE REF TO |
CL_BSP_ADDRESS_GLOBAL_PARAM |
Diese Methode fordert von der Anwendung Parameter an, die unabhängig von einzelnen Adressen sind. Es ist wichtige, dass der Address Controller diese Parameter kennt, selbst wenn keine Adresse zur Anzeige ausgewählt ist, z.B. beim Start einer Transaktion. Weitere Informationen zu diesen Zusatzparametern finden Sie unter Klasse CL_BSP_ADDRESS_GLOBAL_PARAM.
Diese Methoden müssen nur dann implementiert werden, wenn die Anwendung die Funktion Felder mit der Anwendung synchronisieren einsetzen will.
Diese Methode muss nur implementiert werden, wenn die Anwendung die Funktion Duplikatprüfungen mit Fremdwerkzeugen aktivieren einsetzen will.
Die Klasse hat zusätzliche Methoden, die die Anwendung verwenden kann.
IV_ADDRESS_HANDLE |
Import |
TYPE |
AD_HANDLE |
IS_ADDRESS_REFERENCE |
Import |
TYPE |
ADDR_REF |
IV_PERSONAL_ADDRESS |
Import |
TYPE |
AD_PRSADDR |
IV_NUMBERRANGE_NUMBER |
Import |
TYPE |
NRNR |
IV_OWNER |
Import |
TYPE |
XFELD |
EV_RETURNCODE_NUMBERRANGE |
Export |
TYPE |
NRRETURN |
EV_ADDRESS_NUMBER |
Export |
TYPE |
AD_ADDRNUM |
Diese Methode gleicht dem Funktionsbaustein ADDR_NUMBER_GET und sollte verwendet werden, um eine Adressnummer für eine neu angelegte Adresse zu erhalten. Diese Methode sollte in der Methode CHECK_BEFORE_SAVE der Prozessklasse aufgerufen werden.
IV_PERSON_HANDLE |
Import |
TYPE |
AD_HANDLE |
IS_PERSON_REFERENCE |
Import |
TYPE |
PERS_REF |
IV_OWNER |
Import |
TYPE |
XFELD |
EV_PERSON_NUMBER |
Export |
TYPE |
AD_PERSNUM |
EV_RETURNCODE_NUMBERRANGE |
Export |
TYPE |
NRRETURN |
Diese Methode gleicht dem Funktionsbaustein ADDR_PERSON_NUMBER_GET und sollte verwendet werden, um eine Personennummer für eine neu angelegte Adresse zu erhalten.
IV_OBJECT_KEY |
Import |
TYPE |
CRMT_BSP_OBJECTKEY |
IV_SCREEN_STRUCTURE_NAME |
Import |
TYPE |
CRMT_BSP_SCRSTRUCNAME |
IS_ADDRESS_KEY |
Import |
TYPE |
CRMT_BSP_ADDRESS_KEY_INTERNAL |
IS_ADDR_REF |
Import |
TYPE |
ADDR_REF |
IS_PERS_REF |
Import |
TYPE |
PERS_REF |
IV_RETAIN_PERSON |
Import |
TYPE |
XFELD SPACE |
EV_DELETE_SUCCESSFUL |
Export |
TYPE |
XFELD |
ET_APPLOG |
Export |
TYPE |
CRMT_BSP_APPLOG_TAB |
ET_CLASS_NAME |
Export |
TYPE |
CRMT_MODELACCESSCLASS_TAB |
ADDRESS_NOT_EXIST |
Ausnahme |
Mit dieser Methode wird eine bestehende Adresse gelöscht. Sie sollte in der DELETE-Methode der Model-Access-Klasse der Anwendung aufgerufen werden. Um die Adresse zu identifizieren, benötigt die Methode entweder den Objektschlüssel oder den Adressschlüssel. Die Strukturen IS_ADDR_REF und IS_PERS_REF haben dieselbe Bedeutung wie in den DELETE-Funktionsbausteinen in Funktionsgruppe SZA0.
Der Parameter EV_DELETE_SUCCESSFUL gibt an, ob es beim Löschen Probleme gab. Falls ja, enthält die Tabelle ET_APPLOG alle Fehlermeldungen.
Der Parameter ET_CLASS_NAME enthält den Namen der entsprechenden Prozessklasse. Die aufrufende Anwendung muss ihn an die Schnittstellenschicht übergeben, damit die Löschung gesichert wird.
IV_OBJECT_KEY |
Import |
TYPE |
CRMT_BSP_OBJECTKEY |
IV_SCREEN_STRUCTURE_NAME |
Import |
TYPE |
CRMT_BSP_SCRSTRUCNAME |
IS_ADDRESS_KEY |
Import |
TYPE |
CRMT_BSP_ADDRESS_KEY_INTERNAL |
ADDRESS_NOT_EXIST |
Ausnahme |
Mit dieser Methode werden alle Änderungen an einer bestehenden Adresse zurückgenommen. Sie sollte in der Initialisierungsklasse der Anwendung aufgerufen werden. Um die Adresse zu identifizieren, benötigt die Methode entweder den Objektschlüssel oder den Adressschlüssel. Wenn die Adresse neu angelegt und noch nicht gesichert war, wird das Anlegen zurückgenommen.