AddOn Control

Version 6.20.7

Benutzerhandbuch AddOn Control

Benutzerhandbuch AddON Control

Inhaltsverzeichnis
1

Vorbemerkung ................................................................................................................... 3

Kundenerweiterungen ....................................................................................................... 3

Funktionen ......................................................................................................................... 3

Installation .......................................................................................................................... 3

Handhabung des Produkts................................................................................................ 4

5.1 Berechtigungen und Transaktionen ............................................................................... 4
5.1.1 Berechtigungsobjekt YBC_ADOC_A ....................................................................... 4
5.2 Vornehmen der Einstellungen........................................................................................ 5
5.2.1 Grundeinstellungen fr das AddOn Control ............................................................. 5
5.2.2 Start des Programms .............................................................................................. 7
5.2.3 Grundeinstellungen fr eine Erweiterung ................................................................ 8
5.2.3.1 Pflege von Filtergruppen ................................................................................. 10
5.2.3.2 Pflege von Parametergruppen ........................................................................ 12
5.2.4 Aktivieren/Deaktivieren eines AddOn Controls ...................................................... 14
5.2.5 Beispiel fr den Einbau des AddOn Controls innerhalb einer Erweiterung ............ 15
5.2.6 Transport eines Eintrages ..................................................................................... 16
5.3 Implementierungs-Listen ............................................................................................. 16
5.3.1 Liste implementierter Enhancements .................................................................... 16
5.3.2 Liste implementierter BAdIs .................................................................................. 18
5.3.3 Liste implementierter Exits .................................................................................... 19
5.3.4 Liste Datenelement-Exits ...................................................................................... 20
5.3.5 Modification-Browser ............................................................................................. 20
5.3.6 Verwendungsliste .................................................................................................. 21
5.4 Weitere Funktionen ..................................................................................................... 22
5.4.1 Nchste freie ID ermitteln ...................................................................................... 22
5.4.2 Coding generieren und in das Clipboard stellen. ................................................... 22
5.4.3 Ausschlusstabelle ................................................................................................. 23
5.4.4 Protokoll ................................................................................................................ 24
5.4.4.1 Protokoll anzeigen .......................................................................................... 25
5.4.4.2 Protokollierung verwalten................................................................................ 26

Transportwesen ............................................................................................................... 27
6.1
6.2

Entwicklungsklasse ..................................................................................................... 27
Technische Details ...................................................................................................... 27

Ansprechpartner .............................................................................................................. 28

Autor: it-motive AG, Version: 6.20.7

Seite 2 von 28

Benutzerhandbuch AddON Control

1 Vorbemerkung
Erweiterungen stellen Kundenanforderungen dar, die nicht im SAP Standard zur Verfgung
stehen. Diese Erweiterungen des SAP-Standards in Form von Field-Exits, Customer-Exits, BADIS und Enhancements knnen modifikationsfrei ber unterschiedliche Funktionen und Transaktionen in einem Kundensystem implementiert werden.
Das AddOn Control der it-motive AG dient der Verwaltung und Dokumentation von mandantenabhngigen und mandantenunabhngigen Erweiterungen.

2 Kundenerweiterungen
Kundenerweiterungen sind Anpassungen des SAP-Standards, die vom Kunden angefordert
werden knnen.
Im SAP-Standard werden Kundenerweiterungen als leere Modifikationshlse vorgedacht, die
dann mit kundenspezifischer Logik erweitert werden knnen. Diese Modifikationshlsen werden
als Exits bezeichnet.

3 Funktionen
Das AddOn Control Tool zeichnet sich durch folgende Leistungsmerkmale aus:

keine Modifikation im SAP-Standard

Verwaltung und Dokumentation smtlicher Erweiterungen am SAP Standard an einer
zentralen Stelle
Mandantenbezogenes bzw. mandantenbergreifendes Aktivieren/Deaktivieren von Erweiterungen
Hinterlegen von variablen Werten zum Durchlaufen der Erweiterung

4 Installation
Voraussetzung zum Einsatz des AddOn Control Tools ist ein SAP System mit dem Releasestand 6.20.
Das Tool wird via SAP Transportauftrag ausgeliefert. Alle Objekte liegen im it-motive eigenen
Namensraum; beginnend mit /ITMOD/.

Autor: it-motive AG, Version: 6.20.7

Seite 3 von 28

Benutzerhandbuch AddON Control

5 Handhabung des Produkts

5.1

Berechtigungen und Transaktionen

Der Name des Profils fr alle Funktionen (Transaktionen) lautet ,/ITMOD/ADOC_ALL. Es enthlt alle Berechtigungen, die zur Pflege von Einstellungen und Regeln notwendig sind. Falls Sie
in Ihrem Unternehmen z.B. ein Profil mit Anzeigeberechtigungen bentigen, so muss hierfr ein
eigenes Profil erstellt werden.
Folgende Transaktionen werden ber das Berechtigungsobjekt gesteuert:
/ITMOD/ADOC
/ITMOD/ADOC_BADI
/ITMOD/ADOC_EXIT
/ITMOD/ADOC_WU
/ITMOD/ADOC_ENHO
/ITMOD/PARAM
/ITMOD/PARAS
/ITMOD/ADOC_PROP
/ITMOD/ADOC_PROT_LIS
/ITMOD/ADOC_PROT_USR
/ITMOD/ADOC_EXCL_USR
5.1.1

AddOn Control
Liste implementierter BADIs
Liste implementierter Exits
Verwendungsnachweis Methode IS_ACTIVE
Liste der implementierten Enhancements
Pflege der Parametergruppen
Anzeige der Parametergruppen
Grundeinstellungen
ADOC: Protokollanzeige
ADOC: User einbeziehen fr Protokoll
ADOC: User ausschlieen

Berechtigungsobjekt YBC_ADOC_A

Das o.a. Berechtigungsobjekt ist das Berechtigungsobjekt fr alle Aktivitten im AddOn Control.
Es beinhaltet die folgenden Felder:

/ITMOD/ID ID eines AddOns

o

Einzelne IDs bzw. Bereiche von Ids der AddOns. (Einschrnkung s.u.) Die IDs
mssen mit fhrenden Nullen eingegeben werden (insgesamt 8 Stellen)

ACTVT Aktivitt
o

01 Hinzufgen/Anlegen eines neuen AddOns

02 ndern eines bestehenden AddOns

03 Anzeigen eines bestehenden AddOns

05 User von einem AddOn ausschlieen. Prfung ohne ID.

06 Lschen eines AddOns

07 Aktivieren/Deaktivieren eines AddOns. Hierbei wird zustzlich der Mandant

geprft.

21 Transportieren eines AddOns

Autor: it-motive AG, Version: 6.20.7

Seite 4 von 28

Benutzerhandbuch AddON Control

70 Grundeinstellungen vornehmen. Prfung ohne ID.

H2 Protokollierung einschalten. Prfung ohne ID.

CLIENT Mandant
o

Der Mandant wird nur in Verbindung mit der Aktivitt 07 geprft. Ist ein AddOn
mandantenunabhnig muss der User fr alle Mandanten berechtigt sein. Ist es
mandantenabhngig wird die Prfung fr alle aktiven Mandanten durchgefhrt.

Kundenspezifisch kann somit festgelegt werden, wer welche Aktivitten innerhalb des AddOn
Controls vornehmen darf.

5.2
5.2.1

Vornehmen der Einstellungen

Grundeinstellungen fr das AddOn Control

Nach dem Einspielen des Transportauftrages fr das AddOn Control sollten zunchst die
Grundeinstellungen gepflegt werden.
Die Grundeinstellungen werden ber die Transaktion /ITMOD/ADOC_PROP oder aber ber
den Menpunkt Zustze aufgerufen.

Bild 2: Start der Transaktion /ITMOD/ADOC_PROP

Die Dialogstruktur enthlt 3 Meneintrge, die nachfolgend beschrieben werden:

Grundeinstellung
Mit dem Parameter Mandantensteuerung wird festgelegt, wie Mandanten im
AddOn Control verwendet werden knnen. Der Parameter lsst drei Werte zu:

SPACE = sowohl mandantenabhngige wie -unabhngige Definitionen

sind mglich. Die Auswahl erfolgt bei der Definition.

I = nur mandantenunabhngige Definition mglich. Das AddOn Control

wird in allen Mandanten durchlaufen.

Autor: it-motive AG, Version: 6.20.7

Seite 5 von 28

Benutzerhandbuch AddON Control

D = nur mandantenabhngige Definition mglich. Das AddOn Control

wird nur in den von Ihnen festgelegten Mandanten durchlaufen.

Mit dem Parameter Filtergruppen verwenden wird festgelegt, ob im AddOn Control Filtergruppen verwendet werden knnen.
Mandanten
Fr den Fall, dass in den Zielsystemen fr die Entwicklungen andere Mandanten
als im Entwicklungssystem vorkommen, werden im Menpunkt Mandanten die
mglichen Zielmandanten aller in Frage kommenden Zielsysteme hinterlegt.

Bild 3: Mandantenpflege in der Transaktion /ITMOD/ADOC_PROP

Fr jeden Zielmandanten knnen folgende Optionen festgelegt werden:

_ = frei whlbar
D = der Mandant ist defaultmig ausgewhlt aber nderbar
O = der Mandant ist obligatorisch. Die Auswahl ist im Dialog nicht nderbar

Fr den Fall, dass keine Mandanten gepflegt werden, sind alle Mandanten aus
der Tabelle T000 (ausgenommen Mandant 000 und Mandant066 ) gltig.

Autor: it-motive AG, Version: 6.20.7

Seite 6 von 28

Benutzerhandbuch AddON Control

Nummernkreise
Im Menpunkt Nummernkreise werden fr die SAP SYSIDs, in denen die Erweiterungen entwickelt werden, die Nummernkreise fr die IDs hinterlegt. Die Intervalle mssen berschneidungsfrei sein. Die Pflege der Nummernkreise ist dann
notwendig, wenn mehrere SAP Systeme fr die Entwicklung genutzt werden.

Die Nummernkreise knnen mit dem Objektkatalogeintrag

R3TR TABU /ITMOD/BC_ADOC_N in die weiteren Entwicklungssysteme
transportiert werden.

Bild 4: Nummernkreispflege in der Transaktion /ITMOD/ADOC_PROP

5.2.2

Start des Programms

Das Tool wird ber die Transaktion /ITMOD/ADOC aufgerufen.

Bild 1: Start der Transaktion /ITMOD/ADOC

Die Anwendungsfunktionsleiste enthlt 8 Meneintrge, die nachfolgend beschrieben werden:

Anlegen
ber den Button Anlegen knnen Sie ein AddOn Control anlegen.
ndern

Autor: it-motive AG, Version: 6.20.7

Seite 7 von 28

Benutzerhandbuch AddON Control

ber die Funktion ndern knnen Sie ein vorhandenes AddOn Control verndern oder aktivieren/deaktivieren.
Anzeigen
ber die Funktion Anzeigen knnen Sie ein vorhandenes AddOn Control anzeigen.
Kopieren
ber die Funktion Kopieren knnen Sie ein vorhandenes AddOn Control auf eine neue ID/SUB-ID kopieren oder zu einer bereits vorhandenen ID eine neue
SUB-ID kreieren.
Transport
ber den Button Transportieren werden die Eintrge zu einer ID/SUB-ID in einen
Transportauftrag aufgenommen.
User ausschlieen
Es knnen Regeln erstellt werden, fr die ein AddOn Control durchlaufen bzw.
nicht durchlaufen werden soll
Lschen
ber den Button Lschen wird das AddOn Control zu einer ID/SUB-ID gelscht.
Beenden
ber den Button Beenden wird das Programm verlassen.

5.2.3

Grundeinstellungen fr eine Erweiterung

Bild 5 Einstiegsbild AddOn Control

Zur Anlage eines AddOn Controls werden ID und SUB-ID als numerischer Wert vom Anwender
vorgegeben oder aber ber die Funktionalitt Nchste freie ID automatisch ermittelt. Nach Bettigen der Funktionstaste Anlage erscheint folgendes Bild:

Autor: it-motive AG, Version: 6.20.7

Seite 8 von 28

Benutzerhandbuch AddON Control

Bild 6 Detailbild AddOn Control

Bei einer aktiven Verwendung der Erweiterung wird die erste Verwendung im Feld Verwendung
angezeigt. Weitere Verwendungen knnen ber die Symboltaste weitere Verendungen angezeigt werden.

Bild 6a Detailbild AddOn Control fr Verwendung

Im Bildabschnitt erfolgt folgende Pflege:

Kurztext
Es kann eine Kurztext fr die Beschreibung des AddOn Controls hinterlegt werden.
Langtext
Es kann ein beliebig langer Langtext hinterlegt werden.
Mandantenabhngigkeit
Wird das Feld Mandantenabhngigkeit gesetzt, so kann ber die Auswahlliste
Mandanten gesteuert werden, in welchen Mandanten die Erweiterung durchlaufen werden soll.
Anwendungskomponente

Autor: it-motive AG, Version: 6.20.7

Seite 9 von 28

Benutzerhandbuch AddON Control

Zu Dokumentationszwecken muss die Applikation angeben werden, zu der die
Erweiterung gehrt.
Filter
Mittels der Filterfunktion knnen fr bestimmte Mandanten die Datenelemente
benannt werden, unter deren Bedingungen eine Erweiterung zu durchlaufen ist.
Gleiche Datenelemente werden in einem Range zusammengefasst und entsprechend der ABAP IN Logik abgeprft 8or9: Mehrere Filterbedingungen unterschiedlicher Datenelemente werden mit UND verknpft geprft.
Filtergruppen
Es knnen jetzt Filtergruppen gebildet werden, die ein oder mehrere Filterbedin
gung/en zusammenfassen. Bei der Evaluierung des Aktiv-Kennzeichens werden
alle Gruppen entsprechend der hinterlegten Reihenfolge abgearbeitet, bis eine
vollstndige bereinstimmung gefunden wurde. Den Filtergruppen knnen Parametergruppen, die Daten fr das aufrufende Programm bereitstellen, zugeordnet werden. Eine Referenz auf das entsprechende Objekt liefert das AddOn Control.
5.2.3.1 Pflege von Filtergruppen
Die Pflege von Filtergruppen kann ber den Reiter Filtergruppen aufgerufen werden.
Zunchst werden die Filtergruppen gepflegt. In einem weiteren Schritt werden zu den Filtergruppen Filterbedingungen erfasst. Den Filtergruppen knnen Parametergruppen zugeordnet
werden.

Bild 7 Detailbild AddOn Control

Autor: it-motive AG, Version: 6.20.7

Seite 10 von 28

Benutzerhandbuch AddON Control

Bild 8 Pflege von Filtergruppen

Ablauflogik zum o.a. Beispiel:

Es existieren zwei Filtergruppen. Die Filtergruppe fr die Materialart HIBE hat die Sequenznummer 1, die Filtergruppe fr die Materialart FERT hat die Sequenznummer 2. Zum Schluss
kann jede Materialart genommen werden. Die Ermittlung, ob die Erweiterung aktiv oder inaktiv
ist, luft somit wie folgt ab:

Zunchst wird in den Mandanten 023 und 050 geprft, ob die MTART HIBE ist. Wenn ja,
ist die Erweiterung aktiv.

Wenn die MTART ungleich HIBE ist, wird geprft ob die MTART FERT ist. Wenn ja, ist
die Erweiterung aktiv.

Wenn die beiden o.a. Bedingungen nicht erfllt sind, wird geprft ob die MTART irgendein Zeichen enthlt. Wenn ja, ist die Erweiterung aktiv.

Die Filtergruppe SPACE ist immer implizit verfgbar, so dass nicht zwingend eine Filtergruppe definiert werden muss. Sind Filtergruppen definiert, ist sie die letzte Filtergruppe deren Bedingungen geprft werden. Eine Parametergruppe kann hier nicht hinterlegt werden und msste ggf. explizit ber das Parameter Tool besorgt werden ( Klasse /ITMOD/CL_PARAM ).

Autor: it-motive AG, Version: 6.20.7

Seite 11 von 28

Benutzerhandbuch AddON Control

5.2.3.2 Pflege von Parametergruppen

Die Pflege von Parametergruppen kann ber den Reiter Filtergruppen aufgerufen werden oder
ber die Transaktion /ITMOD/PARAM.
Parametergruppen stellen Daten fr das aufrufende Programm bereit. Eine Referenz auf das
entsprechende Objekt liefert das AddOn Control. Die Pflege von Parametergruppen kann ber
die Transaktion /itmod/para aufgerufen werden, oder aber ber das Symbol Parametergruppen
aus dem Pflegedialog heraus.

Bild 9 Pflege von Parametergruppen

Autor: it-motive AG, Version: 6.20.7

Seite 12 von 28

Benutzerhandbuch AddON Control

Bild 10 Pflege von Parametergruppen

Zunchst einmal wird eine Beschreibung fr eine Parametergruppe hinterlegt.

Bild 11 Zuordnung der Parameter zu einer Gruppe

Im zweiten Schritt werden die Parameter der Gruppe zugeordnet.

Bild 12 Zuordnung von Werten zu einem Parameter

Im dritten Schritt werden den Parametern die gewnschten Rckgabewerte zugewiesen.

Die eingegebenen Werte werden gem ihres Typs in das interne Form gebracht und eine Zuweisung in eine dem Typ entsprechende Variable getestet. Beispiel Datum: Eingabe
05.02.2014 wird in 20140205 konvertiert. Weiterhin wird bei Datenelementen deren Domne
eine Prftabelle zur Werteprfung zugeordnet ist, eine Prfung des Wertes gegen diese Tabelle
durchgefhrt, unter Bercksichtigung des Mandanten sofern die Tabelle nicht mandantenunabhngig ist. Ein fehlender Wert wird durch Warnung erkenntlich gemacht.
Diese Prfung erfolgt auch fr die Filter.
Autor: it-motive AG, Version: 6.20.7
Seite 13 von 28

Benutzerhandbuch AddON Control

5.2.4

Aktivieren/Deaktivieren eines AddOn Controls

ber den Button

wird das AddOn Control aktiviert. Nach Ausfhren des Buttons Aktivieren

ndert sich das Farbsymbol.

Bild 13 Aktivieren eines AddOn Controls

Die Aktivierung eines AddOn Controls ist zwingend notwendig, damit das Coding in der Erweiterung durchlaufen wird.
Folgende Prfungen werden bei der Aktivierung durchlaufen:

Bei Mandantenabhngigkeit muss mindestens ein Mandant aktiv sein

Existiert eine Filtergruppe ohne Filterbedingungen

Werden in den Filtergruppen die gleichen Datenelemente verwendet; wenn nicht erfolgt eine Ausnahme in der Methode IS_ACTIVE.

Da die Meldungen nicht als Fehlermeldungen deklariert sind, kann die Erweiterung trotzdem
aktiviert werden.

ber den Button

wird das AddOn Control deaktiviert. Nach Ausfhren des Buttons Deaktivieren erhalten Sie die nachfolgende Meldung:

Bild 14 - Deaktivieren eines ADDON-Controls

Durch das Deaktivieren wird das AddOn Control in der implementierten Erweiterung nicht mehr
bercksichtigt.

Autor: it-motive AG, Version: 6.20.7

Seite 14 von 28

Benutzerhandbuch AddON Control

5.2.5

Beispiel fr den Einbau des AddOn Controls innerhalb einer Erweiterung

In der Abbildung 15 ist beispielhaft der Aufruf eines AddOn Controls dargestellt.

Bild 15 Beispielimplementierung in einer Erweiterung

Autor: it-motive AG, Version: 6.20.7

Seite 15 von 28

Benutzerhandbuch AddON Control

5.2.6

Transport eines Eintrages

ber den Button Transportieren werden die Eintrge zu einer ID/SUB-ID in einen Transportauftrag aufgenommen.
Nach Bettigen des Buttons Transportieren mssen Sie mitteilen fr welchen Mandanten Sie
das AddOn Control und die damit ggf. verbundenen Filter transportieren mchten.

Bild 16 Mandantenauswahl fr Transportauftrag

Bei der Funktion Transportauftrag schreiben wird geprft, ob es noch einen offenen Transport
mit der ID/SUB_ID gibt. Dieser wird in einer Warnmeldung angezeigt. Die Funktion kann beendet oder aber ausgefhrt werden.
Das Lschen von Eintrgen muss manuell in den jeweiligen Systemen erfolgen.

5.3
5.3.1

Implementierungs-Listen
Liste implementierter Enhancements

Aus dem Einstiegsbild kann ber den Menpunkt Springen -> Liste implementierter Enhanc.
ein Report aufgerufen werden, der existierende Enhancement-Implementierungen auffhrt.

Autor: it-motive AG, Version: 6.20.7

Seite 16 von 28

Benutzerhandbuch AddON Control

Bild 17 Selektionsbild Liste implementierter Enhancements

Dabei knnen die Implementierungen nach folgenden Kriterien ausgewhlt werden:

Aktiv/Inaktiv
Es knnen sowohl aktive als auch inaktive Implementierungen gesucht werden.
Kunde/SAP
Die Suche kann auf Kunden- oder SAP-Implementierungen eingeschrnkt werden.
Transportierbar/Lokal
Implementierungen knnen sowohl transportierbar als auch lokal vorhanden
sein. Auch nach diesem Kriterium knnen die Implementierungen ausgewhlt
werden.
Schalter on / Schalter off
Im Switch Framework besteht die Mglichkeit, Implementierung ber einen
Schalter ein und auszuschalten. ber dieses Kriterium kann danach gefiltert
werden.
Art der Erweiterung
ber diese Checkboxfelder kann die Art der Erweiterung eingeschrnkt werden.
Die Arten, bei denen die Checkbox markiert wurde werden in der Liste angezeigt.

Autor: it-motive AG, Version: 6.20.7

Seite 17 von 28

Benutzerhandbuch AddON Control

Bild 18 Liste implementierter Enhancements

Aus der erzeugten Liste kann in die Implementierungen und in die dazugehrenden Enhancementspots gesprungen werden.
Die Liste der implementierten Enhancements ist ebenfalls erreichbar ber den Transaktionscode /ITMOD/ADOC_ENHO.

5.3.2

Liste implementierter BAdIs

Aus dem Einstiegsbild der Transaktion kann ber den Menpunkt Springen -> Liste implementierter BAdIs ein Report aufgerufen werden, der existierende BAdI-Implementierungen auffhrt.

Bild 19 Selektionsbild Liste implementierter BAdIs

Dabei knnen die Implementierungen nach folgenden Kriterien ausgewhlt werden:

Aktiv/Inaktiv
Es knnen sowohl aktive als auch inaktive Implementierungen gesucht werden.
Kunde/SAP
Die Suche kann auf Kunden- oder SAP-Implementierungen eingeschrnkt werden.
Transportierbar/Lokal

Autor: it-motive AG, Version: 6.20.7

Seite 18 von 28

Benutzerhandbuch AddON Control

Implementierungen knnen sowohl transportierbar als auch lokal vorhanden
sein. Auch nach diesem Kriterium knnen die Implementierungen ausgewhlt
werden.

Bild 20 Liste implementierter BAdIs

Aus der erzeugten Liste kann in die Implementierungen, die dazugehrigen Interfaces, die implementierenden Klassen, die BAdI-Definitionen und in das Coding der implementierten Methoden gesprungen werden.
Die Liste der implementierten BAdIs ist ebenfalls erreichbar ber den Transaktionscode
/ITMOD/ADOC_BADI.

5.3.3

Liste implementierter Exits

Eine weitere Mglichkeit, Implementierungen von AddOns zu suchen ist die Liste der implementierten Exits. Dabei handelt es sich um Exits, die ber die Transaktion SMOD gepflegt werden.
Die Liste ist erreichbar im Einstiegsbild unter dem Menpunkt Springen -> Liste implementierter Exits oder ber den Transaktionscode /ITMOD/ADOC_EXIT.

Bild 21 Selektionsbild Liste implementierter Exits

Dabei knnen sowohl die Funktions-Exits aufgefhrt werden als auch ber die Transaktion
SMOD pflegbare Tabellen-Erweiterungen ber Includetabellen.

Autor: it-motive AG, Version: 6.20.7

Seite 19 von 28

Benutzerhandbuch AddON Control

Bild 22 Liste implementierter Exits

Aus der Liste kann in die Exits, die verwendeten Includes und die SMOD-Projekte abgesprungen werden.
5.3.4

Liste Datenelement-Exits

Datenelement-Exits, sogenannte Feldexits, knnen ebenfalls gesucht werden. Aus dem Menpunkt im Einstiegsbild Springen -> Liste Datenelement-Exits kann in die Pflege der Feldexits
verzweigt werden.
Da diese Technologie veraltet ist und fr das System explizit freigeschaltet sein muss, erhalten
Sie vor dem Aufruf der Exit-Pflege ein Informations-Popup, das Ihnen anzeigt, ob Datenelement-Exits fr das System erlaubt sind oder nicht.
5.3.5

Modification-Browser

Ebenfalls im Einstiegsbild kann im Men Springen in den Modification Browser verzweigt werden, um eine Liste der Modifikationen zu erhalten.

Autor: it-motive AG, Version: 6.20.7

Seite 20 von 28

Benutzerhandbuch AddON Control

5.3.6

Verwendungsliste

Um herauszufinden, an welchen Stellen das AddOn-Control verwendet wurde, kann ber den
Menpunkt Springen -> Verwendungsliste die Suche nach Aufrufen des AddOn-Controls gestartet werden. Alternativ ist diese Liste ber die Transaktion /ITMOD/ADOC_WU erreichbar.

Bild 23 Selektionsbild Verwendungsliste

Wird der Parameter Liste neu aufbauen benutzt, wird das System nach der Verwendung
durchsucht. Dies kann unter Umstnden lange Laufzeiten zur Folge haben.
Ohne einen Neuaufbau der Liste wird das letzte Suchergebnis zur Anzeige verwendet.

Bild 24 Verwendungsliste

Aus der Liste kann sofort an die Stelle verzweigt werden, an dem das AddOn-Control verwendet wird.

Autor: it-motive AG, Version: 6.20.7

Seite 21 von 28

Benutzerhandbuch AddON Control

5.4

Weitere Funktionen

5.4.1

Nchste freie ID ermitteln

Bild 25 Ermitteln der nchsten freien ID

Die o.a. Funktion erreicht man auf folgenden Wegen:

ber den Menpunkt Zustze, dann Nchste freie Nummer

ber das Fernglassymbol in der Drucktastenleiste

Nachdem Aufruf kann die nchste freie ID auf folgenden Wegen ermittelt werden:

Erste freie Nummer Suchen; damit knnen Lcken geschlossen werden

Hchste ID ermitteln

Bild 26 Auswahl Suchverfahren zur Ermittlung der ID

5.4.2

Coding generieren und in das Clipboard stellen.

Die o.a. Funktion kann entweder ber den Menpunkt Zustze -> Coding generieren aufgerufen
werden, oder aber ber das Generierungssymbol in der Drucktastenleiste.

Autor: it-motive AG, Version: 6.20.7

Seite 22 von 28

Benutzerhandbuch AddON Control

Bild 27 Coding generieren und in das Clipboard stellen.

Auf Basis der aktuellen Definition wird das Coding fr den IS_ACTIVE Aufruf generiert und in
die Windows Zwischenablage kopiert. Weiterhin kann im ABAP Editor ber Muster -> Anderes
Muster -> /ITMOD/BC_ADOC_PAT das Coding an die aktuelle Stelle im Editor eingefgt werden.
5.4.3

Ausschlusstabelle

ber den Menpunkt AddOn Control User ausschlieen wird in einen Pflegedialog abgesprungen.

Bild 28 Ausschlusstabelle

ber die Ausschlusstabelle knnen Ausnahmen deklariert werden, bei denen aktive AddOn
Controls trotz gltiger Parameter nicht durchlaufen werden. Es wird dadurch die Mglichkeit geboten, AddOn Controls Benutzer,- und Komponentenspezifisch abzuschalten. Des Weiteren
kann durch die Angabe einer ID / SubID ein spezifisches AddOn Control deaktiviert werden.
Lfdnr 1:

Alle Controls zum User ITMKON01, in der Komponente FI-AA-AA und allen
darunterliegenden Teilkomponenten werden in allen Mandanten abgeschaltet.

Lfdnr 2:

Alle Controls zum User ITMKON01, in der Komponente FI und allen darunterliegenden Teilkomponenten werden im Mandanten 050 abgeschaltet.

Lfdnr 3:

Alle Controls werden bei jedem User, in der Komponente FI-AA-AA und allen
darunterliegenden Teilkomponenten in allen Mandanten abgeschaltet.

Autor: it-motive AG, Version: 6.20.7

Seite 23 von 28

Benutzerhandbuch AddON Control

Lfdnr 4:

Das Control 02011 / 001 wird bei User ITMKON01, im Mandanten 050 abgeschaltet. Gleichzeitige Angabe einer Komponente und einer ID/SubID ist nicht
mglich.

Lfdnr 5:

Das Control 02011 und alle dazugehrigen Sub_Ids werden bei User ITMKON01, in allen Mandanten abgeschaltet.

Lfdnr 6:

Bei User ITMKON01, werden alle Controls in allen Mandanten abgeschaltet.

Lfdnr 7:

Bei jedem User werden alle Controls in allen Mandanten abgeschaltet.

ber die Transaktion /ITMOD/ADOC_EXCL_USR kann die Ausschlusstabelle direkt aufgerufen

werden.

5.4.4

Protokoll

Bild 29 Protokoll

ber den Menpunkt Zustze Protokoll kann der Benutzer die Funktionen zum Protokoll
aufrufen.

Autor: it-motive AG, Version: 6.20.7

Seite 24 von 28

Benutzerhandbuch AddON Control

5.4.4.1 Protokoll anzeigen

Der Menpunkt Protokolle anzeigen verzweigt in das Selektionsbild zur Einschrnkung der
Protokolleintrge.

Bild 30 Protokoll - Selektion

ber den Schalter nur Eintrge, bei denen kann auf den Rckgabewert der IS_ACTIVE
Methode gefiltert werden. Ist die Checkbox markiert, werden nur Eintrge zurckgeliefert bei
denen das Ergebnis positiv gewesen ist. Wird das Feld leer gelassen, bekommt man alle Eintrge angezeigt.

Bild 31 Liste der ausgewhlten Protokolleintrge

ber die Ikonen in den Spalten Selektion und Call Stack werden zustzliche Informationen in
einem Popup zum ausgewhlten Eintrag angezeigt.

Autor: it-motive AG, Version: 6.20.7

Seite 25 von 28

Benutzerhandbuch AddON Control

Grund:

In dieser Spalte wird ein Grund angezeigt, fr den Fall das der Rckgabewert der
IS_ACTIVE negativ gewesen ist. ( Activation, Client, User, Filter )

Selektion:

Im Popup werden die Filter Optionen angezeigt mit denen die IS_ACTIVE Methode aufgerufen wurde

Call Stack:

Im Popup wird die Aufrufhierarchie der Erweiterung angezeigt

ber die Transaktion /ITMOD/ADOC_PROT_LIS kann die Protokollanzeige direkt aufgerufen

werden.
5.4.4.2 Protokollierung verwalten
ber den Menpunkt Zustze Protokollierung einstellen kann der Benutzer ber einen
Pflegedialog Regeln erstellen, fr welche Benutzer bzw. Anwendungskomponenten Protokolleintrge erstellt werden sollen.

Bild 32 Usertabelle fr Protokollierung

LfdNr. 1:

Fr Benutzer ITMKON01 wird in allen Komponenten und zu jeder Kombination

ID/SubID in jedem Mandanten ein Protokolleintrag erzeugt

LfdNr. 2:

Es wird fr alle Benutzer immer ein Protokolleintrag erzeugt

Autor: it-motive AG, Version: 6.20.7

Seite 26 von 28

Benutzerhandbuch AddON Control

6 Transportwesen
6.1

Entwicklungsklasse

Die Entwicklungsobjekte zum ADDON-Tools werden in der Entwicklungsklasse

/ITMOD/BC_ADD_ON_CONTROL ausgeliefert.

6.2

Technische Details
Tabellen
/ITMOD/BC_ADOC_A
/ITMOD/BC_ADOC_C
/ITMOD/BC_ADOC_G
/ITMOD/BC_ADOC_M
/ITMOD/BC_ADOC_N
/ITMOD/BC_ADOC_F
/ITMOD/BC_ADOC_H
/ITMOD/BC_ADOC_T
/ITMOD/BC_ADOC_I
/ITMOD/BC_ADOC_U
/ITMOD/BC_ADOC_P
/ITMOD/BC_ADOC_L

ADOC: Add On Control Grundeinstellungen

ADOC: Add On Control Mandantensteuerung
ADOC: Add On Control Filtergruppen
ADOC: Add ON Control Mandantengrundeinstellung
ADOC: Add ON Control Nummernkreise
ADOC: Add On Control Filter
ADOC: Add On Control Header
ADOC: Add On Control Kurztext
ADOC: temporre Daten
ADOC: User die einen Exit nicht durchlaufen sollen
ADOC: Protokolltabelle
ADOC:User fr die eine Protokoll erstellt wird

Klassen
/ITMOD/CL_ADDON_CONTROL ADOC: Basisklasse Add On Control
/ITMOD/CL_PARAM
ADOC: Zugriffe auf die Parameter

Transaktionen
/ITMOD/ADOC
/ITMOD/ADOC_BADI
/ITMOD/ADOC_EXCL_USR
/ITMOD/ADOC_EXIT
/ITMOD/ADOC_WU
/ITMOD/ADOC_ENHO
/ITMOD/ADOC_PROT_LIS
/ITMOD/ADOC_PROT_USR
/ITMOD/PARAM
/ITMOD/PARAS
/ITMOD/ADOC_PROP

AddOn Control
Liste implementierte BAdIs
ADOC: User ausschlieen
Liste implementierte Exits
Verwendungsnachw. Methode IS_ACTIVE
Liste der implement. Enhancements (ab 7.00)
ADOC: Protokollanzeige
ADOC: User einbeziehen fr Protokoll
Pflege der Parametergruppen
Anzeige der Parametergruppen
Grundeinstellungen

Autor: it-motive AG, Version: 6.20.7

Seite 27 von 28

Benutzerhandbuch AddON Control

7 Ansprechpartner

it-motive AG
Zum Walkmller 6
47269 Duisburg
Matthias Heming
Telefon +49 (203) 608 78 120
Telefax +49 (203) 608 78 222
e-mail: matthias.heming@it-motive.de
oder
Christian Blank
Telefon +49 (203) 608 78 160
Telefax +49 (203) 608 78 222
e-mail: christian.blank@it-motive.de

Autor: it-motive AG, Version: 6.20.7

Seite 28 von 28