Logo Rest Serivs, Logo ERP programları ile harici bir uygulamayı haberleştirmek için kullanılan servisin adıdır. Bu makalede, Logo Rest Servis ile ilgili kapsamlı bir bilgi paylaşacağız.
Rest Nedir?
REpresentational State Transfer (Temsili Durum Transferi) ifadesinin kısaltmasıdır. Web standartları temeliyle oluşturulmuştur. HTTP ve HTTPS protokollerini kullanarak veri aktarımı ve/veya iletişimi için kullanılır.
Bu aktarım/iletişim işlemlerinde aşağıdaki web metotları kullanılır:
GET – Yalnızca okuma izniyle veriye erişim sağlar.
PUT – Yeni bir veri oluşturmaya yarar
DELETE – Bir veriyi silmeye yarar
POST – Mevcut bir veriyi güncellemeye veya yeni bir veri oluşturmaya yarar.
OPTIONS – veri üzerinde yapılabilecek işlemler için kullanılır.
LOGO REST Servis Nedir?
Logo REST Servis, temelde Logo Objects in yeteneklerini REST API üzerinden kullanmaya yarar. Logo Objects’in web arayüzüdür de diyebiliriz. Yani Logo Objects olmadan Logo Rest Servis hiç bir anlam ifade etmez.
Hangi Ürünlerde Kullanılır
Logo Rest Servis, 3 ve Wings Serisi ürünlerde kullanılabilir. Tiger 3, Tiger Wings, Tiger 3 Enterprise ve Tiger Wings Enterprise ürünlerinde kullanılabilir. Logo Start, Tiger Plus, Go Plus, Go 3 ve Tiger Enterprise gibi ürünlerde kullanılamaz.
Logo Rest Servis Lisanslı mıdır?
Yukarıda bahsettiğimiz gibi, Logo Rest Servis, temelde Logo Objects in yeteneklerini kullanan bir arayüzdür. Bu nedenle ayrı bir ürün gibi değerlendirilmez ve Logo Rest Servisi diye bir lisans yoktur. Logo Objects kullanım lisansınızın olması ve yukarıdaki ürünlerden birine sahip olmanız yeterlidir.
Logo Rest Servis Kurulumu
Logo ERP programının kurulumu veya versiyon geçişleri gerçekleştirilirken son aşamada aşağıdaki gibi bir ekran ile karşılaşılır.
Bu ekrandaki kutucuk işaretlenirse ve kurulum başarılı olursa, Logo Rest Servis default ayarlarla kurulacak ve çalışmaya başlayacaktır.
Eğer kutucuk işaretlenmezse veya daha sonradan bir rest servis ihtiyacı duyulursa, Logo ERP programının kurulu olduğu dizinde, RESTServis isminde bir klasör bulunur. Bu klasör içerisindeki LogoRestServiceSetup.exe çalıştırılarak da Logo Rest Servis kurulumu yapılabilir.
Logo Rest Servis Ayarları
Servisin kurulması, Logo Rest Servis’i çalıştırmak için yeterli ancak kullanmak için yeterli olmayacaktır. Çünkü servis, yukarıda belirtildiği gibi default ayarlar ile kurulacaktır.
Logo Rest Servis ayarlarını yapmak için,
ERP dizini\RESTServis\LogoObjects.RestService.RestServiceWSManager.exe dosyası yönetici olarak çalıştırılır.
Karşınıza yukarıdaki görsele benzer bir pencere çıkacaktır. Benzer dememdeki sebep, 2.99 ve sonraki versiyonlarda yukarıdaki gibi, önceki versiyonlarda ise bazı alanların farklı gelmesinden dolayıdır.
Eğer Cannot connect Logo Server gibi bir hata alıyorsanız, REGISTER.BAT dosyasını yönetici olarak çalıştırın ve ERP programına giriş yapabildiğinizden emin olun.
Yukarıdaki görselde numaralandırılan alanları ifade edelim:
1 numaralı alan : Kurulumu yapılan servisin, Windows hizmetlerdeki ismini ifade eder.
2 numaralı alan : Logo Rest Servisin mevcut durumunu ifade eder. (Çalışıyor, Durduruldu, Durmayı Bekliyor vs.)
3 numaralı alan : Logo Rest Servisin sürüm bilgisini ifade eder. ERP sürümü ile aynı olması gerekir.
4 numaralı alan : Başlat, Durdur ve Servis Durumunu Göster, windows hizmetlere gitmeden servise müdahale etmeye yarar. Kaydet butonu yapılan değişiklikleri uygular ve kaydeder. Kapat butonu ilgili ekranı kapatır.
5 numaralı alan : Servisin çalışacağı protokol, ip adresi ve port bilgisini ifade eder. Adres kısmına kurulum yapılan sunucunun ip adresi yazılacağı gibi, localhost ifadesi de yazılabilir. Rest servise uzaktan erişim yapılacak ise, ip adresi yazılması önerilir. Port kısmına yazılacak olan portun boş ve kullanılmayan bir port olması gerekir. Ön değer port 32001 dir.
- https kullanımı için, gerekli Server ve Client sertifikalarının kurulumu gerekmektedir. Ayrıntılı bilgi için tıklayın
- Proxy ve/veya firewall kullanılıyor ise, Logo Rest Servis ayarlarına tanımlanan portların yetkilendirilmesi gerekmektedir. Ayrıntılı bilgi için tıklayın
- Bu alanda değişiklik yapılmadan önce servisin Durdur butonu ile durdurulması, değişiklikler yapıldıktan sonra Kaydet butonu ile ayarların doğrulanması, ardından tekrar Başlat butonu ile servisin başlatılması, önerilen işlem adımlarıdır.
6 numaralı alan : Token geçerlilik süresi, Logo Rest Servis’den alınan token izninin kaç dk geçerli olacağını belirtir. LObjectslerin kapatılma süresi, Logo Rest Servis kullanırken açılan LObjects.exe lerin kullanılmadığı durumda otomatik kapatılma süresini belirtir.
7 numaralı alan : Loglama işleminin yapılacağı seviyeyi belirtir. Öndeğer seviye “Error” dur. Yani tüm hatalar loglanır. Diğer log seviyeleri şu şekildedir:
- Fatal: Kritik hatalar loglanır
- Error: Tüm hatalar loglanır
- Warning: Uyarılar da loglanır
- Info: Bilgi mesajları da loglanır
- Verbose: Servis üzerinden yapılan her adım loglanır.
Loglamalar ERP_DİZİNİ\RESTServis\Logs klasörü içerisinde tutulur.
8 numaralı alan : Logo Yazılım bünyesindeki Dikey Çözüm ürünlerinin kullanabileceği Maksimum ve Minimum LObjects sayısını belirtir. Minimum değer 2 nin altında, Maximum değer 3 ün altında verilemez.
9 numaralı alan : Objects kullanım lisansı ile kullanılabilecek Maksimum ve Minimum LObjects sayısını belirtir. Kaç kullanıcılı Objects kullanım lisansınız varsa bu sayıyı Maximum değere verebilirsiniz. Örneğin; Objects kullanım lisansı ve objects kullanıcı artırım lisansı +2 lisansına sahipseniz maksimum değere 1+2 = 3 yazabilirsiniz.
10 numaralı alan : ERP sys üzerinde açılmış, Logo Objects kullanımı yetkisi tam olan bir kullanıcıya ait bilgileri ifade eder.
Test İşlemleri Sekmesi
Bu sekmeden, Logo Rest Servis ayarlarınızın doğruluğunu test edebilirsiniz.
Logo Rest Servis, yapılacak işlemlerde Token bilgisine ihtiyaç duyar. Token almak için de, elinizde Rest Servis Anahtar Sahibi (ClientId) ve Rest Servis Anahtar Değeri (ClientSecret) olması gerekir.
Bu bilgiler yalnızca, Logo Çözüm Ortaklarına verilir. Bu bilgiler olmadan direkt olarak Rest Servis kullanılamaz.
Yukarıdaki görselde, ClientId ve ClientSecret bilgileri kullanılarak, RestServisWSManager üzerinden ilk muhasebe hesabına ait bilgilerin çekilmesi test edilmektedir.
GET /glaccounts?limit=1 ifadesi, muhasebe hesaplarından 1 kayıt getir anlamını taşır. Her hangi bir sıralama şartı verilmediği için A-Z sıralaması uygulanır ve ilk kayıt çağrılır.
1- Token Alma: Girilen ClientId ve ClientSecret bilgileri kullanılarak, http://sunucuadresi:32001/api/v1/token adresinden token talep edilir. Bilgiler doğru ise, istek karşılığında bir token bilgisi döner.
2- İsteğin Karşılanması: Token bilgisi kullanılarak, http://sunucuadresi:32001/api/v1/glaccounts?limit=1 adresine GET isteği gönderilir ve dönen json değeri ekrana getirilir.
3- Token Yoketme: http://sunucuadresi:32001/api/v1/revoke adresine istek gönderilerek token yok edilir.
Test Swagger Yardım UI butonuna basarak, Logo Rest Servis için hazırlanan dökümana erişebilirsiniz. Ayrıca LOBJECTS metotlarının RestServis karşılıklarına erişmek için Logo REST Resource sayfasındaki dökümanını inceleyebilirsiniz.
