Zusatzbutton CUST1 für kundenspezifische Funktionen

BUTTON_CUST1

// Ab Allevo-Version 2.9.24 (erweitert in Version 3.3.38)

In der Allevo-Planungsansicht können kundenspezifische Funktionen eingebunden werden, beispielsweise für das Anlegen von Stammdaten oder die Nachbearbeitung bereits existierender Plandaten. Die folgenden Aufrufe bei diesem Button hinterlegt sein:

1. Kundenspezifischer Funktionsbaustein (Details / Schnittstelle siehe unten)

2. Beliebige SAP Transaktion (nur Aufruf ohne Übergabe von Selektionsparametern)

3. Allevo internes Kommando

Die einzelnen Aufrufe lassen sich kombinieren (komma-getrennt), wobei die jeweiligen Funktionen in der vorgegebenen Reihenfolge ausgeführt werden. Beispiel: der Eintrag „PLANEN,EXIT2“ mit zwei Allevo internen Kommandos sorgt für Übergabe von Daten in Excel an SAP und Lesen von Satelliten (siehe auch Beispiele weiter unten).

Für die Ausführung einer kundenspezifischen Funktion muss ein passender Funktionsbaustein im Kundensystem vorhanden sein (üblicherweise im Kunden-Namensraum). Vorgeben sind die Import- und Export-Parameter mit folgender Struktur:

§ Import: /KERN/IPP_S_CUST_BUT_TO_FM
mit Informationen zum Layout und dem aktuellen Planungsobjekt bzw. der Liste aller Objekte im MultiPage-Modus (ab Allevo 3.3 auch Desktop-Integrationsobjekt und Headerdaten).
Das zugehörige Layout-Objekt liefert die Information darüber, ob der Aufruf über Allevo Inplace oder über den Allevo Business Client (ABC) erfolgt ist; im letzten Fall dürfen keine PopUp-Funktionen aufgerufen werden (nur Rückgabe von Hinweisen über die BAPI-Return-Tabelle).

§ Export: /KERN/IPP_S_CUST_BUT_FROM_FM
enthält die Tabelle für Meldungen im Format BAPIRET2.
Der untergeordnete Parameter COMMAND dient als Rückgabewert für Allevo-Kommandos, die nach (erfolgreicher) Ausführung eines kundenspezifischen Buttons automatisch aufgerufen werden sollen (z. B. bei der automatischen Übernahme von Plandaten).

§ Export: EV_SHOW_BUTTON
steuert die Anzeige des Buttons beispielsweise in Abhängigkeit vom Objektstatus oder spezifisch je nach Anwender.
Diese Funktion steht nur dann zur Verfügung, wenn bei Wert bis der Funktionsbaustein ohne weitere Allevo-Kommandos eingetragen ist.

Ein Muster-Funktionsbaustein steht unter dem Namen /KERN/IPP_BUT_CUST_TEMPL zur Verfügung. Er enthält die relevanten Schnittstellen, hat aber sonst keine Funktion außer der Ausgabe eines PopUp-Fensters. Der Funktionsbaustein kann für erste Tests verwendet werden.

Der Eintrag in der Spalte Wert von definiert die Beschriftung der Schaltfläche |Cust.Button1|. Ohne Beschriftung wird der Button nicht angezeigt.

Bei Wert bis wird der Name des Funktionsbausteins eingetragen. Daraufhin ist der Button in der Allevo-Planungsansicht sichtbar (z. B. der oben erwähnte Muster-Baustein). Existiert der eingetragene Funktionsbaustein nicht im System, so erscheint beim Klick auf den CUST1-Button eine Fehlermeldung.

Analog dazu gibt es einen weiteren Festwert BUTTON_CUST2 mit gleicher Funktionalität. In der Planungsansicht können also zwei kundenspezifische Funktionen definiert und aufgerufen werden.

Hinweis: Alternativ zum Customer-Button kann bei Anwendungen von Architect und Actuals auch das direkte Speichern und Lesen von Satellitendaten über die Standardfunktionen des Allevo sinnvoll sein (siehe z.B. Festwert READ_AFTER_PLAN_SAT).

Aufruf im ABC: Beim Aufruf über den ABC stehen die genannten Funktionen nur eingeschränkt zur Verfügung; z. B. dürfen in den aufgerufenen Funktionsbausteinen keine ABAP-Dialoge/PopUps enthalten sein (Einschränkungen bitte im Allevo-Einführungsprojekt abklären). Wahlweise kann eine kundenspezifische Funktion auch selbst entscheiden, ob der Aufruf über ABC erfolgt ist; so kann die Ausführung also auch abhängig vom jeweiligen Modus erfolgen (z. B. PopUp im ABC-Modus übergehen).

Anwendungsbeispiele

Beispiel 1: Satellitendaten in einem Schritt aktualisieren

Der Eintrag „PLANEN,ZDE_FB_TEST,EXIT2“ sorgt für die automatische Ausführung der folgenden Funktionen:

§ Allevo-Funktion für „Plandaten übernehmen“

§ Funktionsbaustein ZDE_FB_TEST ausführen

§ Allevo-Funktion für „Satellitendaten neu einlesen“

Eine Liste der verfügbaren Allevo-Kommandos kann vom Kern-Support zur Verfügung gestellt werden.

Zudem gibt es die Möglichkeit, sprachabhängige Texte zu definieren; das zugehörige Namensschema ist <BUT_xx_CUST1> mit xx als gewünschte Sprache.

Beispiel 2: mehrsprachige Anwendung

Festwert BUT_EN_CUST1 definiert den Text in Englisch. Der Name des aufgerufenen Funktionsbausteins wird weiterhin über BUTTON_CUST1 bestimmt.

Beispiel 3: Ersatz für Allevo-Einzelpostenanzeige

Über die Import-Parameter /KERN/IPP_S_CUST_BUT_TO_FM werden auch die Allevo-internen Objekte für die Headerdaten und Desktop-Integration (DOI) übergeben: dadurch ist es möglich, auf den Status der Bearbeitung in Excel zu reagieren (z. B. um wie bei der Einzelpostendarstellung auf eine kundenspezifische Auswertung zu springen). Diese Funktion steht beim Aufruf über ABC nicht zur Verfügung.

Beispiel 4: Buchung über Allevo Actuals und Architect aufrufen

Für den Aufruf der Buchungsfunktionen von Allevo Actual wird der Funktionsbaustein /KERN/IPP_EMBED_INTERFACE ausgeliefert, der als Eintrag zum Customer-Button genutzt wird. Die dafür notwendigen Steuerungsparameter sind beim Festwert EMBEDDED_INTERFACE hinterlegt (für weitere Details siehe auch Handbuch „Allevo Actual“).

Neu ab Allevo-Version 3.0

Der Festwert ist jetzt in allen Allevo-Planungstransaktionen verfügbar (vorher nur bei MultiObject).

Neu ab Allevo-Version 3.2.11

Je nach Anwendungsfall ist das Ausblenden des Buttons möglich über Exportparameter EV_SHOW_BUTTON.

Info im Layout-Objekt zum Aufruf über Allevo Inplace oder ABC

Neu ab Allevo-Version 3.3

Mehrere Funktionsbausteine hinterlegen: bei Wert bis können mehrere Funktionsbausteine und auch Allevo-Kommandos eingetragen sein (kommagetrennt). Die hinterlegten Funktionen werden dann in der vorgegebenen Reihenfolge ausgeführt.

Neu ab Allevo-Version 3.3.38

Aufruf beliebiger SAP Transaktionscodes incl. Berechtigungsprüfung