installation manual order management tool

76
Order Management Tool Installation Manual Version: 17 Issue date: 18.06.2009

Upload: others

Post on 23-Oct-2021

3 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Installation Manual Order Management Tool

Order Management Tool

Installation Manual

Version: 17

Issue date: 18.06.2009

Page 2: Installation Manual Order Management Tool

Copyright © 2009 by T-Systems Enterprise Services GmbH [place of jurisdiction named in file: Enter data].

All rights reserved, including the reprinting of excerpts, photo-mechanical reproduction (including microcopy) and evaluation by

databases or similar means.

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page ii

Editorial Information

Published by:

T-Systems Enterprise Services GmbH Neugrabenweg 4 66123 Saarbruecken - Germany

File name

Installation Manual Order Management

Tool V17.doc

Version Date

17 18.06.2009

Author

Ostermann.Tim

Saarbrücken

Contact person Phone/fax E-mail

Tim Ostermann +49-681-909-2470 [email protected]

Brief overview

Installation instructions for the Order Management Tool (OMT)

Page 3: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page iii

Table of contents

1 Introduction 1

2 Symbols Used 2

3 Installation Types 3

4 Multi-User Scenario (Client Server) 4

5 System Requirements 5

5.1 Internet Program Access................................................................................................................................... 5

5.1.1 OMT...................................................................................................................................................... 5

5.1.2 FileClient.............................................................................................................................................. 5

5.1.3 Updater ................................................................................................................................................ 6

Page 4: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page iv

6 Summary of Software Requirements 7

7 Hardware Requirements 8

8 Extension of an Existing Single-User Version to a Multi-User Version 9

9 Downloading the Setup 11

10 Starting the Installation 13

11 Automatic Installation 14

12 Opening File – Security Warning 15

13 Language Selection 16

14 Installation Greeting 17

15 License Agreements 18

16 Start of Installation 19

17 Setup Status 20

18 Finishing the Installation and Restarting the Computer 21

19 Updating to the Current Version 22

20 Updater 23

21 Starting the Setup Wizard 27

22 First Installation 28

23 Welcome to the Setup Wizard 29

24 Selecting the Installation Types 30

25 Single-User Version 31

26 Network Server 32

27 Network Client 34

28 Proxy Server 36

29 What is a Proxy? 37

30 Address of the Proxy Server 38

31 Administration Proxy Server 40

32 Checking the Internet Connection 41

33 System Access Data 42

34 Administration of multiple TP-Shortnames 43

Page 5: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page v

35 Connection Address to the DTAG System 45

36 Setup connection of the OMT to the testing system 47

37 Automatic Error Notification via E-mail 49

38 Finishing the Configuration 51

39 Manual 52

40 Permission wizard 53

41 Removing the Application 57

42 Installing the OMT Service on your System 60

43 SendReceiveInterval 61

44 FileClientLog 62

45 Error Codes in the FileClientLog 64

45.1 1008 Incorrect document type.......................................................................................................................64

45.2 1009 The connectivity to our SAP XI system is disrupted ........................................................................64

45.3 1011 Incorrect parameter ...............................................................................................................................64

46 Change of the language 65

47 Http status codes 68

47.1 HTTP 1xx ............................................................................................................................................................68

47.2 HTTP 2xx ............................................................................................................................................................68

47.3 HTTP 3xx ............................................................................................................................................................68

47.4 HTTP 4xx ............................................................................................................................................................69

47.5 HTTP 5xx ............................................................................................................................................................70

48 List of Abbreviations 71

Page 6: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 1

1 Introduction

Deutsche Telekom AG (DTAG) and its company units increasingly exchange electronic business documents

with their business partners.

As electronic integration for the business partners is generally very complex however, they have, to date, lacked

the facility to process these documents simply and cost-effectively.

The Order Management Tool (OMT) is DTAG’s simple and freefreefreefree solution for small and medium-sized companies

facilitating completely electronic integration without these companies having to have their own integration

platforms.

DTAG’s OMT is used by the business partner to receive, process and send electronic documents.

The OMT user interface adjusts to the relevant document format and thus allows the user to process every

format in the same way.

Tedious training periods are no longer required.

Even inexperienced users of the Order Management Tool find it easy and quick to process digital business

documents.

Page 7: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 2

2 Symbols Used

General note

Attention! Important note!

Page 8: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 3

3 Installation Types

The Order Management Tool setup gives you 3 different installation options:

♦ Single-user installation

♦ Server installation

♦ Client installation (installed server version is a precondition)

Page 9: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 4

4 Multi-User Scenario (Client Server)

In principle, the OMT can be divided into two components.

The first component “OMT file interface” establishes the connection with our document server.

It receives and transfers the documents (OMT server).

The transfer is fully automatic and takes place once every 60 min (default setting).

The second component “OMT GUI” is the user interface, with which users can view and edit the documents.

This is also used to create the response documents and to transfer files to the OMT file interface for dispatch

(OMT client).

In the case of single-user installation, both components are installed on the workplace computer.

Page 10: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 5

5 System Requirements

In order to be able to use the Order Management Tool, all installations require Internet access.

This is to enable communication with our central routing system, but also so that the application can be

updated both on the server and on the client side.

The clients can also be kept up-to-date via a News section on the start screen.

As the application uses parts of the Internet Explorer 6.0 program, this version is the minimum requirement.

Acrobat Reader, the free application from Adobe, is also required to convert the documents to PDF format (for

viewing and printing).

Processor speed and available disk space depend on the number of business documents to be processed.

The application itself requires approx. 60 MB of hard disk space.

The size of an individual document is approx. 20-25 KB, i.e. for 1000 documents you require 25 MB of memory.

Furthermore, Microsoft Office 2000/XP/2003 or higher is required to handle any file attachments.

The tool can run on the following versions of Microsoft Windows: NT/2000/XP/2003

5.1 Internet Program Access

5.1.1 OMT

The OMT itself (BusinessConnector20.exe) accesses the start page on the Internet via an integrated Internet

Explorer, so that it can also display the News (center part of the start page).

When using a proxy server, therefore, you may be asked to enter a password when starting the OMT.

Should access not be possible here, the news is not displayed (not critical). This is simply a matter of calling up

a website via port 80 as normal.

The proxy settings are accepted by Internet Explorer.

5.1.2 FileClient

The FileClient service accesses the Internet to exchange data with the CPEx.

Access takes place via

"Addins\FileClient\FileClientService.exe"

and

"Addins\FileClient\SendAndReceive.exe".

The proxy server settings saved in the FileClient.ini file are used here.

The SendAndReceive.exe file is called up once once once once each time the OMT is started; the FileClientService.exe is

started once every hour (default) as a Windows service.

Page 11: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 6

Both files use the same functions from the FileClientConnector.dll library to establish the connection with the

CPEx.

The connection is established as a web service (HTTP with SOAP) on port 443 (SSL).

Note:

Older versions of this program part experienced problems with some firewalls and proxy servers.

The corrected version writes everything to an entry in the fileClient.log, in the mode of "Storeserver OMT-

FileClient ... ...Version 1.41 Network".

5.1.3 Updater

The updater (Update.exe) offers functions to update the software.

Here Internet Explorer’s own function "URLDownloadToFile" is used to download updates from the Internet.

Access takes place via HTTP, port 80. The program is executed in “silent mode” every time the OMT is started,

to check whether a new version is available.

As a result of this application you may also be asked for a user name/password, if your company is using a

proxy authentication. The proxy settings are accepted by Internet Explorer.

Note: The older version of this program part experienced problems with some special proxy servers. The

corrected version has the version number >= 1.1.59.

Please update your installation, if required.

Page 12: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 7

6 Summary of Software Requirements

♦ NT/2000/XP/2003

♦ Office 2000/XP/2003

♦ Internet Explorer 6.0

♦ Adobe Acrobat Reader

Page 13: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 8

7 Hardware Requirements

♦ Intel Pentium III, 800MHz and above

♦ Min. 256 MB RAM

♦ Min. 100 MB hard disk space

Page 14: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 9

8 Extension of an Existing Single-User Version to

a Multi-User Version

If you have previously installed the single-user version and wish to use a multi-user version in the future, simply

follow the steps below:

For the server components, you ideally need a dedicated server.

First install the OMT software on the server.

Then start the Setup Setup Setup Setup wizardwizardwizardwizard.

On Screen 2 of the wizard, select the Network ServerNetwork ServerNetwork ServerNetwork Server option.

The OMT software must likewise be installed on each and every computer, on which employees intend to work

with the OMT.

After starting the Setup wizardSetup wizardSetup wizardSetup wizard on the relevant employee’s computer, please select the Network ClientNetwork ClientNetwork ClientNetwork Client option.

It should be possible to update all installations regularly so that the latest version is always available.

It is therefore important to ensure an appropriate assigment of rights.

Page 15: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 10

Please also read Section 24 ff

If you wish to switch from your previous singleIf you wish to switch from your previous singleIf you wish to switch from your previous singleIf you wish to switch from your previous single----user version to a multiuser version to a multiuser version to a multiuser version to a multi----user version, please ensure that the previous user version, please ensure that the previous user version, please ensure that the previous user version, please ensure that the previous

documents are moved to the network server.documents are moved to the network server.documents are moved to the network server.documents are moved to the network server.

To do this, you must copy the entire FileStore under C:\Programme\Storeserver BusinessConnector

2.0\FileStore at file/directory level to the server.

To this end, it is essential that you read the section from Point Point Point Point 24242424 onwards.

Please back up all data beforehand.

Page 16: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 11

9 Downloading the Setup

The “omt_setup.exe” is available for download at

http://omt.storeserver.net/telekom/download/http://omt.storeserver.net/telekom/download/http://omt.storeserver.net/telekom/download/http://omt.storeserver.net/telekom/download/

The file size is approx. 60-70 MB depending on the version.

Please load the OMT_Setup.exe onto your computer or start the setup by clicking directly on “Run”.

Page 17: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 12

Page 18: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 13

10 Starting the Installation

Please start the installation, once you have downloaded the software, by double-clicking on OMT_Setup.exe.

Page 19: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 14

11 Automatic Installation

The Setup wizard uses a “normal” install script – InstallShield setup. Thus you can use all InstallShield options (e.g. OMT_Setup.exe /s for a silent installation).

Please note in this respect that once the installation is complete, a configuration wizard writes the configuration

settings to the FileClient.ini file in the directory

C:\Programme\Storeserver BusinessConnector 2.0\Addins\FileClient.

Moreover after successful configuration, the file configuration.doneconfiguration.doneconfiguration.doneconfiguration.done is written to the directory

C:\Programme\Storeserver BusinessConnector 2.0.

This dummy file prevents the Setup wizard from restarting automatically after the first installation.

Page 20: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 15

12 Opening File – Security Warning

Then click on

Page 21: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 16

13 Language Selection

Currently the languages GermanGermanGermanGerman and EnglishEnglishEnglishEnglish are available.

Select the desired language and click .

Click

Page 22: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 17

14 Installation Greeting

Page 23: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 18

15 License Agreements

Please accept the license agreement and click

♦ DTAG’s General Contractual Conditions for eCommerce

♦ General Terms and Conditions for Using the Software, Order Management Tool

♦ Storeserver License Contract

Only when you have accepted the above mentioned agreements can you install the software.

If you do not agree to this, you cannot use the software.

If you have any questions, please contact the purchaser responsible for you at DTAG.

Please print out the license agreement, if required.

Page 24: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 19

16 Start of Installation

Please click

Page 25: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 20

17 Setup Status

Please wait until the wizard has completed the installation.

Page 26: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 21

18 Finishing the Installation and Restarting the Computer

Please restart the computer after successful installation, if you are asked to do so.

Page 27: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 22

19 Updating to the Current Version

The Order Manangement Tool features an integrated, automatic update function which is run every time the

Order Management Tool is started.

Alternatively, the update function can also be called up via the Start menu entry “Updater”.

The update program transmits its installation number and checks whether an updated program version is

available.

If updates are available, you can install these via the update program.

Your installation thus remains up-to-date at all times.

In special cases, you may also be prompted to start a dedicated update.

To do this, go to the program menu as follows:

Go to the program menu under Programs > Support > Update and run the UpdateManager.

Page 28: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 23

20 Updater

Screen display after Updater is started.

Click “Next”.

Page 29: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 24

Note: The version shown in the screenshot is not the version shown at the time you are running it.

This is always higher than the version currently used by you.

Select the desired update by checking the corresponding box and click “Next”.

Page 30: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 25

Once the installation has been successfully updated, the window shown above is displayed.

Click on “Finish”.

Please restart the computer.

Page 31: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 26

Page 32: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 27

21 Starting the Setup Wizard

Once the computer has been rebooted, start the Setup wizard under START -> Programs -> Order Management

Tool-> Support> Setup Wizard

Page 33: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 28

22 First Installation

If you have erroneously started the OMT already, the application will detect that this is the first time it has been

started and will ask you to enter the necessary configuration details by answering the prompts that follow.

The application itself must be closed again for this.

Page 34: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 29

23 Welcome to the Setup Wizard

Page 35: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 30

24 Selecting the Installation Types

In the following window, you are given a choice as to which version to install.

If you wish to install the network version, ensure that the network server components have been installed first.

If you wish to install the single-user version, then continue with “Next”.

If you are installing the network server, continue with Point Point Point Point 26262626.

If you wish to set up a network client, continue with Point Point Point Point 27272727.

Page 36: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 31

25 Single-User Version

Page 37: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 32

26 Network Server

First select the Network Server option if you wish to install a distributed application.

You should perform this installation on a dedicated server.

The server should be permanently available to all desired clients (24-hour operation).

The network version works with directory shares.

Please note the server names and the sharenames for future client installations.

We recommend accepting the pre-assigned sharenames.

Page 38: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 33

Next, continue the installation from Point Point Point Point 31313131.

Page 39: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 34

27 Network Client

This version must be set up on the workstation of each employee who is to have access to the central database

on the server.

In the following window, enter the name of the server and the shares on the client computer.

Page 40: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 35

Next, continue the installation from PointPointPointPoint 31313131.

Page 41: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 36

28 Proxy Server

If you are using a http proxy server in your company to access the Internet, check the box “Use proxy server”.

Page 42: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 37

29 What is a Proxy?

A proxy communicates with the Internet as a representative or proxy for your Internet application (normally a

web browser). Here, the requested and transmitted data (web pages) are stored locally on the proxy.

Consequently, subsequent access to the same data can take place very quickly from this local copy. A proxy

accelerates and reduces data traffic to the Internet within the proxy’s user community.

Page 43: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 38

30 Address of the Proxy Server

Ask your IT department

or

open your Internet Explorer browser.

In the menu under Tools > Internet Options, click on the Connections tab and then on under

LAN settings.

In the Local Area Network (LAN) Settings, click on .

Page 44: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 39

Page 45: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 40

31 Administration Proxy Server

Enter the address provided under HTTP in the Address* field and the Port* field.

Add a user name and the corresponding password, if required.

Page 46: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 41

32 Checking the Internet Connection

When you click on , the wizard checks whether an Internet connection can be established.

If this is not possible, the following error message appears!

Page 47: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 42

33 System Access Data

If the connection is successful, the following window will appear.

Now enter the “Credentials” we provided to you, i.e. the user and password data.

If you do not have this information, contact the Helpdesk.

Ensure that you enter the details correctly, as even one error in a number or letter will prevent the connection

from being established.

Page 48: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 43

34 Administration of multiple TP-Shortnames

In addition to the main user, also known as Trading Partner (TP-Short Name) with whom youre able to send and

receive, it is possible to add more users in one installation.

You can store up to 10 additional user accounts in your application.

To administrate further trading partners you should click the button, “further shortnames” in the window for

configuring the system-access data in the setup wizard.

It appears a second window in which you can insert more user / password combinations. Enter the known data,

max. 10 in the fields "User" and "Password" and then click “add”.

If your entries are finished, then close the window by clicking on “Finished”.

Page 49: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 44

To remove wrong add data click on the “Delete”–Button. When you are finished with that than click on “Close”.

Page 50: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 45

35 Connection Address to the DTAG System

Normally you can skip this window by clicking “Next”.

The URL of DTAG’s central routing system to which you wish to connect is given here.

The default address is already pre-assigned.

Only change this address when you are explicitly asked to do so.

To change it you must first check the box next to “Enter another address”.

LIVE system address CPX: EAIHub=https://cpex.telekom.de/DocumentProcessorWS/DocumentProcessorWSConfig?style=document

Testing system address QPX: EAIHub=https://cpex-t.telekom.de/DocumentProcessorWS/DocumentProcessorWSConfig?style=document

Please change the prepopulated address, if you would like to connecting the OMT with the testing system.

Page 51: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 46

Additionally you have to complete the line with an additional RFC userpassword: RFC_Password=cpextest File to change: FileClient.ini Location: e.g.: C:\Programme\Storeserver BusinessConnector 2.0\Addins\FileClient

Please make sure that the entry will be removed again if you change to the live system. Also make sure that the passwords (Password=) for the user in the live and the testing system will be different. Also don’t forget to delete the line with the RFC_Password again, if you are connected to the live system. Please see the following chapter.

Page 52: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 47

36 Setup connection of the OMT to the testing system

For the setup of OMT with connection to the testing system you have to do some changes in the file FileClient.ini. This changes have to be removed if you change back to the live system. You can find the FileClient.ini-file normally under: C:\Programme\Storeserver BusinessConnector 2.0\Addins\FileClient The drive is the standard local drive. Maybe its also installed under Program Files. You have to do the following changes in the FileClient.ini-file (see screenshot): 1. Change of the access address

You have to change the default connection address to live system. You need to insert an hyphen and a “t” behind https://cpex. The rest of the address will be unchanged. The right address to the testing systems is. https://cpex-t.telekom.de/DocumentProcessorWS/DocumentProcessorWSConfig?style=document

2. Insert RFC_Password-line You have to insert a new line under the still existing password-line. The content of the new line will be: RFC_Password=cpextest

You should test the connection to the testing system to be sure that it works. You could test the connection with the SendAndReceive.exe and control your effort in the FileClient.log-File. Both you can find under C:\Programme\Storeserver BusinessConnector 2.0\Addins\FileClient. Please, follow these steps to test the connection:

Page 53: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 48

1. Activate the SendAndReceive.exe via double click. Now you can see the hourglass appears for a short moment.

2. Opening of the FileCLient.log Please open the FileClient.log and scroll down to the last entry. You should read here the following entry:

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_XXXXXX available…

This entry means that the service for retrieving an sending of documents of the OMT has been activated. There are no new documents for download on the testing system. But you know that the login was successful.

This message tell you that the connection to the testing system is ok. If you want to change from the testing system to the live system you have to remove the changes again.

Page 54: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 49

37 Automatic Error Notification via E-mail

If you wish to be informed about errors or disruptions that occur during file transport, you can set up an e-mail

notification in the following screen.

Page 55: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 50

Info: The e-mail function is currently not possible behind proxy servers.

Page 56: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 51

38 Finishing the Configuration

Once you have entered all the details, the last screen displays the successful setup.

Also after successful setup, the file configuration.doneconfiguration.doneconfiguration.doneconfiguration.done is written to the directory C:\Programme\Storeserver

BusinessConnector 2.0.

This dummy file prevents the Setup wizard from restarting automatically after the first installation.

Info: If you selected the network server installation, the Permission wizard now starts. See 40.

Page 57: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 52

39 Manual

The application now starts automatically.

Further information is provided in the manual.

This can be accessed in the program menu under Support > User Manual.

The latest version can always be found on the OMT’s start screen under: FAQ: Online support center FAQ: Online support center FAQ: Online support center FAQ: Online support center

Simply click on the corresponding link.Simply click on the corresponding link.Simply click on the corresponding link.Simply click on the corresponding link.

Page 58: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 53

40 Permission wizard

The Permission wizard is a tool to administrate the desired user in the network scenario.

The wizard starts automatically after theThe wizard starts automatically after theThe wizard starts automatically after theThe wizard starts automatically after the Network Server version has been successfully installed. Network Server version has been successfully installed. Network Server version has been successfully installed. Network Server version has been successfully installed.

If you want to start the wizard manually,

go to

C:\Programme\Storeserver BusinessConnector 2.0

and double-click on the file

to run it.

Using this you will create a standard permission to the corresponding directories:

Once you have selected the Network Server installation, a window appears with the Permission wizard.

Page 59: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 54

Enter the authorized user in the format <domain>\user or user in the following window.

If you have several users to enter, use a semi-colon to separate the individual entries.

Page 60: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 55

After successful administration, the following screen appears.

Page 61: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 56

Page 62: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 57

41 Removing the Application

Close the OMT application.

Go to Add or Remove Programs in the Control Panel.

Click on Remove.

Page 63: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 58

The system searches for all of the components to be removed.

Click on Yes.

The program is removed.

Page 64: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 59

Click on “Finish” to end the removal routine.

The following points only apply to the singleThe following points only apply to the singleThe following points only apply to the singleThe following points only apply to the single----user version and the network server versiouser version and the network server versiouser version and the network server versiouser version and the network server version, where applicable.n, where applicable.n, where applicable.n, where applicable.

Page 65: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 60

42 Installing the OMT Service on your System

Once you have run the wizard completely, clicking “Finish” completes the installation of a Windows system

service.

You will find this under Control Panel > Administrative Tools > Services

To ensure fault-free operation, it is essential that the Order Management Tool File Client ServiceOrder Management Tool File Client ServiceOrder Management Tool File Client ServiceOrder Management Tool File Client Service is startedstartedstartedstarted. The

start type should be “automaticautomaticautomaticautomatic”.

This service sends and receives all documents in conjunction with the OMT.

At 60 min intervals (default setting), a connection is established with DTAG’s routing platform.

Page 66: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 61

43 SendReceiveInterval

Under Programme\Storeserver BusinessConnector 2.0\Addins\FileClient

you will find the file, FileClient.ini

Here the SendReceiveInterval is set by default at 3600 (specified in seconds) i.e. once per hour the web service

request attempts to access DTAG’s routing platform to pick up and send new documents.

Default setting: SendReceiveInterval=3600

You should not change this interval without first discussing it with Support at DTAG.

Page 67: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 62

44 FileClientLog

Under C:\Programme\Storeserver BusinessConnector 2.0\Addins\FileClient

you will find the file, FileClient.log

This file displays whether the FileClient is successfully processing the transport service.

All transactions are provided with a date stamp here and it can thus be a very useful tool when analyzing errors

in transmissions.

If the service is not working, error and warning messages are also displayed here.

Please contact your regular Helpdesk, if required.

Page 68: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 63

Page 69: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 64

45 Error Codes in the FileClientLog

45.1 1008 Incorrect document type

This is an invalid xCBL document.

Please check the FileClient output:

C:\Programme\Storeserver BusinessConnector 2.0\Addins\FileClient\OUT

45.2 1009 The connectivity to our SAP XI system is disrupted

Please report this to the Helpdesk.

45.3 1011 Incorrect parameter

Please check your user name and/or password.

Page 70: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 65

46 Change of the language

1. Click on the Start-Button on the Windows Start bar (blue arrow) 2. Choose “Ausführen” (RUN) (red arrow)

3. Write “regedit” in the field and press the OK-Button

Page 71: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 66

4. Choose the right path

On my PC it is “HKEY_LOCAL_MACHINE” (blue arrow) [screenshot I ] � “SOFTWARE” (red arrow) [screenshot I ] � “Storeserver Systems” (There are two Storeserver entries. SO you have to look after the right one. You have to try it out) [screenshot II ] � “BusinessConnetcor2.0” [screenshot II ] � “appLanguage” (open it with double click) [screenshot III ] I.

II.

III.

5. Change the language setting Put the desired language in the field. You have to put in two letters. The shortnames for the languages are:

Page 72: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 67

„SK“ = Slovak „EN“ = English „DE“ = German With the entry of the screenshot the language will be Slovak. After it press ok. If you open the OMT now it will be in the desired language.

Page 73: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 68

47 Http status codes

47.1 HTTP 1xx

Code Meaning Functional description

100 Continue The Client has sent a request correctly and should continue with it.

101 Switching Protocols

The Client asks for another transmission protocol. The server has understood a request and agrees to the change.

47.2 HTTP 2xx

Code Meaning Functional description

200 Successful The Client’s request was successfully processed and all information was sent by the server.

201 Created The Client requested that the server create a new document. The new source is named in the header.

202 Accepted The Client’s request was understood and accepted by the server, but not processed.

203 Non-Authorative Information

The Client receives information from the server which originates from a source other than the server.

204 No Content The server has understood the request, but only sends the header without a body to the Client.

205 Reset Content The request was successfully executed and the Client should reset the document.

206 Partial Content The Client has only requested a part of a document in its header.

47.3 HTTP 3xx

Code Meaning Functional description

300 Multiple Choices The Client has requested a resource, for which several sources are applicable.

301 Moved Permanently

The requested resource was permanently moved to another location.

302 Moved Temporarily

The requested resource was only temporarily moved.

303 See Other The Client has requested a resource which is in another location however.

Page 74: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 69

304 Not Modified The requested resource has not changed since the last request.

305 Use Proxy The resource requested must not be taken from the server but from a specified proxy server.

307 Moved Temporarily

The Client has requested a resource which is currently in another location.

47.4 HTTP 4xx

Code Meaning Functional description

400 Bad Request The Client’s request was not understood by the server.

401 Unauthorized The request requires authentication of the user and/or Client.

402 Payment Required A resource that is subject to payment was requested. A status code for the future.

403 Forbidden The request was understood, but the execution was forbidden by the server.

404 Not Found The requested resource was not found.

405 Method Not Allowed The method specified for the execution is not allowed for this resource (Get or Post).

406 Not Acceptable The Client requested a resource, the format of which it does not support according to its own information.

407 Proxy Authentication Required

The used proxy demands authentication.

408 Request Timeout The Client has not sent a complete request within

the anticipated or permissible waiting time.

409 Conflict Due to the status of the requested resource, the request could not be executed by the server.

410 Gone The resource is no longer available on the server and its new location is unknown.

411 Length Required The Client’s request did not specify the length details (byte number) of the resource.

412 Precondition Failed The If conditioned request of the Client could not be processed by the server.

413 Request Entity Too Long

The resource requested by the Client is too large for the server and was thus not processed.

414 Request Entity Too Long

The URL transmitted by the Client was so long that the server could no longer process it. E.g. too many Get parameters.

415 Unsupported Media Type

The actual resource type and the type named in the Client’s request do not correspond.

416 Request range not satisfiable

The requested range of a document could not be delivered by the server.

Page 75: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 70

417 Expectation failed The Client has sent an Expect Header, which the server cannot fulfill.

424 Site too ugly The Client has requested a document that the server does not want to deliver.

47.5 HTTP 5xx

Code Meaning Functional description

500 Internal Server

Error

This error is triggered, if an unexpected error occurred

on the server while the request was being answered. A more precise reason for the error is provided in the server log files.

501 Not Implemented

The server could not execute the Client request, as the request is not supported.

502 Bad Gateway The proxy or gateway notifies that the superordinate server has delivered faulty data.

503 Service Unavailable

The server is temporarily overloaded and cannot process any further requests.

504 Gateway Timeout

The proxy or gateway is showing with this that the supordinate server had not delivered any data within the expected timeframe.

505 HTTP Version Not Supported

The requested HTTP protocol version is not supported by the server.

Page 76: Installation Manual Order Management Tool

Installation Manual Order Management Tool V17.doc Version 17, 18.06.2009, final Page 71

48 List of Abbreviations

OMT Order Management Tool

DTAG Deutsche Telekom AG