Mobile RPG - Smartphone-Anwendungen mit Mobile RPG - II Christian Neißl,

Transkript

1 Mobile RPG - Smartphone-Anwendungen mit Mobile RPG - II Christian Neißl, In diesem und den folgenden Artikeln lernen wir mit MR umzugehen. Dazu erstellen wir ein kleines Programm das hilft den Entwicklungszyklus von MR Anwendungen zu verstehen. Wir lernen auch die Wege kennen die es uns erlauben Steuerelemente wie Maps, Charts und Images, die ja in den DDS-Konzepten nicht vorkommen, auf Webseiten darzustellen und mit Leben zu füllen. Unser Beispielprojekt Calculator Der Fokus liegt hier zweifellos nicht auf hochkomplexer Logik oder beeindruckender Optik. Es geht schlicht und einfach darum die Arbeitsweise von MR zu verstehen. Der Dialog besteht aus einigen konstanten Texten wie Wert1, Wert2, 3, 2 numerischen Eingabefeldern für die Werte, Buttons mit denen die Operation ausgewählt wird und einem Textfeld zur Ausgabe der Operationstyps und einem numerischen Ergebnisfeld. Hier ist das von MR erzeugte DDS: A DSPSIZ( *DS4) A INDARA A R RECORD A OVERLAY A WERT1 5Y 0B A WERT2 5Y 0B A OPCODE 1A O A ERGEBNIS 7Y 0O 1 19 Wie man hier sehen kann wird von MR ein DSPF-DDS erzeugt das den Datenpuffer beschreibt. Da dieses DDS ausschließlich für die Umwandlung des RPG-Programms benötigt wird bleiben die konstanten Texte wie auch die Darstellungsattribute Sache der Dialogebene. Hier ist der Code der diese Anwendung steuert: FCALCDSPF CF E WORKSTN Handler('MOBILERPG') C********************************************************************* C* Use the RPG-Cycle to display the main menu, get out on IN C********************************************************************* C ExFmt Record C Select C When *INKF C Eval OpCode = '+' C Eval Ergebnis = Wert1 + Wert C When *INKG C Eval OpCode = '-' C Eval Ergebnis = Wert1 - Wert C When *INKH C Eval OpCode = 'x' C Eval Ergebnis = Wert1 * Wert C When *INKC C Eval *InLR = *On C Return C EndSl

2 Diese Routine basiert auf der von MR über den Export zur Verfügung gestellten Logik. Das Programm verwendet den RPG-Zyklus, die Rechenoperationen kommen über Funktionstaste F6 (*INKF) für Addition, F7 (*INKG) für Subtraktion und F8 (*INKH) für Multiplikation herein. Innerhalb der Select-Zweige werden die Ausgabefelder gesetzt. Noch einfacher kann es nicht gehen. Für den Dialog ist es völlig egal welche und wie viel Operationen hinter den Feldwerten stehen. MR stellt eine Brücke zwischen den Ebenen der mobilen Anwendung und der Datenund Programmbasis der AS/400 her. Wenn Sie hier eine Artikelabfrage mit externer Preisfunktion aufrufen oder per SQL Daten auslesen betrifft das die mobile Anwendung kaum da die Verarbeitungsgeschwindigkeit auf der AS/400 so hoch ist dass sich diese Operationen als Benutzer des Mobilgeräts kaum wahrnehmen lassen. Von Anfang an Nachdem die Entwicklungsumgebung und MR installiert wurde ist der nächste Schritt die Definition einer DB-Verbindung. Dazu stellt MR den Menüpunkt Datagate und den Dialog Datagate Explorer zur Verfügung. Mit der Funktion Add New Database Name im Knoten Database Names wird eine DB-Verbindung erstellt. Siehe Abbildungen 1-3. Ein DB-Name ist vergleichbar mit einem Connection-String der eine Verbindung zu einer DB wie SQL-Server, MS-Access, mysql, etc. herstellt. Er legt die IP, den Port, den Standardbenutzer, die Bibliotheksliste etc. fest. Abbildung 1 - Erstellen eines DB-Namens Abbildung 2 - geöffnete DB-Verbindung Abbildung 3 - Erstellen eines DB-Namens Hinzufügen eines Dialoges zu einem Projekt Mit der Anleitung zum Erstellen eines neuen Projekts aus dem vorangegangenen Artikel erstellen wir das Grundgerüst unserer Beispielanwendung Calc. Menü DATEI Neu Webseite. Wählen Sie die Vorlage ASNA Mobile RPG Web Site aus und benennen Sie das Projekt Calc. Damit haben Sie die Basis geschaffen um einen neuen Dialog in das Verzeichnis MobileDFs hinzuzufügen. (Abbildung 4 und 5).

3 Abbildung 4 - Dialog zu Projekt hinzufügen Abbildung 5 Neuen Dialog hinzufügen und benennen

4 Steuerelemente am Dialog positionieren In Abb. 6 - Toolbox werden die von ASNA in dieser ersten Version gelieferten Steuerelemente dargestellt, rechts davon sehen Sie den Dialog in der Designansicht. Diese Steuerelemente verhalten sich wie mobile-controls, bringen aber die Eigenschaften mit die es braucht um von dem RPG-ILE-Programm gesteuert zu werden. Um sie zu verwenden kann man sie einfach von der Toolbox auf den Dialog ziehen. Die Eigenschaften werden im Eigenschaftseditor Abb. 7. eingestellt. Abbildung 6 - Steuerelemente und Dialoggestaltung Abbildung 7 - Eigenschaftseditor

5 Was im Hintergrund passiert Der Designer aus Visual Studio erstellt im Hintergrund ASP.NET Code, so wie SDA auf der AS/400 DDS-Code erstellt. Wenn man nie gerne mit SDA gearbeitet und die DDS immer selbst geschrieben hat wird man auch hier gerne direkt mit ASP.NET Code arbeiten. Dazu bietet VS die Source- und die Split-Ansicht in der der ASP.NET Code oder beides dargestellt wird. ASNA behauptet dass es für die Arbeit mit MR nicht nötig ist ASP.NET, HTML, JavaScript etc. zu lernen. Das stimmt auch da man alles mit der Designsicht und dem Eigenschaftseditor machen kann. Es ist aber kein Nachteil wenn man sich auch im Quellcode zurecht findet da man hier, genauso wie in DDS, schneller ans Ziel kommt als mit dem Designwerkzeug. Auch wenn der Code am Anfang wohl nicht so flüssig aus der Tastatur läuft werden Sie durch die eingebaute Hilfe schnell produktiv werden. Viel schlimmer als DDS ist ASP.NET letztendlich auch nicht. Abbildung 8 - Ansichten der Dialog-Source

6 Der Code für unseren Dialog Sie können diesen Code per Copy und Paste in die Sourcedatei kopieren oder mit dem Dialogdesigner erstellen, vielleicht wollen Sie auch mit dem Code-Editor arbeiten um die Umgebung besser kennen zu lernen. Dieser Code muss in den Content-Bereich des AppBody platziert werden. Er umfasst den kompletten Dialog. <mdf:ddsrecord id="_record1" runat="server" style="position: relative;" Alias="Record1" CssClass="DdsRecord" NavigationBarControlID="NavigationBar" AttnKeys="F3 03;" EraseFormats="*ALL" > <div style="height:44px"> <mdf:ddsbar ID="NavigationBar" runat="server" CssClass="navigationbar" Width="100%" Height="44px" BackColor="LightGray" > <mdf:ddsbarsegment ID="DdsBarSegment1" runat="server" Alignment="Left"> <mdf:ddsbutton ID="DdsButton1" ButtonStyle="Button" runat="server" CssClass="NavButton" AidKey="F3" Text="End" ToolTip="F3" /> </mdf:ddsbarsegment> <mdf:ddsbarsegment ID="DdsBarSegment2" runat="server" Alignment="Center"> <span class="paneltitle" >Calc</span> </mdf:ddsbarsegment> <mdf:ddsbarsegment ID="DdsBarSegment3" runat="server" Alignment="Right"> </mdf:ddsbarsegment> </mdf:ddsbar> </div> <div style="height:147px" > <mdf:ddspanel ID="DdsPanel1" runat="server" CssClass="DdsPanel"> <mdf:ddsconstant ID="DdsConstant1" runat="server" Text="Wert 1:" /> <mdf:ddsdecfield ID="Wert1" runat="server" CssClass="DdsDecField" Length="5" Decimals="0" Type="Packed" EditCode="K" /> <br /> <mdf:ddsconstant ID="DdsConstant2" runat="server" Text="Wert 2:" /> <mdf:ddsdecfield ID="Wert2" runat="server" CssClass="DdsDecField" Length="5" Decimals="0" Type="Packed" EditCode="K" /> <br /> <mdf:ddsbutton ID="DdsButton2" runat="server" ButtonStyle="Button" CssClass="SubmitButton" AidKey="F6" Font-Bold="True" Font-Size="20pt" Text="+" ToolTip="F6" /> <mdf:ddsbutton ID="DdsButton3" runat="server" ButtonStyle="Button" CssClass="SubmitButton" AidKey="F7" Font-Bold="True" Font-Size="20pt" Text="-" ToolTip="F7" /> <mdf:ddsbutton ID="DdsButton4" runat="server" ButtonStyle="Button" CssClass="SubmitButton" AidKey="F8" Font-Bold="True" Font-Size="20pt" Text="x" ToolTip="F8" /> <br /> <mdf:ddsconstant ID="DdsConstant3" runat="server" Text="Operation:" /> <mdf:ddscharfield ID="OpCode" runat="server" CssClass="DdsCharField" Usage="OutputOnly" Length="1" Width="24px" Font-Bold="True" Font-Size="Larger" ForeColor="Red" /> <mdf:ddsconstant ID="DdsConstant4" runat="server" Text="Ergebnis:" /> <mdf:ddsdecfield ID="Ergebnis" runat="server" CssClass="DdsDecField" Usage="OutputOnly" Length="7" Decimals="0" Type="Packed" EditCode="K" Font-Bold="True" Font-Size="Larger" ForeColor="Red" /> <br /> </mdf:ddspanel> </div> </mdf:ddsrecord> Für alle Leser die sich jetzt fragen was das mit RPG zu tun hat habe ich hier die Referenzen zu unseren Datentypen und den DDS-Eigenschaften hervorgehoben. Betrachten Sie diesen Code als logische Fortführung des DDS der eine Brücke zwischen der zeitgemäßen Softwareentwicklung und dem Bestand und Wissen der letzten 30 Jahre darstellt.

7 Exportieren Sie den DSPF auf die AS/400. Sie können mit dem Haken Save DDS Source festlegen ob und wohin Ihre Quelle gespeichert werden soll. Verwenden Sie wie auch beim Erstellen die DB-Verbindung MR die eingangs erstellt wurde. Abbildung 9 - Export auf die AS/400 Und wie wird das Programm gestartet? Nach dem Export des DDS auf die AS/400 ( Export to Displayfile ) können Sie das RPG- Programm erstellen und kompilieren. Im VS-Projekt finden Sie in der Parameterdatei Web.config im Bereich appsettings die nötigen Parameter um das Programm ausführen zu können. Abbildung 10 - Konfigurationsdatei

8 Das Programm wird über die Bibliothek und dem Programmnamen die hier eingetragen sind gestartet. Wichtig ist auch der Name der DB-Verbindung da für diese Anwendung weder eine Serverauswahl noch eine Anmeldung vorgesehen sind. Mehr über die Möglichkeiten im nächsten Artikel. Offizielle Unterstützung für Mobile RPG ASNA stellt eine Reihe von Informationen wie Dokumentation, Tutorials und Beispiele zur Verfügung die MR erklären. Gerne stehe ich Ihnen zu allen Fragen über Mobile RPG zur Verfügung, zögern Sie nicht mich unter zu kontaktieren.