ABAP Architect

ABAP Architect

English | Türkçe

Eclipse plug-in that generates ABAP type definitions from JSON/XML data and creates real DDIC objects (structure, table type, transparent table, data element, domain) in a connected SAP system via ADT (ABAP Development Tools).

JSON/XML verisinden ABAP tip tanımları üreten ve bağlı SAP sisteminde ADT üzerinden gerçek DDIC nesneleri (structure, table type, transparent table, data element, domain) oluşturan Eclipse eklentisi.

• GitHub: https://github.com/murattahtaciii
• LinkedIn: https://www.linkedin.com/in/murattahtacii/

English

Features

• ABAP Types: generates TS_* structures and TT_* table types for JSON objects/arrays and XML element/attribute analysis (TYPES: BEGIN OF ... END OF ...).
• Mapping: generates /ui2/cl_json=>name_mappings for JSON/ABAP name differences (SNAKE_CASE conversion, suffix support).
• iXML Code: generates cl_ixml-based parsing code for XML (attributes, arrays, nested nodes).
• Simple Transformation: generates tt:transform source for XML.
• Templates: /ui2/cl_json serialize/deserialize and HTTP client (SM59) code templates.
• Validation: JSON/XML syntax check with error line/column information.
• Create DDIC: creates the planned types as real DDIC objects in the connected SAP system and activates them: Structure (TABL/DS), Table Type (TTYP), Transparent Table (TABL/DT), Data Element (DTEL), Domain (DOMA). Names are suggested and validated according to the Z/Y (or /NAMESPACE/) rule; package/transport is asked on every run.
• List packages / transports: lists packages (RIS search) and the user's modifiable transports from the connected system and fills the fields by selection.
• Insert into Editor: inserts the generated code at the cursor position in the active editor. ADT ABAP editor is supported (via the IAbapSourcePage adapter).
• TR/EN interface, dark/light theme aware coloring, line numbers.

Screenshots

Main view (JSON input -> generated ABAP types):

Create DDIC Objects dialog:

Requirements

• Eclipse IDE 2026-03 (4.39) or similar; Java 21+.
• ADT (ABAP Development Tools) is optional; without it "Insert into Editor" works with editors implementing ITextEditor, but "Create DDIC" is disabled (the plug-in has no compile-time dependency on ADT; reflection is used).
• SAP backend: S/4HANA (on-premise) or NetWeaver 7.50+ (SAP_BASIS 750+) with ADT enabled. DDIC creation is not supported on SAP BTP ABAP Environment (ABAP Cloud) because classic DDIC object creation via REST is not available there.

Installation

1. Help > Install New Software... > Add...
2. Location: https://murattahtaciii.github.io/abap-architect/
3. Install "ABAP Architect" and restart Eclipse.

Local installation from a build:

1. Build (see below) and take releng/io.github.murattahtaciii.abaparchitect.site/target/repository.
2. Help > Install New Software... > Add... > Local... and select that folder.

Build

Maven Wrapper (mvnw) is included; no local Maven installation required.

# Online (target platform: download.eclipse.org/releases/2026-03)
./mvnw clean verify

# Different Eclipse release (example)
./mvnw -Declipse.release=2025-12 clean verify

# Offline: creates a local target platform from the installed Eclipse
releng/sync-local-target.sh
./mvnw -Plocal-target clean verify

Output: releng/io.github.murattahtaciii.abaparchitect.site/target/repository/ (p2 update site).

Publish the update site to GitHub Pages (gh-pages branch):

releng/publish-site.sh

Usage

1. Window > Show View > Other... > ABAP Architect > ABAP Architect
2. Paste JSON or XML into the left pane (format is auto-detected; can be overridden).
3. Inspect the output tabs; use Insert into Editor to add the generated code to the active editor.
4. Settings: Root (root structure name), Str/Tab (structure/table type prefixes), Suffix (ABAP/JSON target), Snake_Case, Attr: Flat for XML.

Creating DDIC objects

1. Paste JSON/XML data (the DDIC tab shows the plan preview).
2. Press Create DDIC on the toolbar.
3. In the dialog:
   • ADT Project: the connected ABAP project (the active editor's project is preselected)
   • Package: e.g. $TMP (local) or ZSD_PKG; a Transport is mandatory for non-$TMP packages. List packages loads packages from the connected system (RIS search, DEVC); List transports loads the user's modifiable transports (official ADT IAdtTransportService.findTransports first, CTS REST as fallback).
   • Naming: <MODULE>_<CODE>_<NAME>: default codes are structure S, table type TT, table T, data element DE, domain DD.
   • Objects table: double-click a cell to edit type (dropdown), name and description; invalid names are shown in red and the Create button is disabled while any name is invalid.
   • Edit...: edits the fields of the selected object (name, ABAP type, length, decimals, description, key for tables; row type for table types; domain for data elements; data type for domains). Length/decimals are enabled per type; preset types fill them automatically.
4. Press Create; matching objects are created in dependency order (domains -> data elements -> structures/table types -> root -> table), saved and activated. The log shows OK / ERROR with SAP's response for each object.

Rules and notes:

• Names must be Z... / Y... or /NAMESPACE/...; max 30 characters (16 for transparent tables). For structures/tables the 2nd or 3rd character must not be an underscore (SAP DT101); suggestions are fixed automatically.
• Arrays (e.g. items) become a separate structure + table type. In structures they are added as a tabular component (items : Z_TT_...;); transparent tables cannot contain deep components, so they are skipped there (the log informs about it).
• Nested objects are referenced as a substructure component in structures (header : ZS_...;); in transparent tables they are flattened with include. Target objects are created first (topological ordering).
• The transparent table key is the first elementary field; if it is a STRING it is automatically converted to CHAR(20) (STRING fields cannot be keys in DDIC).
• The DDIC DDL source contains no comments and uses ASCII only (the backend DDL parser rejects // comments and non-ASCII characters).
• When saving into a transportable package, corrNr is passed. If an object is already recorded in another transport (HTTP 409), the plug-in retries with the existing transport record.
• If there is no SAP session, right-click the ADT project and Log On before creating.

License

Eclipse Public License 2.0 (EPL-2.0). See LICENSE.

Türkçe

Özellikler

• ABAP Types: JSON nesneleri için TS_* structure, diziler için TT_* table type üretir (TYPES: BEGIN OF ... END OF ...). XML için element/attribute analizine göre aynısını yapar.
• Mapping: JSON alan adları ABAP alan adlarından farklıysa /ui2/cl_json=>name_mappings tablosu üretir (SNAKE_CASE dönüşümü, Suffix desteği).
• iXML Kodu: XML için cl_ixml tabanlı ayrıştırma kodu üretir (attributeler, diziler, iç yapılar).
• Basit Dönüşüm: XML için tt:transform (Simple Transformation) kaynağı üretir.
• Şablon: /ui2/cl_json serialize/deserialize + HTTP istemci (SM59) kod şablonları.
• Doğrulama: JSON/XML sözdizimi kontrolü, hata satır/sütun bilgisi.
• DDIC Oluştur: JSON/XML'den planlanan tipleri bağlı SAP sisteminde gerçek DDIC nesnesi olarak oluşturur ve aktive eder: Structure (TABL/DS), Table Type (TTYP), Transparent Table (TABL/DT), Data Element (DTEL), Domain (DOMA). İsimler Z/Y (veya /NAMESPACE/) kuralına göre önerilir ve doğrulanır; paket/transport her seferinde sorulur.
• Paketleri / Transportları listele: bağlı sistemden paketleri (RIS arama) ve kullanıcının değiştirilebilir transportlarını listeler, seçimle alanları doldurur.
• Editöre Ekle: Üretilen kodu aktif editörde imlecin bulunduğu konuma ekler. ABAP Development Tools (ADT) ABAP editörü desteklenir (IAbapSourcePage adaptörü üzerinden).
• TR/EN arayüz, koyu/açık tema uyumlu renklendirme, satır numaraları.

Ekran Görüntüleri

Ana görünüm (JSON girişi -> üretilen ABAP tipleri):

DDIC Nesneleri Oluştur diyaloğu:

Gereksinimler

• Eclipse IDE 2026-03 (4.39) veya benzeri; Java 21+.
• ADT (ABAP Development Tools) isteğe bağlıdır; yoksa "Editöre Ekle" standart ITextEditor uygulayan editörlerle çalışır, ancak "DDIC Oluştur" devre dışı kalır (eklentinin ADT'ye derleme bağımlılığı yoktur, yansıma kullanılır).
• SAP sistemi: S/4HANA (on-premise) veya NetWeaver 7.50+ (SAP_BASIS 750+) ve ADT aktif olmalı. SAP BTP ABAP Environment (ABAP Cloud) üzerinde DDIC oluşturma desteklenmez (klasik DDIC nesnesi oluşturma REST API'si orada kapalıdır).

Kurulum

1. Help > Install New Software... > Add...
2. Konum: https://murattahtaciii.github.io/abap-architect/
3. "ABAP Architect" kurun ve Eclipse'i yeniden başlatın.

Build çıktısından yerel kurulum:

1. Build alın (aşağıya bakın) → releng/io.github.murattahtaciii.abaparchitect.site/target/repository
2. Help > Install New Software... > Add... > Local... ile o klasörü seçin.

Derleme

Maven Wrapper (mvnw) depoda bulunur; Maven kurulu olmasa da olur.

# Çevrimiçi (target platform: download.eclipse.org/releases/2026-03)
./mvnw clean verify

# Eclipse sürümü farklıysa (örnek)
./mvnw -Declipse.release=2025-12 clean verify

# Çevrimdışı: kurulu Eclipse kurulumunuzdan yerel target platform üretir
releng/sync-local-target.sh
./mvnw -Plocal-target clean verify

Çıktı: releng/io.github.murattahtaciii.abaparchitect.site/target/repository/ (p2 update site).

Update site'i GitHub Pages'e (gh-pages dalı) yayınlama:

releng/publish-site.sh

Kullanım

1. Window > Show View > Other... > ABAP Architect > ABAP Architect
2. Sol panele JSON veya XML yapıştırın (biçim otomatik algılanır, üstteki listeden elle de seçilebilir).
3. Sağdaki sekmelerden çıktıyı inceleyin; Editöre Ekle ile aktif editöre ekleyin.
4. Ayarlar: Root (kök yapı adı), Str/Tab (structure/table type ön ekleri), Suffix (+ hedefi ABAP/JSON), Snake_Case, XML için Attr: Düz.

DDIC nesnesi oluşturma

1. JSON/XML verisini yapıştırın (DDIC sekmesinde plan önizlemesi görünür).
2. Araç çubuğundan DDIC Oluştur'a basın.
3. Açılan pencerede:
   • ADT Projesi: bağlı ABAP projesi (aktif editörün projesi otomatik seçilir)
   • Paket: örn. $TMP (lokal) veya ZSD_PKG; $TMP dışındaysa Transport zorunludur. Paketleri listele bağlı sistemden paketleri (RIS arama, DEVC) listeler; Transportları listele kullanıcının değiştirilebilir transportlarını getirir (önce resmi ADT IAdtTransportService.findTransports, yoksa CTS REST).
   • İsimlendirme: <MODÜL>_<KOD>_<AD>; varsayılan kodlar: structure S, table type TT, tablo T, data element DE, domain DD.
   • Nesneler tablosu: satıra çift tıklayarak tip (dropdown), isim ve açıklama düzenlenir; geçersiz isimler kırmızı görünür ve geçersiz isim varken Oluştur pasiftir.
   • Düzenle...: seçili nesnenin alanlarını düzenler (alan adı, ABAP tipi, uzunluk, ondalık, açıklama, tablolarda anahtar; table type için satır tipi; data element için domain; domain için veri tipi). Uzunluk/ondalık alanları tipe göre açılır-kilitlenir; hazır tipler değerleri otomatik doldurur.
4. Oluştur'a basın; nesneler bağımlılık sırasına göre (domain → data element → structure/ table type → kök → tablo) oluşturulur, kaydedilir ve aktive edilir. Günlükte her nesne için OK / HATA ve SAP'nin döndürdüğü mesaj görünür.

Kurallar ve notlar:

• İsimler Z... / Y... veya /NAMESPACE/... olmalıdır; en fazla 30 karakter (transparent tablo 16). Structure/tablolarda 2. veya 3. karakter alt tire olamaz (SAP DT101); öneriler otomatik düzeltilir.
• Diziler (ör. items) ayrı bir structure + table type olarak oluşturulur. Structure'larda tabular bileşen olarak eklenir (items : Z_TT_...;); transparent tablo derin bileşen içeremez, orada atlanır (günlükte bilgi verilir).
• İç içe nesneler structure'da alt yapı bileşeni olarak referanslanır (header : ZS_...;); transparent tabloda include ile düzleştirilir. Hedef nesneler bağımlılık sırasına göre önce oluşturulur (topolojik sıralama).
• Transparent tabloda anahtar, ilk elementary alandır; STRING ise otomatik olarak CHAR(20)'ye çevrilir (DDIC'te STRING alan anahtar olamaz).
• DDIC DDL kaynağı yorum satırı içermez ve yalnızca ASCII karakterler kullanır (backend DDL parser'ı // yorumlarını ve Türkçe karakterleri reddeder).
• Transport'lu pakete kaydederken corrNr gönderilir; nesne başka bir transportta kayıtlıysa (HTTP 409) eklenti mevcut transport kaydıyla yeniden dener.
• SAP oturumu yoksa oluşturma öncesi ADT projesine sağ tıklayıp Log On yapın.

Lisans

Eclipse Public License 2.0 (EPL-2.0). Bkz. LICENSE.