Wozu Add-ons?

Add-ons bieten zusätzliche Informationen und Sie können diese leicht in CIS mobile einbauen. Im Gegensatz zu den Berichten werden Add-ons an bestimmten Stellen platziert, um z.B. weitere Daten zu einem Kundenauftrag anzuzeigen.

Im Prinzip suchen Sie sich in CIS mobile die Stelle heraus, an der noch Informationen fehlen, implementieren eine Methode, die die Daten aus dem ERP-System liest und bereiten diese in Form von HTML5 auf.

Eine etwa 15 minütige Einführung als Video können Sie sich gerne hier anschauen:
CIS mobile - Erweiterungen mit AddOn’s (Video)

Eine PDF-Version steht ebenfalls zum Download zur Verfügung:
CIS mobile - Erweiterungen mit AddOn’s (PDF-Version)



Die Verbindung von Addon-Platzhaltern und der entspr. Methode in VB.net

Vorbereitung für ein neues Add-on

Aktivieren Sie in den Einstellungen den Testmodus für Add-ons. Dann navigieren Sie in der Anwendung an die Stelle, an der Sie zusätzliche Informationen einbinden möchten und notieren sich den Namen der gelben/orangen Schaltfläche. Der Name entspricht dann der Methode, die Sie in VB.net implementieren müssen. Öffnen Sie das Projekt "s10cisaddon.sln", dort sind bereits einige Beispielmethoden zu finden.


Nur Platzhalter der Addons anzeigen in CIS mobile

Verfügbare Schlüssel

Klicken Sie auf einen Platzhalter für ein Add-on, um eine Liste der an dieser Stelle verfügbaren Schlüssel und deren aktuelle Werte zu erhalten. Diese Daten sind im VB.net-Projekt in Fom eines dictionary-Objects verfügbar und können als Parameter für Aufrufe zum ERP-System verwendet werden. Sie erhalten die Werte zu einem Schlüssel durch den Befehl

GetItem(keys, "Schlüsselname")

wobei "keys" das dictionary-Objekt ist.

GetItem(keys,"VBELN") liefert z.B. bei einem Kundenauftrag die zugehörige Auftragsnummer.



Die verfügbaren Schlüssel zu einer Auftragsposition


Daten beschaffen und HTML aufbereiten

Für die Beschaffung der benötigten Daten aus dem ERP-System stehen ihnen eine Reihe an Möglichkeiten zur Verfügung:
 Im einfachsten Fall lesen Sie nur eine bestimmte Tabelle, was in manchen Fällen ausreicht. Bei komplexeren Abfragen müssen Sie aber wahrscheinlich auf BAPIs zurückgreifen, oder Sie nutzen die SAP GUI Scriptingschnittstelle. Dabei wird eine SAP GUI Session "im Dunkeln" gestartet und so eine Benutzersession simuliert.

Gehen sie dazu am besten die Beispiele durch. Sie können auch den Rekorder von GuiXT verwenden, um die benötigten Feldbezeichnungen zu erhalten. Nähere Informationen dazu finden Sie in einem gesonderten Kapitel.

Die Aufbereitung der Daten erfolgt nun in Form von HTML. Die Methode gibt einen String zurück, der dann von CIS mobile als HTML interpretiert und ausgegeben wird. Testen Sie die Ausgabe am besten durch Rückgabe der beschafften Daten als einfachen Textstring. Später können Sie dann am Design feilen und z.B. eine Tabellendarstellung entwerfen.

Buttons zum Aufklappen hinzufügen

In jeder zu implementierenden Methode zu einem Add-on ist ein Parameter "buttons" vorgesehen. Dieser sorgt bei folgender Eingabe dafür, dass ein Button zum Aufklappen, also mit einem (+)-Symbol versehene Schaltfläche, erzeugt wird. Dabei wird folgendes Format erwartet:

buttons = "Name der aufzurufenden Methode | Beschriftung | Text der Wartenachricht"

Beispiel:

buttons = "ProductionOrder|" & "Fertigungsauftrag" & "|" & "Fertigungsauftrag wird geladen"
(Beim Klick/Touch auf die Schaltfläche wird die Methode "BuildProductionOrder" aufgrufen)

Performance des Add-ons

Aktivieren Sie in den Einstellungen bei den Addons "Ausgabe hervorheben". Damit werden alle Add-ons farblich hervorgehoben und können von der Standardfunktionalität von CIS mobile unterschieden werden. Klicken Sie innerhalb eines geöffneten Add-ons an eine beliebige Stelle und Sie erhalten das Ergebnis einer Zeitmessung. Die Messung startet beim Aufruf des Add-ons und endet, sobald die angeforderten Daten zurückgeliefert wurden.


Messungs der Ausführungszeit eines Addons