jsClient: Cofiguración del wrapper JavaScript

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.