|
Übersicht In diesem Beispiel erstellen wir eine Anwendung, die die Messpunkte zu Equipments anzeigt. Der Benutzer kann neue Messungen eintragen und diese mit einer Unterschrift quittieren, oder bereits gespeicherte Messungen anzeigen. Diese Anwendung ist zum Beispiel für Servicetechniker geeignet, die unterwegs einen einfachen Zugriff auf Equipmentdaten benötigen sowie schnell Messwerte eintragen und direkt im SAP-System speichern möchten. Denkbar ist aber auch, diese App direkt Kunden zur Verfügung zu stellen, die so eigene Messpunkte rückmelden können. Beispiel Wird ein Messbeleg ausgewählt, werden Details zum Messpunkt, zur erfassten Messung sowie die getätigte Unterschrift angezeigt. Diese Ansicht kann dann direkt weiterverarbeitet werden, z.B. durch Ausrucken oder Weiterversand als PDF-Dokument:
Bei der Erfassung von Messungen können jeweils Werte
eingetragen werden, wobei vom S10 Framework automatisch das
richtige Format entsprechend der Mengeneinheit verwendet wird.
Erst nach dem eine Unterschrift erfolgt ist, kann der Beleg
gespeichert werden: |
|
Implementierung Die Implementierung der Anwendung erfolgt in folgenden Schritten:
Dies ist jedoch nur als Vorschlag zu betrachten, denn die HTML-Views können prinzipiell frei gestaltet werden, wobei nur die Verbindung zu den ABAP Objekten durch bestimmte Namenskonventionen sichergestellt werden muss. |
|
1. Ermitteln der entsprechenden SAP Tabellen für die anzuzeigenden Daten Wir möchten mit dieser S10 Anwendung Teile einer bestehenden SAP Transaktion abbilden. In diesem Fall starten wir mit der Transaktion IE03 (Equipment anzeigen) und können dort mit der F1-Taste die technischen Informationen zu Feldern anzeigen. Wie unten gezeigt, wird in der IE03 der Tabellenview ITOB verwendet, den wir auch als Basis für die Anwendung nehmen könnten.
Per Doppelklick auf den View sehen wir jedoch, dass hier die
SAP-Tabelle EQUI (Equipment Stammdaten) verknüpft wird und
nehmen daher diese als Ausgangspunkt für die Anwendungsgenerierung: |
|
2. Ermitteln einer Schnittstelle zum Speichern der
Eingabedaten (Messwerte) Für das Speichern von Daten sollten prinzipiell Funktionsbausteine verwendet werden, falls diese für den Anwendungsfall vorhanden und geeignet sind. Als weitere Möglichkeit können Sie auch eine Transaktion per Batch-Input aufzeichnen und als Funktionsaufruf verfügbar machen. Außer in eigene Tabellen sollte in SAP-Tabellen generell nicht direkt geschrieben werden. Geeignete Funktionen zum Speichern von Daten können Sie über die Transaktionen SE37 (Function Builder), SE38 (ABAP Editor), SE24 (Class Builder) oder auch BAPI (BAPI Explorer) finden oder zumeist auch im Internet an diversen Stellen. In dieser Anwendung verwenden wir den Funktionsbaustein MEASUREM_DOCUM_RFC_SINGLE_001 (Speichern von Messwerten) sowie die ABAP-Klasse CL_MIME_REPOSITORY_API (API für MIME Repository) zum Speichern der Bilddatei mit der Unterschrift. |
|
3. Generieren der Basisanwendung mit den S10
Utilities In der Regel ist es empfehlenswert, mit einer bestehenden Anwendung zu starten und diese anzupassen und zu erweitern. Dadurch sind bereits grundlegende Funktionen wie die Login-Seite vorhanden. In diesem Beispiel verwenden wir die S10 Utilities, um aus einer SAP-Tabelle eine bereits lauffähige Anwendung zu generieren. Details dazu finden Sie in der Dokumentation unter dem Punkt "Generierung". Wir rufen dazu zunächst die Transaktion /S10/UTIL auf und wechseln auf den Reiter "Listanzeige generieren". Wie in Schritt 1 festgestellt, möchten wir zunächst mit der Sicht auf die Equipments starten und geben daher als Tabelle "EQUI" ein. Anschließend wählen wir einige Felder für Anzeige der Tabelle, Suchfelder sowie für die Detailansicht aus. Nach dem Ausführen befindet sich in dem angegeben Ausgabeverzeichnis dann eine fertige S10 Anwendung, die wir noch erweitern werden. ![]() ![]() Eine S10 Anwendung ist im Prinzip aus einzelnen Views aufgebaut, das heißt separaten HTML-Seiten, die jeweils zu einer bestimmten ABAP-Klasse gehören. Das bedeutet, dass wir einzelne Teile der Anwendung getrennt entwickeln und testen können, um sie anschließend in einer komplexeren Anwendung gemeinsam zu verwenden. Wir generieren daher weitere Anwendungen, wobei das Ausgabeverzeichns durchaus gleich bleiben kann, es wird dann ein weiterer View mit zugehöriger ABAP-Klasse generiert. Die Tabelle mit den Messungen der Messpunkte eines Equipments setzt sich dann allerdings aus unterschiedlichen Spalten zusammen, so dass wir diesen Teil direkt im HTML editieren. Grundsätzlich besteht eine generierte S10 Anwendung aus einer Sicht auf die gewählten Felder der angegebenen Tabelle oder des Tabellenviews sowie der Möglichkeit, einzelne Zeilen der Tabelle aufzuklappen und so Details dieses Objekts anzuzeigen. Diese Detailansicht kann beliebig erweitert werden durch weitere Felder, aber auch komplexere Teile wie Bilder, weitere Tabellen oder Interaktions- und Navigationsmöglichkeiten. |
|
4. Erweitern der generierten Anwendung Konkret fügen wir in der generierten Detailansicht nun eine Tabelle mit den bisherigen Messungen ein sowie einen Pushbutton, der einen neuen Screen zur Eingabe von Messwerten öffnet. Dieser Screen kann wiederum als eigenständiger View mit zugehöriger Klasse entwickelt werden (modularer Aufbau). So wird das Wiederverwenden einzelner Teile sowie das Testen stark vereinfacht. Die HTML-Views Öffnen Sie zunächst die generierte HTML-Datei für den View, in unserem Fall die Datei "equi_manager.list.html" im Verzeichnis "classes\equi_manager\views.de". Die Detailansicht zu einer Zeile beginnt mit folgendem Code Teil: HTML
Sie finden in diesem Abschnitt die generierten Felder und
wir können dort weitere Elemente einfügen:Ein Pushbutton, um zu einem Screen zu navigieren, auf dem Messwerte eingetragen werden können: HTML
Wenn der Benutzer auf diesen Pushbutton drückt, wird die ABAP-Methode 'open_measurepoints' in der aktiven Klasse aufgerufen. Für die Tabelle mit den Messwerten zunächst die Überschriften: HTML
Anschließend die Definition der Tabellenzeile, wobei wir die Zuordnung zu dem ABAP-Objekt wieder per name= angeben: HTML
Die ABAP-Methoden Wir haben in dem HTML-Coding an zwei Stellen Aufrufe in die ABAP-Klasse definiert:
ABAP
Hinweis Nachdem der Dialog bzw. der View "measurepoints" geschlossen wurde, z.B. in dem der Benutzer ein "zurück" ausgelöst hat, wird die Codeausführung in der nächsten Zeile fortgesetzt. In diesem Fall könnte der Benutzer neue Messungen eingetragen und gespeichert haben, so dass ein Auffrischen der vorherigen Anzeige angestoßen werden sollte. Die zweite Methode navigiert zu einem View, der die Details zu der jeweiligen Messungen bzw. dem Messbeleg anzeigt sowie ein Bild der geleisteten Unterschrift: ABAP
Hinweise
|
|
5. Implementierung der Speicherung von Messungen Wir benötigen im Prinzip nur eine kleine Tabelle, die pro Messpunkt dessen Namen und die Erfassungseinheit anzeigt, sowie ein Eingabefeld für neue Messwerte anbietet. Hier sehen Sie die Verbindung zwischen den Elemente der HTML-Oberfläche und den jeweiligen Variablen in der ABAP Klasse (Details dazu unter dem Punkt "Datenbindung" in der Dokumentation): HTML
Die Felder in der dazugehörigen ABAP-Klasse:ABAP
Wir benötigen nun noch einen einfachen Pushbutton, mit dem der Benutzer das Speichern der eingetragenen Messwerte auslösen kann: HTML
Hinweis Hier sei noch einmal betont, dass keine Übergabe der eingegebene Werte an die ABAP-Methode notwendig ist, sondern das S10 Framework automatisch dafür sorgt, dass die jeweils am Front-End eingegebenen Daten des Benutzers in einer aufgerufenen ABAP-Methode direkt zur Verfügung stehen. Umgekehrt werden in der ABAP-Methode geänderte Daten nach Ablauf automatisch an das Front-End geschickt, so dass dort jeweils die aktuellen Daten angezeigt werden. Die entsprechende ABAP-Methode "measures_save" ist nicht besonders umfangreich: ABAP
Hinweis zum Datentyp der einzugebenden Messwerte Der Messwert, den der Benutzer eingibt, muss in diesem Beispiel nicht erst in einen anderen Datentyp umgewandelt werden, da er bereits in dem für den Funktionsbaustein erwarteten Typ definiert ist. Der Typ ist "rimr0-recdc welcher zur Domäne FLTP_INOUT (Ein-/Ausgabefeld für Gleitkommafelder, 22-stellig) gehört und im Prinzip ein CHAR, also Text ist. Sie können jedoch in dem ABAP-Programm dem S10 Framework mitteilen, welches Feld die Mengeneinheit definiert. Auf der Oberfläche wird dann die Einheit entsprechend formatiert, z.B. ohne Dezimalstellen bei ST (Stück), 2 Dezimalstellen bei Währungseinheiten und so weiter: ABAP
Hier definieren wir ein Feld für die Eingabe eines Messwerts, ein Feld für die Mengeneinheit sowie eine Verbindung zwischen beiden Feldern durch ein vorangestelltes "unit_" vor dem Namen des Feldes. ![]() Hinweis zu Übersetzungsmöglichkeiten Neben der Möglichkeit, im ABAP-Coding sog. Text-IDs zu verwenden für die Übersetzung von Texten, bietet das S10 Framework auch die Möglichkeit, kleine Textdateien zu pflegen und per "s10localize" den Text in der Anmeldesprache des Benutzers zu ermitteln. Details dazu finden Sie in der Referenz zu s10localize() . |
|
6. Implementierung der Speicherung der Unterschrift Die Möglichkeit zur Unterschrift wurde in Form einer JavaScript-Bibliothek, die als Open-Source Software unter github.com/szimek/signature_pad verfügbar ist, eingebunden. Sie bietet die Möglichkeit, das Bild der Unterschrift direkt als Zeichenfolge zu speichern (Base64). Somit kann es sehr einfach in einem versteckten S10 Feld an die ABAP-Methode übertragen werden. Anschließend wird dieser Text mit einem Funktionsbaustein wieder in das binäre Format umgewandelt und im MIME-Repository als Bilddatei abgelegt. Wir binden zunächst die JavaScript-Bibliothek in dem HTML-View ein: HTML
Für das Feld für die Unterschrift wird ein sog. HTML5 <canvas> Element verwendet, welches das Zeichnen von Grafiken ermöglicht. JavaScript bietet im Standard einen Befehl an, mit dem die Grafik als Textrepräsentation (Base64) gespeichert und weiterverarbeitet werden kann: HTML
Nach dem der Benutzer unterschrieben hat, wird das Bild als Base64 String codiert und in das S10 Feld gestellt. Dadurch wird es automatisch vom S10 Framework in die ABAP Variable übertragen: JavaScript
Beim Speichern der Messwerte wird zusätzlich die Methode "save_signature" aufgerufen. Diese wandelt den Base64 Text in Binärdateien um und speichert diese im MIME-Repository als .PNG Bilddatei ab: ABAP
|
|
Download Sie können alle Projektdateien hier herunterladen: s10_service_example.zip Das .ZIP Archiv enthält die HTML-Views sowie eine Textdatei mit dem ABAP Programm "/s10/service_demo". Zum Importieren der HTML-Views können Sie den Report "BSP_UPDATE_MIMEREPOS" verwenden wie in der Dokumentation unter dem Punkt Entwicklungsumgebung" beschrieben. Bitte passen Sie ggf. noch Nummer des Mandanten in der Datei "user.logon.html" an. Details dazu finden Sie in der Dokumentation unter dem Punkt S10Logon() |
|
Komponente: S10 Framework |