Zur Seite ERP-Kontakte

Wenn Sie diese Seite direkt aus der App ERP-Kontakte aufgerufen haben, dann gelangen Sie durch einen Doppleklick auf den Home-Button Ihres iPhones wieder zurück in die App.

Sollte es zu irgend einem Zeitpunkt in der Installation nicht weiter gehen, so nehmen Sie bitte mit uns Kontakt auf. Wir helfen Ihnen gerne. Aufgrund unterschiedlichster Systemumgebungen kann es bei der Inbetriebnahme zu Problemen kommen, die wir hier nicht dokumentiert haben. Alle uns bekannten Probleme werden wir in unseren Installationsbeschreibungen dann ergänzen.

Wenn Sie die Einrichtung Ihres iPhones nun zum ersten Mal durchführen, nehmen Sie sich ausreichend Zeit für die Konfiguration. Die erste Einrichtung ist nicht mal eben schnell erledigt. Der initiale Datentransfer eines Produktivsystems mit ca. 5000 Kunden und mehreren Organisationseinheiten in einer Multisite-Umgebung kann schon, je nach Systemkonfiguration, bis zu 30 Minuten dauern. Die Synchronisation der Daten nach dem initialen Aufsetzen der Anwendung ist nartürlich schneller.

1. Importieren der Import/Export-Filter.

Die Anwendung ERP-Kontakte benutzt für die Kommunikation mit Semiramis die Import/Export-Schnittstelle über die SOAP-Architektur (WebServices) des ERP Systems. Hierzu müssen Sie die nötigen Filterbeschreibungen in Ihr ERP System laden. Die Filter finden Sie hinter diesem Link „FilterDefinition.xml.gz“ oder in der App ERP-Kontakte in iTunes. Laden Sie über die ERP Anwendung „Daten importieren“ diese Filterdefinitionen in das Business Entity „com.cisag.sys.tools.bi.obj.FilterDefinition“. Alle unsere Filter beginnen mit dem Namen „IX_“. Bitte prüfen Sie vor dem Import, ob es in Ihrem System eigene Filter mit diesem Präfix gibt. Bei möglichen Kollisionen sollten Sie die Filter nicht importieren und sich mit uns in Kontakt setzen.

Die Filter der Anwendung ERP-Kontakte nutzen nur Felder aus dem Standard des ERP Systems. Sie wurden mit Semiramis 4.5 erstellt und mit 5.x Systemen getestet. Die Anwendung ERP-Kontakte sollte daher mit allen ERP Enterprise Installationen ab Version 4.5 kompatibel sein.

2. Anlegen eines Benutzers für den Import/Export von Daten des ERP Systems.

Für den Import/Export über die SOAP Schnittstelle legen Sie bitte einen neuen User in Ihrem ERP System an. Dieser User sollte für den Import/Export auf der Datenbank, die Sie für den mobilen Zugriff freigeben wollen, alle nötigen Rechte besitzen. Diesem User geben Sie auch im Rahmen der Systemkonfiguration im Systemcockpit die Rechte für den SOAP-Zugriff (ab V5.1).

Bitte legen Sie den User vom Typ „Interaktiv“ an, fügen Ihn in die Gruppe der Administratoren ein und ordnen Ihn einer Person Ihres ERP-Mandanten als Benutzerkonto zu.

Auch, wenn Sie an dieser Stelle einen schon vorhandenen User wählen können, empfehlen wir hier ausdrücklich die Neuanlage eines Users nur für diesen Zweck. Nennen Sie diesen User z.B. MOBILE_CONNECT. Es bleiben Ihnen dann für die Zukunft mehr Möglichkeiten im Rechtemanagement Ihrer mobilen Umgebung. Die Zuordnung zur Gruppe der Administratoren können Sie auch später weiter einschränken, um diesen User mit möglichst wenig Rechten auszustatten. Um bei der Inbetriebnahme der App aber Probleme mit den Berechtigungen auszuschliessen, empfiehlt sich hier die Zuordnung zu den Administratoren.

Bitte importieren Sie das Zertifikat dieses Benutzers in Ihren Internet Explorer mit der Option „Schlüssel als exportierbar markieren“.

Legen Sie für diesen User kein Kennwort an. Damit vermeiden wir, dass man sich mit diesem User später an der App ERP-Kontakte als Anwender anmeldet.

3. Prüfen der Exportfähigkeit der neuen Filter.

Nach dem Import der Filter sollten Sie zur Vermeidung späterer Probleme über die ERP Anwendung „Daten exportieren“ die Funktionsfähigkeit aller Exporte prüfen. Bitte generieren Sie zu jedem Filter, der mit „IX_“ beginnt, einen Export und vergewissern Sie sich, dass es hierbei keine Fehler gibt. Es kann zum Beispiel vorkommen, dass durch eine fehlerhafte oder unvollständige Konfiguration Ihres ERP Systems der Filter IX_ORGANIZATION nicht exportiert werden kann. Bitte beheben Sie alle Probleme, bevor Sie mit dem nächsten Schritt fortfahren.

Nutzen Sie für diese Exporte bitte den unter Punkt 2 angelegten Benutzer MOBILE_CONNECT.

4. Konfiguration des ERP-Systems für den SOAP-Zugriff.

Bitte legen Sie einen Application-Server für die Kommunikation mit der App ERP-Kontakte an. Sie können natürlich auch eine vorhandene Instanz nutzen, falls diese für den Betrieb mit ERP-Kontakte geeignet ist. Der Application Server muss auf einer URL laufen, die über das WLAN Ihres iOS-Gerätes erreichbar ist. Möchten Sie auch über das mobile Netz Ihres iPhones auf diesen Server zugreifen, so muss es sich bei dieser URL um eine öffentlich nutzbare DNS-Adresse handeln.
Der Applikationsserver sollte über ausreichend grossen Arbeitsspeicher für die Import/Export-Prozesse verfügen. Unter Comarch ERP Enterprise 4.5 können Sie mit jedem Applicationsserver direkt über SOAP kommuniziern. Ab Version 5.1 müssen Sie diese Kommunikationsart über das Systemcockpit explizit erlauben (Im Rahmen der Benutzerzuordnung zum System).

Merken Sie sich die URL dieses Applikationsservers für die spätere Konfiguration der App.

Der verwendete Applikationsserver muss ausreichend schnell sein, um die Anfragen der App ERP-Kontakte innerhalb vorgegebener Zeiten zu beantworten. Der Export von IX_PARTNER_FAST_ACCESS über Ihren gesamten Partnerstamm muss in unter 300 Sekunden erfolgen. Der Export von IX_PARTNER muss in einer Selektion von 50 Partnern in unter 120 Sekunden fertig werden. Der Timeout für alle weiteren Anfragen an das ERP-System liegt bei 120 Sekunden.

5. Anlegen der Gruppen MOBILE_USER und MOBILE_ADMIN.

Legen Sie die beiden Benutzergruppen MOBILE_USER und MOBILE_ADMIN in Ihrem ERP System an. Dann ordnen Sie alle User, die sich später an der App anmelden können sollen, der Gruppe MOBILE_USER zu. Ordnen Sie alle Administratoren, die auch die App ERP-Kontakte administrieren können sollen, der Gruppe MOBILE_ADMIN zu.

Nur, wenn Sie sich der Gruppe MOBILE_USER und MOBILE_ADMIN zuordnen, können Sie sich später am iPhone anmelden und die App verwalten.

Anwender, die Ihr iOS-Gerät durch die EDV bereitgestellt bekommen, sollten nur in der Gruppe MOBILE_USER sein.

6. Anlegen von Kennwörtern für die Anmeldung mobiler User.

Alle Anwender in der Gruppe MOBILE_USER müssen über ein Passwort verfügen. Nur mit diesem Passwort können Sie sich später an der App anmelden. Sollten Sie Ihr Passwort im ERP System später ändern, so müssen Sie die App erst mit dem ERP System synchronisieren, bevor Sie sich erneut anmelden können.

7. Aufbereiten des Zertifikates für die SOAP-Kommunikation.

Jetzt wird es etwas trickreich. Das exportierte *.pfx Zertifikat aus Ihrem ERP System kann nicht direkt in der App ERP-Kontakte registriert werden. Sie müssen sich erst ein nutzbares Zertifikat erzeugen. Das geht so:

• Importieren Sie das Zertifikat in den Internet Explorer unter Windows.
• Wählen Sie dabei die Option „Schlüssel als exportierbar markieren.“
• Exportieren Sie das Zertifikat in eine neue Datei.

Wählen Sie für den Export ein ausreichend sicheres Passwort. Durch den Import und anschliessenden Export haben wir nun eine Zertifikatsdatei, die zu der iOS und Apple Softwareumgebung kompatibel ist.

8. Importieren des Zertifikates in die App ERP-Kontakte.

Die gerade exportierte Zertifikatsdatei bekommt nun eine andere Endung. Ändern Sie die Endung von „.pfx“ nun in „.nkey“ um. Nun können Sie dieses Zertifikat in der Anwendung ERP-Kontakte registrieren. Die Anwednung ERP-Kontakte sollte zu diesem Zeitpunkt auf Ihrem iPhone installiert sein. Nutzen Sie nun einen von zwei Wegen:

1. Schicken Sie sich die „.nkey“ Datei per Mail auf Ihr iPhone. Öffnen Sie die Mail und tippen Sie auf die „.nkey“ Datei. In dem dann folgenden Dialog bestätigen Sie bitte die Option „In ERP-Kontakte öffnen“.
2. Legen Sie die „.nkey“ Datei auf einen Webserver. Besuchen Sie die Seite mit Safari. Tippen Sie auf die „.nkey“ Datei. In dem dann folgenden Dialog bestätigen Sie bitte die Option „In ERP-Kontakte öffnen“.

Jetzt wechselt Ihr iPhone direkt in die App ERP-Kontakte und Sie werden nach dem Kennwort der Zertifikatsdatei gefragt. Geben Sie das Kennwort ein und bestätigen Sie den Vorgang.

9. Anlegen einer Datenbank in ERP-Kontakte.

Nach dem Registrieren eines Zertifikates können Sie nun in der App eine Datenbank anlegen. Sie können für jede ERP Instanz, mit der Sie arbeiten wollen, eine Datenbank auf dem iPhone anlegen und später zwischen diesen Datenbanken wechseln.

Drücken Sie in der Ansicht „Datenbanken“ auf das Plus-Symbol in der Navigationsleiste. Sie bekommen nun ein leeres Formular für die Anlage einer Datenbank.

Füllen Sie nun die Felder Datenbank, Zertifikat, URL und Firmennummer wie folgt aus:

• Datenbank : Tragen Sie hier den OLTP-DB Namen der ERP Instanz ein, genauso wie er in der Fußzeile des Internetexplorers geschrieben steht, wenn Sie mit dieser Instanz verbunden sind.
• Zertifikat : Wählen Sie hier das Zertifikat aus, das Sie gerade importiert haben.
• URL : Tragen Sie hier die URL ein, unter der der ERP Applicationsserver erreichbar ist.
• Firmennummer : Geben Sie hier die Firmennummer an, die in Ihrer Organisationsstruktur den Rootknoten oder den Mandanten abbildet.

10. Datenbank prüfen

Nach der Eingabe der Daten müssen Sie die Daten prüfen. Tippen Sie nun auf Konfiguration prüfen. Wenn sich das System nun mit der Meldung „Konfiguration ist gültig“ zurückmeldet, dann haben Sie bis hierhin alles richtig gemacht.

Sollten Fehlermeldungen erscheinen, müssen Sie alle Felder der Eingabe noch mal auf Ihre Richtigkeit prüfen. Ist alles richtig geschrieben. Beginnt die URL mit „https://“. Stimmt die Firmennummer, der OLTP-DB Name, e.t.c.

Sollten alle Informationen richtig sein, dann prüfen Sie auch die Logdateien und Meldungsprotokolle des ERP Systems. Desweiteren überprüfen Sie die Logdateien Ihres iPhones. Anleitungen zum Finden der iPhone Logdateien finden Sie im Internet. Eine von vielen Beschreibungen hierzu ist z.B. diese hier „How to find crash logs…„.

Wenn sich aus diesen Informationen für Sie keine Lösung ergibt, dann schicken Sie uns möglichst viele Informationen an unsere Support Adresse erpcontacts@hwigmbh.de. Wir werden uns bemühen, die Probleme schnellstmöglich zu beseitigen.

11. Datenbank aktivieren

Nachdem Sie auf Aktivieren gedrückt haben, wird der initiale Datenaustausch mit dem ERP System stattfinden. Dieser Datenaustausch kann je nach der Größe Ihrer Installation einige Minuten dauern.

Ein Produktivsystem mit ca. 5000 Partnern und mehreren Organisationseinheiten in einer  Multisiteumgebung kann hier schon mal 30 Minuten in Anspruch nehmen.

In dieser Zeit sollten Sie das Programm nicht verlassen. Bitte führen Sie diesen Schritt nur aus, wenn Sie in einer ausreichend schnellen WLAN-Umgebung sind.

Es wird automatisch in die Sicht Transferstatus gewechselt, in der Sie den Fortschritt der Aktivität beobachten können. Diese Sicht können Sie auch verlassen, sollten das in der Initialisierungsphase der Software aber nicht tun.

Achten Sie auch darauf, dass Ihr iPhone nicht einschläft während der Datenübertragung. Nur in der Sicht Transferstatus der App ERP-Kontakte wird das Einschlafen der App auch ohne Ihre Bedienung unterbunden.

12. Anmelden an der App

Nach der vollständigen Initialisierung der Daten springt die Anwendung automatisch in die Sicht der Anmeldung. Geben Sie hier bitte den Namen und das Passwort eines Benutzers ein. Für die Benutzung der Software muss dieser Anwender in der ERP Gruppe „MOBILE_USER“ sein. Für die Administration des Gerätes auch in der Gruppe „MOBILE_ADMIN“.

Die Anmeldung an der Software dauert, je nach der Größe Ihres Partnerstammes, einen Moment. Ein angemeldeter Benutzer bleibt auf dem iPhone aber in der App angemeldet, bis man Ihn abmeldet oder die Software gelöscht wird.

13. Wechsel zwischen den Sichten

Nach der erfolgreichen Anmeldung kann man sich in den Sichten der Software frei bewegen. Mit dem Menüsymbol in der Navigationsleiste oder einem Swipe nach rechts in der Navigationsleiste öffnen Sie das Menü.

Jetzt haben Sie die Möglichkeit in die vorbereiteten Sichten

• Partner
• Kunden
• Ansprechpartner
• Kontakte
• Firma

einzusteigen.

Lesen Sie hierzu auch die Bedienungsanleitung der Software ERP-Kontakte.

14. Installation weiterer Geräte

Wenn Sie mit dem ersten iPhone fertig sind, dann wird es für weitere Geräte ganz einfach. Melden Sie sich an der App als Administrator an (User in der Gruppe MOBILE_ADMIN). Öffnen Sie die Sicht Administration und wählen Sie eine Datenbank. Nun tippen Sie auf die Schaltfläche „Datenbank exportieren“. Die Datenbank wird nun nach iTunes exportiert. Schließen Sie das iPhone an iTunes (an Ihren Rechner) an und kopieren Sie die Datenbank aus iTunes heraus. Nun können Sie diese Datenbank, wie unter Punkt 8 beschrieben, auf weitere Geräte bringen. Die App ERP-Kontakte und das Zertifikat sollte sich jedoch schon auf diesen Geräten befinden. Das ist Alles.

Ich wünsche Ihnen viel Erfolg mit der Anwendung ERP-Kontakte. Sollten Sie Fragen oder Ideen zu dieser Anwendung haben, nutzen Sie bitte erpcontacts@hwigmbh.de , um mit uns in Kontakt zu treten.

Zur Seite ERP-Kontakte