6.1 Rapor servisi: GET /ClientREST/ReportServer

<< İçindekileri Görüntülemek İçin Tıklayın >>

Yer:  Teknik Kılavuzlar > Netsim System Agent İstemci Protokolü Referansı > 6. Rapor uçları >

6.1 Rapor servisi: GET /ClientREST/ReportServer

Rapor servisi (Netsim.Reporting: DevExpress rapor tasarımcısı, görüntüleyici, POST /report/export) ajanın alt sürecidir (conf reportServer); istemci servise doğrudan gider, ajan istekleri geçirmez. Servisin kendi uçları ve oturum akışı Netsim.WEB docs/ENTEGRASYON.md §5'tedir.

  • Açık oturum ister (401). Servis kapalı, sağlıksız ya da yalnız 127.0.0.1'e bağlı ve publicUrl'siz ise 404 + result: false (istemci bu rapor motorunu kullanılamaz sayar).
  • Başarı 200 {"result": true, "url": "<servisin taban adresi, / ile biter>", "token": "<JWT>", "expiresIn": <sn>}.
  • Sorgu: term = istemcinin terminal numarası (NetsimApp GetUserInfoINT(5); servis filtre değerlerini o terminalin TFILTDET satırlarından okur, öndeğer 0); database = MASTER kayıt adı, yalnız oturumda DatabaseName yoksa okunur. Oturumda ikisi de yoksa ya da oturumun kullanıcı adı boşsa 202 + result: false.
  • Belirteç: HS256 JWT, anahtarı ajan servisi her başlatışında üretir. Claim'ler iss NetsimSystemAgent, aud Netsim.Reporting, sub oturumun kullanıcı adı (OpenSession UserName'i yazıldığı gibi; PostgreSQL rol adları harf duyarlıdır), db kayıt adı, sid ajan oturumunun özeti (oturum çerezi değil), term, exp (öndeğer 300 sn, conf tokenTtlSec), jti. Tek kullanımlıktır: her kullanımdan hemen önce yenisi alınır (her çağrı yeni jti). Parola belirtece girmez: kullanıcı kipinde istemci servise POST /session {token, password} ile kendi parolasını verir.
  • Oturum kapanınca (CloseSession, WebSocket düşmesi, CLOSESESSION, süre aşımı) ajan servise POST /session/revoke gönderir; o oturuma bağlı servis oturumları düşer. Yalnız bu uçtan belirteç almış oturumlar için gönderilir.