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 öneki
• 001: Firma numarası
• 02: Dönem numarası
• STLINE: Stok fişi 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 hareketleri tutar (fatura, sipariş, fiş satırları). Her dönem için ayrı tablo oluşturulur:

• LG_001_01_STLINE → birinci dönemin stok hareketleri
• LG_001_02_STLINE → ikinci dönemin stok hareketleri

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

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

Bu ayrım sorgu tasarımını doğrudan etkiler. Hareket sorgularında dönem numarasını çalışma zamanında belirlemeniz, tanım sorgularında ise yalnızca firma numarasını kullanmanız gerekir.

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'

İlk yıl kusursuz çalışıyor. Yıl döndüğünde ne oluyor? Sorgu hata vermiyor. Yalnızca eski dönemin verisini okumaya devam ediyor. Çünkü LG_001_01_STLINE hâlâ var ve geçen yılın kayıtlarıyla dolu.

Bu sessiz hata, 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ı yapılandırmadan ya da Logo'nun dönem tanımlarından okuyun, sorguya sabit yazmayın. Logo Objects ve REST servis tarafında da firma ve dönem bilgisi oturum açılırken verilir; orada da sabit yazmayın.

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 birleştirmeyi ve gruplamayı yazabilirsiniz.
• Loglama ve izleme: Kendi log mekanizmanızı kurarsınız.

Kısıtlar ve Tehlikeler

1. Yalnızca okuma. Logo veritabanına INSERT, UPDATE, DELETE yaparsanız Logo'nun kendi kontrolleri atlanır ve veri bütünlüğünün sorumluluğu tamamen size geçer.
2. İş mantığı yok: Ham kolon değerlerini doğru yorumlamak sizin sorumluluğunuzdadır.
3. Dönem numarası yönetimi: Yukarıda anlattığımız sessiz hata riski.
4. Şema genişlemesi: Sürümlerle birlikte tablolara yeni alanlar eklenir; sorgularınızı yükseltme sonrası gözden geçirmeniz gerekir.

Ne Zaman Kullanmalı?

• BI raporlama (Power BI, Tableau, özel panel)
• Veri ambarı aktarımı (yalnızca okuma, gece çalışan toplu iş)
• Hız gerektiren okuma (stok gösterimi gibi)

Önerilen yaklaşım: Canlı Logo veritabanı yerine salt-okunur kopya kullanın. Böylece okuma yükü canlı sistemi etkilemez.

Örnek senaryo: bir gıda distribütörü her gece Logo verisini salt-okunur kopyaya aktarır ve tüm raporlarını oradan besler. Canlı sistemde ek yük oluşmaz, analiz ekibi istediği sorguyu rahatça yazar.

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

Logo Objects, Logo'nun COM tabanlı resmi uyarlama ve entegrasyon aracıdır. Ekleme, değiştirme ve silme işlemlerini yapar; aktarım sırasında XML katmanı üzerinden haberleşir.

Avantajlar

• Logo'nun kendi doğrulamaları çalışır: Kayıt Logo'nun veri modeline uygun oluşur, fiş ile satır ilişkisi kendiliğinden kurulur.
• Yazma işlemleri: Sipariş, fatura ve fiş güvenle oluşturulur.
• İki tür hata yakalanır: İş mantığı hataları ve veritabanı hataları.

Kısıtlar

• COM bağımlılığı: Windows makinesi ve bileşen kaydı gerekir.
• Sürüm eşleşmesi: Logo Objects ile ERP çalıştırılabilir dosyalarının sürümleri birbirini tutmalıdır. Yükseltmeden sonra bileşenlerin yeniden kaydı ve projenin yeniden derlenmesi gerekebilir.
• Toplu okuma: Çok sayıda kaydı okumak için doğrudan SQL daha pratiktir.

Lisans Gerçeği

Logo Objects bir run-time lisansı gerektirir. Lisans yoksa nesnelere giriş yapılamaz. Lisans, Logo Çözüm Ortağı kanalından temin edilir.

Bu bir kısıt mı? Evet. Gizlenmesi gereken bir şey mi? Hayır. Proje öncesinde lisans konusunu netleştirmek gerekir. Keşif görüşmesinde "Logo Objects run-time lisansı var mı?" sorusu ilk sorulardan biridir. Yoksa temin süreci proje planına eklenir.

Ne Zaman Kullanmalı?

• Yazma işlemleri: E-ticaret siparişini Logo'ya sipariş ya da fatura olarak aktarmak.
• Doğrulamanın önemli olduğu kayıtlar: Cari, stok ve zorunlu alan kontrollerinin Logo tarafında yapılması.
• REST servisin bulunmadığı ürünler: GO ailesi gibi.

Örnek senaryo: bir firmanın B2B portalından gelen siparişler Logo Objects ile Logo Tiger'a yazılır. Cari doğrulaması ve stok kontrolü Logo tarafında çalışır; tanımsız cariye sipariş açılmaz.

Erişim Yolu 3: REST Servis

Logo REST Servis, Logo Objects'in yeteneklerini HTTP üzerinden sunan katmandır. Kimlik doğrulama OAuth token ile yapılır; servis Swagger arayüzüyle gelir ve beş seviyeli log altyapısı vardır.

Avantajlar

• Platformdan bağımsız çağrı: İstek atan uygulama herhangi bir platformda çalışabilir.
• JSON: Web ve mobil uygulamalar için uygundur.
• Swagger arayüzü: Hangi uç noktaların açık olduğu kurulumun kendisinden görülür.
• Log: Beş seviyeli log, hata ayıklamayı kolaylaştırır.

Kısıtlar ve Tuzaklar

1. Her Logo ürününde yok

Yetkili çözüm ortağı dokümanlarına göre REST Servis Tiger 3, Tiger 3 Enterprise ve Wings serisinde destekleniyor. Logo Start, Tiger Plus, GO Plus, GO 3 ve Tiger Enterprise desteklenmeyenler arasında sayılıyor. Kurulum öncesi mutlaka teyit edilmeli.

Keşif görüşmesinde sorulacak soru: "Kullandığınız Logo ürününde REST servis var mı, kurulu mu, kimlik bilgileri alındı mı?"

Tipik bir durum: firma "REST var" varsayımıyla projeye başlar, sonradan kimlik bilgilerinin alınmadığı ya da ürünün REST'i desteklemediği anlaşılır. Takvim kayar. Bu yüzden bu soru kontrol listesinin ilk maddesidir.

2. Varsayılan port ve güvenlik

REST servis varsayılan olarak 32001 portundan yayın yapar. Servis doğrudan internete açılmamalı; erişim VPN ya da ters vekil üzerinden, şifreli bağlantı ve IP kısıtıyla verilmelidir.

3. Kimlik bilgileri

REST servisin kullandığı ClientId ve ClientSecret bilgileri Logo Çözüm Ortağı kanalından verilir.

4. Sürüm uyumu

REST servis, ERP dizinindeki kendi kurulum dosyasıyla kurulur. Logo yükseltildiğinde servisin de güncel sürümle kurulu olduğu kontrol edilmelidir.

Ne Zaman Kullanmalı?

• Mobil uygulama: Saha satış ekibinin stok ve cari sorgulaması.
• Ayrı sunucu: Uygulama sunucusu ile Logo sunucusunun ayrıldığı kurulumlar.
• Farklı teknolojiler: .NET dışındaki dillerle geliştirilen uygulamalar.

Örnek senaryo: bir lojistik firmasında sürücülerin kullandığı mobil uygulama, irsaliye durumunu REST servis üzerinden sorgular. Uygulama tarafında token yenileme, yeniden deneme ve çevrimdışı önbellek kurgulanır.

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

Özellik	Doğrudan SQL	Logo Objects	REST Servis
Okuma	En hızlı yol	Mümkün, toplu okumada pratik değil	Mümkün
Yazma	Kullanılmamalı	Evet, Logo'nun kontrolleriyle	Evet, Logo'nun kontrolleriyle
Çalışma ortamı	SQL Server'a erişen her ortam	Windows, COM bileşeni kayıtlı	HTTP isteği atabilen her ortam
Ürün desteği	Tüm ürünler	Tiger ve GO aileleri	Tiger 3, Tiger 3 Enterprise, Wings
Dönem bilgisi	Tablo adında, sorguda siz belirlersiniz	Oturum açarken verilir	Oturum açarken verilir
Gereken	Salt okunur veritabanı kullanıcısı	Run-time lisansı	ClientId ve ClientSecret
Log	Kendiniz eklersiniz	Kendiniz eklersiniz	Beş seviyeli log

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

En dengeli çözüm çoğu zaman hibrit yaklaşımdır:

• Okuma (stok raporu, cari bakiye, sipariş listesi): Doğrudan SQL, tercihen salt-okunur kopyadan
• Yazma (fatura, sipariş, fiş): Logo Objects ya da REST servis

Böylece okuma hızlı olur, yazma Logo'nun kontrollerinden geçer.

Örneğin bir e-ticaret entegrasyonunda:

• Ürün kataloğu, stok, fiyat → SQL ile belirli aralıklarla okunur
• Sipariş aktarımı → REST servis ya da Logo Objects ile yazılır

Yalnızca okuma yapılan işlerde Logo Objects lisansına ihtiyaç duyulmayabilir. Yazma tarafı ise resmi arayüzde kalır.

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

Proje başlamadan önce teyit edilmesi gerekenler:

Logo Tarafı

1. Ürün ve sürüm: Tiger 3, Tiger 3 Enterprise, Wings ya da GO; sürüm numarası
2. REST servis: Ürün destekliyor mu, kurulu mu, kimlik bilgileri alındı mı?
3. Objects run-time lisansı: Var mı?
4. Veritabanı erişimi: Salt-okunur kullanıcı tanımlanabilir mi?
5. Firma ve dönem: Kaç firma var, hangi dönem aktif, geçmiş dönemler okunacak mı?

Yazılım Tarafı

1. Sürüm eşleşmesi: Entegrasyon, kurulu Logo sürümüyle mi derlendi?
2. Ağ erişimi: Logo sunucusuna hangi port üzerinden erişilecek, güvenlik duvarı kuralları tanımlı mı?
3. Hata yönetimi: Zaman aşımı, yeniden deneme ve başarısız kayıt listesi var mı?
4. Dönem geçişi: Yıl döndüğünde dönem numarası nasıl güncellenecek?

İş Süreci

1. Veri sahibi: Entegrasyondan hangi birim sorumlu?
2. Test ortamı: Canlıya geçmeden denemek için test firması var mı?
3. Destek süreci: Sorun çıktığında ilk kim bakacak, yetkili bayi ne zaman devreye girecek?

Bu listeyi keşif görüşmesinde doldurmak, proje ortasında çıkacak sürprizleri önler.

Sık Sorulan Sorular

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

Hayır. Doğrudan SQL ile okuma için çözüm ortağı olmak gerekmez. Logo Objects run-time lisansı ve REST servis kimlik bilgileri ise Logo Çözüm Ortağı kanalından temin edilir. D'Cloud Software çözüm ortağı ya da bayi değildir; bu adımı müşterinin kendi yetkili bayisiyle birlikte yürütürüz.

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

Dönem numarasını sabit yazdıysanız durmaz, ama yanlış çalışır: hata vermeden eski dönemi okumaya devam eder. Dönem bilgisini yapılandırmadan okuyan bir entegrasyonda yıl dönümünde yapılacak iş, yeni dönemin açıldığını teyit edip ayarı güncellemektir.

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

Hayır. Yetkili çözüm ortağı dokümanlarına göre Tiger 3, Tiger 3 Enterprise ve Wings serisi destekleniyor; GO 3 ve GO Plus gibi ürünler desteklenmeyenler arasında sayılıyor. Proje öncesi yetkili bayinizden teyit edilmelidir.

Doğrudan SQL ile yazma yaparsak ne olur?

Logo'nun kendi kontrolleri atlanır. Kayıt veritabanına girer ve ekranda görünür, ama ilişkileri eksik ya da alanları tutarsız olabilir. Sorun çoğu zaman aynı gün değil, ay sonunda mizanda ya da stok sayımında ortaya çıkar. Kesinlikle tavsiye etmiyoruz.

Logo entegrasyonu maliyeti ne kadardır?

Kapsama bağlıdır. Yalnızca stok ve cari okuyan bir entegrasyon ile çift yönlü sipariş ve fatura aktarımı aynı iş değildir. Keşif görüşmesinde ihtiyaç ve lisans durumu netleşir, ardından sabit fiyat teklifi verilir ve sözleşmeye yazılır. Teslim sonrası 15 gün ücretsiz hata düzeltme kapsamdadır.

Hangi yöntemi seçmeliyim?

İhtiyacınıza göre:

• Yalnızca raporlama ve analiz: Doğrudan SQL, tercihen salt-okunur kopyadan
• Fatura ve sipariş yazma: REST servis (ürününüz destekliyorsa) ya da Logo Objects
• Okuma yoğun, ara sıra yazma: SQL ile okuma, Objects ya da REST ile yazma

Hangisinin uygun olduğu ürününüze, lisansınıza ve kurulumunuza göre belirlenir.

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

Logo Tiger entegrasyonu doğru kurulduğunda işletmenin veri akışını güçlendirir. Yanlış kurulduğunda, özellikle dönem bağımlı tablolar sabit dönem numarasıyla sorgulandığında, sessiz hata üretir.

Üç erişim yolunun her birinin güçlü ve zayıf yanı var. Doğrudan SQL hızlıdır ama yalnızca okuma içindir. Logo Objects kaydı Logo'nun kontrollerinden geçirir ama COM'a ve lisansa bağlıdır. REST servis platformdan bağımsızdır ama her Logo ürününde bulunmaz.

En dengeli yaklaşım hibrit modeldir: okuma SQL ile, yazma Logo Objects ya da REST ile.

D'Cloud Software, Mersin merkezli bağımsız bir yazılım firmasıdır. Logo bayisi değiliz; lisans, kurulum ve Logo desteği yetkili bayinizde kalır. Sabit fiyat sözleşmede yazılıdır, teslim sonrası 15 gün hata düzeltme ücretsizdir.

Logo Tiger verinizi e-ticaret sitesine, mobil uygulamaya, rapor paneline ya da B2B portala bağlamak istiyorsanız iletişim formu ya da WhatsApp üzerinden ücretsiz keşif görüşmesi talep edebilirsiniz.