Netsis NetOpenX Nedir? Netsis Entegrasyonuna Teknik Giriş

Netsis'in MS SQL Veri Mimarisi ve Logo Tiger'dan Kritik Farkı

Netsis verisini Microsoft SQL Server üzerinde tutar. Tablo adları TBL önekiyle başlar ve modül bazında gruplanır. Entegrasyon açısından asıl önemli olan adlandırma değil, çok işletmeli ve çok şubeli yapının nasıl temsil edildiğidir.

Logo Tiger tarafında firma numarası ve dönem numarası tablo adının içine yazılır. Yani her firma ve dönem için ayrı bir tablo adıyla karşılaşırsınız:

-- Logo Tiger: firma 001, dönem 01 tablo adının içinde
SELECT LOGICALREF, DATE_, AMOUNT
FROM LG_001_01_STLINE

Netsis'te ise şube ve işletme ayrımı satırın içindeki kolonlarla yapılır: SUBE_KODU ve ISLETME_KODU. Sorguda tablo adını değiştirmezsiniz, filtreyi değiştirirsiniz.

Konu	Logo Tiger	Netsis
Tablo öneki	LG_	TBL
Şube ve işletme ayrımı	Firma ve dönem tablo adında	SUBE_KODU ve ISLETME_KODU kolonlarında
Sorgudaki ilk risk	Yanlış firma ya da dönem tablosuna bağlanmak	Filtreyi unutmak
Resmi arayüz	Logo Objects ve Logo REST Servis	NetOpenX ve NetOpenX Rest

Firma ve dönem: kurulumda teyit edilmesi gereken nokta

Şube ve işletme kolonları belgeli. Firma ve dönemin fiziksel olarak nasıl ayrıldığı ise kurulumdan kuruluma değişebiliyor. Logo'nun Sene Sonu Devir dokümanı, yeni yıl için yeni bir şirket açılmasını ve kopyalamanın yedekleme ile geri yükleme üzerinden yapılmasını anlatıyor. Bu, şirket ve yıl başına ayrı veritabanının yaygın olduğu anlamına geliyor. Aynı şirkette devam etmek de teknik olarak mümkün.

Hangisinin sizde geçerli olduğunu varsaymayın. Kaç şirket, kaç yıl ve kaç veritabanı olduğunu proje başında yazılı hâle getirin.

Tablo adlarını tahmin etmeyin

Bu yazıda bilerek tablo listesi vermiyoruz. Kamuya açık kaynaklarda bazı Netsis tablo adları birbiriyle çelişiyor ve sürümler arasında fark olabiliyor. Doğru liste, sizin kurulumunuzdaki veritabanından çıkarılır. SQL Server Management Studio ile bağlanıp TBL ile başlayan tabloları listelemek bunun için yeterli.

NetOpenX Nedir ve Neden Kullanılır?

NetOpenX, Netsis'in uyarlama ve entegrasyon arayüzüdür. Var oluş amacı tek cümleyle özetlenebilir: dışarıdan gelen kaydı, programın iş mantığını bozmadan sisteme almak ve sistemden veri okumak.

Bunun pratik karşılığı şu. Bir fatura ya da cari kaydı NetOpenX üzerinden geçtiğinde Netsis'in kendi doğrulamaları çalışır. Zorunlu alanlar kontrol edilir, fiş ile satırları arasındaki ilişki doğru kurulur, hata varsa anlamlı bir mesaj döner ve kayıt oluşmaz.

Doğrudan SQL ile tabloya satır eklemek teknik olarak mümkündür. Sorun, bu yolla oluşan kaydın programın kontrollerinden hiç geçmemiş olmasıdır.

NetOpenX'in Sağladığı Güvenlik ve Tutarlılık

Tipik bir durum: bayi portalı kurulurken "doğrudan veritabanına yazalım, daha hızlı olur" önerisi gelir. Test ortamında siparişler kaydedilir ve her şey çalışıyor gibi görünür. Sorun sonradan çıkar. Kayıt Netsis ekranında açıldığında beklenen davranışı göstermeyebilir, muhasebeleştirme aşamasında takılabilir ya da e-belge tarafında sorun çıkarabilir.

Bozulan veriyi düzeltmenin maliyeti, kazanılan birkaç günlük geliştirme süresinden büyüktür. Bu yüzden yazma işlemleri için tek yol NetOpenX'tir.

NetOpenX REST API: Windows Servisi ve Swagger Desteği

NetOpenX'in REST tabanlı sürümü NetOpenX Rest adıyla ayrı bir kurulum paketiyle gelir ve NetOpenX Rest Manager üzerinden yönetilir. Entegrasyon geliştiren ekip için iki özelliği öne çıkıyor.

1. IIS gerektirmez. Servis kendi başına ayağa kalkar. Sunucuda ayrıca bir web sunucusu kurmak ve uygulama havuzu yapılandırmak gerekmez.

2. Swagger arayüzüyle gelir. Hangi uç noktaların açık olduğunu, hangi alanların zorunlu olduğunu ve dönen cevabın yapısını kurulumun kendisinden görebilirsiniz. Üreticinin dokümantasyonunda Postman üzerinden örnek çağrılar da yer alıyor.

Swagger'ın değeri hafife alınmamalı. Dokümantasyon ile gerçek kurulum arasında fark varsa, bunu geliştirmeye başlamadan görürsünüz. Bu yazıda uç nokta adı ya da port numarası vermiyoruz; ikisi de kurulumunuzdaki Swagger ekranından okunur.

Kurulum ve Lisans Doğrulaması

NetOpenX Rest'i kurmadan önce iki şeyi yetkili bayinizle teyit edin.

1. Arayüz kurulumunuzda var mı? NetOpenX ve NetOpenX Rest her kurulumda hazır gelmeyebilir.
2. Ayrı lisans ya da modül gerekiyor mu? Bazı kaynaklar REST arayüzünün ayrı lisans gerektirebileceğini söylüyor. Bu konuda kesin cevap bayinizden alınır.

Hangi modüllerin lisansınızda olduğu da önemlidir. Lisansınızda olmayan bir modülün verisine arayüzden ulaşmayı beklemeyin. Modül durumunu proje başında netleştirmek, sonradan çıkacak sürprizi önler.

Okuma ve Yazma İşlemlerinde Farklı Yaklaşımlar

Okumak ile yazmak aynı risk sınıfında değildir. İkisini baştan ayrı planlamak gerekir.

Okuma İşlemleri (Veri Çekme)

Rapor, panel ve analiz için veri doğrudan veritabanından okunabilir. Hiçbir kayıt değişmediği için Netsis'in bütünlüğü etkilenmez. Dikkat edilecek noktalar:

• Filtre: İşletme ve şube filtresini her sorguya açıkça yazın.
• Yük: Ağır raporlama sorgularını canlı veritabanı yerine salt okunur bir kopyada çalıştırın. Netsis kullanıcılarının gün içi performansı korunur.
• Tek katman: Okuma sorgularını tek bir veri erişim katmanında toplayın. Sürüm yükseltmesinden sonra kontrol edilecek yer tek olur.

Yazma İşlemleri (Veri Gönderme)

Fatura, irsaliye, stok hareketi ya da cari kayıt gönderilecekse yol NetOpenX'tir. Yazma tarafında şunları baştan kurgulayın:

• Zorunlu alanlar: Swagger ekranında zorunlu işaretli alanları eksiksiz gönderin.
• Tanımlı kodlar: Netsis'te tanımlı olmayan cari ya da stok koduyla gelen kayıt reddedilir. Kod eşlemesini yönetilebilir bir tabloda tutun.
• Tekrar gönderim: Ağ kesintisinden sonra aynı kayıt ikinci kez gönderilirse iki fiş oluşmamalı. Bunun için kayıt anahtarını saklayın.
• Hata kaydı: Reddedilen kayıt sessizce kaybolmamalı. Listelenmeli, sebebi yazılmalı ve yeniden denenebilmeli.

Netsis Data Inspector: Resmi Uyarlama ve Kontrol Aracı

Netsis Data Inspector, kısa adıyla NDI, sık sık yanlış anlaşılıyor. NDI bir veritabanı inceleme aracı değildir. Netsis'in standart ekranlarının dışında ekran, rehber ve rapor tasarlamak için üreticinin sunduğu uyarlama ortamıdır. Netsis Toolbar, Object Inspector, Design Screen ve VCL Palette bileşenlerinden oluşur.

Entegrasyon projesindeki yeri şudur: NetOpenX üzerinden aktarılan kaydı Netsis'in içinden kontrol etmek istediğinizde, NDI ile küçük bir doğrulama raporu ya da ekranı tasarlanabilir. Veritabanı şemasını incelemek için ise SQL Server Management Studio kullanılır.

SUBE_KODU ve ISLETME_KODU ile Sorgu Tasarımı

Kolon bazlı ayrımın bir kolaylığı, bir de tuzağı var. Kolaylığı şu: şube ve işletme için tablo adını dinamik üretmeniz gerekmez. Tuzağı şu: filtreyi unutan sorgu hata vermez, yanlış toplam üretir.

Aşağıdaki sorgu yalnızca kalıbı gösterir. Tablo ve kolon adları kurulumunuzda doğrulanmalıdır:

-- Tablo adı yer tutucudur; gerçek ad kurulumda doğrulanır
SELECT STOK_KODU, SUM(MIKTAR) AS TOPLAM
FROM STOK_HAREKET_TABLOSU
WHERE ISLETME_KODU = 1
  AND SUBE_KODU = 2
GROUP BY STOK_KODU

SUBE_KODU satırını silerseniz sorgu yine çalışır. Ekranda bir sayı görünür ve kimse sistemin yanlış hesap yaptığını fark etmez.

Çoklu Şube Senaryoları

Şöyle bir durum düşünün: İstanbul ve Ankara'da iki şubesi olan bir firma e-ticaret sitesinde stok gösteriyor. Sorguda şube filtresi yok. Site iki şubenin toplam stoğunu gösteriyor, müşteri İstanbul'dan sipariş veriyor, ürün ise yalnızca Ankara'da var. Sevkiyat aşamasında stok bulunamıyor.

Bunu önlemenin iki yolu var. İşletme ve şube filtresini veri erişim katmanında kural hâline getirin. Her raporu da en az iki şubenin verisiyle test edin. "Zaten tek şubemiz var" varsayımı, ikinci şube açıldığı gün sessizce yanlış rapor üretmeye başlar.

Entegrasyon Öncesi Kontrol Listesi

• Ürün ve sürüm: Netsis 3 Standard, Enterprise ya da Wings; sürüm numarası
• Yapı: Kaç işletme ve şube tanımlı, kaç şirket ve yıl var
• Modüller: Hangi modüller lisanslı ve aktif
• Arayüz: NetOpenX ya da NetOpenX Rest kurulumda mevcut mu, ek lisans gerekiyor mu
• Şema: Kullanılacak tablolar ve kolonlar veritabanından çıkarıldı mı
• Test ortamı: Yazma işlemleri önce test veritabanında deneniyor mu
• Yedek: Canlıya geçmeden önce veritabanı yedeği alındı mı

Yaygın Hatalar ve Çözümleri

Yetkilendirme hatası: Kullanıcının arayüzü çağırma yetkisi ve lisans durumu kontrol edilir.

Tablo bulunamadı: Tablo adı kaynaktan kopyalanmıştır, kurulumda farklıdır. Ad veritabanından doğrulanır.

Kayıt reddedildi: Çoğu zaman tanımsız bir cari ya da stok kodu, ya da eksik bir zorunlu alan vardır. Arayüzün döndürdüğü mesaj sebebi söyler.

Zaman aşımı: Sorgu filtresizdir ya da tarih aralığı çok geniştir. Filtre eklenir, ağır sorgu salt okunur kopyaya taşınır.

Sıkça Sorulan Sorular

Netsis entegrasyonu ne kadar sürer ve maliyeti nedir?

Ürün, sürüm, işletme ve şube sayısı ile kapsam bilinmeden verilen süre tahmindir. Basit bir stok okuma işi ile çift yönlü sipariş ve fatura aktarımı aynı iş değildir. Keşif görüşmesinde kurulumunuzu, hangi verinin hangi yöne akacağını ve hangi arayüzün kullanılacağını netleştiriyoruz. Ardından yazılı takvim ve sabit fiyat veriyoruz. Teslim sonrası 15 gün ücretsiz hata düzeltme kapsamdadır.

NetOpenX kullanmadan doğrudan SQL sorgusuyla veri aktarımı yapabilir miyim?

Okuma için evet, yazma için hayır. Rapor ve analiz amacıyla veriyi doğrudan okumak yaygın ve güvenlidir. Kayıt oluşturmak ise NetOpenX üzerinden yapılmalıdır, çünkü arayüzün amacı kaydı iş mantığını bozmadan sisteme almaktır. Arayüzü atlamak, programın kendi doğrulamalarını da atlamak demektir.

SUBE_KODU ve ISLETME_KODU ne zaman önemli hale gelir?

Birden fazla şube ya da işletme tanımlandığı anda. Tek şubeyle çalışırken filtreyi yazmamak sorun çıkarmaz, bu yüzden alışkanlık hâline gelir. İkinci şube açıldığında aynı sorgular iki şubenin toplamını vermeye başlar ve hata mesajı çıkmaz. Filtreyi ilk günden yazmak en ucuz önlemdir.

Netsis Data Inspector olmadan entegrasyon yapabilir miyim?

Evet. NDI, Netsis içinde ekran ve rapor tasarlama ortamıdır; entegrasyonun çalışması için zorunlu değildir. Aktarılan kayıtları Netsis'in içinden kontrol edecek özel bir rapor istiyorsanız işe yarar. Veritabanı şemasını incelemek için SQL Server Management Studio yeterlidir.

NetOpenX ile NetOpenX Rest arasındaki fark nedir?

İkisi de aynı amaca hizmet eder: kaydı iş mantığını bozmadan Netsis'e almak. NetOpenX Rest, bu yeteneği HTTP üzerinden sunan sürümdür. Ayrı bir kurulum paketiyle gelir, IIS gerektirmez ve Swagger arayüzü içerir. Web ve mobil uygulamalar için daha uygundur. Hangisinin kurulumunuzda mevcut olduğu ve lisans durumu yetkili bayinizle teyit edilir.

E-ticaret sitemi Netsis ile entegre etmek istiyorum, nereden başlamalıyım?

Şu beş soruyu cevaplayarak:

• Hangi veri aktarılacak: stok, fiyat, sipariş, fatura, cari?
• Akış tek yönlü mü, çift yönlü mü?
• Ne sıklıkla: anlık mı, saatlik mi, günlük mü?
• E-ticaret altyapınız ne?
• Netsis ürününüz, sürümünüz ve lisanslı modülleriniz neler?

Bu cevaplarla ücretsiz online keşif görüşmesi için bize ulaşabilirsiniz. Görüşmede arayüz ve lisans durumunu birlikte netleştirir, ardından sabit fiyatlı teklif veririz.

Sonuç: Netsis Entegrasyonunda Başarı İçin Teknik Temeller

Netsis'te şube ve işletme ayrımı tablo adında değil, kolonlarda yapılır. Bu, sorguyu sadeleştirir ama filtre unutulduğunda sessiz hataya yol açar. Firma ve dönemin fiziksel ayrımı kurulumdan kuruluma değişebildiği için proje başında teyit edilir.

Yazma işlemleri NetOpenX üzerinden yapılır. NetOpenX Rest, IIS gerektirmeden çalışır ve Swagger arayüzüyle hangi uç noktaların açık olduğunu gösterir. Okuma tarafında doğrudan sorgu kullanılabilir, yeter ki filtre eksiksiz olsun ve ağır sorgular canlı sistemi yormasın.

D'Cloud Software, Mersin merkezli bağımsız bir yazılım firmasıdır. Netsis ya da başka bir programın bayisi değiliz; lisans, kurulum ve program desteği yetkili bayinizde kalır. Bizim işimiz, Netsis'in yanında çalışan ve onunla resmi arayüzünden konuşan yazılımı geliştirmek. Sabit fiyat sözleşmede yazılıdır, teslim sonrası 15 gün hata düzeltme ücretsizdir.

Kurulumunuzu birlikte değerlendirmek için iletişim formu ya da WhatsApp üzerinden ücretsiz keşif görüşmesi talep edebilirsiniz.