Arbeiten mit den BAS
Dieses Kapitel richtet sich ausschließlich an Entwickler. Es beschreibt grundlegende Schritte, um Adressen mit den BAS zu verwalten:
Planung
Pflegen von Adressen
Pflegen von Verwendungsnachweisen
Verwendung von Standard-Dialogen
Alle Funktionen und Daten zu den BAS sind in der Entwicklungsklasse SZAD gekapselt. In den nächsten Abschnitten erhalten Sie eine Übersicht über Funktionen dieser Entwicklungsklasse, mit denen Sie die oben genannten Aufgaben realisieren.
Hinweis
Der Demoreport EXADR1 in der Entwicklungsklasse SZAD veranschaulicht die Verwendung der BAS anhand eines kleinen Anwendungsszenarios.
Funktionsgruppen
Um Adressen mit Hilfe der BAS zu verwalten benötigen Sie im Wesentlichen Funktionsbausteine von vier Funktionsgruppen:
Die Funktionsgruppe SZA0 kapselt Funktionen zum Verwalten von Adressen aller Adreßtypen ohne Dialog (die BAS nutzen diese Bausteine selbst für die Implementierung der Standard-Dialoge). Die Funktionsbausteine greifen dabei auf das lokale Gedächtnis (interne Tabellen dieser Funktionsgruppe) zu.
Die Funktionsgruppen SZA1, SZA5 und SZA7 stellen Standarddialoge (Subscreen, Popup) für den Adreßtyp 1, 3 beziehungsweise 2 bereit. Siehe dazu das Kapitel Standard-Dialoge der BAS verwenden.
Übersicht über wichtige Funktionsbausteine
Das Präfix eines Funktionsbausteins der Entwicklungsklasse SZAD bezieht sich entweder auf:
das
Objekt
Adresse im Allgemeinen (Präfix ADDR) oder auf das Objekt Person (Präfix ADDR_PERSON). Im ersteren Fall bezieht sich die Funktion auf alle oder eine Auswahl von Adreßtypen (im Text steht dann ein entsprechender Hinweis).auf einen der
Adreßtypen
:Präfix bei Adreßtyp 1 (Organisationsadressen): ADDR
Präfix bei Adreßtyp 2 (Personenadressen): ADDR_PERSONAL
Präfix bei Adreßtyp 3 (Arbeitsplatzadressen): ADDR_PERS_COMP
In der folgenden Tabelle sind Funktionsbausteine über den Platzhalter <Objekt>
(d.h. es gibt für beide Objekte einen Funktionsbaustein) beziehungsweise <Typ>
(d.h. es gibt zu jedem Adreßtyp einen Funktionsbaustein) zusammengefaßt.
Ob sich das Präfix ADDR auf die Adresse im Allgemeinen oder auf den Adreßtyp 1 bezieht, erkennt man an dem Verwendeten Platzhalter.
Übersicht der Funktionsbausteine nach Funktionsgruppen
Funktionsgruppe |
Bedeutung |
|
Funktionsbaustein |
Bedeutung |
|
SZA0 |
Zentrale Funktionsbausteine und Adreßpflege ohne Dialog (alle Adreßtypen). |
|
|
Ziehen einer Nummer für eine Adresse (beliebigen Adreßtyps) beziehungsweise Person. Beim Ziehen müssen Sie einen Verwendungsnachweis angeben. |
|
|
Löschen einer Verwendung zu einer Adresse (vom Adreßtyp 1 oder 2) beziehungsweise Person. |
|
|
Einfügen einer neuen Verwendung zu einer bestehenden Adresse (Adreßtyp 1 oder 2) beziehungsweise Person. |
|
|
Lesen von Telekommunikationsdaten zu einer Adresse von Typ |
|
|
Pflegen von Telekommunikationsdaten zu einer Adresse von Typ |
|
|
Löschen einer Adresse vom Typ |
|
|
Lesen einer Adresse vom Typ |
|
|
Einfügen einer Adresse vom Typ |
|
|
Aktualisieren von Adreßdaten ohne Dialog für Adressen vom Typ |
|
ADDR_MEMORY_CLEAR |
Initialisierung des lokalen Gedächtnisses der Funktionsgruppe SZA0. |
|
ADDR_MEMORY_SAVE |
Sichert alle Adreßdaten vom lokalen Gedächtnis auf die Datenbank, vorausgesetzt alle Handles wurden vorher in Nummern umgewandelt. |
|
ADDR_SINGLE_SAVE |
Sichert Adreßdaten einer Adresse vom lokalen Gedächtnis auf die Datenbank |
|
SZA1 |
Dialoge für Organisationsadressen (Adreßtyp 1) |
|
ADDR_DIALOG |
Popup: Dialogpflege von Organisationsadressen (Anlegen, Ändern, Anzeigen). |
|
ADDR_DIALOG_PREPARE |
Popup, Subscreen, Fullscreen: Setzt Parameter für Sonderfälle der Adreßpflege (Feldoptionen, Titel, etc.). |
|
ADDR_EXIT_SUBSCREEN |
Subscreen: Prüft, ob Adreßdaten geändert wurden (Aufruf im Modul AT EXIT-COMMAND). |
|
ADDR_EXP_SUBSCREEN |
Subscreen: Datenübergabe aus Anwendungs-Modulpool an Subscreen (Handle, initiale Werte für Adreßfelder, etc.). |
|
ADDR_IMP_SUBSCREEN |
Subscreen: Datenübergabe aus Subscreen an Anwendungs-Modulpool (Inhalte der Adreßfelder, Fehlerinformationen, Änderungsflag). |
|
ADDR_SELECT_FOR_DIALOG |
Fullscreen: Einstieg in die Dialogpflege für Adressen als Alternative zur parametrisierten Transaktion SADR (wenn man ADDR_DIALOG_PREPARE für eine anwendungsspezifiesche Konfiguration des Dynpros benötigt) |
|
ADDR_SUBSCREEN_SET_OKCODE |
Subscreen: Weiterleiten eines OK_Codes zur Steuerung des Subscreens. |
|
SZA5 |
Dialoge für Arbeitsplatzadressen (Adreßtyp 3) |
|
ADDR_PERS_COMP_DIALOG |
Popup: Dialogpflege von Arbeitsplatzadressen (Anlegen, Ändern, Anzeigen). |
|
ADDR_PERS_COMP_DIALOG_PREPARE |
Popup, Subscreen, Fullscreen: Setzt Parameter für Sonderfälle der Adreßpflege (Feldoptionen, Titel, etc.). |
|
ADDR_PERS_COMP_EXIT_SUBSCREEN |
Subscreen: Prüft, ob Adreßdaten geändert wurden (Aufruf im Modul AT EXIT-COMMAND). |
|
ADDR_PERS_COMP_EXP_SUBSCREEN |
Subscreen: Datenübergabe aus Anwendungs-Modulpool an Subscreen (Handle, initiale Werte für Adreßfelder, etc.). |
|
ADDR_PERS_COMP_IMP_SUBSCREEN |
Subscreen: Datenübergabe aus Subscreen an Anwendungs-Modulpool (Inhalte der Adreßfelder, Fehlerinformationen, Änderungsflag). |
|
ADDR_PERS_COMP_SELECT_DIALOG |
Fullscreen: Einstieg in die Dialogpflege für Adressen als Alternative zur parametrisierten Transaktion SADP (wenn man ADDR_PERS_COMP_DIALOG_PREPARE für eine anwendungsspezifiesche Konfiguration des Dynpros benötigt) |
|
ADDR_PERS_COMP_SUB_SET_OKCODE |
Subscreen: Weiterleiten eines OK_Codes zur Steuerung des Subscreens. |
|
SZA7 |
Dialoge für Personenadressen (Adreßtyp 2) |
|
ADDR_PERSONAL_DIALOG |
Popup: Dialogpflege von Personenadressen (Anlegen, Ändern, Anzeigen). |
|
ADDR_PERSONAL_DIALOG_PREPARE |
Popup, Subscreen, Fullscreen: Setzt Parameter für Sonderfälle der Adreßpflege (Feldoptionen, Titel, etc.). |
|
ADDR_PERSONAL_EXIT_SUBSCREEN |
Subscreen: Prüft, ob Adreßdaten geändert wurden (Aufruf im Modul AT EXIT-COMMAND). |
|
ADDR_PERSONAL_EXP_SUBSCREEN |
Subscreen: Datenübergabe aus Anwendungs-Modulpool an Subscreen (Handle, initiale Werte für Adreßfelder, etc.). |
|
ADDR_PERSONAL_IMP_SUBSCREEN |
Subscreen: Datenübergabe aus Subscreen an Anwendungs-Modulpool (Inhalte der Adreßfelder, Fehlerinformationen, Änderungsflag). |
|
ADDR_PERSONAL_SELECT_DIALOG |
Fullscreen: Einstieg in die Dialogpflege für Adressen als Alternative zur parametrisierten Transaktion SADQ (wenn man ADDR_PERSONAL_DIALOG_PREPARE für eine anwendungsspezifiesche Konfiguration des Dynpros benötigt) |
|
ADDR_PERSONAL_SUB_SET_OKCODE |
Subscreen: Weiterleiten eines OK_Codes zur Steuerung des Subscreens. |
|
SZAE |
Bausteine für komplexe oder zusammengefaßte Operationen auf Adressen |
|
|
Lesen der kompletten Adreßdaten zur Adresse vom Typ |
|
|
Pflegen der kompletten Adreßdaten zur Adresse vom Typ |
|