İçeriğe geç
Logo Yazılım

Logo Entegrasyonu

Logo’nuz yerinde kalır. Tezgâhı, depoyu, e-ticareti veya bayi portalını Logo’ya bağlayan katmanı, ürünün kendi arayüzleri üzerinden yazarız.

Kısa özet

  • Logo ürünlerinde veri MS SQL Server üzerinde tutulur ve tablolar LG_ önekiyle adlandırılır; firma ve dönem numarası tablo adının içine gömülüdür.
  • İki resmi arayüz vardır: Logo Objects (COM tabanlı, XML katmanı üzerinden çalışır) ve Logo REST Servis. REST desteği tüm ürünlerde yoktur.
  • Logo Objects run-time lisansı ve REST için gereken ClientId/ClientSecret, Logo Çözüm Ortağı kanalından temin edilir.
  • Biz bayi değiliz; bu adımı sizin yetkili bayinizle birlikte yürütüyoruz — lisans teyidi yapılmadan takvim vermiyoruz.
  • Okuma için doğrudan SQL yaygın ve kabul edilebilir; yazma daima Logo Objects veya REST üzerinden yapılmalıdır.
  • Logo sürüm yükseltmeleri entegrasyonu kırabilir. Bu bilinen ve tekrar eden bir durumdur, tek seferlik proje değil bakım gerektirir.

Logo verisi nasıl duruyor?

Logo ürünleri Microsoft SQL Server üzerinde çalışır ve tablo adlandırması Logo’ya özgü bir mantık taşır: tüm tablolar LG_ önekiyle başlar, firma numarası üç hane, dönem numarası iki hanedir ve bu numaralar tablo adının içine gömülüdür.

Bu, entegrasyon tasarımını doğrudan etkileyen bir ayrıntı. Tablolar iki gruba ayrılır ve hangi gruptan veri okuduğunuz, sorgunuzun dönem değiştiğinde hâlâ çalışıp çalışmayacağını belirler.

Logo tablo adlandırma mantığı. Tablo adları örnek niteliğindedir; kullanılacak tam liste her kurulumda doğrulanır.
GrupAdlandırmaTipik tablolar
Dönem bağımlı (hareket / fiş)LG_[firma:3]_[dönem:2]_[tablo]INVOICE (faturalar), STFICHE ve STLINE (stok fişi ve satırları), ORFICHE (siparişler), CLFICHE (cari hareketler), EMFICHE (muhasebe fişleri)
Dönem bağımsız (kart / tanım)LG_[firma:3]_[tablo]CLCARD (cari kartlar), ITEMS (malzeme kartları), EMUHACC (hesap planı), PRCLIST (fiyat listeleri), INVDEF (ambar tanımları), FAREGIST (sabit kıymetler)

Logo’ya bağlanmanın üç yolu

Logo Objects — COM tabanlı resmi katman

Logo’nun uzun süredir kullanılan resmi uyarlama ve entegrasyon aracı. COM teknolojisiyle çalışır, .NET tarafında UnityObjects kütüphanesi COM referansı olarak eklenir. Aktarım sırasında XML katmanı üzerinden haberleşir; ekleme, değiştirme ve silme işlemlerini yapar.

Asıl değeri şurada: kayıt Logo’nun kendi veri modeline uygun şekilde oluşturulur, fiş ile satır arasındaki ilişki otomatik kurulur ve iki tip hata da yakalanır — iş mantığı hataları (stok bakiyesinin eksiye düşmesi gibi) ve veritabanı hataları (tekil alana mükerrer değer gibi). Doğrudan INSERT bunların hiçbirini yapmaz.

Logo REST Servis — modern HTTP arayüzü

Logo Objects yeteneklerini HTTP üzerinden sunan katman. ERP dizini altındaki kendi kurulum dosyasıyla kurulur, yönetim aracı yönetici yetkisiyle çalıştırılır ve varsayılan olarak 32001 portundan yayın yapar. Kimlik doğrulama OAuth token ile yapılır; servis Swagger arayüzüyle gelir ve beş seviyeli log altyapısı vardır.

Önemli kısıt: REST servis her Logo ürününde bulunmaz. Tiger 3, Tiger 3 Enterprise ve Wings serisi desteklenir; Logo Start, Tiger Plus, GO Plus, GO 3 ve Tiger Enterprise desteklenmez (yetkili çözüm ortağı dokümanlarına göre). Yani yetkili çözüm ortağı dokümanları GO 3 ve GO Plus’ı desteklenmeyenler arasında sayıyor; kurulumda teyit edilir — bu yüzden GO kullanan kurulumlarda REST’i varsaymıyor, yetkili bayinizle doğruluyoruz.

  • REST, Logo Objects’in yerine geçen ayrı bir ürün değil — onun üstüne oturan bir arayüz katmanıdır
  • Uygulama sunucusuyla Logo sunucusu ayrıldığında REST, COM’a göre çok daha rahat bir dağıtım sağlar
  • Servis kendi log seviyelerini tuttuğu için hata ayıklama COM tarafına göre belirgin şekilde kolaydır

Doğrudan SQL — yalnızca okuma

Rapor, panel ve analiz için doğrudan SQL okuma yaygın ve pratiktir. Ağır raporlama sorgularını canlı veritabanı yerine salt-okunur bir kopya üzerinde çalıştırmak, Logo kullanıcılarının gün içi performansını korur.

Yazma tarafında ise doğrudan SQL bizim için kapalı bir kapı. Bunun sebebi ideoloji değil, sorumluluk: obje katmanı kullanıldığında veri bütünlüğünün korunması ürünün işi olur; doğrudan tabloya yazıldığında o sorumluluk tamamen entegrasyonu yazanın üstüne kalır.

Lisans gerçeği — burada açık konuşalım

Logo entegrasyonlarında en sık atlanan ve en geç fark edilen konu bu. Logo Objects bir run-time lisansı gerektirir; lisans yoksa nesnelere giriş yapılamaz, yani entegrasyon hiç başlamaz. Aynı şekilde REST servisin kullandığı ClientId ve ClientSecret bilgileri de Logo Çözüm Ortağı kanalından verilir.

Biz Logo bayisi veya çözüm ortağı değiliz. Bunu proje ortasında keşfedilecek bir sürpriz olarak bırakmak yerine baştan söylüyoruz — çünkü bu, işin yapılamayacağı anlamına gelmiyor, sadece bir adımın sizin yetkili bayiniz üzerinden yürüyeceği anlamına geliyor.

Pratikte akış şöyle işliyor: keşif görüşmesinde hangi arayüzü kullanacağımızı belirliyoruz, gereken lisans ve kimlik bilgilerinin kurulumunuzda mevcut olup olmadığını yetkili bayinizle birlikte teyit ediyoruz, eksikse bayiniz üzerinden temin ediliyor. Biz bu süreçte teknik muhatap olarak bayinizle doğrudan konuşabiliriz; çoğu bayi bu iş birliğinden memnun olur, çünkü geliştirme yükü onlardan kalkar.

Okuma ve yazma — neden aynı şey değil

Bir müşteri “doğrudan tabloya yazsan daha hızlı olmaz mı” diye sorduğunda cevabımız hep aynı: olur, ama yapmıyoruz.

Resmi arayüz üzerinden yazıldığında Logo’nun kendi kontrolleri devreye girer. Cari doğrulaması, stok bakiye kontrolü, zorunlu alan kontrolleri çalışır; hata varsa anlamlı bir mesaj döner ve hiçbir şey bozulmaz. Fiş başlığı ile satırları arasındaki ilişki Logo’nun veri modeline uygun kurulur.

Doğrudan INSERT bunların tamamını atlar. Kayıt veritabanına girer, ekranda görünür, ama ilişkileri eksik veya alanları tutarsızdır. Sorun genelde o gün değil, ay sonunda mizanda ya da stok sayımında ortaya çıkar — ve o noktada hangi kaydın bozuk olduğunu bulmak, entegrasyonu baştan yazmaktan pahalıdır.

  • Okuma — doğrudan SQL serbest; tercihen salt-okunur kopya üzerinden
  • Yazma — istisnasız Logo Objects veya REST Servis üzerinden
  • Yoğun akışta kuyruk kullanılır; Logo kapalıyken saha durmaz, bağlantı gelince birikmiş kayıtlar sırayla işlenir
  • Mükerrer kayıt koruması (idempotent yazma) baştan kurgulanır; ağ kesintisi sonrası yeniden deneme iki fiş oluşturmaz

Sürüm yükseltmesi: bilinen ve tekrar eden bir risk

Logo entegrasyonlarında sürüm yükseltmesi rutin bir bakım kalemidir. Bunu bir kusur olarak değil, işin doğası olarak anlatıyoruz — çünkü müşterinin bunu bilerek planlaması, altı ay sonra bir sabah sistemin durmasından iyidir.

Temel kural, üretici destek kaynaklarında belirtildiği üzere: Logo Objects ile ERP çalıştırılabilir dosyalarının sürümleri birbirini tutmalıdır. Sürümler ayrıştığında entegrasyon uygulaması Logo’ya bağlanamaz.

Üreticinin destek kaynaklarında tekrar eden iki tipik durum var. Birincisi, yeni sürüm sonrası COM bileşenlerinin yeniden kaydedilmesi gerekmesi; eskimiş ara dosyalar yüzünden bağlantı açılmıyor ve çözüm, kayıt işleminin yeni sürümle yeniden yapılıp projenin yeniden derlenmesi oluyor. İkincisi, ana makinede sorun yokken terminallerde kütüphane kayıt hatası alınması.

Buna bir de şema genişlemesi ekleniyor: sürümlerle birlikte veritabanına yeni alanlar ekleniyor ve bunların XML karşılıkları ayrıca üretiliyor. Yani entegrasyonun gördüğü alan kümesi sürümle birlikte değişiyor. Sürüm notlarını takip etmeyen bir entegrasyon, yeni alanları hiç görmeden çalışmaya devam eder.

Hangi Logo ürününü kullanıyorsunuz?

Tiger ailesi

Entegrasyon açısından en geniş seçeneğe sahip hat. Logo Objects ve REST Servis birlikte kullanılabilir, dolayısıyla mimariyi ihtiyaca göre seçebiliyoruz. Üretim, depo ve sipariş entegrasyonlarının büyük kısmı bu hat üzerinde kurgulanıyor.

GO ailesi

Veritabanı şeması Tiger ile aynı mantığı taşır, dolayısıyla okuma tarafı benzer şekilde çalışır. Yazma tarafında yetkili çözüm ortağı dokümanları GO 3 ve GO Plus’ı REST Servis desteklenmeyenler arasında sayıyor, yol Logo Objects; kurulumda teyit edilir. Bu yüzden GO kurulumlarında mimariyi varsayımla değil, bayinizle yapılan teyitten sonra belirliyoruz.

j-Platform

Java tabanlı, servis odaklı mimariye sahip ürün. Entegrasyon tarafında SOAP web servisi, REST ve Custom Web Service (controller) sunuyor; Excel ve XML üzerinden kayıt aktarımı ise kurulumda teyit edilir. Bu hat, veritabanı katmanından çok servis katmanı üzerinden çalışmayı gerektiriyor.

Logo İşbaşı (bulut)

Bulut ürün olduğu için doğrudan veritabanı erişimi yok — tek yol üreticinin API’si. Erişim API anahtarıyla sağlanıyor; anahtar üreticiden (destek kanalı ya da geliştirici sayfası üzerinden) talep edilir. Bu aslında daha temiz bir çalışma şekli: şema ve sürüm sorunları büyük ölçüde ortadan kalkıyor. Buna karşılık API’nin kapsamı neye izin veriyorsa onunla sınırlısınız.

Logo bayileri için: geliştirme tarafını biz üstlenelim

Logo bayilerinin sık yaşadığı bir durum var: müşteri standart üründe olmayan bir şey istiyor, iş kaçmasın isteniyor ama bünyede geliştirici yok. Bu noktada devreye giriyoruz.

Ürün, lisans ve müşteri ilişkisi sizde kalır; biz yalnızca yazılım tarafını yaparız. İstenirse beyaz etiketli çalışırız, müşteriye karşı görünen taraf siz olursunuz. Hiçbir ERP üreticisinin bayisi olmadığımız için sizinle rekabet etme ihtimalimiz yok — bu modelde bizim işimiz kod yazmak, sizin işiniz müşteriyi yönetmek.

Sahada nasıl görünüyor?

Üretim kaydı Logo’ya akıyor

Sahadaki iş emri kapandığında mamul girişi ve hammadde sarfı Logo’ya resmi arayüz üzerinden düşüyor. Ustabaşının akşam yaptığı toplu giriş ortadan kalkıyor; dönem tablosu çalışma zamanında çözüldüğü için yıl dönümünde kayıt eski döneme düşmüyor.

El terminali ile depo sayımı

Sayım el terminaliyle yapılıyor, sonuç Logo’daki ambar bakiyesiyle karşılaştırılıyor ve fark listesi sorumluya düşüyor. Ambar tanımları Logo tarafındaki kayıtlarla eşleştirildiği için iki liste arasında elle karşılaştırma yapılmıyor.

E-ticaret ve pazaryeri siparişleri

Gelen siparişler Logo’ya sipariş fişi olarak giriliyor, stok bakiyesi tek noktadan yönetiliyor. Stok kodu eşlemesi yönetilebilir bir tabloda tutulduğu için yeni ürün eklendiğinde geliştirici gerekmiyor.

Bayi sipariş portalı

Bayiler siparişini portalden giriyor, kayıt Logo’ya sipariş fişi olarak resmi arayüzden düşüyor. Cari doğrulaması Logo’nun kendisinde çalıştığı için tanımsız cariye sipariş açılmıyor; yanlış giriş ve ardından gelen karşılıklı suçlama gündemden çıkıyor.

Yönetim paneli — Logo’ya dokunmadan

Ciro, stok, alacak ve sipariş durumu tek panelde toplanıyor. Veri salt-okunur şekilde alındığı ve ağır sorgular canlı veritabanında çalıştırılmadığı için Logo kullanıcılarının performansı etkilenmiyor.

Referans iş birliği

Entegrasyon tarafında yeni bir hat kuruyoruz ve ilk projeleri referans iş birliğiyle yürütüyoruz: projenin sonunda ölçülebilir sonuçları vaka çalışması olarak yayımlamamıza ve sizi referans göstermemize izin veren firmalara özel koşul uyguluyoruz. Karşılığında alacağınız şey standart bir paket değil, süreçlerinize göre yazılmış bir sistem — ve geliştiren ekibe doğrudan erişim.

Sık sorulan sorular

Logo bayisi misiniz?

Hayır. Logo Yazılım’la aramızda bayilik, çözüm ortaklığı ya da iş ortaklığı sözleşmesi yok; bağımsız bir yazılım geliştiricisi olarak çalışıyoruz. Entegrasyonu Logo’nun kendi belgelenmiş arayüzleri üzerinden yapıyoruz. Lisans ve yetkilendirme gerektiren adımlarda sizin yetkili bayinizle birlikte çalışıyoruz — bu bir engel değil, standart bir iş akışı.

Logo Objects lisansımız yok. Entegrasyon yapılamaz mı?

Yapılabilir, ama önce bu konunun netleşmesi gerekiyor. Logo Objects bir run-time lisansı gerektirir ve lisans olmadan nesnelere giriş yapılamaz; REST servisin kullandığı kimlik bilgileri de Logo Çözüm Ortağı kanalından verilir. Keşif aşamasında kurulumunuzda ne olduğunu tespit ediyor, eksik varsa yetkili bayinizle birlikte tamamlıyoruz. Yalnızca okuma gerektiren işlerde (rapor, panel, analiz) bu adıma hiç ihtiyaç duyulmayabilir.

Doğrudan SQL ile yazsanız daha hızlı olmaz mı?

Hızlı olur, doğru olmaz. Resmi arayüz üzerinden yazıldığında Logo’nun kendi doğrulamaları çalışır ve hatalı kayıt en baştan reddedilir; doğrudan INSERT bu kontrollerin tamamını atlar, fiş ile satır arasındaki ilişkiyi elle kurmak zorunda bırakır. Sorun genelde aynı gün değil, ay sonunda mizanda veya stok sayımında ortaya çıkar. O noktada bozuk kaydı bulmak, entegrasyonu baştan yazmaktan pahalıdır. Bu yüzden talep edilse bile doğrudan yazma yapmıyoruz.

Logo’yu güncellediğimizde entegrasyon bozulur mu?

Bozulabilir ve bunu baştan söylüyoruz. Üretici destek kaynaklarında belirtildiği üzere Logo Objects ile ERP çalıştırılabilir dosyalarının sürümleri birbirini tutmalıdır; ayrıştıklarında bağlantı kurulamaz. Ayrıca sürümlerle birlikte veritabanına yeni alanlar ekleniyor ve XML karşılıkları ayrıca üretiliyor, yani entegrasyonun gördüğü alan kümesi değişiyor. Bizim yaptığımız, sürüm bağımlılığını gevşek tutmak ve her yükseltme öncesi kontrol turu yapmak. Bu süreklilik gerektiren bir iş olduğu için bakım anlaşması konusudur.

Çok firmalı ve çok dönemli yapımız var, sorun olur mu?

Olmaz, ama tasarımda dikkat gerektirir. Logo’da firma ve dönem numarası tablo adının içine gömülüdür; bu yüzden sorguları dönem numarası sabit yazılmış şekilde bırakmak tehlikelidir. Yıl döndüğünde eski tablo hâlâ mevcut olduğu için sorgu hata vermez, sadece geçen yılın verisini okumaya devam eder. Biz dönem ve firma çözümlemesini çalışma zamanında yapıyor, yeni dönem açıldığında entegrasyonun kendiliğinden doğru tabloya yönelmesini sağlıyoruz.

Logo İşbaşı kullanıyoruz, bulut sürümde de çalışıyor musunuz?

Evet, ama mimari farklı. Bulut üründe doğrudan veritabanı erişimi yoktur; tek yol üreticinin API’sidir. Erişim API anahtarıyla sağlanır; anahtar üreticiden (destek kanalı ya da geliştirici sayfası üzerinden) talep edilir. Bu bazı açılardan daha rahat bir çalışma şekli — şema ve sürüm sorunları büyük ölçüde ortadan kalkar. Buna karşılık API’nin kapsadığı işlemlerle sınırlı kalırsınız; bu yüzden projeye başlamadan önce istediğiniz akışın API tarafında karşılığı olup olmadığını kontrol ediyoruz.

Logo bayisiyiz, müşterimize özel geliştirme lazım. Birlikte çalışabilir miyiz?

Evet, bu bizim için düzenli bir çalışma modeli. Ürün satışı, lisans ve müşteri ilişkisi sizde kalır; biz yalnızca geliştirme tarafını üstleniriz ve istenirse beyaz etiketli çalışırız. Logo bayisi olmadığımız için sizinle rekabet etme ihtimalimiz yok. Keşif bittiğinde kapsam ve bedel yazılı olarak sabitlenir; siz de müşterinize kesin rakam verebilirsiniz.

Hatay’daki fabrikamıza gelir misiniz?

Geliriz. Hatay ve İskenderun, Mersin’den yerinde keşif yaptığımız Akdeniz hattının içinde; Tarsus, Adana ve Osmaniye de öyle. Logo tarafındaki geliştirme işi büyük ölçüde uzaktan ilerler; ancak sahada terminal, depo ya da tezgâh başı kurulum varsa o günler takvime yerinde ziyaret olarak eklenir. Türkiye’nin diğer illerinde başlangıç online görüşmedir, saha montajı gerekirse seyahat planı baştan yazılır.

Mevcut sisteminizi konuşalım

Hangi programı kullandığınızı, sahada hangi verinin elle girildiğini ve neyi otomatikleştirmek istediğinizi anlatın. İlk görüşmede teknik olarak mümkün olup olmadığını ve hangi yöntemle yapılacağını netleştiriyoruz.

Bu sayfada adı geçen ürün ve markalar ilgili firmaların tescilli ticari markalarıdır. D'Cloud Software bağımsız bir yazılım geliştiricisidir; anılan firmaların yetkili bayisi, çözüm ortağı veya iş ortağı değildir. Entegrasyon hizmeti, ürünlerin kendi belgelenmiş arayüzleri ve veri erişim yöntemleri üzerinden sunulur.