WEBGATE400 ACTIVEX CONTROL Manuale Programmatore Pagina 1
SOMMARIO Webgate400 ActiveX Control... 3 1 A Chi è destinato... 3 2 Pre requisiti... 3 3 Introduzione... 3 3.1 Requisiti di sistema... 3 3.2 Distribuzione di applicazioni... 3 4 Guida al programmatore... 5 4.1 Modalità di esecuzione e aspetto grafico... 5 4.2 Identificatori di registrazione... 6 4.3 Interfaccia di programmazione... 6 4.3.1 Metodi disponibili... 6 4.3.1.1 SetConnectionData... 6 4.3.1.2 Login... 7 4.3.1.3 Logout... 7 4.3.1.4 StartJob... 7 4.3.1.5 IsJobActive... 8 4.4 Inserire Webgate400 ActiveX Control in una pagina HTML... 8 Pagina 2
WEBGATE400 ACTIVEX CONTROL Benvenuti alla guida all'uso di Webgate400 ActiveX Control, il Rich-Client Http per l'esecuzione di programmi IBM PowerI in un unico Controllo ActiveX. Usando Webgate400 ActiveX Control, potrete creare ed eseguire applicazioni IBM PowerI scritte utilizzando il compilatore Webgate400 R8.0, in un ambiente grafico e distribuito inserendo funzionalità per l'accesso a dati ed applicazioni gestionali in ambienti Web attraverso pagine HTML e/o in programmi scritti per il sistema operativo Windows utilizzando sistemi di programmazione orientati agli oggetti come Visual C++, C#, VbScript, JavaScript. 1 A CHI È DESTINATO Programmatori Web, progettisti di sistemi distribuiti. 2 PRE REQUISITI Conoscenza concettuale di sistemi di programmazione Web, Html. Concetti base di OLE. Conoscenza concettuale di oggetti di programmazione ActiveX. Linguaggi orientati agli oggetti Visual C++, C#, VbScript, JavaScript. Conoscenza concettuale di sistemi IBM PowerI. 3 INTRODUZIONE 3.1 Requisiti di sistema Webgate400 ActiveX Control richiede per l'esecuzione uno dei seguenti sistemi operativi: Windows 7 Windows 8 Windows Server 2008 Windows Server 2012 Webgate400 ActiveX supporta uno dei seguenti sistemi di sviluppo: Microsoft Visual C++ Microsoft C# Microsoft Visual Basic Microsoft Internet Explorer 9.0 o superiore Webgate400 ActiveX viene distribuito con il rilascio R8.0 del prodotto PowerI Webgate400. 3.2 Distribuzione di applicazioni Se create un'applicazione che utilizza Webgate400 ActiveX Control, occorre includere l'installazione dello stesso nel pacchetto di distribuzione della vostra applicazione. Per installare Webgate400 ActiveX Control è sufficiente eseguire WG400ActiveXSilentSetup.exe. Trovate questo file nella directory di distribuzione /webgate400/applet/downloadv8/bin del vostro PowerI, presente dopo l'installazione del rilascio di Webgate400 R8.0. L'esecuzione del pacchetto di installazione richiede diritti di amministratore da parte dell'utente utilizzatore. Non è necessario avere diritti di amministratore per l'utente finale delle applicazioni. Pagina 3
Sui sistemi operativi dove attivo lo User Account Control un messaggio simile a questo avvisa dell'avvio di una procedura di installazione. Rispondere Sì per continuare e fornire le credenziali di amministratore ove richieste. Lo User Account Control certifica il distributore del software Webgate Italia Srl. E' possibile installare Webgate400 ActiveX Control dove presente un'installazione completa del client Webgate400, spesso riferito come applet, dal menu 'Help', posto in alto a destra della ribbon bar. Pagina 4
4 GUIDA AL PROGRAMMATORE Webgate400 ActiveX Control espone al sistema su cui è installato la propria interfaccia di programmazione secondo lo standard della famiglia dei componenti OLE. Un'applicazione in grado di contenere un oggetto ActiveX si definisce container. I sistemi di sviluppo in commercio per Windows rendono possibili, attraverso automatismi propri, l'inclusione e l'uso all'interno delle proprie applicazioni di oggetti ActiveX, includendolo in modo interamente dinamico, come per esempio Internet Explorer, o parzialmente dinamico creando codice sorgente adatto alla gestione interna del controllo stesso. 4.1 Modalità di esecuzione e aspetto grafico All'atto dell'attivazione mostra un'immagine neutra del logo di release. Esempio di uso in pagina HTML Una volta in esecuzione Webgate400 ActiveX Control rende di fatto disponibile al programmatore di applicazioni PowerI, la parte centrale del client Webgate400, in cui normalmente avviene l'interazione tra l'utente e l'applicazione PowerI, escludendo alla vista e all'operatività la parte occupata normalmente dalla Ribbon Bar e tutti i pannelli scorrevoli disponibili normalmente. Non sono quindi disponibili dal punto di vista della presenza a video i Tasti Funzione, le opzioni subfile, i command service. I tasti funzione continuano ad essere disponibili attraverso l'uso della tastiera, ma ovviamento l'utente non ha a disposizione lo mnemonico della funzione richiesta. Ne deriva che le applicazioni progettate per l'utilizzo in questo assetto debbano rispondere a criteri ergonomici tipici delle applicazioni Windows includendo nell'area di lavoro tutto il necessario affinchè l'utente possa usare tutte le potenzialità offerte dell'applicazione in esecuzione. Esempio di uso in pagina HTML Pagina 5
Come nell'esempio, l'uso dei tasti funzione deve essere ricondotto alla presenza di pulsanti all'interno dello spazio occupato dall'applicazione in esecuzione. 4.2 Identificatori di registrazione CLSID OBJNAME A237EC79-4B4E-43EE-99BF-9777C131E936 WG400ACTIVEX.WG400ActiveXCtrl.1 4.3 Interfaccia di programmazione L'interfaccia di programmazione di Webgate400 ActiveX Control è essenziale e ridotta allo stretto indipensabile nei metodi disponibili al programmatore. 4.3.1 Metodi disponibili 4.3.1.1 SetConnectionData Webgate400ActiveXControl.SetConnectionData hostname username password usessl Si utilizza per impostare le credenziali di accesso al sistema. I dati necessari sono: nome dell'host di collegamento che può essere anche nella forma di indirizzo ip corredato della porta di connessione (Es. 66.125.97.32:4405). Il nome dell'utente accreditato Password, secondo le regole del PowerI di riferimento Utilizzo connessione SSL (facoltativo) Return Value Data types Javascript hostname String username String password String usessl Boolean <script> function SetConnectionParameters() { var hostname = document.getelementbyid("hostname").value; var user = document.getelementbyid("user").value; var password = document.getelementbyid("password").value; var wga = document.getelementbyid("wg_ax_1"); wgc.setconnectiondata(hostname, user, password, 0);... Pagina 6
4.3.1.2 Login Webgate400ActiveXControl.Login Si utilizza aprire una sessione di comunicazione valida con il PowerI di riferimento. Utilizza i dati di collegamento impostati dalla SetConnectionData. Restituisce un esito di tipo vero/falso. Return Value Data types Javascript Boolean <script> function Login() { var bloggedon = wgc.login(); if (bloggenon = 0) alert("login Failed"); 4.3.1.3 Logout Webgate400ActiveXControl.Logout Si utilizza per chiudere una sessione di connessione attiva. Necessaria in caso di connessioni su sistemi diversi nell'ambito della sessione di lavoro. Return Value Data types Javascript <script> function Logout() { wgc.logout(); 4.3.1.4 StartJob Webgate400ActiveXControl.StartJob powericommandline Consente di avviare una applicazione sul PowerI di riferimento. La riga di comando deve essere una riga di comando valida per il sistema PowerI nella forma CALL PGM(...) oppure nella forma di command MYCOMMAND PAR1(...) PAR2(...). Restituisce un esito di tipo vero/falso. Fallisce se non è stata effettuata una precedente azione di Login e/o se un job avviato in precedenza risulta ancora attivo. Return Value Boolean Data types powericommandline String Javascript <script> function StartApplication(command) { var wga = document.getelementbyid("wg_ax_1"); var bappstarted = wgc.startjob(command); if (bappstarted = 0) alert("failed to start application"); Pagina 7
4.3.1.5 IsJobActive Webgate400ActiveXControl.IsJobActive Consente di verificare se all'interno del controllo activex sia già attiva una sessione di lavoro. Return Value Data types Javascript Boolean <script> function IsJobActive() { var wga = document.getelementbyid("wg_ax_1"); var bappstarted = wgc.isjobactive(); if (bappstarted = 0) alert("an application is already active in Webgate400 ActiveX Control"); 4.4 Inserire Webgate400 ActiveX Control in una pagina HTML Per inserire Webgate400 ActiveX Control in una pagina HTML, è sufficiente prevedere un tag OBJECT e definire le caratteristiche dell'oggetto. Fondamentale il CLASSID per l'identificazione nel sistema dell'oggetto. Nel caso l'oggetto non risulti installato è possibile indicare con la proprietà CODBASE il sito da cui scaricare l'autoinstallante opportunamente predisposto. <center> <OBJECT ID="WG_AX_1" CLASSID="clsid:A237EC79-4B4E-43EE-99BF-9777C131E936" WIDTH="960" HEIGHT="600" STYLE="border: 1px solid #404040;" CODEBASE="http:// xx.xx.xx.xx:4400/webgate400/applet/downloadv8/wg400activexisilentsetup.exe"> </OBJECT> </center> Pagina 8