ABAS SQL CONNECTOR 2.1.0 LEGAL DISCLAIMER © 2020 abas Software GmbH. All rights reserved. The names and data used in this manual are entirely fictitious. Please note that the abas ERP version of this manual may differ from your abas ERP version. The content of this document has been compiled with the utmost care. However, should you notice any errors, please do not hesitate to contact us. Please note that abas Software GmbH cannot be held liable for the accuracy of the content of this manual. This manual is protected by copyright. Any reproduction and distribution, in whatever form or by whatever media, is prohibited without the prior written consent of abas Software GmbH. Revision 2 TABLE OF CONTENTS 1 Introduction....................................................................................................................... 9 2 Licensing of abas SQL Connector....................................................................................... 11 3 Setting up the abas ERP clients ......................................................................................... 12 3.1 Requirements ........................................................................................................................... 12 3.2 Installing the SQLConnectorExtensionPack abas ESDK package .................................................... 12 3.3 Communication of abas SQL Connector via abas REST API........................................................... 13 4 Installing and registering abas SQL Connector on the Microsoft Windows server................... 14 4.1 Microsoft Windows server system requirements........................................................................... 14 4.2 Microsoft SQL server requirements ............................................................................................. 15 4.3 Installing abas SQL Connector.................................................................................................... 16 4.4 Registering abas SQL Connector at an MS SQL database.............................................................. 17 4.5 Starting the user interface ......................................................................................................... 18 4.6 Subsequently changing the connection to the configuration database ........................................... 19 5 Working with abas SQL Connector..................................................................................... 21 5.1 Connecting abas ERP clients ...................................................................................................... 21 5.2 Windows service administration.................................................................................................. 27 5.3 Logging in abas SQL Connector.................................................................................................. 30 5.4 Applications .............................................................................................................................. 32 5.5 Database synchronization .......................................................................................................... 35 5.6 Infosystem synchronization........................................................................................................ 46 5.7 Down Times ............................................................................................................................. 51 6 Upgrading abas SQL Connector version 1........................................................................... 53 6.1 Requirements ........................................................................................................................... 53 6.2 Transferring the field list from version 1 to version 2.................................................................... 54 6.3 Follow-up work ......................................................................................................................... 54 7 Appendix ......................................................................................................................... 55 7.1 Related links ............................................................................................................................. 55 7.2 Index ....................................................................................................................................... 57 HOW TO USE THIS MANUAL The most important information for using this manual effectively can be found below. STRUCTURE At the start of each chapter, there is an introduction to the topic which is covered in the respective chapter Most of the chapters contain guidelines in addition to useful information Exercises and solutions for the training are provided in the corresponding workbooks and solution books An index can be found at the end of the manual SYMBOLS TYPOGRAPHY ABAS SQL CONNECTOR 1 INTRODUCTION This manual will show you how to prepare abas ERP clients for the connection to abas SQL Connector how to install and configure abas SQL Connector on a Windows server how to use and administrate abas SQL Connector abas SQL Connector is a Microsoft Windows Server application ™ which consists of a user interface and two Windows services. abas SQL Connector provides the following options: Export data from tables from databases of different abas ERP clients to a Microsoft SQL Server™ database Incrementally synchronize the exported data with the data set of the connected abas ERP clients Export execution results of infosystems in multiple clients to Microsoft SQL Server™ database tables in a configurable mode If abas ERP clients are to be connected to one or multiple MS SQL databases through abas SQL Connector, it must be possible to access them via abas REST API. Furthermore, the supplied SQLConnectorExtensionPack must be installed in the appropriate version in these clients. Further information can be found under Setting up the abas ERP clients (see page 12). abas SQL Connector consists of the following components: User interface to configure the interface abas SQL Connector Windows service to synchronize abas ERP databases abas SQL Connector – Infosystem Windows service to synchronize the execution results of infosystems SQLConnectorExtensionPack abas ESDK package for installation in the connected abas ERP clients abas SQL Connector is available as an openly configurable or closed interface. 9 of 58 This document is protected by copyright. Reproduction and distribution prohibited. ABAS SQL CONNECTOR OPEN INTERFACE The open version of abas SQL Connector is subject to a fee and is activated through the licensing of at least one connected abas ERP client. You have the following options: Configure database synchronization: configuring new databases for synchronization or expanding existing ones Synchronize execution results of infosystems from multiple abas ERP clients with tables in MS SQL Server CLOSED INTERFACE In this version, you can only synchronize databases of abas ERP clients with an MS SQL Server database. It is not possible to export execution results of infosystems. You can export data from abas ERP clients only with defined, not changeable formats. These formats are represented by encrypted XML files, which you can only obtain together with products using abas SQL Connector. EXAMPLE The encrypted XML file abasBI.exml is supplied with abas BI Essentials, using which you can create the basis for abas BI through abas SQL Connector. 10 of 58 This document is protected by copyright. Reproduction and distribution prohibited. ABAS SQL CONNECTOR 2 LICENSING OF ABAS SQL CONNECTOR This chapter will show you how to license abas SQL Connector which license types are available abas SQL Connector communicates with the connected abas ERP clients via abas REST API. For this, you must license at least one of the connected clients for abas SQL Connector. To ensure stable operation of abas SQL Connector, it should be possible to access this client via abas REST API at all times. To determine the license type, run the View configuration command > Expansions page tab MS SQL section in the Master files > Systems admin. files > Configuration > Application folder in abas ERP. A license is required for abas SQL Connector (MS SQL Connector checkbox) in order to use it for the configurable synchronization of database tables from abas ERP clients and the synchronization of infosystems. If you select the abas BI Professional license type in addition, Primary- and Foreignkey- fields are generated for all applications in abas SQL Connector for database synchronization as well as for infosystem synchronization. Further information on the effects of the different license types can be found under Windows service administration (see page 27). Further information can be found under the key word License type in the daily updated Online Help (see page 55). 11 of 58 This document is protected by copyright. Reproduction and distribution prohibited. ABAS SQL CONNECTOR 3 SETTING UP THE ABAS ERP CLIENTS This chapter will show you which requirements must be met in abas ERP clients to use them with abas SQL Connector how to prepare abas ERP clients for the use with abas SQL Connector 3.1 REQUIREMENTS abas ERP clients from Version 2016r4n13 can be used together with abas SQL Connector. For abas ERP clients to be connected with abas SQL Connector, it must be possible to access them via abas REST. Another requirement is the installation of the supplied SQLConnectorExtensionPack abas ESDK package matching the main version