OMT. Order Management Tool. Installationsanleitung

Transkript

1 OMT Order Management Tool Installationsanleitung Version: 18 deutsch Stand:

2 Impressum Herausgeber T-Systems Enterprise Services GmbH Neugrabenweg Saarbrücken Deutschland Dateiname Installationsanleitung Order Management Tool_V18.doc Version Stand ab Softwareversion ff Autor Tim Ostermann Ansprechpartner Telefon / Fax Tim Ostermann tim.ostermann@t-systems.com Kurzinfo Installationsanleitung zum Order Management Tool OMT Copyright 2009 by T-Systems Enterprise Services GmbH, Frankfurt am Main Alle Rechte, auch die des auszugsweisen Nachdrucks, der fotomechanischen Wiedergabe (einschließlich Mikrokopie) sowie der Auswertung durch Datenbanken oder ähnliche Einrichtungen, vorbehalten. Version 18, , final Seite ii

3 Inhaltsverzeichnis OMT Order Management Tool i Installationsanleitung...i Impressum...ii Inhaltsverzeichnis iii 1. Einleitung 1 2. Verwendete Symbole 2 3. Installationstypen 3 4. Szenario der Mehrplatz-Version (Client-Server) 4 5. Systemvoraussetzungen 5 6. Netzwerk-Zugriffe durch das Programm 6 Dokumenten-Austausch... 6 News-Funktion... 6 Automatische Updateprüfung... 6 Copyright 2009 by T-Systems Enterprise Services GmbH, Frankfurt am Main Alle Rechte, auch die des auszugsweisen Nachdrucks, der fotomechanischen Wiedergabe (einschließlich Mikrokopie) sowie der Auswertung durch Datenbanken oder ähnliche Einrichtungen, vorbehalten. Version 18, , final Seite iii

4 7. Zusammenfassung Softwarevoraussetzungen 8 8. Hardwarevoraussetzungen 9 9. Erweiterung einer vorhandenen Einzelplatzversion auf eine Mehrplatzversion Download des Setup Start der Installation Automatische Installation Datei öffnen -Sicherheitswarnung Sprachauswahl Installation Begrüßung Lizenzvereinbarungen Installationsbeginn Setup-Status Abschluss der Installation und Neustart des Computers Update auf aktuelle Version Updater Starten des Setup Assistenten Initialeinrichtung Willkommen beim Setup/ Einrichtungs-Assistenten Installationstypen Auswahl Einzelplatzversion Netzwerk-Server Netzwerk-Client ProxyServer Was ist ein Proxy? Adresse des Proxy-Servers Administration Proxyserver Prüfung der Internetverbindung System-Zugangsdaten 44 Version 178, vom Seite iv

5 35. Einrichtung mehrerer TP-Shortnames Verbindungsadresse zum System der DTAG Einrichtung des OMT mit Zugriff auf das Testsystem Automatische Fehlerbenachrichtigung via Abschluss der Konfiguration Handbuch Berechtigungsassistent Deinstallieren der Anwendung Installation des OMT Service auf Ihrem System SendReceiveInterval FileClientLog Fehlercodes im FileClientLog falscher Dokumententyp Die Connectivity zu unserem SAP XI System ist gestört falsche Parameter Wechsel der Sprache Http Statuscodes HTTP 1xx HTTP 2xx HTTP 3xx HTTP 4xx HTTP 5xx Abkürzungsverzeichnis 77 Version 178, vom Seite v

6 1. Einleitung Die Deutsche Telekom AG (DTAG) und Ihre Konzerneinheiten tauschen mit Ihren Geschäftspartnern zunehmend elektronische Geschäftsdokumente aus. Da die elektronische Integration für die Geschäftspartner jedoch meist sehr aufwändig ist, fehlte Ihnen bisher die Möglichkeit diese Dokumente einfach und kostengünstig zu verarbeiten. Order Management Tool (OMT) ist die einfache und kostenlose Lösung der DTAG für kleine und mittlere Unternehmen sich vollständig elektronisch integrieren zu können, ohne selbst über eigene Integrationsplattformen zu verfügen. Das OMT der DTAG dient zum Empfang, der Verarbeitung und dem Versenden elektronischer Dokumente auf Seite der Geschäftspartner. Die Benutzeroberfläche des OMT passt sich dabei dem jeweiligen Format des Dokumentes an und ermöglicht so dem Benutzer jedes Format in derselben Weise zu bearbeiten. Langwierige Einarbeitungszeiten entfallen. Auch unerfahrene Nutzer des Order Management Tool finden leichten und schnellen Umgang mit digitalen Geschäftsdokumenten. Version 178, vom Seite 1

7 2. Verwendete Symbole Allgemeiner Hinweis Achtung! Wichtiger Hinweis! Version 178, vom Seite 2

8 3. Installationstypen Das Setup des OrderManagementTool ermöglicht es Ihnen 3 verschiedene Installationen vorzunehmen: Installation für Einzelplatz Installation für Server Installation für Client ( installierte Serverversion ist Voraussetzung ) Version 178, vom Seite 3

9 4. Szenario der Mehrplatz-Version (Client-Server) Grudsätzlich läst sich das OMT-Tool in 2 Komponenten unterteilen. Die erste Komponente OMT-Fileschnittstelle, stellt die Verbindung mit unserem Dokumentenserver her. Sie empfängt und überträgt die Dokumente. (OMT-Server) Die Übertragung erfolgt vollautomatisch in einen Rhythmus von 60 min (Standardeinstellung). Die zweite Komponente OMT-GUI stellt das User-Interface dar, mit dessen Hilfe der Benutzer die Dokumente ansehen und bearbeiten kann. Hiermit werden auch die Antwortdokumente erzeugt und zum Versand an die OMT-Fileschnittstelle übergeben. (OMT-Client) Bei der Einzelplatzinstallation werden beide Komponenten auf dem Arbeitsplatzrechner installiert. Version 178, vom Seite 4

10 5. Systemvoraussetzungen Um das OrderManagementTool einsetzen zu können, benötigen alle Installationen einen Internet Zugang. Dieser dient der Kommunikation mit unserem zentralen Routingsystem, aber auch um die Anwendung sowohl serverseitig als auch clientseitig updaten zu können. Außerdem können die Clients über den Startbildschirm Neuigkeiten erfahren. Da die Anwendung Programmteile des Internet Explorers 6.0 nutzt, ist diese Version Mindestvoraussetzung. Für die Konvertierung der Dokumente in das PDF-Format (Voransicht/Drucken) wird das von Adobe kostenlos erhältliche Produkt Acrobat Reader benötigt. Prozessorleistung, wie auch freistehender Festplattenplatz richtet sich nach der Anzahl der zu verarbeitenden Geschäftsdokumente. Die Anwendung an selbst benötigt ca. 60 MB Festplattenspeicher. Die Einzelgröße eines Dokumentes liegt bei ca KB, d.h. für 1000 Dokumente benötigen Sie 25 MB Speicherplatz. Für die Verarbeitung möglicher Dateianhänge ist außerdem Microsoft Office 2000/XP/2003 oder höher notwendig. Das Tool ist auf folgenden Microsoft Windows Versionen lauffähig: NT/2000/XP/2003/Vista/Windows7 Version 178, vom Seite 5

11 6. Netzwerk-Zugriffe durch das Programm Das Order Managment Tool greift in verschiedenen Programmteilen auf das Internet zu: Dokumenten-Austausch Datei: FileClientService.dll Zieladresse: Beschreibung: in einem einstellbaren Intervall (1 x je Std) überträgt die Anwendung neue eingehende Belege (z.b. Aufträge) und sendet ausgehende Belege (z.b. Auftragsbestätigung, Rechnung, etc). Die Belege werden über eine SSL Verschlüsselung und mittels Benutzername und Passwort gesichert übertragen. Der Zugriff erfolgt durch "Addins\FileClient\FileClientService.exe" und "Addins\FileClient\SendAndReceive.exe". Dabei werden die in der Datei FileClient.ini hinterlegten Proxyserver -Einstellungen verwendet. Die Datei SendAndReceive.exe wird bei jedem Start des OMT einmal aufgerufen, die FileClientService.exe wird als Windows-Dienst jede Stunde (default) einmal gestartet. Beide Dateien nutzen dieselben Funktionen aus der Bibliothek FileClientConnector.dll um die Verbindung mit der CPEx aufzubauen. Die Verbindung wird als Webservice (HTTP mit SOAP) auf Port 443 (SSL) aufgebaut. News-Funktion Datei: BusinessConnector2.0.exe - Zieladresse Beschreibung: auf der Startseite des OMT werden aktuelle News und Infos zum Programm dargestellt (über integrierte InternetExplorerfunktionalität). Zum Beispiel Hinweise auf aktuelle und neue Funktionen sowie bevorstehende Programmupdates, FAQ, etc. Evtl. Proxy-Einstellungen werden vom Internet Explorer übernommen. Automatische Updateprüfung Datei: Updater.exe - Zieladresse Beschreibung: Der Updater sucht in regelmäßigen Intervallen automatisch nach neuen Features und Updates welche die kontinuierliche Pflege der Software garantieren. Dabei wird die InternetExplorer eigene Funktion "URLDownloadToFile" verwendet, um Updates aus dem Internet herunterzuladen. Der Zugriff erfolgt über HTTP, Port 80. Das Programm wird bei jedem Start des OMT im Silent-Modus ausgeführt um zu prüfen, ob eine neue Version vorhanden ist. Version 178, vom Seite 6

12 Es kann auch durch diese Anwendung zu einer Benutzer/Passwortabfrage kommen, wenn Ihr Unternehmen eine Proxy-Authentifizierung verwendet. Die Proxy-Einstellungen werden vom InternetExplorer übernommen. Version 178, vom Seite 7

13 7. Zusammenfassung Softwarevoraussetzungen NT/2000/XP/2003/Vista/Windows7 Office 2000/XP/2003 Internet Explorer 6.0 oder höher Adobe Acrobat Reader Version 178, vom Seite 8

14 8. Hardwarevoraussetzungen Ab Intel Pentium III, 800MHz Mind. 256 MB RAM Mind. 100 MB Festplattenspeicher Version 178, vom Seite 9

15 9. Erweiterung einer vorhandenen Einzelplatzversion auf eine Mehrplatzversion Sollten Sie bisher die Einzelplatzversion installiert haben und wünschen zukünftig eine Mehrplatzversion einzusetzen, so beachten Sie bitte die folgenden Schritte: Für die Serverkomponente benötigen Sie idealerweise einen dedizierten Server. Installieren Sie zuerst auf dem Server die OMT-Software. Starten Sie danach den Setup-Assistenten. Auf Seite 2 des Assistenten wählen Sie bitte Netzwerk-Server aus. Auf allen Rechnern, von denen Mitarbeiter mit dem OMT arbeiten wollen, ist ebenfalls je eine Installation der OMT Software nötig. Nach Starten des Setup-Assistenten auf dem jeweiligen Rechner des Mitarbeiters, wählen Sie bitte die Option des Netzwerk-Client aus. Version 178, vom Seite 10

16 Alle Installationen sollten regelmäßig upgedatet werden können, damit immer die aktuellste Version zur Verfügung steht. Achten Sie daher auf die entsprechende Rechtevergabe. Lesen Sie bitte auch die Kapitel 25 ff Wollen Sie von Ihrer bisherigen Einzelplatzversion auf eine Mehrplatzversion wechseln, so tragen Sie bitte dafür Sorge, dass die bisherigen Dokumente auf den Netzwerk-Server transportiert werden. Hierzu müssen Sie auf Datei-/Verzeichnisebene den kompletten Filestore unter C:\Programme\Storeserver BusinessConnector 2.0\FileStore auf den Server kopieren. Lesen Sie hierzu bitte unbedingt die Kapitel ab Punkt 25 Bitte nehmen Sie zuvor eine Datensicherung vor. Version 178, vom Seite 11

17 10. Download des Setup Die omt_setup.exe finden Sie per Download unter Dateigröße ca MB je nach Version Bitte laden Sie die OMT_Setup.exe auf Ihren Rechner oder starten Sie das Setup, indem Sie direkt auf Ausführen klicken. Version 178, vom Seite 12

18 Version 178, vom Seite 13

19 11. Start der Installation Bitte starten Sie die Installation, sofern Sie die Software heruntergeladen haben, mit Doppelklick auf OMT_Setup.exe. Notice: Bei Windows Vista und Windows 7 immer als Administrator anmelden, zusätzlich ist die Aktivierung des XP-Kompatibilitätsmodus erforderlich. Version 178, vom Seite 14

20 12. Automatische Installation Der Setupwizard verwendet ein "normales" Installscript - Installshield Setup. Daher können Sie alle Installshield Optionen verwenden (z.b. OMT_Setup.exe /s für eine Silent-Installation) Bitte beachten Sie hierzu, dass nach erfolgter Installation ein Konfigurationsassistent die Konfigurationseinstellungen in die Datei FileClient.ini in das Verzeichnis C:\Programme\Storeserver BusinessConnector 2.0\Addins\FileClient schreibt. Außerdem wird nach erfolgreicher Konfiguration in das Verzeichnis C:\Programme\Storeserver BusinessConnector 2.0 die Datei configuration.done geschrieben. Diese Dummydatei verhindert das erneute automatische Starten des Setupassistenten nach einer Initialinstallation. Version 178, vom Seite 15

21 13. Datei öffnen -Sicherheitswarnung Klicken Sie dann auf Version 178, vom Seite 16

22 14. Sprachauswahl Zurzeit stehen die Sprachen Deutsch und Englisch zur Verfügung. Wählen Sie die gewünschte Sprache aus und klicken Sie auf. Klicken Sie auf Version 178, vom Seite 17

23 15. Installation Begrüßung Version 178, vom Seite 18

24 16. Lizenzvereinbarungen Bitte akzeptieren Sie die Lizenzvereinbarung und klicken Sie auf AGB zur Nutzung der Software Order Management Tool Lizenzvertrag Storeserver Nur wenn Sie die oben genannten Vereinbarungen akzeptieren, können Sie die Software installieren. Sollten Sie hiermit nicht einverstanden sein, können Sie die Software nicht nutzen. Bei Fragen wenden Sie sich bitte an den für Sie zuständigen Einkäufer bei der DTAG. Bitte drucken Sie sich die Lizenzvereinbarung im Bedarfsfall aus. Version 178, vom Seite 19

25 Version 178, vom Seite 20

26 17. Installationsbeginn Bitte klicken Sie auf Version 178, vom Seite 21

27 18. Setup-Status Bitte Warten Sie bis der Wizard die Installation durchgeführt hat... Version 178, vom Seite 22

28 19. Abschluss der Installation und Neustart des Computers Bitte starten Sie den Computer nach erfolgreicher Installation neu, sofern Sie hierzu aufgefordert werden. Version 178, vom Seite 23

29 20. Update auf aktuelle Version Das Order Manangement Tool verfügt über eine integrierte, automatische Aktualisierungsfunktion, die bei jedem Start des Order Management Tools ausgeführt wird. Alternativ kann die Update-Funktion auch über den Startmenüeintrag "Updater" aufgerufen werden. Das Update-Programm übermittelt dabei seine Installationsnummer und prüft, ob aktualisierte Programmversionen verfügbar sind. Sollten Aktualisierungen verfügbar sein, können diese über das Update-Programm installiert werden. Ihre Installation bleibt somit immer auf dem neusten Stand. In besonderen Fällen können Sie auch dazu aufgefordert werden ein dediziertes Update zu starten. Gehen Sie hierzu bitte im Programmmenü, wie folgt vor: Bitte gehen Sie im Programmmenü unter Programme > Support > Update und führen den UpdateManager aus. Version 178, vom Seite 24

30 21. Updater Bildschirmanzeige nach Starten des Updaters Bitte klicken Sie auf Weiter Version 178, vom Seite 25

31 Anmerkung: Die im Screenshot gezeigte Version entspricht nicht der zum Zeitpunkt Ihrer Ausführung gezeigten Version. Diese ist stets höher, als die von Ihnen zurzeit benutzte Version. Haken Sie das gewünschte Update ein und gehen auf Weiter Version 178, vom Seite 26

32 Nach erfolgreichem Update der Installation erscheint das oben gezeigte Fenster. Klicken Sie auf Fertigstellen. Version 178, vom Seite 27

33 Bitte starten Sie danach den Computer neu. Version 178, vom Seite 28

34 22. Starten des Setup Assistenten Nachdem der Computer wieder hochgefahren ist, starten Sie bitte den Setup Assistenten unter START -> Programme-> Order Management Tool-> Support> Setup Assistenten Version 178, vom Seite 29

35 23. Initialeinrichtung Sollten Sie irrtümlich bereits das OMT-Tool gestartet haben, so erkennt die Anwendung, dass Sie sie zum ersten Mal starten und bittet Sie nun in den nachfolgenden Eingabeaufforderungen notwendige Angaben zur Konfiguration zu ergänzen. Die Anwendung selbst muss hierfür wieder geschlossen werden. Version 178, vom Seite 30

36 24. Willkommen beim Setup/ Einrichtungs-Assistenten Version 178, vom Seite 31

37 25. Installationstypen Auswahl Im folgenden Fenster haben Sie die Auswahl, welche Version installiert wird. Möchten Sie die Netzwerkversion installieren, so stellen Sie bitte sicher, dass zuerst die Netzwerk-Server Komponente installiert wird. Wenn Sie die Einzelplatzversion installieren möchten, so fahren Sie bitte mit Weiter fort. Wenn Sie den Netzwerk-Server installieren, so fahren Sie bitte mit Punkt 27 fort. Möchten Sie einen Netzwerk-Client einrichten, so fahren Sie bitte mit Punkt 28 fort. Version 178, vom Seite 32

38 26. Einzelplatzversion Version 178, vom Seite 33

39 27. Netzwerk-Server Wählen Sie zuerst die Option Netzwerk Server, wenn Sie eine verteilte Anwendung installieren möchten. Diese Installation sollten Sie auf einem dedizierten Server vornehmen. Der Server sollte allen gewünschten Clients dauerhaft (24-Betrieb) zur Verfügung stehen. Die Netzwerkversion arbeitet mit Verzeichnisfreigaben. Bitte merken Sie sich für die späteren Clientinstallationen den Servernamen und den Freigabenamen. Wir empfehlen die vorbelegten Freigabenamen zu übernehmen. Version 178, vom Seite 34

40 Danach folgen Sie bitte Punkt 32 der Installation Version 178, vom Seite 35

41 28. Netzwerk-Client Diese Version ist jeweils auf den Arbeitsplätzen der Mitarbeiter einzurichten, welche auf den zentralen Datenbestand auf dem Server zugreifen sollen. Tragen Sie im folgenden Fenster den Namen des Servers und der Freigaben auf dem Clientrechner ein. Version 178, vom Seite 36

42 Danach folgen Sie bitte Punkt 32 der Installation Version 178, vom Seite 37

43 29. ProxyServer Falls Sie in Ihrem Unternehmen einen http Proxy-Server verwenden, um ins Internet zu gelangen, so aktivieren Sie bitte das Kästchen Proxy-Server verwenden. Version 178, vom Seite 38

44 30. Was ist ein Proxy? Ein Proxy kommuniziert stellvertretend (Stellvertreter = engl. Proxy) für Ihre Internetanwendung (üblicherweise ein WWW-Browser) mit dem Internet. Hierbei werden auch die angeforderten und übertragenen Daten (Webseiten) lokal auf dem Proxy gespeichert. Dadurch kann ein nachfolgender Zugriff auf dieselben Daten sehr schnell von dieser lokalen Kopie erfolgen. Ein Proxy beschleunigt und reduziert den Datenverkehr zum Internet innerhalb der Benutzergemeinde des Proxys. Version 178, vom Seite 39

45 31. Adresse des Proxy-Servers Fragen Sie Ihre IT-Abteilung oder Öffnen Sie Ihren InternetExplorer-Browser Im Menü unter Extras >Internetoptionen klicken Sie auf den Reiter Verbindungen und dann unter LAN-Einstellungen auf. Im Fenster Einstellungen für lokales Netzwerk (LAN) klicken Sie bitte auf Version 178, vom Seite 40

46 Version 178, vom Seite 41

47 32. Administration Proxyserver Tragen Sie bitte die unter HTTP erwähnte Adresse in das Feld Adresse* und den Port* ein. Ergänzen Sie ggf. einen Benutzernamen und das zugehörige Passwort. Version 178, vom Seite 42

48 33. Prüfung der Internetverbindung Wenn Sie auf klicken prüft der Assistent, ob eine Internetverbindung aufgebaut werden kann. Ist dies nicht möglich, erscheint folgende Fehlermeldung! Version 178, vom Seite 43

49 34. System-Zugangsdaten Bei Erfolg gelangen Sie zum nächsten Fenster. Bitte geben Sie nun die Ihnen von uns mitgeteilten Credentials, also die Daten zu User und Passwort ein. Sollten Ihnen die Angaben fehlen, so kontaktieren Sie bitte den Helpdesk. Achten Sie bitte auf die Richtigkeit der Eintragung, da bereits ein Zahlen- oder Buchstabendreher einen Konnektierung verhindert. Version 178, vom Seite 44

50 35. Einrichtung mehrerer TP-Shortnames Neben dem Haupt-User, auch Tradingpartner genannt ( TP-Shortname) über den Dokumente gesendet und empfangen werden können, ist es möglich weitere User in einer Installation zu nutzen. Es können bis zu 10 weitere Useraccounts genutzt werden. Um weitere Tradingpartner einrichten zu können, klicken Sie die Schaltfläche Fenster zur Einrichtung der System-Zugangsdaten im Einrichtungs-Assistenten an. im Es erscheint ein zweites Fenster in dem Sie weitere User / Passwortkombinationen hinterlegen können. Tragen Sie die Ihnen bekannten Daten, max. 10 möglich, in die davor vorgesehenen Felder User und Passwort ein und klicken Sie anschließend auf. Sind Ihre Eingaben beendet, so schließen Sie das Fenster wieder mit einem Klick auf. Version 178, vom Seite 45

51 Zum Entfernen falsch hinzugefügter Zugangsdaten, nutzen Sie bitte den -Button. Anschließend schließen Sie das Fenster wieder mit einem Klick auf. Bei erfolgreicher Administration werden vom OMT alle Postfächer nacheinander abgearbeitet. Und die Dokumente empfangen und ggf. Antwortdokumente von Ihnen versendet. Version 178, vom Seite 46

52 Version 178, vom Seite 47

53 36. Verbindungsadresse zum System der DTAG Dieses Fenster können Sie in der Regel mit Weiter überspringen. Hier wird die URL des zentralen Routingsystems der DTAG angegeben, auf das Sie sich verbinden möchten. Die Standardadresse ist bereits vorbelegt. Ändern Sie diese Adresse nur, wenn Sie explizit hierzu aufgefordert werden. Zum Ändern ist es zuvor notwendig das Kästchen Andere Adresse angeben auszuhaken. Adresse Wirksystem: EAIHub= Adresse Abnahme-/Testsystem: EAIHub= Bitte ändern Sie die vorbelegte Adresse, wenn Sie das OMT Tool zum Testsystem verbinden wollen. Version 178, vom Seite 48

54 Zusätzlich müssen Sie in der Datei FileClient.ini (z.b: C:\Programme\Storeserver BusinessConnector 2.0\Addins\FileClient) die Zeile RFC_Password=cpextest ergänzen. Bitte achten Sie darauf, den Eintrag bei Umstellung auf das Wirksystem wieder zu entfernen. Achten Sie außerdem darauf, dass sich die Passwörter (Password=) für den User im Wirk- und Testsystem unterscheiden. Zu Details beachten Sie bitte das Folgekapitel. Version 178, vom Seite 49

55 37. Einrichtung des OMT mit Zugriff auf das Testsystem Zur Einrichtung des OMT mit Zugriff auf das Testsystem müssen einige Abänderungen in der Datei FileClient.ini vorgenommen werden, welche bei der Umstellung auf das Wirksystem wieder rückgängig gemacht werden müssen. Die FileClient.ini-Datei ist standardmäßig unter dem Pfad: C:\Programme\Storeserver BusinessConnector 2.0\Addins\FileClient zu finden. Der Laufwerkname kann ggf. abweichen. Standardmäßig wird hier das lokale Laufwerk verwendet. Ebenso kann es vorkommen, dass diese anstatt unter Programme unter Program Files zu finden ist. Es müssen folgende Abänderungen in der der FileClient.ini getroffen werden (s. Screenshot): 1. Änderung der Verbindungsadresse Standardmäßig ist die Verbindungsadresse zum Wirksystem hinterlegt. Wenn Sie sich auf das Testsystem konnektieren wollen, muss daher diese Standardadresse geändert werden. Bitte fügen Sie hierfür ein t hinter ein. Der Rest der Adresse bleibt unverändert Einfügen der RFC_Password-Zeile Unter die bereits existierende Passwort-Zeile müssen Sie eine neue Zeile mit dem Inhalt RFC_Password=cpextest einfügen. Nun sollte der Zugriff auf das Testsystem gegeben sein. Um sicher zu gehen, dass die Verbindung per OMT zum Testsystem aufgebaut werden kann, sollten Sie diese testen. Version 178, vom Seite 50

56 Die Verbindung kann mit Hilfe der SendAndReceive.exe und der FileClient.log getestet werden. Beide Dateien sind ebenfalls unter C:\Programme\Storeserver BusinessConnector 2.0\Addins\FileClient zu finden. Zum Testen der Verbindung gehen Sie bitte wie folgt vor: 1. Aktivieren der SendAndReceive.exe via Doppelklick Die SendAndReceive.exe aktivieren Sie per Doppelklick. Nun sehen Sie die Sanduhr kurz aufflackern. 2. Öffnen der FileClient.log Bitte öffnen Sie die FileClient.log-Datei und scrollen Sie hinunter bis zum letzten Eintrag. Folgender Eintrag sollte nun hier zu lesen sein: XX.XX.2009 XX:XX:XX INFO:Description:Storeserver OMT-FileClient periodical function to get new documents from the server and send pending documents to the server starts. XX.XX.2009 XX:XX:XX INFO:Description:No new documents for user-account 'S_Hin300' available Dieser Eintrag bedeutet, dass der Dienst zum Abrufen und Versenden der Dokumente des OMT aktiviert wurde. Es wurden keine neuen Dokumente zum Herunterladen gefunden. Aber Sie wissen, dass Sie sich erfolgreich Anmelden konnten. Sobald Sie diese Meldung bekomme, können Sie sicher gehen, dass eine Verbindung zum Testsystem gegeben ist. Bei Umstellung der Anbindung vom Testsystem auf das Wirksystem müssen diese Änderungen rückgängig gemacht werden. Bitte beachten Sie, dass die Passwörter für das Test- sowie das Wirksystem unterschiedlich sind. Version 178, vom Seite 51

57 38. Automatische Fehlerbenachrichtigung via Möchten Sie über Fehler bzw. Störungen beim Filetransport informiert werden, so können Sie im folgenden Screen eine Benachrichtigung administrieren. Version 178, vom Seite 52

58 Beispiel: Info: Die funktion ist z.z. hinter Proxyservern nicht möglich. Version 178, vom Seite 53

59 39. Abschluss der Konfiguration Haben Sie alle Eingaben gemacht, dann zeigt der letzte Bildschirm die erfolgreiche Einrichtung. Außerdem wird nach erfolgreicher Einrichtung in das Verzeichnis C:\Programme\Storeserver BusinessConnector 2.0 die Datei configuration.done geschrieben. Diese Dummydatei verhindert das erneute automatische Starten des Setupassistenten nach einer Initialinstallation. Info: Haben Sie die Netzwerk-Server Installation gewählt, so startet nun der Berechtigungsassistent. Siehe 41 Version 178, vom Seite 54

60 40. Handbuch Danach startet die Anwendung selbstständig. Weiter Hinweise finden Sie im Handbuch. Dieses können Sie im Programmmenü unter Support > Benutzerhandbuch aufrufen Die aktuellste Version finden Sie stets unter dem Startbildschirm des OMT unter: FAQ: Online Supportcenter Klicken Sie hierzu bitte auf den entsprechenden Link. Version 178, vom Seite 55

61 41. Berechtigungsassistent Der Berechtigungsassistent ist ein Tool zur Administration der gewünschten User im Netzwerkszenario. Der Assistent startet automatisch nach der erfolgreichen Installation der Netzwerk-Server Version. Wollen Sie den Assistenten per Hand starten, so führen Sie unter C:\Programme\Storeserver BusinessConnector 2.0 bitte per Doppelklick die Datei aus. Hiermit erstellen Sie eine Standardberechtigung auf die entsprechenden Verzeichnisse: Version 178, vom Seite 56

62 Haben Sie die Netzwerk Server Installation gewählt, erscheint nun ein Fenster mit dem Berechtigungsassistenten. Bitte geben Sie im folgenden Fenster die berechtigten User im Format <Domäne>\user oder user ein. Haben Sie mehrere User, so trennen Sie bitte die einzelnen Einträge mit Semikolon. Version 178, vom Seite 57

63 Nach erfolgreicher Administration erscheint der folgende Bildschirm. Version 178, vom Seite 58

64 Version 178, vom Seite 59

65 42. Deinstallieren der Anwendung Schließen Sie die OMT Anwendung Gehen Sie in der Systemsteuerung auf Software Klicken Sie auf Entfernen Version 178, vom Seite 60

66 Alle zu entfernenden Komponenten werden gesucht Klicken Sie auf Ja Das Programm wird entfernt Version 178, vom Seite 61

67 Klicken Sie auf Fertig stellen zum Beenden der Deinstallationsroutine Die folgenden Punkte gelten nur für die Einzelplatzversion, bzw. für die Netzwerk Server Version. Version 178, vom Seite 62

68 43. Installation des OMT Service auf Ihrem System Nachdem Sie den Wizard vollständig durchlaufen haben, wird mit Fertigstellen ein Windows Systemdienst installiert. Diesen finden Sie unter Systemsteuerung>Verwaltung>Dienste Für einen fehlerfreien Betrieb ist es notwendig, dass der Dienst OrderManagementTool FileClientService gestartet ist. Der Startyp sollte automatisch sein. Dieser Dienst versendet und empfängt alle Dokumente im Zusammenhamg mit dem OMT. Im Rhythmus von 60 min (Standardeinstellung) erfolgt eine Konnektierung auf die Routingplattform der DTAG. Version 178, vom Seite 63

69 44. SendReceiveInterval Unter Programme\Storeserver BusinessConnector 2.0\Addins\FileClient befindet sich die Datei FileClient.ini Darin steht das SendReceiveInterval standardmäßig auf 3600 (Angabe in Sekunden) d.h. 1 x pro Stunde versucht der Webserviceaufruf auf die Routingplattform der DTAG zuzugreifen, um neue Dokumente abzuholen und neue Dokumente zu versenden. Standardeinstellung SendReceiveInterval=3600 Sie sollten dieses Intervall nur in Absprache mit dem Support der DTAG abändern. Version 178, vom Seite 64

70 45. Safemode Falls Ihre Unternehmenspolicy das Ausführen von Active X nicht zulässt, so können diese Funktionen (Beispielsweise der POP-up Kalender ) im OMT ausgeschaltet werden. Legen Sie hierzu bitte im Programmverzeichnis (z.b. C:\Programme\Storeserver BusinessConnector 2.0) eine leere Textdatei mit dem Namen safemode.txt ab. Nach Starten des Programmes verschwinden anschließend die Kalenerelemente neben den Datum- Eigabefeldern. Eine manuelle Eingabe ist weiterhin möglich. Bitte achten Sie dabei auf das Datumformat: DD.MM.JJJJ Version 178, vom Seite 65

71 46. Commit Um ein Höchstmass an Übertragungssicherheit zu erlangen lässt sich eine Transaktionsdatenbank aktivieren. Bitte prüfen Sie, ob die Fileclient.dll im Verzeichnis mind. Die Version trägt. Ausserdem sollte im gleichen Verzeichnis die Datenbank-Datei fileclient.fdb vorhanden sein. In der Fileclient.ini ergänzen Sie bitte die Zeile Mode=commit. Version 178, vom Seite 66

72 47. FileClientLog Unter C:\Programme\Storeserver BusinessConnector 2.0\Addins\FileClient Finden Sie die Datei FileClient.log Diese Datei zeigt an, ob der FileClient Transportdienst erfolgreich arbeitet. Alle Transaktionen werden hier mit einem Zeitstempel versehen und können so ein hilfreiches Mittel zur Analyse bei Fehlern in der Übertragung sein. Sollte der Dienst nicht funktionieren, so werden hier auch Fehler- und Warnmeldungen erscheinen. Bitte kontaktieren Sie ggf. den Ihnen bekannten Helpdesk. Version 178, vom Seite 67

73 Version 178, vom Seite 68

74 48. Fehlercodes im FileClientLog falscher Dokumententyp Es handelt sich um ein ungültiges xcbl Dokument. Bitte kontrollieren Sie den FileClient Ausgang: C:\Programme\Storeserver BusinessConnector 2.0\Addins\FileClient\OUT Die Connectivity zu unserem SAP XI System ist gestört Bitte dem Helpdesk melden falsche Parameter Bitte überprüfen Sie Ihr User bzw. Passwort Version 178, vom Seite 69

75 49. Wechsel der Sprache 1. Start -Button in Windows Startleiste anklicken (blauer Pfeil) 2. Ausführen auswählen (roter Pfeil) 3. regedit in das Eingabefeld eintragen und den OK -Button anklicken Version 178, vom Seite 70

76 4. Den richtigen Pfad auswählen Zum Beispiel: HKEY_LOCAL_MACHINE (blauer Pfeil) [Screenshot I ] SOFTWARE (roter Pfeil) [Screenshot I ] Storeserver Systems (Es gibt zwei Storeserver Einträge. Beide Einträge ausprobieren um den richtigen herauszufinden.) [Screenshot II ] BusinessConnetcor2.0 [Screenshot II ] applanguage (Öffnen via Doppelklick) [Screenshot III ] I. II. III. 5. Ändern der Spracheinstellung Version 178, vom Seite 71

77 Eintragen der gewünschten Sprache in das Eingabefeld. Die Sprache wird jeweils mit zwei Buchstaben abgekürzt. Die Abkürzungen der Sprachen lauten: DE = Deutsch EN = Englisch HU = Ungarisch SK = Slowakisch OK -Button anklicken. Nun wird das OMT nach dem Öffnen in der gewünschten Sprache angezeigt. Der Eintrag im Screenshot bewirkt den Wechsel auf die slowakische Sprachausgabe. Version 178, vom Seite 72

78 Version 178, vom Seite 73

79 50. Http Statuscodes HTTP 1xx Code Bedeutung Erklärung 100 Continue Der Client hat eine Anfrage richtig gesendet und soll damit fortfahren. 101 Switching Protocols Der Client verlangt nach einem anderen Übertragungsprotokoll. Der Server hat eine Anfrage verstanden und ist mit dem Wechsel einverstanden HTTP 2xx Code Bedeutung Erklärung 200 Successful Die Anfrage des Clienten wurde erfolgreich bearbeitet und alle Informationen werden vom Server gesendet. 201 Created Der Cliente hat den Server veranlaßt, ein neues Dokument zu erzeugen. Im Header wird die neue Quelle benannt. 202 Accepted Die Anfrage des Clienten wurde vom Server verstanden und akzeptiert, jedoch nicht verarbeitet. 203 Non-Authorative Information Der Client erhält Informationen vom Server, die aus einer anderen Quelle als dem Server stammen. 204 No Content Der Server hat die Anfrage verstanden, sendet jedoch nur den Header ohne Body an den Clienten. 205 Reset Content Die Anfrage wurde erfolgreich ausgeführt, und der Client soll das Dokument neu aufbauen. 206 Partial Content Der Cliente hat in seinem Header nur einen Teil eines Dokumentes angeforderet HTTP 3xx Code Bedeutung Erklärung 300 Multiple Choices Der Client hat eine Ressource angefordert, für die mehrere Quellen in Frage kommen. 301 Moved Permanently 302 Moved Temporarily Die angeforderte Ressource wurde permanent an einen anderen Ort verschoben. Die angeforderte Ressource wurde nur zeitweilig verschoben. 303 See Other Der Client hat eine Ressource angefordert, die jedoch an anderer Stelle zu finden ist. 304 Not Modified Die angeforderte Ressource hat sich seit der letzten Anforderung nicht verändert. 305 Use Proxy Die Ressource, die angefordert wurde, soll nicht vom Server, sondern über einen angegebenen Proxy bezogen werden. Version 178, vom Seite 74

80 307 Moved temporarily Der Client hat eine Ressource angefordert, die momentan an anderer Stelle zu finden ist HTTP 4xx Code Bedeutung Erklärung 400 Bad Request Die Anfrage des Clienten wurde vom Server nicht verstanden. 401 Unauthorized Die Anfrage erforderte eine Authentifizierung des Nutzers bzw. Clienten. 402 Payment Required Es wurde eine kostenpflichtige Ressource angefordert. Ein Statuscode für die Zukunft. 403 Forbidden Die Anfrage wurde verstanden, die Ausführung wurde jedoch vom Server verboten. 404 Not Found Die angeforderte Ressource wurde nicht gefunden. 405 Method Not Allowed Die Methode, die zur Ausführung spezifiziert wurde, ist für diese Ressource nicht erlaubt (Get oder Post). 406 Not Acceptable Der Client hat eine Ressource angefordert, deren Format er nach eigener Information nicht unterstützt. 407 Proxy Authentication Required Der benutzte Proxy verlangt eine Authentifikation. 408 Request Timeout Der Client hat innerhalb der erwarteten oder zulässigen Wartezeit keine vollständige Anfrage gesendet. 409 Conflict Durch den Status der angeforderten Ressource konnte die Anfrage vom Server nicht ausgeführt werden. 410 Gone Die Ressource ist auf dem Server nicht mehr verfügbar und ein neuer Platz ist nicht bekannt. 411 Length Required Bei der Anforderung des Clienten fehlte die Längenangabe (Bytezahl) der Ressource. 412 Precondition Failed Die If konditionierte Anfrage des Clienten konnte vom Server nicht bearbeitet werden. 413 Request Entity Too Long Die vom Clienten angeforderte Ressource ist dem Server zu gross und wurde daher nicht verarbeitet. 414 Request-URI Too Long Die vom Clienten übermittelte URL war so lang, dass der Server sie nicht mehr bearbeiten konnte. Bsp. zu viele Get Parameter. 415 Unsupported Media Type 416 Request range not satisfiable Der tatsächliche Typ der Ressource und der in der Anfrage des Clienten benannte Typ stimmen nicht überein. Der angeforderte Bereich eines Dokumentes konnte vom Server nicht ausgeliefert werden. 417 Expectation failed Der Client hat einen Expect Header gesendet, den der Server nicht erfüllen kann. 424 Site too ugly Der Client hat ein Dokument angefordert, das der Server nicht ausliefern will HTTP 5xx Code Bedeutung Erklärung Version 178, vom Seite 75

81 500 Internal Server Error Dieser Fehler wird ausgelöst, wenn während der Beantwortung der Anfrage ein unerwarteter Fehler auf dem Server eingetreten ist. Einen genaueren Grund für den Fehler findet man in den Server Log-Files. 501 Not Implemented Der Server konnte die Clientanfrage nicht ausführen, da er die Anfrage nicht unterstützt. 502 Bad Gateway Der Proxy oder Gateway teilt mit, daß der übergeordnete Server fehlerhafte Daten geliefert hat. 503 Service Unavailable Der Server ist zeitweilig überlastet und kann keine weiteren Anfragen bearbeiten. 504 Gateway Timeout Der Proxy oder Gateway zeigt damit an, daß der übergeordnete Server keine Daten innerhalb der erwarteten Zeitspanne geliefert hat. 505 HTTP Version Not Supported Die angeforderte HTTP Protokollversion wird vom Server nicht unterstützt. Version 178, vom Seite 76

82 51. Abkürzungsverzeichnis OMT DTAG Order ManagementTool Deutsche Telekom AG Version 178, vom Seite 77