ObjektdokumentationKlasse 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.

Methoden
GET_ADDRESS_KEY

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.

ADDRESS_IS_CREATED

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.

GET_GLOBAL_PARAMETERS

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.

GET_SYNCHRONIZED_FIELDS und SET_SYNCHRONIZED_FIELDS

Diese Methoden müssen nur dann implementiert werden, wenn die Anwendung die Funktion Felder mit der Anwendung synchronisieren einsetzen will.

DUPLICATES_FOUND

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.

GET_ADDRESS_NUMBER

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.

GET_PERSON_NUMBER

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.

DELETE_ADDRESS

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.

INITIALIZE_ADDRESS

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.