D2000 OBJApi - Základné časti užívateľského klient procesu

Inicializácia komunikácie
Obsluha správy NewObjectValue
Obsluha správy NewDefinition
Výkonná časť
Ukončenie komunikácie

Inicializácia komunikácie

Pred volaním akejkoľvek funkcie z D2000 ObjApi je potrebné najskôr volať inicializačnú funkciu - ConnectKernel, ktorá zabezpečí nadviazanie komunikácie s procesom D2000 Server. Po volaní funkcie ConnectKernel logicky nasleduje volanie funkcie SendChildren, ktoré zabezpečí prijatie definícií potomkov užívateľského procesu.

Obsluha správy NewObjectValue

Pri nadviazaní spojenia s procesom D2000 Server definujeme parametrom funkcie ConnectKernel obslužnú procedúru, ktorá bude prijímať asynchrónne správy o zmene hodnoty alebo stavu objektu. Správy signalizujúce zmenu objektu budú posielané pre každý objekt, ktorý bol otvorený volaním funkcie OpenObject a pre všetkých potomkov procesu.

Obsluha správy NewDefinition

Po nadviazaní spojenia s procesom D2000 Server je možné požiadať o definíciu potomkov užívateľského procesu volaním funkcie SendChildren. Pri volaní tejto funkcie definujeme obslužnú procedúru, ktorá bude prijímať konfiguračné správy NewDefinition.

Výkonná časť

Vo výkonnej časti môžeme volať funkcie rozhrania D2000 ObjApi slúžiace na:

• otvorenie a zatvorenie objektu. Pre otvorený objekt sú posielané správy NewObjectValue o zmene jeho hodnoty alebo stavu,
• získanie aktuálnej hodnoty objektu,
• nastavenie hodnoty objektu,
• získanie údajov z archívnej databázy,
• získanie údajov z monitorovacej databázy (zatiaľ nepodporené),
• získanie zoznamu objektov daného typu, všetkých objektov, alebo objektov, ktorých názov vyhovuje zadanej maske.

Ukončenie komunikácie

Pred ukončením činnosti užívateľského procesu je potrebné korektne ukončiť komunikáciu s procesom D2000 Server volaním funkcie LogoffProc. Automatické znovu spustenie (Autoštart) užívateľského procesu je prevedené len ak sú splnené súčasne nasledujúce podmienky:

• v čase ukončenia užívateľského procesu bolo nadviazané spojenie s procesom D2000 Server a nebolo korektne ukončené volaním LogoffProc,
• proces D2000 Server beží na tom istom počítači ako užívateľský proces,
• vlastný spustiteľný súbor užívateľského procesu je uložený v podadresári Bin programového adresára, kde sú uložené spustiteľné súbory systému D2000,
• proces nesmie byť konfigurovaný ako „service“ parametrom /X, je vždy spúšťaný ako bežný proces komunikujúci s užívateľom.