DL-Application Manual Book 2024-10-07
DL-Application Manual Book 2024-10-07
DL-Application
USER MANUAL
1. Introduction 4
2. DL-SAP Connector 6
2.1 Overview ......................................................................................................................... 7
2.2 Installation ...................................................................................................................... 9
2.2.1 Windows Installation ............................................................................................... 9
2.2.2 RFC Setup ............................................................................................................... 14
2.3 Configuration ............................................................................................................... 18
2.4 Tips and Trick ............................................................................................................... 22
3. DL-Sync 24
3.1 Overview ....................................................................................................................... 25
3.2 Installation .................................................................................................................... 26
3.3 Configuration ............................................................................................................... 27
3.3.1 SAP Connection ...................................................................................................... 27
3.3.2 ODBC Connection ................................................................................................... 29
3.4 Features ........................................................................................................................ 32
3.4.1 SQL Editor ............................................................................................................... 32
3.4.1.1 Create New Manual ................................................................................................................................ 32
3.4.1.2 Create New Automatic ........................................................................................................................... 37
3.4.1.3 Modify SQL ............................................................................................................................................... 38
3.4.1.4 Copy SQL ................................................................................................................................................... 41
3.4.2 Clone Database Table ............................................................................................ 43
3.4.3 ETL DB to DB .......................................................................................................... 45
3.4.3.1 Single DB .................................................................................................................................................. 46
3.4.3.2 Multi DB ................................................................................................................................................... 55
3.4.4 ABAP Editor ............................................................................................................ 58
3.4.4.1 Create New Manual ................................................................................................................................ 59
3.4.4.2 Create New Automatic ........................................................................................................................... 62
3.4.4.3 Create Custom Search Help .................................................................................................................. 66
3.4.4.4 Create Extract Data Program ................................................................................................................ 69
3.4.4.5 Create Upload Data Program ............................................................................................................... 73
3.4.5 Clone SAP Table ..................................................................................................... 75
3.4.6 ETL SAP to DB ......................................................................................................... 78
3.4.6.1 Single DB .................................................................................................................................................. 79
3.4.6.2 Multi DB ................................................................................................................................................... 87
3.4.7 ETL DB to SAP ......................................................................................................... 91
3.4.7.1 Single DB .................................................................................................................................................. 92
3.4.8 ETL Service ............................................................................................................. 95
3.4.8.1 Database .................................................................................................................................................. 95
3.4.8.2 SAP System ............................................................................................................................................... 99
3.4.9 Custom TCode ...................................................................................................... 102
3.4.10 SAP Directory ........................................................................................................ 105
3.5 Practice ....................................................................................................................... 106
4. DL-Remote 121
4.1 Installation .................................................................................................................. 122
6. Troubleshooting 148
6.1 E_FAIL Status .............................................................................................................. 149
6.2 Localhost refused to connect ................................................................................... 149
6.3 ABAP Selection Screen Blank .................................................................................... 151
6.4 Can't Run DL-Apps ..................................................................................................... 152
6.5 Error Database "Can't connect to" ........................................................................... 153
6.6 DL-Sync Logon Failed ................................................................................................. 154
Index 0
1 Introduction
DL = DIFO LESTARI
Website : www.difolestari.com
E-mail : [email protected] and [email protected]
2 DL-SAP Connector
DL-SAP Connector (DL-SAPCon) adalah aplikasi yang digunakan untuk
menghubungkan aplikasi non-SAP dengan SAP System. SAP yang didukung
mulai dari versi 4.6 sampai SAP HANA. Dengan menggunakan teknologi RFC,
DL-SAPCon dapat berkomunikasi dengan sangat cepat. Selain RFC, DL-
SAPCon menggunakan juga teknologi HTTP untuk berinteraksi dengan
aplikasi non-SAP.
2.1 Overview
2. Profesional
Max thread :4
Max Instance in 1 Server : Many
2.2 Installation
System Requirement
Mimial
§ Procecor : 2 core 4 Thread
§ Memory : 2 GB
§ Storage : 128 GB SSD
§ OS : Windows 10 Home 64bit
*minimal requirement cannot execute and process large data
Recommended
§ Procecor : 8 core 16 Thread
§ Memory : 16 GB
§ Storage : 1 TB SSD
§ OS : Windows 10 Pro 64bit
Software Requirement
§ XAMPP (Aphace-PHP)
§ SAP GUI 770 (RFC 64bit)
10.Done
5. Done
2.3 Configuration
4. Done
3 DL-Sync
DL-Sync is a middleware developed by Difotech, a part of CV. Difo Lestari, an
Indonesian IT consulting company. It is designed to facilitate communication
between SAP systems and other external systems. Initially launched in 2016,
DL-Sync has evolved significantly, now offering features such as ETL (Extract,
Transform, Load) processes for SAP data, multi-thread processing, and
integration with various databases like MySQL, Oracle, and SQL Server. It is
widely used to streamline data synchronization and integration, particularly
in environments where businesses use SAP ERP systems.
DL-Sync supports various versions of SAP, from older systems like SAP 4.6
and ECC6 to newer versions such as SAP HANA. Additionally, the software
comes with tools for creating and managing SAP reports, field mapping, and
even multi-upload table features for licensed users.
Once you run DL-Sync, configure it to connect to your SAP system. You'll
need to enter details like your SAP client, username, password, and server
information. DL-Sync facilitates synchronization between SAP and external
systems, making this connection critical.
3.1 Overview
DL-Sync have 2 type version, witch is "Free" and "Pro" version. Free version
have fully functional feature and no need License.
Others
Commercial Ads
Max Field Mapping 30 Many
ABAP generator for SAPD05
Report Mode for User/Staff
Download Link
§ DL-Sync (middleware apps)
3.2 Installation
System Requirement
Mimial
§ Procecor : 2 core 2 Thread
§ Memory : 2 GB
§ Storage : 128 GB HDD
§ OS for DL-Sync v4 above : Windows 10 Home 64bit
§ OS for DL-Sync v3 : Windows XP 64bit
*minimal requirement cannot execute and process large data
Recommended
§ Procecor : 4 core 4 Thread
§ Memory : 8 GB
§ Storage : 128 GB SSD
§ OS : Windows 10 Pro 64bit
Database Connector
§ ODBC Driver for Specific Database 29
SAP Connector
§ DL-SAPCon 7
3.3 Configuration
1. SAP Connection 27
2. ODBC Connection 29
*Make sure your SAP User have an RFC Authorization, such as "S_RFC"
*Make sure your already create those function module in your SAP Server (see
here 14 )
7. Done
3.3.2 ODBC Connection
Example : Setup MySQL or MariaDB ODBC Connection
1. Download "ODBC driver for MySQL" (here)
2. Run and install "ODBC driver for MySQL"
3. Click "Windows Search" and type "ODBC"
4. Select "ODBC Data Source (64 bit)"
8. Click "Ok"
9. Done
3.4 Features
1. SQL Statement 32
2. Clone Database Table 43
3. ETL DB to DB 45
4. ABAP Program 58
5. Clone SAP Table 75
6. ETL SAP to DB 78
7. ETL DB to SAP 111
8. ETL Service 95
9. Custom TCode 102
10.SAP Directory 105
*ex : local
6. Enter/select "zmara_source"
7. click "Execute" or press "Enter"
7. Do it again for other field and don't forget write "," between field
*Before
*After
9. Done
3.4.3 ETL DB to DB
DL-Sync supports ETL processes to extract data from SAP, transform it, and
load it into external databases (e.g., MySQL, Oracle, SQL Server). You can
configure these processes using the built-in GUI.
1. Single DB 46
2. Multi DB 55
3.4.3.1 Single DB
1. Select "SQLD03"
11. Click " " button and select delete SQL "SQL_DELETE_TARGET01"
Create "SQL_DELETE_TARGET01"
1. Open TCode "SQLD01"
2. Click "Cancel" to create New SQL
3. Setup ODBC Connection String
4. Enter SQL Name "SQL_DELETE_TARGET01"
5. Click "INS-Structure"
6. Select "zmara_target01" and click "Execute"
9.
13.Select cell "Pos 5" - "Function" and click "date" from left List
14.Repeat to "Pos 6" and result like this
3.4.3.2 Multi DB
1. Run "SQLD03"
2. Select ETL Name "ETL_DB2DB_TEST01 46 "
14.Done
3.4.4 ABAP Editor
ABAP Editor is a tools to create and edit ABAP Program, and run the result
directly in one screen. Almost 80% abap syntax is supported using this editor.
9. Done
3.4.4.2 Create New Automatic
Create ABAP Program using ABAP Program Generator
1. Select "SAPD01"
2. Click "Run TCode" or Double Click "SAPD01"
3. Click "Cancel" to create new ABAP Program
4. Enter Program name "SAP_SELECT_TEST02"
5. Click "INS-Structure" button
6. Enter sap table name "MARA" and click "Execute" or press "ENTER"
12.Done
3.4.4.3 Create Custom Search Help
Create ABAP Program using ABAP Program Generator
1. Select "SAPD01"
2. Click "Run TCode" or Double Click "SAPD01"
3. Click "Cancel" to create new ABAP Program
4. Enter Program name "SH_MAKT"
5. Click "INS-Structure" button
6. Enter sap table name "MAKT" and click "Execute" or press "ENTER"
12.Done
3.4.4.4 Create Extract Data Program
Create ABAP Program using ABAP Program Generator
1. Select "SAPD01"
2. Click "Run TCode" or Double Click "SAPD01"
3. Click "Cancel" to create new ABAP Program
4. Enter Program name "SAP_SELECT_MARA"
5. Click "INS-Structure" button
6. Enter sap table name "MARA" and click "Execute" or press "ENTER"
12.Done
3.4.4.5 Create Upload Data Program
Create ABAP Program using ABAP Program Generator
1. Select "SAPD01"
2. Click "Run TCode" or Double Click "SAPD01"
3. Click "Cancel" to create new ABAP Program
4. Enter Program name "SAP_UPLOAD_ZMARA"
5. Click "INS-Structure" button
6. Enter sap table name "ZMARA_EXTERNAL 109 " and click "Execute" or press
"ENTER"
8. Done
3.4.6 ETL SAP to DB
The tool allows for syncing data from SAP to external databases or vice
versa. This can be particularly useful for automating reports or data transfer
across systems. You can configure field mapping and data transfer settings
based on your needs.
1. Single DB 79
2. Multi DB 87
3.4.6.1 Single DB
1. Select "SAPD03"
11. Click " " button and select delete SQL "SQL_DELETE_TARGET01"
Create "SQL_DELETE_TARGET01"
1. Open TCode "SQLD01"
2. Click "Cancel" to create New SQL
3. Setup ODBC Connection String
4. Enter SQL Name "SQL_DELETE_TARGET01"
5. Click "INS-Structure"
6. Select "zmara_target01" and click "Execute"
9.
13.Select cell "Pos 5" - "Function" and click "date" from left List
14.Repeat to "Pos 6" and result like this
10.Done
14.Done
3.4.7 ETL DB to SAP
The tool allows for syncing data from external databases to SAP or vice
versa. This can be particularly useful for automating reports or data transfer
across systems. You can configure field mapping and data transfer settings
based on your needs.
3.4.7.1 Single DB
1. Select "SAPD04"
1. Database 95
2. SAP System 99
3.4.8.1 Database
1. Open Windows Explorer
2. Create new Folder "D:\Services\SQL\"
3. Select "ETL01"
10.Done
3.4.8.2 SAP System
1. Open Windows Explorer
2. Create new Folder "D:\Services\SAP\"
3. Select "ETL01"
10.Done
3.4.9 Custom TCode
1. Select "TCode"
6. Press "ENTER"
7. Click "Close"
9. Done
4. Done
3.5 Practice
Preparation
§ Database 107
§ SAP ZTable 109
Create ETL
§ ETL DB to DB
§ ETL SAP to DB
§ ETL DB to SAP
3.5.1 Database Examples
1. Open webbrowser
2. Enter this URL "http://localhost/"
3. Click "phpmyadmin"
8. Done
Common SQL :
Report VARIANT
§ REPORT <free_name> : Output as Text
§ REPORT TEXT_* : Output as Text
4. Click "Regenerate"
7. Done
3.6.4 How to change ABAP Search Help
Make sure the "Search Help" is already generated.
Tutorial : How to set ABAP Selection Screen 115
6. Click "Update"
11.Done
4 DL-Remote
DL-Remote is very small and easy application for remote or display Desktop
from another computer via Webbrowser.
§ No License
§ No Data Limit
§ No Installation
§ No Audit
Download Link
§ DL-Remote
4.1 Installation
3. Right click on "This PC" and select "Properties" to Check your windows
5. Open folder DL_Remote v1.3 (64bit)"" bit then copy all then content to "D:
\DL_Remote v1.3"
6. Select and delete 2 folder above
127.0.0.1 : IP Address
8080 : Port Number
1.5 : Screen scale
70 : Quality ( 1 - 100)
Y : Y = Remote On, N = Remote Off
16.Click "http://<ipaddress>:8080"
5.1 Overview
View
-> berfungsi untuk menampilkan informasi dalam bentuk GUI
Controller
-> berfungsi untuk menghubungankan antara View dan Model menjadi
satu kesatuan
Kelebihan DL-SWF yang tidak dimiliki framework lainnya adalah tidak perlu
menggunakan API standard (REST, OData, RFCWebeservices dst) dalam
melakukan koneksi ke SAP System tetapi langsung menggunakan ABAP
Program yang tersimpan di server DL-SWF. ABAP Program di "Model"
tersebut yang nantinya di kirim oleh "Controller" ke DL-SAPCon untuk di
process dan dikembalikan hasilnya ke server DL-SWF dan ditampilkan oleh
"View".
Selain itu ada kelebihan lainnya adalah Source code ABAP yang disimpan di
folder "Model" dapat diganti langsung tanpa harus melalui transport seperti
didalam SAP System.
Live Demo
§ DL-SWF
Download Link
§ DL-SWF
5.2 Installation
System Requirement
Mimial
§ Procecor : 2 core 4 Thread
§ Memory : 2 GB
§ Storage : 128 GB SSD
§ OS : Any Linux or Windows
*minimal requirement cannot execute and process large data
Recommended
§ Procecor : 4 core 8 Thread
§ Memory : 8 GB
§ Storage : 256 GB SSD
§ OS : Any Linux or Windows
Software Requirement
§ XAMPP (Aphace-PHP)
§ Sublime Text
SAP Connector
§ DL-SAPCon 7
6. Done
4. Click "Execute"
4. Click "Send"
5. Done
5.5 Create Report
Result :
5.5.1 menu
1. Open Sublime and click open folder
2. Select "D:\xampp\htdocs\dl-swf\"
5. Click "Save"
6. Done
5.5.2 view
1. Right Click on "view"
6. Click "Save"
7. Done
5.5.3 controller
1. Right Click on "view"
5. Click "Save"
6. Done
5.5.4 model
1. Right Click on "view"
TABLES : EKKO.
START-OF-SELECTION.
*Additional Code
S_EBELN-SIGN = 'I'.
S_EBELN-OPTION = 'CP'.
S_EBELN-LOW = '[EBELN]'.
WRITE : / S_EBELN-LOW.
IF S_EBELN-LOW IS NOT INITIAL.
APPEND S_EBELN.
ENDIF.
S_AEDAT-SIGN = 'I'.
S_AEDAT-OPTION = 'CP'.
S_AEDAT-LOW = '[AEDAT]'.
WRITE : / S_AEDAT-LOW.
IF S_AEDAT-LOW IS NOT INITIAL.
APPEND S_AEDAT.
ENDIF.
*End of additional code
SELECT
EBELN
BUKRS
BSART
AEDAT
ERNAM
LIFNR
ZTERM
EKORG
EKGRP
INTO TABLE GI_EKKO UP TO P_MAXR ROWS
FROM EKKO
WHERE EBELN IN S_EBELN AND
AEDAT IN S_AEDAT.
END-OF-SELECTION.
"Header
ULINE AT 0(84).
WRITE : / LV_H0, LV_H1,
LV_H2,
LV_H3,
LV_H4,
LV_H5,
LV_H6,
LV_H7,
LV_H8,
LV_H9.
ULINE AT /0(84).
"Content
LOOP AT GI_EKKO.
ADD 1 TO LV_INDEX.
LV_H0 = LV_INDEX.
WRITE GI_EKKO-EBELN TO LV_H1.
WRITE GI_EKKO-BUKRS TO LV_H2.
WRITE GI_EKKO-BSART TO LV_H3.
WRITE GI_EKKO-AEDAT TO LV_H4.
WRITE GI_EKKO-ERNAM TO LV_H5.
WRITE GI_EKKO-LIFNR TO LV_H6.
WRITE GI_EKKO-ZTERM TO LV_H7.
WRITE GI_EKKO-EKORG TO LV_H8.
WRITE GI_EKKO-EKGRP TO LV_H9.
WRITE : / LV_H0,
LV_H1,
LV_H2,
LV_H3,
LV_H4,
LV_H5,
LV_H6,
LV_H7,
LV_H8,
LV_H9.
ENDLOOP.
ULINE AT /0(84).
5. Click "Save"
6. Done
6 Troubleshooting
Error Message
"Data provider or other service returned an E_FAIL Status"
Solution
1. Open table structure
2. Check if any field of "date" and "time" type that have a "Null".
Error Message
Solution
1. Open "XAMPP Control Panel"
2. Click "Start" for "Aphace"
3. Open browser and enter "http://localhost/gateway"
4. Done
Error
Solution
1. Open ABAP Program
2. Check if any code like this below
6. Done
6.4 Can't Run DL-Apps
Error
Solution
1. Click "More Info"
Error
Solution
1. Check your connection to database server
2. Make sure your database server is running
3. Close the DL-Apps
4. Run again
Error
Solution
1. Open "Gateway" tab