====== Registracija korisničkih licenci ======

Registracija se oslanja na REST web API koji klijenti kontaktiraju u periodičnom intervalu kako bi izvršili validaciju prava na upotrebu Balans licence. Ovaj članak opisuje klijentsku i serversku specifikaciju, uz veze ka člancima koji se bave implementacijom rešenja.

Web adresa servisa za registraciju je [[https://melany.rs/lc/register/|https://melany.rs/lc/register/]], u daljem tekstu referirana kao $REGB3

===== Klijent =====

Po pokretanju klijent šalje JSON "[[:l3:serveri:registracija_json_registracija|Registracija]]" poruku na $REGB3 i kratko vreme čeka na JSON "[[:l3:serveri:registracija_json_licenca|Licenca]]" odgovor na osnovu kog se donosi odluka o daljem radu sistema.\\
Podaci o licenci se čuvaju u Balans bazi Melany Team-a, i u BLFPUB.dat fajlu odnosno blfpub bazi na strani klijenta. Za detalje implementacije pogledati:

  * [[:l3:serveri:registracija_db_balans_struc|struktura tabela u Balans bazi podataka]]
  * [[:l3:serveri:registracija_json_licenca#mapiranje_na_ms_firnfo_tip_blfpub_zapis|struktura tabela/zapisa u BLFPUB bazu/fajlu na strani klijenta]]
  * [[:l3:serveri:registracija|COM biblioteka za registraciju kod klijenta]]

Specifikacija procesa registracije:

  - Ukoliko servis nije dostupan, postavlja se [[:l3:serveri:registracija_max_datum_tolerancije|maksimalni datum tolerancije]] (1 godina)
  - prvi put kada servis postane dostupan maksimalni datum tolerancije se nulira
  - tri meseca pre isteka maksimalnog datuma tolerancije korisnik dobija pri svakom pokretanju obaveštenje da kontaktira distributera
  - po isteku datuma tolerancije poruka iskače na svakih 5 sekundi
  - Proces registracije odvija se u skladu sa zapisima iz [[:l3:serveri:registracija_json_licenca#mapiranje_na_ms_firnfo_tip_blfpub_zapis|BLFPUB]] baze/fajla koji definiše:
  - Verziji programa i baze podataka
  - Podatke o nosiocu licence (povlače se sa $REGB3 nakon uspešne registracije)
  - Sledeći [[:l3:serveri:registracija_datum_osvezavanja|datum osvežavajna registracije]]
  - Dobijeni [[:l3:serveri:registracija_mel_id_token|mel_id]] token koji predstavlja jedinstveni broj licence pod kojim radi sistem. Kod distribuiranog modela (razmena podataka), svaka radna jedinica ima svoj [[:l3:serveri:registracija_mel_id_token|mel_id]] token.
  - Status licence (granted, readonly, revoked)
  - [[:l3:serveri:registracija_datum_isteka_licence|]] (nakon kog status automatski prelazi u readonly)
  - U procesu registracije šalje se i [[:l3:serveri:registracija_osnovna_statistika|osnovna statistika]] o upotrebi programa koja se sastoji od:
  - broja registrovanih firmi u sistemu
  - aktivnih dodatnih modula sistema
  - maksimalne veličine aktivnih baza podataka

==== Ručna obnova licence ====

Registar svih firmi je na serveru MOC, baza b7, tabela public.[[:l3:serveri:registracija_db_balans_struc#reginfo|reginfo]].

Da bi se ručno obnovila licenca, mora da se zna GUID. SQL: ''SELECT * FROM public.reginfo WHERE mel_id='<guid>'''

Tada mogu da se osveže vrednosti u kolonama:

  * ''distrib ''- Obično pišemo "**Melany**", ovo je ko je uradio instalaciju i brine o klijentu
  * ''lic_to ''- Uglavnom je dovoljno ukloniti "**Preliminary: **" iz postojeće vrednosti. Ako je prazna, uneti ime firme.
  * ''status ''- Postaviti na **50**, ako već nije ta vrednost.
SQL primer (prilagoditi po potrebi):
<code>

UPDATE public.reginfo SET distrib='Melany', lic_to=Replace(lic_to, 'Preliminary: ', ''), status=50 WHERE mel_id='<guid>'

</code>