Wolvox Verisini Excel'e ve Rapor Paneline Bağlamak: Firebird, MS SQL ve ODBC

Tipik bir durum: muhasebe sorumlusu her pazartesi Wolvox'tan üç ayrı liste alıyor, Excel'de birleştiriyor ve yöneticiye gönderiyor. Rapor hazır olduğunda veri birkaç gün eskimiş oluyor. Yönetici ise aynı rakamı telefonundan, güncel hâliyle görmek istiyor.

Bu ihtiyacın çözümü çoğu zaman sanıldığından yakındır, çünkü Wolvox'ta veriyi okumanın yolu üretici tarafından anlatılmıştır. Zor olan kısım okumak değil, neyin okunup neyin yazılacağını doğru ayırmaktır.

İlk Soru: Firebird mi, MS SQL Server mı?

Wolvox iki farklı veritabanı altyapısı üzerinde çalışabilir: Firebird ve MS SQL Server. Entegrasyon planı bu cevaba göre en başta ikiye ayrılır. Sürücü seçimi, ağ ayarları ve sorgu davranışı altyapıya göre değişir.

Altyapı	İlgili portlar	Bilinmesi gereken
Firebird	3050-3056 aralığı ve 80	İstemci bağlantısının kopması üreticinin bilgi bankasında ayrı bir makalede ele alınıyor
MS SQL Server	1433 ve 1434	ODBC ile raporlama bağlantısı üreticinin anlattığı yollardan biri

Hangi altyapıda olduğunuzu bilmiyorsanız sunucudaki servis ve port yapılandırmasına bakılarak tespit edilir. Bu cevap netleşmeden verilen süre tahmini sağlıklı olmaz.

Firebird tarafındaki bağlantı kopması konusu ayrıca önemlidir. Üretici bunu kendi bilgi bankasında belgelemiş ve çözümü belirli Firebird sürümlerine bağlamıştır. Bu yüzden rapor katmanı, bağlantının hiç kopmayacağı varsayımıyla tasarlanmaz. Yeniden bağlanma ve yeniden deneme baştan yazılır.

Okuma: Üreticinin Anlattığı Yol

Birçok programda veritabanını doğrudan okumak belirsiz bir alandır. Teknik olarak yapılabilir, üretici ise konuya değinmez. Wolvox'ta durum farklıdır. AKINSOFT kendi bilgi bankasında ODBC ile veritabanına bağlanmayı ve buradan Excel'e canlı rapor almayı adım adım anlatır. Ayrıca Firebird ve SQL veritabanları için PratikSQL adlı bir sorgulama aracını kendi kataloğunda sunar.

Bu, rapor ve analiz ihtiyaçlarında yolu açık hâle getirir. Okuma hiçbir kaydı değiştirmediği için programın veri bütünlüğünü de etkilemez.

Excel ne zaman yeter?

Küçük bir ihtiyaçta ODBC bağlantılı bir Excel dosyası tek başına yeterli olabilir. Her ihtiyacın cevabı yazılım geliştirmek değildir. Tek kişi kullanıyorsa, rapor basitse ve geçmişe dönük karşılaştırma gerekmiyorsa Excel işi görür.

Excel ne zaman yetmez?

Aşağıdaki durumlardan biri varsa araya bir rapor katmanı koymak gerekir:

• Aynı raporu birden fazla kişi kullanıyorsa ve herkes kendi dosyasını tutuyorsa
• Yetkiye göre farklı görünüm gerekiyorsa, örneğin şube müdürü yalnızca kendi şubesini görecekse
• Geçmiş dönemlerle karşılaştırma isteniyorsa
• Rapor telefondan ya da web üzerinden açılacaksa
• Rapor belirli saatlerde otomatik gönderilecekse

Rapor katmanı, veriyi belirli aralıklarla okuyup kendi tarafında hazır tutar. Böylece ağır sorgu gün ortasında Wolvox kullanıcılarını yavaşlatmaz.

Alan anlamları tahmin edilmez

Bu yazıda tek bir tablo ya da kolon adı geçmiyor. Bunun sebebi, üreticinin herkese açık bir geliştirici dokümanı yayımlamamış olmasıdır. Hangi alanın ne anlama geldiği, kurulumunuzda ekrandaki karşılığıyla eşleştirilerek doğrulanır. Firmaların kendi kodlama düzenleri de bu anlamı değiştirebilir.

Çok Şirketli ve Çok Şubeli Kurulumlar

AKINSOFT'un entegrasyon ekranında şirket kodu, şube kodu ve çalışma yılı ayrı ayrı sorulur. Bu, verinin bu üç değere göre ayrıştığını gösterir. Değerlerden biri yanlış seçilirse rapor hata vermez, farklı bir şirketin, şubenin ya da yılın rakamını gösterir.

Bu yüzden filtre kuralları yazılı hâle getirilir ve rapor katmanında tek bir yerde tutulur. Çalışma yılı, yıl dönümünde gözden geçirilmesi gereken bir ayardır.

Yazma Tarafı Neden Ayrı Ele Alınır?

Okumanın bu kadar rahat olması, yanlış bir sonuca götürebilir: "Veritabanına bağlanabiliyorsak kayıt da ekleyebiliriz."

Üretici okumayı belgelemiştir. Doğrudan veritabanına kayıt eklemenin desteklendiğine dair bir kaynak ise bulamadık. Kayıt doğrudan tabloya eklendiğinde programın kendi denetimleri çalışmaz: cari doğrulaması, stok bakiye kontrolü, zorunlu alanlar ve belge ile satır arasındaki ilişki atlanır. Sorun çoğu zaman hemen değil, ay sonu kapanışında ortaya çıkar.

Yazma ihtiyacı olduğunda bakılacak yer, kurulumunuzda bulunan resmi entegrasyon yüzeyidir. AKINSOFT kataloğunda Wolvox Web Entegrasyon adında ayrı bir ürün yer alır ve stok, sipariş, fatura ile cari entegrasyonu için konumlanır. Bu ürünün kurulumunuzda bulunup bulunmadığı ve lisans koşulu yetkili bayinizle teyit edilir.

Ağ Tarafında Önceden Hazırlanacaklar

Saha kurulumlarında en çok zaman alan kısım çoğu zaman yazılım değil, ağ ayarlarıdır. Aşağıdaki kalemler önceden hazır olursa kurulum kısalır.

1. Portlar. Altyapıya göre ilgili portların güvenlik duvarında nasıl açılacağı BT sorumlusuyla konuşulur.
2. Sabit IP. AKINSOFT e-Ticaret tarafındaki Entegrasyon Yönetimi ekranında Kontrol Paneli'nin IP adresi istenir ve bu adresin sabit olması gerekir. Dinamik IP kullanan kurulumda adres değiştiğinde bağlantı kesilir.
3. Ayrı kullanıcı. Rapor ve entegrasyon için ayrı bir kullanıcı tanımlanması, kimin ne yaptığının izlenebilmesini sağlar. Okuma için kullanılan kullanıcıya yazma yetkisi verilmez.
4. IP kısıtlaması. e-Ticaret paneli API kullanıcı tanımında isteğe bağlı bir IP adresi alanı bulunur. Erişimi belirli adreslerle sınırlamak güvenliği artırır.
5. Sürüm bilgisi. Entegrasyon ekranında sürüm seçimi bulunması, davranışın sürüme bağlı olduğunu gösterir. Kurulu sürüm not edilir.

Adım Adım İlerleme

Wolvox tarafında herkese açık bir geliştirici dokümanı olmadığı için iş keşifle başlar. Sıra genellikle şöyledir:

1. Altyapı tespiti: Firebird mi, MS SQL Server mı
2. Kurulumda hangi entegrasyon yüzeyinin bulunduğunun belirlenmesi
3. Alan anlamlarının ekran karşılıklarıyla doğrulanması
4. Ağ ve erişim ayarlarının hazırlanması
5. Salt okunur pilot: hiçbir kayıt değişmeden bağlantının ve verinin doğruluğunun görülmesi
6. Kapsamın ve sabit fiyatın yazılması

Takvim ve fiyat bu adımlardan sonra verilir. Keşif yapılmadan söylenen rakam, proje ortasında kapsam tartışmasına dönüşür.

Sıkça Sorulan Sorular

Wolvox'un herkese açık bir API'si var mı?

Üreticinin yayımladığı, herkese açık bir REST ya da SOAP API dokümanı bulamadık. Katalogda Wolvox Web Entegrasyon adında ayrı bir ürün yer alıyor. Kurulumunuzda bulunup bulunmadığı ve kapsamı keşif aşamasında birlikte tespit edilir.

Rapor için Wolvox'a ek bir modül almam gerekir mi?

ODBC ile okuma, üreticinin bilgi bankasında anlatılan bir yoldur. Lisansınıza bağlı bir koşul olup olmadığını yetkili AKINSOFT bayinizden teyit etmeniz gerekir.

Rapor Wolvox'u yavaşlatır mı?

Doğru kurulursa yavaşlatmaz. Ağır sorgular gün içinde canlı veritabanı üzerinde çalıştırılmaz. Veri belirli aralıklarla okunur ve rapor katmanında hazır tutulur.

Web sitemdeki stok bilgisi Wolvox'tan beslenebilir mi?

Beslenebilir. Stok ve fiyat bilgisi belirli aralıklarla okunup web tarafına aktarılır. Bağlantı kesildiğinde site son bilinen veriyle çalışmaya devam eder, bağlantı geldiğinde güncelleme sürer.

AKINSOFT bayisi misiniz?

Hayır. D'Cloud Software hiçbir yazılım üreticisinin bayisi ya da çözüm ortağı değildir. Lisans, kurulum ve eğitim yetkili bayinizin alanıdır. Bizim yaptığımız iş, ürünün belgelenmiş veri erişim yolları üzerinden çalışan yazılımı geliştirmektir.

Teslimden sonra hata çıkarsa ne olur?

Teslim sonrası 15 gün ücretsiz hata düzeltme sözleşmeye yazılır. Sürüm yükseltmesi sonrası doğrulama gibi süren işler ayrı bir bakım maddesinde tanımlanır.

Sonuç

Wolvox'ta okuma yolu üretici tarafından anlatılmıştır; rapor ve panel ihtiyaçları bu yoldan kurulabilir. Yazma tarafı ise ayrı ele alınır ve resmi entegrasyon yüzeyinin dışına çıkılmaz. İşin ilk adımı altyapının, kurulu sürümün ve ağ koşullarının tespit edilmesidir.

Wolvox verinizi bir rapor paneline, web sitenize ya da depo uygulamanıza bağlamak istiyorsanız, kurulumunuzu birlikte değerlendirmek için iletişime geçin.