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
        }
    });