Arbeiten mit den BAS (SAP-Bibliothek - Business Address Services (BC-SRV-ADR))

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

Funktions- gruppe	Bedeutung
	Funktionsbaustein	Bedeutung
SZA0	Zentrale Funktionsbausteine und Adreßpflege ohne Dialog (alle Adreßtypen).
	<Objekt> _NUMBER_GET	Ziehen einer Nummer für eine Adresse (beliebigen Adreßtyps) beziehungsweise Person. Beim Ziehen müssen Sie einen Verwendungsnachweis angeben.
	<Objekt> _REFERENCE_DELETE	Löschen einer Verwendung zu einer Adresse (vom Adreßtyp 1 oder 2) beziehungsweise Person.
	<Objekt> _REFERENCE_INSERT	Einfügen einer neuen Verwendung zu einer bestehenden Adresse (Adreßtyp 1 oder 2) beziehungsweise Person.
	<Typ> _COMM_GET	Lesen von Telekommunikationsdaten zu einer Adresse von Typ <Typ>.
	<Typ> _COMM_MAINTAIN	Pflegen von Telekommunikationsdaten zu einer Adresse von Typ <Typ>.
	<Typ> _DELETE	Löschen einer Adresse vom Typ <Typ> ohne Dialog
	<Typ> _GET	Lesen einer Adresse vom Typ <Typ> ohne Dialog
	<Typ> _INSERT	Einfügen einer Adresse vom Typ <Typ> ohne Dialog
	<Typ> _UPDATE	Aktualisieren von Adreßdaten ohne Dialog für Adressen vom Typ <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
	<Typ> _GET_COMPLETE		Lesen der kompletten Adreßdaten zur Adresse vom Typ <Typ>
	<Typ> _MAINTAIN_COMPLETE		Pflegen der kompletten Adreßdaten zur Adresse vom Typ <Typ>