Logo Tiger Verisine Erişim: SQL, Logo Objects ve REST Servis Karşılaştırması

Logo Tiger'ın Veri Mimarisi: MS SQL ve LG_ Önekli Tablolar

Logo Tiger, Microsoft SQL Server üzerinde çalışır. Tüm tablolar LG_ önekiyle başlar ve tablo adının içine firma numarası (üç hane) ile dönem numarası (iki hane) gömülüdür.

Örnek tablo adı: LG_001_02_STLINE

• LG: Logo prefix
• 001: Firma numarası (001, 002, 003…)
• 02: Dönem numarası (01 = 2025, 02 = 2026, vb.)
• STLINE: Stok hareketi satırları

Bu yapıda iki önemli nokta var:

Dönem Bağımlı ve Dönem Bağımsız Tablolar

Dönem bağımlı tablolar yıllık hareketleri tutar (fatura, sipariş, fiş satırları). Her dönem için ayrı tablo oluşturulur:

• LG_001_01_STLINE → 2025 stok hareketleri
• LG_001_02_STLINE → 2026 stok hareketleri

Dönem bağımsız tablolar ana tanımları (cari kart, stok kart, ambar tanımları) tutar. Tek tablo tüm dönemlerde kullanılır:

• LG_001_CLCARD → Cari kartlar (dönem numarası yok)
• LG_001_ITEMS → Stok kartları

Bu ayrım sorgu tasarımını doğrudan etkiler. Hareket sorgularında dönem numarasını dinamik olarak almanız, tanım sorgularında ise sabit tablo adı kullanmanız gerekir.

Sahada Sık Yapılan Hata: Sabit Dönem Numarası

Şu sorguyu yazıyorsunuz:

SELECT LOGICALREF, AMOUNT, DATE_
FROM LG_001_01_STLINE
WHERE DATE_ >= '2025-01-01'

2025 yılında mükemmel çalışıyor. 2026 geldiğinde ne oluyor? Sorgu hata vermiyor. Sadece 2025 verisini okumaya devam ediyor. Çünkü LG_001_01_STLINE hâlâ var, boş değil — geçen yılın verileriyle dolu.

Bu sessiz hata (silent failure) gürültülü hatadan çok daha tehlikelidir. Kullanıcı raporda "stok neden azalmıyor?" diye sorana kadar kimse fark etmez.

Çözüm: Dönem numarasını parametre veya konfigürasyondan alın, sorguya sabit yazmayın. Logo Objects veya REST kullanıyorsanız dönem bilgisi otomatik yönetilir; doğrudan SQL kullanıyorsanız bu sorumluluğu manuel üstlenirsiniz.

Erişim Yolu 1: Doğrudan SQL Sorgusu

Logo veritabanına doğrudan bağlanıp SELECT sorgusu çalıştırmak en hızlı yoldur. Avantajları:

• Performans: Ara katman yok, doğrudan veri.
• Sorgulama esnekliği: İstediğiniz JOIN, GROUP BY, analitik pencere fonksiyonu.
• Loglama ve izleme: Kendi log mekanizmanızı kurarsınız.

Kısıtlar ve Tehlikeler

1. Sadece okuma (read-only). Logo veritabanına INSERT, UPDATE, DELETE yaparsanız veri bütünlüğü bozulur, Logo'nun iş mantığı atlanır, garanti kaybolur.
2. İş mantığı yok: Stok rezervasyon, maliyet hesaplama, KDV mantığı sizin sorumluluğunuzda.
3. Dönem numarası yönetimi: Yukarıda anlattığımız sessiz hata riski.
4. Tablo yapısı değişikliği: Logo güncelleme sonrası yeni kolon eklenirse sorgunuz kırılabilir.

Ne Zaman Kullanmalı?

• BI raporlama (Power BI, Tableau, custom dashboard)
• Veri ambarı ETL (yalnızca okuma, gece batch)
• Performans kritik sorgular (anlık stok gösterimi)

Önerilen yaklaşım: Canlı Logo veritabanı yerine salt-okunur replikasyon kopyası (read replica) kullanın. Böylece okuma yükü canlı sistemi etkilemez.

Örneğin Mersin'de faaliyet gösteren bir gıda distribütörü, her gece Logo veritabanından salt-okunur kopyaya ETL yapıyor ve tüm raporları oradan besliyor. Canlı sistemde hiç yük yok, analiz ekibi istediği JOIN'i özgürce yazabiliyor.

Erişim Yolu 2: Logo Objects (COM Katmanı)

Logo Objects, Logo'nun kendi COM tabanlı API'sidir. XML mesajları üzerinden veri okuma ve yazma imkânı sunar.

Avantajlar

• İş mantığı doğrulamaları: Fatura keserken KDV, döviz kuru, stok rezervasyon otomatik hesaplanır.
• Yazma işlemleri: Sipariş, fatura, ödeme fişi güvenle yazabilirsiniz.
• Logo sürümüne uyumluluk: Logo güncellendikçe Objects de güncellenir.

Kısıtlar

• COM bağımlılığı: Windows Server, COM threading modeli, register işlemleri.
• XML serialization: JSON'a göre daha hantal, parse maliyeti yüksek.
• Hata mesajları: Bazen kriptik, troubleshoot zor.
• Performans: Toplu okuma (5000 cari kartı) SQL'den yavaş.

Lisans Gerçeği

Logo Objects kullanabilmek için run-time lisansı ve kimlik bilgileri gerekir. Bu bilgiler genellikle Logo çözüm ortağı kanalından sağlanır. Müşteri doğrudan Logo'dan alabilir mi? Evet, ama genelde çözüm ortağı üzerinden gider.

Bu bir kısıt mı? Evet. Gizlenmesi gereken bir şey mi? Hayır. Proje öncesinde lisans konusunu netleştirmek gerekir. D'Cloud Software olarak keşif görüşmesinde "Logo Objects run-time lisansı var mı?" sorusunu mutlaka sorarız. Yoksa proje planına eklenir.

Ne Zaman Kullanmalı?

• Yazma işlemleri: E-ticaret siparişini Logo'ya fatura olarak aktarmak.
• İş mantığı kritik: Otomatik fiyat, iskonto, vade hesaplaması.
• Orta ölçek okuma: Günlük 1000-2000 fatura, kabul edilebilir performans.

Örneğin İstanbul'daki bir medikal ürün firması, B2B portal üzerinden gelen siparişleri Logo Objects ile doğrudan Logo Tiger'a fatura olarak yazıyor. KDV, kur, stok düşümü Logo tarafında otomatik yapılıyor — sıfır manuel müdahale.

Erişim Yolu 3: REST Servis

Logo Tiger REST servis modülü HTTP üzerinden JSON API sunar. OAuth token tabanlı kimlik doğrulama, Swagger dokümantasyonu ve beş seviyeli loglama içerir.

Avantajlar

• Platformdan bağımsız: Linux, Docker, cloud-native entegrasyon.
• JSON: Modern frontend ve mobil uygulamalar için ideal.
• Swagger dokümantasyonu: API keşfi kolay, postman collection hazır.
• Loglama: DEBUG, INFO, WARN, ERROR, FATAL seviyeleriyle detaylı izleme.

Kısıtlar ve Tuzaklar

1. Her Logo ürününde yok

Logo Tiger 5, Tiger 6, GoTiger gibi farklı sürümler var. REST servis bazı sürümlerde standart, bazılarında opsiyonel modül, bazılarında hiç yok. Kurulum öncesi mutlaka teyit edilmeli.

Keşif görüşmesinde soracağınız soru: "Kullandığınız Logo sürümünde REST servis modülü var mı, aktif mi, lisanslı mı?"

Bir imalat firmasıyla görüşmüştük, "REST var" demişlerdi. Proje başladıktan sonra anlaşıldı ki modül lisanslı değil, satın alınması gerekiyor. Proje takvimi 3 hafta ertelendi. Şimdi checklist'imizde ilk maddedir.

2. Varsayılan port ve güvenlik

Logo REST servis varsayılan HTTP portunda çalışır (örn. 5003, sürüme göre değişir). Production ortamında reverse proxy (nginx, IIS ARR) ile HTTPS'e alınmalı, IP whitelist uygulanmalı.

3. Sürüm eşleşmesi zorunluluğu

REST servis versiyonu ile Logo Tiger client versiyonu aynı olmalı. Logo güncellemesi yapıldığında REST servis de güncellenmeli. Versiyonlar uyumsuzsa belirsiz hatalar, eksik field'lar oluşabilir.

Ne Zaman Kullanmalı?

• Mobil uygulama entegrasyonu: Saha satış ekibinin stok/cari sorgulama ihtiyacı.
• Cloud-native mimari: Docker container, Kubernetes, AWS Lambda.
• Çok platformlu ekip: .NET, Node.js, Python geliştiricileri aynı API'yi kullanabilir.

Örneğin Avrupa'daki bir Türk lojistik firması, sürücülerin kullandığı Android uygulamadan Logo REST servis üzerinden irsaliye durumu sorguluyordu. Token refresh mekanizması, retry logic ve offline cache ile sorunsuz çalışıyordu.

Üç Yöntemin Karşılaştırma Tablosu

Özellik	Doğrudan SQL	Logo Objects	REST Servis
Okuma performansı	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐
Yazma desteği	❌ (riskli)	✅ (iş mantığı dahil)	✅ (iş mantığı dahil)
Platform bağımsızlık	⭐⭐⭐ (ODBC her yerde)	⭐ (Windows COM)	⭐⭐⭐⭐⭐ (HTTP/JSON)
Kurulum kolaylığı	⭐⭐⭐⭐⭐	⭐⭐ (COM register)	⭐⭐⭐ (lisans teyit)
Hata yönetimi	Kendi kontrolünüz	Kriptik XML hataları	HTTP status + JSON
Dönem yönetimi	Manuel	Otomatik	Otomatik
Lisans ihtiyacı	Hayır (okuma)	Run-time lisans	Modül lisansı
Loglama	Kendiniz ekleyin	Sınırlı	Beş seviyeli

Hibrit Yaklaşım: Okuma SQL, Yazma Objects/REST

Sahada en stabil çözüm genellikle hibrit yaklaşımdır:

• Okuma (stok raporu, cari bakiye, sipariş listesi): Doğrudan SQL (tercihen read replica)
• Yazma (fatura, sipariş, ödeme): Logo Objects veya REST servis

Böylece okuma performansı maksimum, yazma güvenliği garanti altında.

Örneğin bir e-ticaret entegrasyonu:

• Ürün kataloğu, stok, fiyat → SQL (her 5 dakika senkron)
• Sipariş aktarımı → REST servis (anlık, iş mantığı dahil)

D'Cloud Software olarak bu hibrit modeli Mersin'deki imalat, İstanbul'daki perakende ve Avrupa'daki dağıtım firmalarında uyguladık. Okuma tarafında hiçbir Logo lisansı gerekmedi, yazma tarafı Logo garantisinde kaldı.

Lisans, Sürüm ve Kurulum Öncesi Kontrol Listesi

Proje başlatmadan önce mutlaka teyit edilmesi gerekenler:

Logo Tarafı

1. Logo Tiger versiyonu: 5.x mi, 6.x mi, GoTiger mı?
2. REST servis modülü: Kurulu mu, lisanslı mı?
3. Objects run-time lisansı: Var mı, çözüm ortağı kimlik bilgileri alındı mı?
4. Veritabanı erişimi: SQL Server bağlantı izni var mı, salt-okunur kullanıcı oluşturulabilir mi?
5. Dönem bilgisi: Şu an hangi dönem aktif, geçmiş dönem verileri okunacak mı?

Yazılım Tarafı

1. Sürüm eşleşmesi: REST/Objects client kütüphanesi Logo sürümüyle uyumlu mu?
2. Network erişimi: Logo sunucusuna hangi port üzerinden erişilecek, firewall kuralları ayarlandı mı?
3. Hata yönetimi: Timeout, retry, dead-letter queue stratejisi var mı?
4. Dönem geçişi: Yıl döndüğünde otomatik dönem numarası güncellemesi nasıl yapılacak?

İş Süreci

1. Veri sahibi: Hangi departman entegrasyondan sorumlu (IT, muhasebe, lojistik)?
2. Test ortamı: Canlıya geçmeden test edebilmek için Logo test veritabanı var mı?
3. Destek süreci: Hata durumunda Logo çözüm ortağı mı, yazılım ekibi mi devreye girecek?

Bu kontrol listesini keşif görüşmesinde doldurmazsanız proje ortasında sürprizlerle karşılaşırsınız. D'Cloud Software olarak ilk toplantıda bu soruları sorarız; bazı müşteriler "ayrıntıya boğuyorsunuz" der, ama proje başladığında minnettar olurlar.

Sık Sorulan Sorular

Logo entegrasyonu için mutlaka Logo çözüm ortağı olmak gerekir mi?

Hayır, ama bazı durumlarda kolaylaştırır. Doğrudan SQL ile okuma yapıyorsanız çözüm ortağı olmanıza gerek yok. Ancak Logo Objects run-time lisansı veya REST servis modülü satın alacaksanız Logo çözüm ortağı üzerinden daha hızlı ilerlersiniz. D'Cloud Software çözüm ortağı değil, ama Logo kullanan müşterilerimizle entegrasyonlar geliştiriyoruz — lisans ihtiyaçlarını müşteri kendi ortağı üzerinden hallediyor.

Dönem geçişinde entegrasyonumuz duracak mı?

Eğer dönem numarasını sabit yazmışsanız evet — ama sessiz şekilde, yani hata vermeden yanlış çalışacak. Dinamik dönem yönetimi kurarsanız (SQL'de parametre, Objects/REST'te otomatik) sorun olmaz. Yıl dönümünde sadece yeni dönem tablolarının oluştuğunu teyit edersiniz.

REST servis tüm Logo Tiger sürümlerinde var mı?

Hayır. Logo Tiger 5'in bazı paketlerinde standart, bazılarında opsiyonel, eski sürümlerde hiç yok. Proje öncesi mutlaka Logo'dan veya çözüm ortağından teyit edilmeli. Bazı müşteriler "var" diye düşünüyor, kurulumda ortaya çıkıyor ki modül lisansı alınmamış.

Doğrudan SQL ile yazma yaparsak ne olur?

Veri bütünlüğü bozulur. Logo'nun iş mantığı (stok rezervasyon, maliyet, döviz kuru güncelleme) atlanır. Garanti kapsamı dışına çıkarsınız. Kısa vadede çalışıyor gibi görünse de ilerleyen aylarda tutarsız kayıtlar, hatalı raporlar, muhasebe kapanış sorunları ortaya çıkar. Kesinlikle tavsiye etmiyoruz.

Logo entegrasyonu maliyeti ne kadardır?

Değişkendir ve projenin kapsamına bağlıdır. Sadece stok ve cari okuma yapan basit bir entegrasyon ile çift yönlü sipariş-fatura aktarımı, stok senkronizasyonu, ödeme eşleştirmesi yapan karmaşık bir çözüm aynı fiyatta olmaz. D'Cloud Software olarak keşif görüşmesinde ihtiyacı netleştiriyor, sabit fiyat teklifi veriyoruz — sözleşmede yazılı, ek ücret yok. 15 gün ücretsiz hata düzeltme garantimiz var, bu sürede teknik sorun çıkarsa ek ücret talep etmiyoruz.

Hangi yöntemi seçmeliyim?

İhtiyacınıza göre:

• Sadece raporlama, analiz: Doğrudan SQL (tercihen read replica)
• Fatura, sipariş yazma + okuma: REST servis (varsa) veya Logo Objects
• Hibrit (okuma yoğun + ara sıra yazma): SQL okuma + Objects/REST yazma

Keşif görüşmesinde senaryonuzu anlattığınızda hangisinin uygun olduğu netleşir. D'Cloud Software olarak üç yöntemi de kullanıyoruz, müşteriye en stabil ve maliyet-etkin olanı öneriyoruz.

Sonuç: Sessiz Hataları Önleyen Mimari, Gürültülü Hatadan İyidir

Logo Tiger entegrasyonu, doğru yapıldığında işletmenizin dijital omurgasını güçlendirir. Yanlış yapıldığında — özellikle dönem bağımlı tabloları sabit dönem numarasıyla sorgularsanız — sessiz hatalar üretir. Kullanıcı "stok neden güncel değil?" diye sorana kadar kimse fark etmez.

Üç erişim yolunun (SQL, Objects, REST) her birinin avantajları ve kısıtları var. Doğrudan SQL performanslı ama sadece okuma, Objects iş mantığı sağlam ama COM bağımlı, REST modern ve platformdan bağımsız ama her Logo sürümünde yok.

Sahada en stabil yaklaşım hibrit modeldir: okuma SQL (tercihen salt-okunur kopya), yazma Objects veya REST. Böylece performans maksimum, güvenlik garanti altında.

D'Cloud Software olarak Mersin, İstanbul ve Avrupa'da Logo entegrasyonları geliştiriyoruz. Sessiz hataları sevmiyoruz, o yüzden dönem yönetimini dinamik yapıyoruz. Lisans kısıtlarını gizlemiyoruz, keşif görüşmesinde açıkça konuşuyoruz. Sabit fiyat, sözleşmede yazılı; 15 gün ücretsiz hata düzeltme garantisi.

Logo Tiger verinizi e-ticaret, mobil uygulama, BI dashboard veya B2B portala entegre etmek istiyorsanız ücretsiz online keşif görüşmesi yapabiliriz. İhtiyacınızı dinler, hangi erişim yolunun uygun olduğunu değerlendirir, somut çözüm önerisi sunarız. WhatsApp veya iletişim formu üzerinden ulaşabilirsiniz — gürültülü değil, samimi bir teknik sohbet.

Yazar: Doğuhan Bulut
Kategori: Entegrasyonlar & GİB
Tarih: Temmuz 2025