Z verzijo 2026.04. prehajamo na novi vmesnik Web API. Obstoječi Saop Web API, ki temelji na tehnologiji .NET Framework 4.8.1, bomo nadomestili s sodobnejšim vmesnikom ASP.NET Core Web API.

Stare metode bodo še naprej delovale na starem (obstoječem) API-ju, nove metode pa se bodo razvijale izključno na novem ASP.NET Core Web API-ju.

Če imate vzpostavljene integracije z zunanjimi sistemi prek našega Web API-ja, jih bo treba prilagoditi novemu vmesniku ASP.NET Core Web API po spodnjih navodilih. Navodila so namenjena informatikom oz. skrbnikom strežnika, vse pa se izvaja na strežniku oz. glavnem računalniku.

Prehod bo mogoč po namestitvi nove verzije programske opreme Saop, predvidoma po 20. 10. 2026, ko bo na voljo verzija 2026.04.100.

Če boste sledili spodnjim navodilom, s strani integratorja ne bo potreben noben poseg, saj bo URL naslov za integratorja ostal nespremenjen.

Konfiguracija datoteke appsettings.json

1.    Odpremo sledečo mapo na strežniku …\saop2005\icenter\iCenterWeb\iCenterApiCore\ (pot se razlikuje).

Pomagamo si lahko z bližnjico na namizju, če jo imamo. Z desnim miškinim gumbom kliknemo na bližnjico in nato Open File Location.

Odprla se nam bo mapa icenter v kateri gremo v iCenterWeb\iCenterApiCore

V mapi iCenterApiCore preimenujemo datoteko _appsettings.json v appsettings.json

2.    Datoteko appsettings.json odpremo v notepadu in uredimo sledeče:

• IcenterConfigDat = pot do saopsfbaze.dat (primer spodaj)
• IcenterDefaultCatalogId = ime sf baze(, ki je navedena tudi znotraj saopsfbaze.dat)
• LogFilePath = pot do log mape, kjer se shranijo napake (ni potrebno ročno ustvarjati mape na disku, se sama ustvari)

Namestitev ASP.NET Core Runtime

Nato namestimo ASP.NET, ki ga dobimo na povezavi: Download ASP.NET Core 10.0 Runtime (v10.0.9) - Windows Hosting Bundle Installer

Nastavitev IIS (Internet Information Services)

1. Zaženemo IIS (Internet Information Services). V iskanje Windows vpišemo IIS in izberemo označeno na sliki.
2. Pod Sites izberemo naš API s klikom na puščico navzdol in nato iCenterApi in Basic Settings...


3. Odpre se nam okno, kjer pod Physical Path popravimo pot, da kaže na mapo iCenterApiCore (trenutno je iCenterApi, lahko samo dopišemo Core). Tu si še zapomnite ime Application Pool-a, ker ga boste potrebovali v naslednjem koraku.  
4. Nato pod Application Pools izberemo naš pool in kliknemo Advanced Settings...
   

   

5. V oknu, ki se nam odpre, spremenimo Enable 32-Bit Applications na False (sedaj je nastavljeno na True).

   

Zaključek - testiranje

Na koncu še testiramo, tako da pod Sites izberemo naš API in kliknemo Browse.

Odpre se nam privzeti brskalnik in vpišemo naše api podatke:

Se spustimo do zavihka Country in kliknemo Get:

Nato kliknemo Try it out.

In na koncu kliknemo Execute.

Če vse deluje pravilo bomo dobili seznam držav:

V kolikor boste pri prehodu potrebovali pomoč, lahko oddate zahtevek na Saop uporabniški portal za tehnično podporo.