D2Api rozhranie predstavuje základný komunikačný kanál so systémom D2000 pre webové aplikácie. Toto komunikačné rozhranie je na strane klienta implementované v JavaScript-e a je postavené na knižnici CometD.
Nadviazanie a rozpojenie spojenia s D2000
Nadviazanie spojenia s D2000 sa realizuje vytvorením inštancie triedy D2Api, ktorej sa odovzdá konfigurácia pre CometD a následným zavolaním metódy connect. Voliteľne je možné definovať obsluhu chybových stavov metódou registerErrorHandler - v rámci Smart Web Frameworku je pre tento účel dodávaná funkcia reportError.
let cometdConfiguration = { url: "/smartWeb/api/cometd", logLevel: '', } let d2Api = new D2Api(cometdConfiguration); d2Api.registerErrorHandler(reportError); d2Api.connect();
Na rozpojenie spojenia s D2000 slúži metóda disconnect.
d2Api.disconnect();
Počúvanie na zmeny hodnôt objektov D2000
d2Api.subscribeObject
d2Api.unSubscribeObject
Načítanie hodnôt archívnych objektov D2000
d2Api.loadArchive
d2Api.loadArchives
Volanie D2000 RPC
d2Api.rpc
d2Api.rpcJava
d2Api.rpcSBA
Volanie JavaScript funkcií z D2000
d2Api.subscribeRpc
d2Api.unSubscribeRpc
Zmena hesla prihláseného užívateľa
Rozhranie D2Api umožňuje taktiež zmeniť heslo prihláseného užívateľa. Slúži na to metóda changePassword, ktorá má dva parametre - staré heslo a nové heslo a vracia Promise objekt.
let oldPassword = 'secret'; let newPassword = 's3Cr3t*'; d2Api.changePassword(oldPassword, newPassword). .then(onFulfilled => { if (onFulfilled.data === 'ok') { // password changed } });