Da-AddOn Control 6 20 7

AddOn Control Version 6.20.7

Benutzerhandbuch AddOn Control

Benutzerhandbuch AddON Control

Autor: it-motive AG, Version: 6.20.7 Seite 2 von 28

Inhaltsverzeichnis

1 Vorbemerkung ................................................................................................................... 3

2 Kundenerweiterungen ....................................................................................................... 3

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

4 Installation .......................................................................................................................... 3

5 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

6 Transportwesen ............................................................................................................... 27

6.1 Entwicklungsklasse ..................................................................................................... 27

6.2 Technische Details ...................................................................................................... 27

7 Ansprechpartner .............................................................................................................. 28



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, BA-DIS und Enhancements knnen modifikationsfrei ber unterschiedliche Funktionen und Trans-aktionen in einem Kundensystem implementiert werden.

Das AddOn Control der it-motive AG dient der Verwaltung und Dokumentation von mandanten-abhngigen 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 Er-weiterungen

Hinterlegen von variablen Werten zum Durchlaufen der Erweiterung

4 Installation

Voraussetzung zum Einsatz des AddOn Control Tools ist ein SAP System mit dem Release-stand 6.20.

Das Tool wird via SAP Transportauftrag ausgeliefert. Alle Objekte liegen im it-motive eigenen Namensraum; beginnend mit /ITMOD/.



5 Handhabung des Produkts

5.1 Berechtigungen und Transaktionen

Der Name des Profils fr alle Funktionen (Transaktionen) lautet ,/ITMOD/ADOC_ALL. Es ent-hlt 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 AddOn Control /ITMOD/ADOC_BADI Liste implementierter BADIs /ITMOD/ADOC_EXIT Liste implementierter Exits /ITMOD/ADOC_WU Verwendungsnachweis Methode IS_ACTIVE /ITMOD/ADOC_ENHO Liste der implementierten Enhancements /ITMOD/PARAM Pflege der Parametergruppen /ITMOD/PARAS Anzeige der Parametergruppen /ITMOD/ADOC_PROP Grundeinstellungen /ITMOD/ADOC_PROT_LIS ADOC: Protokollanzeige /ITMOD/ADOC_PROT_USR ADOC: User einbeziehen fr Protokoll /ITMOD/ADOC_EXCL_USR ADOC: User ausschlieen

5.1.1 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

o 02 ndern eines bestehenden AddOns

o 03 Anzeigen eines bestehenden AddOns

o 05 User von einem AddOn ausschlieen. Prfung ohne ID.

o 06 Lschen eines AddOns

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

o 21 Transportieren eines AddOns



o 70 Grundeinstellungen vornehmen. Prfung ohne ID.

o 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 Vornehmen der Einstellungen

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



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 Con-trol 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 nder-

bar

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



Nummernkreise

Im Menpunkt Nummernkreise werden fr die SAP SYSIDs, in denen die Erwei-terungen entwickelt werden, die Nummernkreise fr die IDs hinterlegt. Die Inter-valle 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



ber die Funktion ndern knnen Sie ein vorhandenes AddOn Control vern-dern oder aktivieren/deaktivieren.

Anzeigen

ber die Funktion Anzeigen knnen Sie ein vorhandenes AddOn Control an-zeigen.

Kopieren

ber die Funktion Kopieren knnen Sie ein vorhandenes AddOn Control auf ei-ne 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 Be-ttigen der Funktionstaste Anlage erscheint folgendes Bild:



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 ange-zeigt 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 wer-den.

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 durchlau-fen werden soll.

Anwendungskomponente



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 entspre-chend der ABAP IN Logik abgeprft 8or9: Mehrere Filterbedingungen unter-schiedlicher 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 Pa-rametergruppen, die Daten fr das aufrufende Programm bereitstellen, zugeord-net werden. Eine Referenz auf das entsprechende Objekt liefert das AddOn Con-trol.

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 Filter-gruppen Filterbedingungen erfasst. Den Filtergruppen knnen Parametergruppen zugeordnet werden.

Bild 7 Detailbild AddOn Control



Bild 8 Pflege von Filtergruppen

Ablauflogik zum o.a. Beispiel:

Es existieren zwei Filtergruppen. Die Filtergruppe fr die Materialart HIBE hat die Sequenz-nummer 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 irgend-ein Zeichen enthlt. Wenn ja, ist die Erweiterung aktiv.

Die Filtergruppe SPACE ist immer implizit verfgbar, so dass nicht zwingend eine Fil-tergruppe definiert werden muss. Sind Filtergruppen definiert, ist sie die letzte Filter-gruppe deren Bedingungen geprft werden. Eine Parametergruppe kann hier nicht hin-terlegt werden und msste ggf. explizit ber das Parameter Tool besorgt werden ( Klas-se /ITMOD/CL_PARAM ).



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



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 Zu-weisung 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 mandantenunab-hngig ist. Ein fehlender Wert wird durch Warnung erkenntlich gemacht.

Diese Prfung erfolgt auch fr die Filter.



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 Erweite-rung 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 er-folgt 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 Deakti-vieren 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.



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



5.2.6 Transport eines Eintrages

ber den Button Transportieren werden die Eintrge zu einer ID/SUB-ID in einen Trans-portauftrag 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 been-det oder aber ausgefhrt werden.

Das Lschen von Eintrgen muss manuell in den jeweiligen Systemen erfolgen.

5.3 Implementierungs-Listen

5.3.1 Liste implementierter Enhancements

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



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 wer-den.

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.



Bild 18 Liste implementierter Enhancements

Aus der erzeugten Liste kann in die Implementierungen und in die dazugehrenden Enhan-cementspots gesprungen werden.

Die Liste der implementierten Enhancements ist ebenfalls erreichbar ber den Transaktions-code /ITMOD/ADOC_ENHO.

5.3.2 Liste implementierter BAdIs

Aus dem Einstiegsbild der Transaktion kann ber den Menpunkt Springen -> Liste implemen-tierter 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 wer-den.

Transportierbar/Lokal



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 im-plementierenden Klassen, die BAdI-Definitionen und in das Coding der implementierten Metho-den 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 implemen-tierten 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 implementier-ter 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.



Bild 22 Liste implementierter Exits

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

5.3.4 Liste Datenelement-Exits

Datenelement-Exits, sogenannte Feldexits, knnen ebenfalls gesucht werden. Aus dem Men-punkt 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 Datenele-ment-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 wer-den, um eine Liste der Modifikationen zu erhalten.



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 ge-startet 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 verwen-det wird.



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.



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 wer-den.

5.4.3 Ausschlusstabelle

ber den Menpunkt AddOn Control User ausschlieen wird in einen Pflegedialog abge-sprungen.

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 ge-boten, 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 darunter-liegenden 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.



Lfdnr 4: Das Control 02011 / 001 wird bei User ITMKON01, im Mandanten 050 abge-schaltet. Gleichzeitige Angabe einer Komponente und einer ID/SubID ist nicht mglich.

Lfdnr 5: Das Control 02011 und alle dazugehrigen Sub_Ids werden bei User ITM-KON01, 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.



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 Ein-trge 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.



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 Me-thode 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 Proto-kolleintrge 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



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 ADOC: Add On Control Grundeinstellungen

/ITMOD/BC_ADOC_C ADOC: Add On Control Mandantensteuerung

/ITMOD/BC_ADOC_G ADOC: Add On Control Filtergruppen

/ITMOD/BC_ADOC_M ADOC: Add ON Control Mandantengrundeinstellung

/ITMOD/BC_ADOC_N ADOC: Add ON Control Nummernkreise

/ITMOD/BC_ADOC_F ADOC: Add On Control Filter

/ITMOD/BC_ADOC_H ADOC: Add On Control Header

/ITMOD/BC_ADOC_T ADOC: Add On Control Kurztext

/ITMOD/BC_ADOC_I ADOC: temporre Daten

/ITMOD/BC_ADOC_U ADOC: User die einen Exit nicht durchlaufen sollen

/ITMOD/BC_ADOC_P ADOC: Protokolltabelle

/ITMOD/BC_ADOC_L 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 AddOn Control

/ITMOD/ADOC_BADI Liste implementierte BAdIs

/ITMOD/ADOC_EXCL_USR ADOC: User ausschlieen

/ITMOD/ADOC_EXIT Liste implementierte Exits

/ITMOD/ADOC_WU Verwendungsnachw. Methode IS_ACTIVE

/ITMOD/ADOC_ENHO Liste der implement. Enhancements (ab 7.00)

/ITMOD/ADOC_PROT_LIS ADOC: Protokollanzeige

/ITMOD/ADOC_PROT_USR ADOC: User einbeziehen fr Protokoll

/ITMOD/PARAM Pflege der Parametergruppen

/ITMOD/PARAS Anzeige der Parametergruppen

/ITMOD/ADOC_PROP Grundeinstellungen



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: [email protected]

oder

Christian Blank Telefon +49 (203) 608 78 160 Telefax +49 (203) 608 78 222 e-mail: [email protected]

Documents

Da-AddOn Control 6 20 7