Prijelaz na novi API

S verzijom 2026.04. prelazimo na novo Web API sučelje. Postojeći Saop Web API temeljen na tehnologiji .NET Framework 4.8.1, zamijeniti ćemo modernijim sučeljem ASP.NET Core Web API.

Postojeće metode nastaviti će funkcionirati na starom (postojećem) API-ju, dok će se nove metode razvijati isključivo na novom ASP.NET Core Web API-ju.

Ukoliko imate uspostavljene integracije s vanjskim sustavima putem našeg Web API-ja biti će ih potrebno prilagoditi novom sučelju ASP.NET Core Web API-ja u skladu s niže navedenim uputama.

Upute su namijenjene IT stručnjacima ili administratorima servera, a svi se postupci provode na serveru ili glavnom računalu.

Prijelaz će biti moguć nakon instalacije verzije 2026.04.100 koja će biti dostupna 20.10.2026.

Ako slijedite upute u nastavku, neće biti potrebna intervencija integratora jer će URL adresa integratora ostati nepromijenjena.

Konfiguracija datoteke appsettings.json

Otvorimo sljedeću mapu na serveru … \saop2005\icenter\iCenterWeb\iCenterApiCore\ (putanja se razlikuje).

Možete koristiti prečac na radnoj površini, ako ga imate. Kliknite desnom tipkom miša na prečac, a zatim odaberite Open File Location.

Otvoriti će se mapa icenter, iz koje otvorite iCenterWeb\iCenterApiCore.

U mapi iCenterWeb\iCenterApiCore preimenujte datoteku _appsettings.json u appsettings.json

Datoteku appsettings.json otvorite u notepadu i uredite sljedeće:

IcenterConfigDat = putanja do saopsfbaze.dat (primer niže)
IcenterDefaultCatalogId = ime sf baze(, koja je također navedena unutar saopsfbaze.dat)
LogFilePath = putanja do log mape gdje se spremaju greške (nije potrebno ručno otvarati mape na disku, mapa se kreira sama)

Instalacija ASP.NET Core Runtime

Zatim je potrebno instalirati ASP.NET, koji se može preuzeti na poveznici: Download ASP.NET Core 10.0 Runtime (v10.0.9) - Windows Hosting Bundle Installer

Instalacija IIS (Internet Information Services)

Pokrenite IIS (Internet Information Services). U Windows pretraživanje upišete IIS i odaberete označeno na slici.

Pod Sites odaberete API klikom na strelicu prema dolje, a zatim odaberite iCenterApi i Basic Settings...

Okno Basic Settings v IIS

Otvara se prozor, u kojem pod Physical Path je potrebno popraviti putanju na mapu iCenterApiCore (trenutno je iCenterApi, možete samo dopisati Core). U ovom koraku zapamtite ime Application Pool-a jer ćete ga trebati u sljedećem koraku.