Configuración del wrapper
La estructura del archivo de configuración ha cambiado y ahora se proporciona un formato genérico para todas los dispositivos móviles soportados. El archivo config.xml contiene la dirección URL de la página con el “remote-form” JavaScript y dependiendo de la plataforma, podrá contener un número variable de otros parámetros (esto se describe en la nota técnica correspondiente). El config.xml está basado en la siguiente estructura:
≤? Xml version="1.0" encoding="UTF-8"≥
≤settings≥
≤apptitle≥0≤/apptitle≥
≤menuincludesettings≥1≤/menuincludesettings≥
≤menuincludeoffline≥1≤/menuincludeoffline≥
≤menuincludeabout≥1≤/menuincludeabout≥
≤settingsfloatcontrols≥0≤/settingsfloatcontrols≥
≤settingsscaleform≥1≤/settingsscaleform≥
≤settingsallowhscroll≥0≤/settingsallowhscroll≥
≤settingsallowvscroll≥0≤/settingsallowvscroll≥
≤settingsmaintainaspectratio≥0≤/settingsmaintainaspectratio≥
≤settingsonlinemode≥1≤/settingsonlinemode≥
≤serveromnisweburl≥http://172.19.250.25:5911≤/serveromnisweburl≥
≤serveronlineformname≥/jschtml/RFonline≤/serveronlineformname≥
≤serveromnisserver≥≤/serveromnisserver≥
≤serveromnisplugin≥≤/serveromnisplugin≥
≤serverofflineformname>rfOffline≤/serverofflineformname≥
≤serverappscafname≥mylib≤/serverappscafname≥
≤testmodeenabled≥0≤/testmodeenabled≥
≤testmodeserverandport≥172.19.250.25:5911≤/testmodeserverandport≥
≤/settings≥
El config.xml contiene las siguientes propiedades estándar:
- AppTitle
La aplicación mostrará una barra de título en la parte superior.
- MenuIncludeSettings
La opción de menú “Ajustes” estará disponible en tiempo de ejecución.
- MenuIncludeOffline
La opción de menú para cambiar al modo “off-line”, estará disponible en tiempo de ejecución.
- MenuIncludeAbout
La opción de menú “Acerca de” estará disponible en tiempo de ejecución.
- SettingsFloatControls
Esta propiedad sólo es significativa cuando SettingsScaleForm es "0" (falso). En este caso, el cliente hará uso de la nueva propiedad $screensizefloat presente en cada control de los “remote-forms” jsClient. Al aplicar el tamaño de la pantalla, el cliente hará uso de $screensizefloat para hacer flotar los bordes de los controles, usando para ello las mismas reglas definidas para los $edgefloat (tenga en cuenta que son los valores del componente los que están soportados, sino sólo los valores relacionados con sus bordes). Si el “form” es más ancho o más alto que la pantalla, la flotación se produce sólo si los parámetros SettingsAllowHScroll o SettingsAllowVScroll están en estado falso. El modo en que los controles floten dependerá de la diferencia entre el ancho o la altura de la pantalla actual y el ancho o la altura diseñada en el “remote-form” y siempre según el valor más próximo al de su propiedad $screensize. El valor de $screensizefloat es guardado tras cada ajuste del $screensize del “remote-form”.
- SettingsScaleForm
Si se ajusta a "1" (true), el cliente escalará el “form” hasta ajustarse al espacio de pantalla disponible. El factor de escala es el ancho de la pantalla o su altura dividido por la anchura o altura del valor más cercano a $screensize. Se usa, el tamaño real de la pantalla, el cual incluyen las áreas reservadas al sistema operativo, tales como la barra de estado.
- SettingsAllowHScroll y SettingsAllowVScroll
Deberá fijar sus valores a "1" si desea permitir el desplazamiento horizontal o vertical del “form” respectivamente, o "0" en caso contrario.
- SettingsMaintainAspectRatio
Si se ajusta a "1", el escalado mantiene la relación de aspecto del “form”. Si está activado y en función del estado de SettingsAllowHScroll y SettingsAllowVScroll, será posible reducir el factor de escala en una dirección específica, con el fin de ajustar el “form” y su centrado vertical u horizontal según se requiera.
- SettingsOnlineMode
La aplicación se iniciará en modo “On-line”.
- ServerOmnisWebUrl
URL del servidor Omnis o del Servidor Web. Si utiliza un servidor de Omnis debería ser http://: . Si utiliza un servidor web deberá ser la URL raíz de su servidor Web, http://miservidor.com.
ServerOnlineFormName
Ruta del “form” en el fichero .htm del ServerOmnisWebUrl. De modo que si usted está testando una aplicación en construcción sobre un servidor de aplicaciones Omnis, será de la forma /jschtml/miform.htm, pero si está utilizando un servidor web, la URL tendrá la forma /omnisapps/miform. (¡Sin añadir la extensión .htm!)
De modo que las propiedades ServerOmnisWebUrl y ServerOnlineFormName son sólo necesarias para “forms” usados en modo “on-line”. El resto de propiedades son sólo para el modo “off-line”.
ServerOmnisServer
Servidor Omnis ≤Dirección IP≥:≤Puerto≥.
ServerOmnisPlugin
Si se está utilizando un servidor web con plug-in para conectar con Omnis, será la ruta a añadida desde el raíz ServerOmnisWebUrl. Por ejemplo: /cgi-bin/omnisapi.dll
ServerOfflineFormName
Nombre del formulario “on-line”. (¡No añada .htm!)
ServerAppScafName
Nombre de la aplicación SCAF. Será el mismo nombre que tiene la librería.
TestModeEnabled
Permite activar el modo de pruebas (Pulsando Ctrl-M se permitirá testar el “form” sobre el dispositivo remoto)
TestModeServerAndPort
Dirección ≤ipaddress≥:≤puerto≥, si se desea hacer uso del modo test mediante Omnis Studio Developer.
También es posible modificar estos parámetros pulsando el botón de menú en el dispositivo móvil y activando las opciones de cambio. La aplicación recuerda el último ajuste realizado a través del menú, por lo que la configuración suministrada mediante el fichero config.xml sólo servirá para suministrar los valores iniciales del wrapper.