Installation GuideInstallation GuideInstallation GuideInstallation Guide

Data Transfer Data Transfer Data Transfer Data Transfer WorkbenchWorkbenchWorkbenchWorkbench 6666....5555.1.1.1.1 for for for for SAP Business OneSAP Business OneSAP Business OneSAP Business One 6.6.6.6.5555

Document Version 3.00, February 2004

© Copyright 2004 SAP AG. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. Microsoft®, WINDOWS®, NT®, EXCEL®, Word®, PowerPoint® and SQL Server® are registered trademarks of Microsoft Corporation. IBM®, DB2®, DB2 Universal Database, OS/2®, Parallel Sysplex®, MVS/ESA, AIX®, S/390®, AS/400®, OS/390®, OS/400®, iSeries, pSeries, xSeries, zSeries, z/OS, AFP, Intelligent Miner, WebSphere®, Netfinity®, Tivoli®, Informix and Informix® Dynamic Server

TM are trademarks of

IBM Corp. in USA and/or other countries. ORACLE® is a registered trademark of ORACLE Corporation. UNIX®, X/Open®, OSF/1®, and Motif ® are registered trademarks of the Open Group. LINUX is a registered trademark of Linus Torvalds and others. Citrix®, the Citrix logo, ICA®, Program Neighborhood®, MetaFrame®, WinFrame®, VideoFrame®, MultiWin® and other Citrix product names referenced herein are trademarks of Citrix Systems, Inc. HTML, DHTML, XML, XHTML are trademarks or registered trademarks of W3C®, World Wide Web Consortium, Massachusetts Institute of Technology.

JAVA® is a registered trademark of Sun Microsystems, Inc. J2EE™ is a registered trademark of Sun Microsystems, Inc. JAVASCRIPT® is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape. MarketSet and Enterprise Buyer are jointly owned trademarks of SAP AG and Commerce One. SAP, SAP Logo, R/2, R/3, mySAP, mySAP.com, xApps, mySAP Business Suite, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other product and service names mentioned are the trademarks of their respective companies. Disclaimer Some components of this product are based on Java™. Any code change in these components may cause unpredictable and severe malfunctions and is therefore expressively prohibited, as is any decompilation of these components. Any Java™ Source Code delivered with this product is only to be used by SAP’s Support Services and may not be modified or altered in any way. InstallShield® is a registered trademark of InstallShield Software Corporation. Documentation in the SAP Service Marketplace You can find this documentation at the following Internet address: service.sap.com/instguidesservice.sap.com/instguidesservice.sap.com/instguidesservice.sap.com/instguides

SAP AGSAP AGSAP AGSAP AG Neurottstraße 16

69190 Walldorf

Germany

T +49/18 05/34 34 24

F +49/18 05/34 34 20 www.sap.comwww.sap.comwww.sap.comwww.sap.com

Typographic Conventions

Type Style Represents

Example Text Words or characters that appear on the screen. These include field names, screen titles, pushbuttons as well as menu names, paths and options.

Cross-references to other documentation

Example text Emphasized words or phrases in body text, titles of graphics and tables

EXAMPLE TEXT Names of elements in the system. These include report names, program names, transaction codes, table names, and individual key words of a programming language, when surrounded by body text, for example, SELECT and INCLUDE.

Example text Screen output. This includes file and directory names and their paths, messages, names of variables and parameters, source code as well as names of installation, upgrade and database tools.

Example text Exact user entry. These are words or characters that you enter in the system exactly as they appear in the documentation.

<Example text> Variable user entry. Pointed brackets indicate that you replace these words and characters with appropriate entries.

EXAMPLE TEXT Keys on the keyboard, for example, function keys (such as F2) or the ENTER key.

Icons

Icon Meaning

Caution

Example

Note

Recommendation

Syntax

Installation Guide: Data Transfer Workbench 6.5.1 for SAP Business One 6.5

February 2004 4

Contents

Installation Guide – Data Transfer Workbench.......................................... 5 1 Introduction .......................................................................................................5 2 Installation – Step by Step ...............................................................................5

2.1 Installing the Data Transfer Workbench ............................................................. 5 3 Installation Check .............................................................................................6 4 Uninstalling the Data Transfer Workbench ....................................................6 5 Troubleshooting for Importing and Updating Data .......................................6

Installation Guide: Data Transfer Workbench 6.5.1 for SAP Business One 6.5

January 2004 5

Installation Guide – Data Transfer Workbench

1 Introduction This document describes how to install the SAP Business One Data Transfer Workbench. The Data Transfer Workbench is an application that can be used to easily migrate legacy data into your SAP Business One system. For detailed information, see the user documentation on the Data Transfer Workbench.

2 Installation – Step by Step Purpose The following section will guide you through the installation process for the Data Transfer Workbench.

Prerequisites SAP Business One 6.5 must be installed successfully.

SAP Business One SDK – DI API 6.5 must be installed successfully.

You have a local area network connection from your PC workstation to the SAP Business One server.

2.1 Installing the Data Transfer Workbench 2.1.1 Installation on Windows Use This procedure describes how to install the SAP Business One Data Transfer Workbench on released Windows platforms.

Procedure !!!! Action

1. Uninstall the previously installed version of the Data Transfer Workbench from your PC workstation

2. Download the Data Transfer Workbench application (Setup.exe) from the SAP Service Marketplace

3. Run the Setup.exe file from the place you download.

4. On the InstallShield Wizard information screen, choose Next.

5. On the Choose Destination Location screen, choose Next to confirm the installation path.

6. On the Select Program Folder, choose Next to confirm the program folder.

Installation Guide: Data Transfer Workbench 6.5.1 for SAP Business One 6.5

6 February 2004

7. In the Start Copying Files dialog box, read the setup summary and choose Next to start copying the files.

At this stage, you can also choose Back to return to the previous windows and make any necessary modifications.

The Data Transfer Workbench setup process begins.

8. When the setup process is complete, choose Finish.

3 Installation Check To check the installation, execute the following steps:

!!!! Action

1. Verify whether the path exists: Choose Start → Programs → SAP Business One → Data Migration

The Data Migration folder consists of three items: Data Transfer Workbench, Documentation, and Templates.

2. Start the Data Transfer Workbench application.

4 Uninstalling the Data Transfer Workbench To uninstall the Data Transfer Workbench, choose Start → Settings → Control Panel → Add/Remove Programs from the Microsoft Start menu.

5 Troubleshooting for Importing and Updating Data Data Transfer Workbench, when importing/updating data, reads and writes a complete transaction at a time. If the transaction is successfully imported/updated, the transaction will be committed to SAP Business One database and a log entry will be automatically created and written to a log file. If the transaction fails, an error file will be automatically created and a log entry written to a log file.

If there are some unpredictable situations such as a power shortage and the system crashes while you are importing/updating data, the transactions are read and written individually into the SAP Business One database. This only affects the running transaction and it will not be written into the database. Users can check the log file to see what transactions are successfully loaded and delete those loaded transactions from the source file so that they need not repeat the process of going through the committed and successful transacations again. The users can now go ahead and reload the rest of data from the source file.