Netsis Dokümantasyonu

Kurulum

Ön koşullar

  • Netsis Temelset 8.06 ve üzeri.
  • Microsoft .NET Framework 4.0 veya üzeri.
  • Netsis Merkezi Kimlik (SSO) kurulu ve erişilebilir; NetOpenX lisansı SSO'dan indirilmiş.
  • Setup dosyası kurulu Netsis sürümüyle uyumlu olmalı.

Setup adımları (NetsisNoxRestSetup.exe)

  1. Dosyayı yönetici olarak çalıştırın.
  2. Kurulum dili: Türkçe veya İngilizce.
  3. Ön koşul kontrolünde tüm maddeler Başarılı olmalı; değilse eksik bileşeni kurun.
  4. Özellik seçimi: "NetOpenX Rest Yönetim Paneli" ve "NetOpenX Rest" seçili olmalı. Değilse sağ tık → "Diske Yükle".
  5. Netsis Merkezi Kimlik Denetimi Servis Konfigürasyonu:
    • SSO Service Adresi: "Bul" ile ağdaki SSO servisleri listelenir. Elle: sunucu-adı:2023/NetsisSsoService.
    • SSO STS URL: http://SunucuAdı/NetsisSTS. "Dene" ile test edilir.
  6. Sanal dizin: varsayılan C:\Netsis\Enterprise8\Nox\. Altında WS ve WSManager klasörleri oluşur.
  7. Windows servisi: Netsis NetOpenX Rest Service (services.msc).

Kurulum sonrası kontrol

  1. Servis yöneticisi: ...\Nox\WSManager\NetOpenX.Rest.Service.WSManager.exe servis durumunu, ayarlarını ve logları gösterir.

    • "Servis Yöntemi" bölümünde Servis dizini kurulumun WS klasörünü göstermeli (ör. C:\Program Files (x86)\Netsis\Nox\WS). Yanlış ya da boş dizin servisin başlamamasına yol açar.
    • Sol alttaki kimlik yönetimi simgesiyle SSO değerleri yeniden okunur, "Kaydet" yapılır.
    • Servis "Stopped" ise "Başlat". Hata ayrıntısı için sağ alttaki Log düğmesi ...\Nox\WS\log klasörünü açar.

  2. Yardım sayfası: http://localhost:7070/api/v2/help. Tüm uçlar, parametreler ve model tipleri burada listelenir. Tek uç için: http://localhost:7070/api/v2/helpinfo?apiId=<METHOD>-api-v2-<yol> (ör. POST-api-v2-ItemSlips-Calculate). Yardım sayfaları token istemez.

  3. Test uygulaması: NetOpenX.Rest.TestApp.exe. "Operation" sekmesindeki "Path" alanına yardım sayfasındaki yol yazılarak çağrı denenir.

  4. Anonim sağlık kontrolü:

    curl http://localhost:7070/api/v2/public/Ping
# "02.11.2026 02:01 > OK"
curl http://localhost:7070/api/v2/public/Version
# "9.0.68.0"
curl http://localhost:7070/api/v2/HealthCheck
# {"IsSuccessful":true,"Description":"NetOpenX Kernel oluşturuldu. Versiyon: 9.0.68.0 ..."}

Port

Dokümantasyon ve örnekler 7070 kullanır; bazı eğitim örnekleri 9090 kullanır. Gerçek kurulumlarda farklı portlar da kullanılır. Kullanılan portu servis yöneticisinden kontrol edin.

Token süresi

  • Varsayılan 20 dakika.
  • "NetOpenX Rest Manager" ekranında Access token geçerlilik süresi alanından değiştirilir.
  • Süresi dolmuş ya da hiç olmayan token ile gelen istekler 401 ile reddedilir; yeni token alınmalıdır.

Sürümle gelen uç sayısı

9.0.68 sürümlü bir sunucunun yardım sayfasında 379 uç listelenmiştir. Kaynak başına en çok uç: ItemSlips 23, Company 18, Mrp 11, DocumentLocking 10, PlanningRecord 9, EDocument 8, MaintenanceOrders 8, Print 8, StatementsHeader 8, ARPs 7, ExRates 7, QualityControls 7; ayrıca definitions 47 ve services 49 şema ucu. Sürümünüzdeki tam listeyi her zaman api/v2/help'ten alın.