Logo REST Servis Kurulumu ve Yapılandırması

Logo REST Servis, Logo ERP ürünleri ile harici uygulamalar arasında veri alışverişi ve entegrasyon sağlamak amacıyla kullanılan bir servis bileşenidir. Bu makalede Logo REST Servis'in ne olduğunu, hangi ürünlerde çalıştığını, nasıl kurulduğunu ve yapılandırıldığını kapsamlı biçimde ele alıyoruz.

REST Nedir?

REST (REpresentational State Transfer — Temsili Durum Transferi), web standartları üzerine inşa edilmiş bir mimari yaklaşımdır. HTTP ve HTTPS protokollerini kullanarak sistemler arasında veri aktarımı ve iletişim sağlar.

REST mimarisinde aşağıdaki HTTP metotları kullanılır:

• GET — Yalnızca okuma yetkisiyle veriye erişim sağlar.
• PUT — Yeni bir kayıt oluşturmak için kullanılır.
• DELETE — Mevcut bir kaydı silmek için kullanılır.
• POST — Mevcut bir kaydı güncellemek veya yeni kayıt oluşturmak için kullanılır.
• OPTIONS — Bir kayıt üzerinde yapılabilecek işlemleri sorgulamak için kullanılır.

Logo REST Servis Nedir?

Logo REST Servis, Logo Objects bileşeninin yeteneklerini REST API arayüzü üzerinden dışarıya açan bir katmandır. Bir başka deyişle Logo Objects'in web tabanlı arayüzüdür. Bu nedenle Logo Objects kurulu ve çalışır durumda olmadan Logo REST Servis işlevsel değildir.

Hangi Ürünlerde Kullanılabilir?

Logo REST Servis yalnızca 3 ve Wings Serisi ürünlerde desteklenmektedir:

• Tiger 3
• Tiger Wings
• Tiger 3 Enterprise
• Tiger Wings Enterprise

Logo REST Servis Lisanslı mıdır?

Logo REST Servis, Logo Objects'in yeteneklerini kullanan bir arayüz katmanı olduğundan ayrı bir ürün olarak lisanslanmaz. Yani "Logo REST Servis Lisansı" diye bir lisans türü bulunmamaktadır. Servisin kullanılabilmesi için:

• Geçerli bir Logo Objects kullanım lisansına sahip olmanız,
• Yukarıda listelenen desteklenen ürünlerden birine sahip olmanız yeterlidir.

Logo REST Servis Kurulumu

Logo ERP kurulumu veya versiyon güncellemesi sırasında son aşamada bir kurulum ekranı görüntülenir. Bu ekrandaki REST Servis kurulum seçeneği işaretlenip kurulum tamamlandığında, Logo REST Servis varsayılan ayarlarla otomatik olarak kurulur ve çalışmaya başlar.

Logo REST Servis Ayarları

Servisin kurulması tek başına yeterli değildir; kullanıma hazır hale getirmek için yapılandırma adımlarının tamamlanması gerekir. Yapılandırma aracını açmak için:

ERP_DİZİNİ\RESTServis\LogoObjects.RestService.RestServiceWSManager.exe

Bu dosyayı yönetici (Administrator) olarak çalıştırın. Karşınıza gelen yapılandırma ekranındaki alanlar şu şekilde açıklanabilir:

Alan	Açıklama
1	Windows hizmetlerindeki servis adını gösterir.
2	Servisin mevcut durumunu gösterir (Çalışıyor, Durduruldu, Durmayı Bekliyor vb.).
3	REST Servis sürüm bilgisini gösterir. ERP sürümüyle aynı olması zorunludur.
4	Başlat, Durdur ve Servis Durumunu Göster butonları — Windows hizmetlerine gitmeden servise müdahale imkânı sağlar. Kaydet butonu değişiklikleri uygular.
5	Servisin çalışacağı protokol, IP adresi ve port bilgisi. Uzaktan erişim için sunucu IP adresi girilmesi önerilir. Varsayılan port: 32001
6	Token geçerlilik süresi (dakika cinsinden) ve kullanılmayan LObjects.exe örneklerinin otomatik kapatılma süresi.
7	Loglama seviyesi. Varsayılan: Error. Diğer seviyeler: Fatal, Warning, Info, Verbose. Loglar ERP_DİZİNİ\RESTServis\Logs klasöründe tutulur.
8	Dikey Çözüm ürünleri için maksimum ve minimum LObjects sayısı. Minimum 2, Maksimum 3'ün altında değer verilemez.
9	Objects kullanım lisansıyla kullanılabilecek maksimum ve minimum LObjects sayısı. Lisans adedine göre belirlenir.
10	ERP sisteminde Logo Objects kullanım yetkisi tanımlanmış bir kullanıcıya ait kimlik bilgileri.

Test İşlemleri

Yapılandırma ekranındaki Test İşlemleri sekmesinden REST Servis ayarlarınızın doğruluğunu kontrol edebilirsiniz.

Logo REST Servis, her işlem için bir Token bilgisi gerektirir. Token alabilmek için:

• ClientId (REST Servis Anahtar Sahibi)
• ClientSecret (REST Servis Anahtar Değeri)

bilgilerine ihtiyaç duyulur.

Test Akışı

1. Token Alma: ClientId ve ClientSecret bilgileri kullanılarak http://sunucuadresi:32001/api/v1/token adresinden token talep edilir. Bilgiler doğruysa bir token değeri döner.
2. İsteğin Karşılanması: Alınan token ile http://sunucuadresi:32001/api/v1/glaccounts?limit=1 adresine GET isteği gönderilir ve JSON yanıtı ekrana gelir. Bu örnekte muhasebe hesaplarından ilk kayıt çekilmektedir.
3. Token Geçersiz Kılma: http://sunucuadresi:32001/api/v1/revoke adresine istek gönderilerek token sonlandırılır.

Sonuç

Logo REST Servis, Logo ERP sistemlerinizi dış uygulamalar ve özel yazılımlarla entegre etmenin en modern ve esnek yoludur. Doğru kurulum ve yapılandırma ile güvenli, performanslı entegrasyonlar geliştirilebilir.

Datasource olarak Logo REST Servis kurulumu, yapılandırması ve entegrasyon geliştirme konularında uzman desteği sunuyoruz. Projeniz için bizimle iletişime geçebilirsiniz.