SAP Commerce Backoffice, SAP Commerce Cloud (eski adıyla SAP Hybris Commerce) platformunun operasyonel yönetim katmanıdır. Sadece bir “admin paneli” değildir; ürün, kategori, sipariş, müşteri, kampanya ve içerik gibi tüm ticari verilerin yönetildiği, kurumsal e-ticaret operasyonlarının merkezinde yer alan güçlü bir UI framework’tür.

Bu makalede SAP Commerce Backoffice yalnızca yüzeysel olarak tanımlanmayacak; mimari içindeki yeri, özelleştirme yetenekleri, performans davranışları ve gerçek proje senaryoları ile birlikte ele alınacaktır.

1. SAP Commerce Backoffice Nedir?

SAP Commerce Backoffice, SAP Commerce platformunda veri yönetimini sağlayan web tabanlı yönetim konsoludur. ZK Framework üzerine inşa edilmiş, metadata-driven çalışan ve Type System ile doğrudan entegre bir UI katmanıdır.

Backoffice’in amacı

Backoffice’in temel amacı şudur:

Teknik olmayan kullanıcıların (business user) platformu yönetebilmesini sağlamak
Developer bağımlılığını azaltmak
Ürün ve içerik operasyonlarını hızlandırmak
Workflow ve approval süreçlerini yönetmek

Hangi kullanıcılar kullanır?

E-ticaret operasyon ekipleri
Product Owner’lar
Merchandiser ekipleri
Customer support ekipleri
SAP Commerce consultant’lar

Neden HAC yerine Backoffice tercih edilir?

HAC (Hybris Administration Console) teknik bir araçtır:

Sadece query execution
CronJob debug
System monitoring

Backoffice ise operasyonel UI’dır:

Özellik	HAC	Backoffice
Kullanıcı tipi	Developer	Business + Admin
UI	Minimal	Zengin UI
Ürün yönetimi	Yok	Var
Sipariş yönetimi	Yok	Var
Extensibility	Düşük	Yüksek

2. SAP Commerce Architecture İçindeki Yeri

Backoffice, SAP Commerce mimarisinde frontend administration layer olarak konumlanır.

Platform içindeki konumu

Backoffice şu katmanlarla birlikte çalışır:

Web Layer (Backoffice UI)
Service Layer
Persistence Layer (Jalo + Model)
Type System
Spring Context

Service Layer ile ilişkisi

Backoffice doğrudan DB’ye gitmez.

Tüm işlemler:

Backoffice UI → Facade → Service Layer → DAO → DB

Bu yapı:

Transaction yönetimi sağlar
Security context’i korur
Interceptor’ları çalıştırır

Type System ile ilişkisi

Backoffice tamamen Type System metadata üzerinden çalışır.

Örneğin:

<itemtype code="Product" autocreate="true" generate="true">
    <attributes>
        <attribute qualifier="name" type="localized:java.lang.String"/>
    </attributes>
</itemtype>

Bu tanım Backoffice’te otomatik UI alanına dönüşür.

Cockpit Framework yapısı

Backoffice, eski CockpitNG framework’ün evrimleşmiş halidir.

3. Backoffice ile Neler Yapılabilir?

Ürün yönetimi

Ürün oluşturma
Variant yönetimi
Attribute güncelleme
Classification assignment

Örnek kullanım:
Merchandising ekipleri kampanya döneminde ürün fiyatlarını bulk günceller.

Kategori yönetimi

Category tree yönetimi
Category relation mapping
Navigation structure

Stok yönetimi

Stock levels görüntüleme
Warehouse bazlı stok yönetimi

Sipariş yönetimi

Order search
Order status update
Refund / cancellation trigger

Müşteri yönetimi

Customer data view
Address management
Consent tracking

Kampanya yönetimi

Promotion engine integration
Coupon yönetimi
Rule-based discount editing

CMS yönetimi

Page yönetimi
Component binding
Content slot management

Workflow

Approval süreçleri
Product approval workflow
Content approval flow

Kullanıcı ve yetki yönetimi

Role-based access control
Permission management

CronJob yönetimi

Job trigger
Job monitoring
Fail analysis

Raporlama

Backoffice native reporting sınırlıdır ancak:

FlexibleSearch reports
Custom widget reporting

4. Backoffice Mimarisi

Backoffice’in gücü modüler widget yapısından gelir.

Widget yapısı

Her UI parçası bir widget’tır:

ListViewWidget
EditorAreaWidget
ExplorerTreeWidget

Perspective

Kullanıcının gördüğü ekran layout’u:

Product Perspective
Order Perspective

Explorer Tree

Sol menü yapısı:

Category tree
Product hierarchy

Editor Area

Seçilen entity detay ekranı.

List View

Grid tabanlı veri listeleme.

CockpitNG Framework

Backoffice altyapısı CockpitNG üzerine kuruludur.

ZK Framework

UI rendering ZK Framework ile yapılır:

Server-side UI rendering
Component-based structure

Spring entegrasyonu

Her widget bir Spring bean’dir:

<bean id="productListWidget"
      class="de.hybris.platform.backoffice.widgets.product.ProductListWidget"/>

5. Backoffice Özelleştirme (Customization)

SAP Commerce Backoffice’in en güçlü yönü customization capability’dir.

Yeni tip ekleme

Type System’e yeni itemtype eklenir ve Backoffice otomatik tanır.

Editor Area özelleştirme

<context component="editor-area">
    <editorArea:editorArea xmlns:editorArea="http://www.hybris.com/cockpitng/component/editorArea">
        <editorArea:tab name="Custom Tab">
            <editorArea:section name="Custom Section"/>
        </editorArea:tab>
    </editorArea:editorArea>
</context>

Explorer Tree düzenleme

Category yerine custom tree eklenebilir.

Yeni widget geliştirme

Java ile widget:

public class CustomWidgetController extends DefaultWidgetController {

    @ViewEvent(componentID = "refreshBtn", eventName = "onClick")
    public void refresh() {
        // custom logic
    }
}

Action ekleme

<context component="listview">
    <y:list-view>
        <y:actions>
            <y:action id="customAction" label="Custom Action"/>
        </y:actions>
    </y:list-view>
</context>

Permission yönetimi

Type-based permission
Attribute-level restriction

backoffice-config.xml

Widget wiring yapılır:

<context type="Product" component="editor-area">
</context>

widgets.xml

Widget lifecycle yönetimi.

6. Gerçek Proje Senaryoları

Ürün operasyon ekipleri

Kampanya döneminde 10.000 ürün fiyat güncelleme
Bulk attribute update

İçerik ekipleri

CMS sayfa düzenleme
Banner yönetimi

Müşteri hizmetleri

Order refund işlemleri
Customer complaint tracking

Kategori ekipleri

Navigation tree optimizasyonu

Merchandising ekipleri

Boosting / pinning ürünler

7. Performans Konuları

Backoffice neden yavaşlar?

Büyük product catalog
Yetersiz indexing
Karmaşık widgets
Permission overhead

En yaygın problemler

Lazy loading yapılmayan listeler
Too many attributes in editor
Heavy explorer tree

Arama optimizasyonu

Solr index tuning
Facet limitleri

Type cache

TypeSystem cache doğru yapılandırılmalıdır.

Permission cache

Her request’te permission check maliyetlidir.

Widget performansı

Too many nested components = slowdown

8. Best Practices

Gereksiz widget yüklemeyin
Faceted search kullanın
Editor area sade olmalı
Role-based perspective tasarlayın
Custom widget sayısını minimum tutun
Backoffice extension’larını modüler yapın
Heavy logic UI layer’a koymayın
Service layer’a business logic taşıyın
Cache mekanizmalarını aktif kullanın
Explorer tree’yi shallow tutun
Attribute sayısını minimize edin
Lazy loading kullanın
Gereksiz interceptor kullanmayın
FlexibleSearch optimize edin
Index rebuild’i schedule edin
Permission tree’yi sade tutun
UI event sayısını azaltın
Batch işlemler kullanın
Logging seviyesini production’da düşürün

9. Sık Yapılan Hatalar

Herkesi admin yapmak
Tek perspective içinde her şeyi toplamak
100+ attribute’lü editor area
UI içinde business logic yazmak
Gereksiz custom widget geliştirmek
Lazy loading kullanmamak
Solr olmadan büyük catalog yönetmek

10. Sık Sorulan Sorular (FAQ)

1. SAP Commerce Backoffice nedir?
Operasyonel UI yönetim katmanıdır.

2. HAC ile farkı nedir?
HAC teknik, Backoffice operasyoneldir.

3. Customization mümkün mü?
Evet, widget ve XML bazlıdır.

4. Hangi teknolojileri kullanır?
ZK Framework + Spring + Java.

5. Widget nasıl geliştirilir?
Spring bean + controller ile.

6. Backoffice performansı neden düşer?
Widget ve query yoğunluğu nedeniyle.

7. Role-based yapı var mı?
Evet.

8. Product management nasıl yapılır?
List + Editor Area üzerinden.

9. CMS yönetimi yapılabilir mi?
Evet.

10. CronJob yönetimi var mı?
Evet.

11. Backoffice extend edilebilir mi?
Evet, tamamen extend edilebilir.

12. UI reactive mi?
Kısmen server-side reactive.

13. Solr ile ilişkisi nedir?
Search işlemleri Solr üzerinden yapılır.

14. Workflow destekliyor mu?
Evet.

15. Multi-site destekliyor mu?
Evet.

11. Sonuç

SAP Commerce Backoffice, yalnızca bir yönetim paneli değil; SAP Commerce mimarisinin operasyonel beynidir. Doğru tasarlandığında iş süreçlerini hızlandırır, yanlış tasarlandığında ise performans ve bakım maliyetlerini ciddi şekilde artırır.

Backoffice’i anlamak, SAP Commerce’i anlamanın en kritik adımlarından biridir.

Reopiya’dan Teknik Not

Büyük ölçekli SAP Commerce projelerinde Backoffice genellikle “sorunsuz çalışan bir admin paneli” olarak görülse de gerçek hayatta en kritik mimari yük noktalarından biridir.

Özellikle:

Çok büyük product catalog yapıları
Karmaşık editor area tasarımları
Gereksiz custom widget geliştirmeleri
Permission zincirlerinin aşırı detaylandırılması

zamanla Backoffice’i yavaşlatan ve operasyon ekiplerinin verimliliğini düşüren temel problemler haline gelir.

Deneyimle görülen en önemli konu şudur:
Backoffice optimizasyonu yapılmayan her SAP Commerce projesi, ölçek büyüdükçe UI tarafında “gizli performans borcu” biriktirir.

Reopiya yaklaşımında:

UI katmanı minimal tutulur
Business logic tamamen service layer’a taşınır
Widget sayısı kontrollü artırılır
Perspective’ler rol bazlı sade tasarlanır
Search ve index stratejisi Backoffice’e göre optimize edilir

Bu yaklaşım uzun vadede sadece performansı değil, bakım maliyetini de ciddi şekilde düşürür ve sistemin sürdürülebilirliğini artırır.