Fast Query – Manual de Usuario

WEBGATE400 ACTIVEX CONTROL Manual de Usuario

1

Fast Query – Manual de Usuario

SUMARIO Webgate400 ActiveX Control ...................................................................................................... 3 1 A QUIÉN SE DIRIGE ............................................................................................................. 3 2 REQUISITOS PREVIOS ........................................................................................................ 3 3 INTRODUCCIÓN ................................................................................................................... 3 3.1

Requisitos de sistema ............................................................................................................................... 3

3.2

Distribución de aplicaciones ....................................................................................................................... 3

4

GUÍA PARA EL PROGRAMADOR ............................................................................................ 5 4.1

Modalidad de ejecución y aspecto gráfico .................................................................................................... 5

4.2

Identificadores de registro......................................................................................................................... 6

4.3

Interfaz de programación .......................................................................................................................... 6

4.3.1

4.4

2

Métodos disponibles ............................................................................................................................ 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

Insertar Webgate400 ActiveX Control en una página HTML............................................................................ 8

Fast Query – Manual de Usuario

WEBGATE400 ACTIVEX CONTROL Bienvenido a la guía de uso de Webgate400 ActiveX Control, el Rich-Client Http para la ejecución de programas IBM PowerI en un único Control ActiveX. Webgate400 ActiveX Control permite crear y ejecutar aplicaciones IBM PowerI escritas por medio del compilador Webgate400 R8.0, en un ambiente gráfico y distribuido, introduciendo funciones para el acceso a datos y aplicaciones de gestión en ambiente Web a través de páginas HTML y/o en programas escritos para el sistema operativo Windows, utilizando sistemas de programación orientada a objetos como Visual C++, C#, VbScript, JavaScript.

1 A QUIÉN SE DIRIGE Programadores Web, diseñadores de sistemas distribuidos.

2 REQUISITOS PREVIOS Conocimiento en las áreas de sistemas de programación Web, Html. Conceptos básicos de OLE. Conocimiento en las áreas de objetos de programación ActiveX. Lenguajes de programación a objetos Visual C++, C#, VbScript, JavaScript. Conocimiento en las áreas de los sistemas IBM PowerI.

3 INTRODUCCIÓN 3.1 Requisitos de sistema Webgate400 ActiveX Control requiere para la ejecución uno de los siguientes sistemas operativos: 

Windows 7



Windows 8



Windows Server 2008



Windows Server 2012

Webgate400 ActiveX soporta uno de los siguientes sistemas de desarrollo: 

Microsoft Visual C++



Microsoft C#



Microsoft Visual Basic



Microsoft Internet Explorer 9.0 o superior

Webgate400 ActiveX es distribuido a través de las fases de desarrollo (release) R8.0 del producto PowerI Webgate400.

3.2 Distribución de aplicaciones Si vas a creas una aplicación que usa Webgate400 ActiveX Control, tienes que incluir también la instalación del mismo paquete de distribución de tu aplicación. Para instalar Webgate ActiveX Control será suficiente ejecutar WG400ActiveXSilentSetup.exe. Encuentras este archivo en el directorio de distribución /webgate400/applet/DownloadV8/bin de tu PowerI, presente después de la instalación de las fases de desarrollo de Webgate400 R8.0. La ejecución del paquete de instalación requiere derechos de administrador por parte del usuario que lo utiliza. No se necesitan derechos de administrador para el usuario final de las aplicaciones. En sistemas operativos donde se activa User Account Control, un mensaje, parecido a este de abajo, advierte del proceso de instalación.

3

Fast Query – Manual de Usuario

Tienes que contestar Sí para continuar y proveer las credenciales de administrador (cuando son requeridas). User Account Control certifica el distribuidor del software Webgate Italia Srl. Se puede instalar Webgate400 ActiveX Control donde hay una instalación completa del cliente Webgate400, a menudo referido como applet, desde el menú 'Help', situado en la parte alta y a la derecha de la ribbon bar (barra de cintas).

4

Fast Query – Manual de Usuario

4 GUÍA PARA EL PROGRAMADOR Webgate400 ActiveX Control muestra su propria interfaz de programación al sistema en el que ha sido instalado, según el estándar de la familia de componentes OLE. Una aplicación que puede contener un objeto ActiveX se llama “container” (contenedor). Los sistemas de desarrollo en venta para Windows hacen posible, a través de automatismos propios, la inclusión y el uso en el interior de sus propias aplicaciones de objetos ActiveX, incluyendolo de manera totalmente dinámica, como por ejemplo Internet Explorer, o parcialmente dinámica creando un código fuente adecuado a la gestión interior del mismo control.

4.1 Modalidad de ejecución y aspecto gráfico En el momento de la activación aparece una imagen neutra del logotipo de release.

Ejemplo de uso en página HTML

Una vez activado, Webgate400 ActiveX Control hace disponible para los programadores de aplicaciones PowerI, la parte central del cliente Webgate400, en la que habitualmente ocurre la interacción entre usuario y aplicación PowerI, excluyendo la parte ocupada generalmente por la Ribbon Bar y todos los paneles corredizos disponibles normalmente . Por lo tanto teclas funciones, opciones subarchivo, command services no serán visibles en pantalla. Las teclas funciones siguen siendo disponibles a través del teclado, pero obviamente el usuario no puede disponer del mnemónico de la función requerida. Por lo tanto las funciones planeadas para ser utilizadas, ahora tienen que responder a criterios ergonómicos típicos de las aplicaciones Windows, incluyendo en el área de trabajo todo lo que necesita el usuario para poder usar todas las potencialidades que la aplicación en ejecución puede ofrecer.

Ejemplo de uso en página HTML

Como en el ejemplo, el uso de teclas función tiene que ser reconducido a la presencia de pulsantes en el espacio ocupado por la aplicación en ejecución. 5

Fast Query – Manual de Usuario

4.2 Identificadores de registro CLSID

A237EC79-4B4E-43EE-99BF-9777C131E936

OBJNAME

WG400ACTIVEX.WG400ActiveXCtrl.1

4.3 Interfaz de programación La interfaz de programación de Webgate400 ActiveX Control es esencial y reducida al mínimo indispensable por lo que concierne los métodos disponibles para el programador.

4.3.1 Métodos disponibles 4.3.1.1

SetConnectionData

Sintaxis

Webgate400ActiveXControl.SetConnectionData hostname username password usessl

Descripción

Se usa para definir las credenciales de acceso al sistema. Datos necesarios son: 

nombre del host de conexión, que también se puede encontrar como dirección ip dotada de puerto de conexión (Ej. 66.125.97.32:4405).



Nombre del usuario acreditado



contraseña, según las normas del PowerI de referencia



Uso conexión SSL (facultativo)

Valor de retorno

Void

Tipos de datos

hostname

String

username

String

password

String

Javascript Ejemplo

usessl Boolean 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"); var wgc = wga.object; wgc.SetConnectionData(hostname, user, password, 0); ... }

6

Fast Query – Manual de Usuario

4.3.1.2

Login

Sintaxis

Webgate400ActiveXControl.Login

Descripción

Se usa para iniciar una sesión de comunicación válida con el PowerI de referencia. Usa datos de conexión definidos por la SetConnectionData. Devuelve un resultado de tipo verdadero/ falso.

Valor de retorno

Boolean

Tipos de datos

Void

Javascript Ejemplo

function Login() { var wgc = wga.object; var bloggedon = wgc.Login(); if (bloggenon = 0) alert("Login Failed"); }

4.3.1.3

Logout

Sintaxis

Webgate400ActiveXControl.Logout

Descripción

Se usa para cerrar una sesión de conexión activa. Se necesita si hay conexiones en sistemas diferentes en el ámbito de la sesión de trabajo.

Valor de retorno

Void

Tipos de datos

Void

Javascript



Ejemplo

function Logout() { var wgc = wga.object; wgc.Logout(); }

4.3.1.4

StartJob

Sintaxis

Webgate400ActiveXControl.StartJob poweriCommandLine

Descripción

Permite iniciar una aplicación en el PowerI de referencia. La línea de comando tiene que ser una línea de comando válida para el sistema PowerI en el formato CALL PGM(...) o bien en el formato de command MYCOMMAND PAR1(...) PAR2(...). Devuelve un resultado de tipo verdadero/falso. Falla si no se efectua una acción anterior de Login y/o si un job, iniciado precedentemente, resulta activo todavía.

Valor de retorno

Boolean

Tipos de datos

poweriCommandLine

Javascript



Ejemplo

String

function StartApplication(command) { var wga = document.getElementById("WG_AX_1"); var wgc = wga.object; var bAppStarted = wgc.StartJob(command); if (bAppStarted = 0) alert("Failed to start application"); }

7

Fast Query – Manual de Usuario

4.3.1.5

IsJobActive

Sintaxis

Webgate400ActiveXControl.IsJobActive

Descripción

Permite comprobar si en el interior del control activex ya está activada una sesión de trabajo.

Valor de retorno

Boolean

Tipos de datos

Void

Javascript



Ejemplo

function IsJobActive() { var wga = document.getElementById("WG_AX_1"); var wgc = wga.object; var bAppStarted = wgc.IsJobActive(); if (bAppStarted = 0) alert("An application is already active in Webgate400 ActiveX Control"); }

4.4 Insertar Webgate400 ActiveX Control en una página HTML Para insertar Webgate400 ActiveX Control en una página HTML, es suficiente prever un tag OBJECT y definir las características del objeto. Será fundamental el CLASSID para la identificación del objeto en el sistema. En el caso de que el objeto no resulte instalado se puede indicar, a través de la propriedad CODBASE, el sitio web desde el cual puedes descargar el autoinstalable predispuesto de oportuna manera.

8