WEBGATE400 ACTIVEX CONTROL Manual de Usuario

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
<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");
var wgc = wga.object;
wgc.SetConnectionData(hostname, user, password, 0);
...
}
</script>
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
<script>
function Login() {
var wgc = wga.object;
var bloggedon = wgc.Login();
if (bloggenon = 0)
alert("Login Failed");
}
</script>
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
<script>
Ejemplo
function Logout() {
var wgc = wga.object;
wgc.Logout();
}
</script>
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
<script>
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
</script>
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
<script>
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");
}
</script>
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.
<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>
8