19 diciembre 2016

Gráficas combinadas con Graph2

Una particularidad del componente Graph2, es la de poder trabajar con capas, lo cual nos permite (por ejemplo) combinar dos o más tipos de gráficas en una misma muestra de datos, tal y como se puede ver a continuación:

 

Sin embargo, la incorporación de sucesivas capas en una misma gráfica, (según se puede desprender tras una rápida lectura del manual para el componente Graph2) parece supeditado al uso del evento evPreLayout, por lo que (al menos en mi caso) se me escapaba el modo de componer éste tipo de gráficas cuando queremos usarlas en informes impresos y no para su representación en pantalla.

Hasta que una lectura más detenida del manual antes citado y en su página 39, me hizo tropezar con el párrafo que cito textualmente a continuación: "When using an object variable based on the Graph2 component you can use the $prelayout() method in the object to add layers"

De esto se desprende que cuando hacemos uso del componente Graph2 en su modo "no-visual", es decir asignado a una variable de tipo objeto, se lleva a cabo la invocación de un posible método $prelayout, desde donde poder añadir capas y cualesquiera otras alteraciones que deseemos sobre la gráfica en composición, como por ejemplo, cambiar el grosor predefinido para la líneas que componen la segunda y tercera capa.

Adjunto una librería que ilustra con detalle lo explicado en éste artículo. No he encontrado mucha información sobre esto en los foros de programación con Omnis Studio, por lo que creo que compartir ésta experiencia con vosotros puede resultar útil. Espero vuestros comentarios al respecto, saludos cordiales.



17 noviembre 2016

Omnis Studio 8 y la localización con jsClient

En ésta entrada nos ocuparemos de mencionar un cambio que se ha producido desde la versión 6.1 de Omnis y la localización a otros idiomas de los mensajes que de forma nativa puede recibir el usuario en su navegador, cuando desarrollamos aplicaciones con jsClient.

En versiones anteriores de Omnis Studio, hemos estado haciendo uso del fichero "Studio.stb", con éste propósito, pero desde la versión 6.1 en adelante ha dejado de ser operativo, en nuestros desarrollos para la Web, decir que para otros entornos todo sigue siendo igual.

Es decir, "Localization" y "StringTables" siguen funcionando como antes, pero para los mensajes que se envían desde de núcleo del cliente JavaScript, se necesita hacer otra cosa, decir que aparece parcialmente documentado en el manual "Omnis_WebDev.pdf", bajo el apartado "Localization for the JavaScript Client" en la página 187, pero desafortunadamente, resulta difícil de entender y la información es incompleta (Omnis Software a prometido corregir esto pronto).

En mi caso tropecé con ésta "falta de información" al tratar de localizar al castellano el mensaje que Omnis muestra sobre el navegador del usuario, cuando el tiempo de conexión a expirado, el mensaje en ingles dice: "You have been disconnected. Refresh or restart application to reconnect"

Centrándonos en la localización para éste texto, mostraremos las dos opciones de que disponemos para resolverlo:

1) Agregar las siguientes líneas al archivo HTM inicial (marcamos en rojo las líneas que ya existen en el fichero:

<!-- The following placeholder is replaced with either a script tag for the remote task string table or nothing when there is no remote task string table -->

jOmnisStrings.en = {"disconnected":"You have been disconnected. Refresh or restart application to reconnect" };
jOmnisStrings.es = {"disconnected":"Ha sido desconectado. Refresque el navegador o vuelva a cargar la aplicación para conectarse de nuevo" };

<title></title>
</head>
Sin embargo, esto puede resultar algo incómodo si son muchas los textos y el número de idiomas a traducir (Existen más de 30 textos de error), por lo que se recomienda hacer lo siguiente:

2) En la carpeta o directorio HTML del raiz de instalación Omnis, crear una nueva carpeta a la que denominaremos "strings" y agregar a ella un archivo denominado "Error_Strings.js" con el siguiente contenido:

jOmnisStrings.en = {"disconnected":"You have been disconnected. Refresh or restart application to reconnect"};
jOmnisStrings.es = {"disconnected":"Ha sido desconectado. Refresque el navegador o vuelva a cargar la aplicación para conectarse de nuevo.(es_es)"};

Ahora necesitaremos modificar el archivo HTML indicado en el punto 1 (o el jsctemp.htm) para que lea como sigue:

<!-- The following placeholder is replaced with either a script tag for the remote task string table or nothing when there is no remote task string table -->
<script type="text/javascript" src="strings/Error_Strings.js"></script>

<title></title>
</head>
Obviamente, tanto la nueva carpeta como el archivo htm modificado deberán ser llevados al Servidor Web.

13 julio 2016

Como convertir caracteres Apple MacRoman a Unicode

Aunque "raras", existen las ocasiones en que vamos a necesitar obtener el correspondiente carácter en formato unicode, partiendo de su codificación no-unicode. En mi caso la razón es que dispongo de una fuente de caracteres Mac OS X para representación de códigos de barras, en formato no-unicode y necesito usarla desde su correspondencia unicode.

Buscando en internet, encontré una tabla con las diferencias que se pueden encontrar entre sus códigos ascii y que extracto a continuación...

...como se puede observar existen diferencias entre la codificación Mac y Unicode, por ejemplo alcaracter ê le corresponde el código 144 (no-unicode) y el 234 en formato unicode.

La manera de obtener dicho carácter en su formato unicode, partiendo de su ascii 144, sería la siguiente...
Do byteset(lBin,0,144)
Do uniconv(kUniTypeNativeCharacters,lBin,kUniTypeCharacter,lChar,kFalse,lErrorText)
...donde lBin es una variable local de tipo binario, mientras que lChar y lErrorText son de tipo carácter. La ejecución de éste código de notación, almacenará en la variable lChar el caracter ê convertido a unicode.

30 marzo 2016

25 febrero 2016

Nuevas opciones del Device Control en Omnis Studio

La propiedad $action del "Device Control" es utilizada para acceder a las características hardware o servicios en un teléfono móvil, tales como hacer una llamada, pero (como ya sabemos) dicha propiedad sólo estaba disponible cuando la aplicación es ejecutada en modo autónomo o "sin-conexión".

Sin embargo la última versión de Omnis Studio, nos permite utilizar el correo electrónico, las llamadas telefónicas y los mensajes SMS (Email, Call y SMS) a modo de una aplicación que fuese ejecutada sobre un navegador y no bajo el "wrapper" o aplicación instalada, es decir que será el navegador instalado por defecto en el dispositivo quien ejecute la acción correspondiente, en lugar de nuestra aplicación. Dichas acciones se corresponden con las siguientes constantes de la propiedad $action: kJSDeviceActionSendEmail, kJSDeviceActionMakeCall, y kJSDeviceActionSendSms. Naturalmente el resto de acciones ya conocidas deberán seguir siendo ejecutadas desde dentro del "wrapper".

Cuando es el navegador quien ejecuta la acción de enviar un SMS, se enviará un único mensaje y para el número especificado bajo la propiedad $communicationaddress del "Device Control", el texto del mensaje deberá figurar bajo la propiedad $communicationdata. Consulte el manual "Creating Web & Mobile Apps" para obtener más información sobre cómo utilizar "Device Control" en la construcción de aplicaciones para dispositivos móviles.

Por cierto, me estoy planteando la posibilidad de traducir al castellano el manual al que hacemos referencia en el párrafo anterior ;-)

03 febrero 2016

Paso de parámetros por URL a una "Remote Task" (Antes y después de la 6.1)

Desde la versión 6.1 Omnis puede capturar para nosotros los parámetros adicionales incluidos en la URL de llamada a la página web, donde indicamos la carga del "remote form". Éstos parámetros se hacen disponibles directamente desde la variable de parámetro "row" del método $construct, ya conocido por todos nosotros. Su funcionamiento es el siguiente:

Suponiendo la siguiente URL: http://127.0.0.1:5988/jschtml/rfSetCurField.htm?x=y&a=b

La tecnología jsClient agregará los parámetros indicados en una columna adicional de la variable parámetro "row" denominada "URLparams". Los datos de la "URLparams" se encuentran codificados en formato JSON, en nuestro ejemplo, x = y & a = b, la cadena JSON resultante sería: {"x": "y", "a": "b"}. Pero no nos preocupemos, pues podemos hacer uso de la nueva función "OJSON" para convertir esto a formato "row", del siguiente modo:

Do OJSON.$jsontolistorrow(pRow.URLparams) Returns lRow

...donde "lRow" es una variable "row", tendremos que lRow.x='y' y lRow.a='b'.

Pero... y antes de la versión 6.1, ¿Cómo podríamos capturar los parámetros de la URL? ¿Sería posible hacerlo con JavaScrip? Pues la respuesta es, si.

Tan sólo deberemos incluir en la sección "head" de nuestra página web, la siguiente función:

<script>
     function gup( name ){
          var regexS = "[\\?&]"+name+"=([^&#]*)";
          var regex = new RegExp ( regexS );
          var tmpURL = window.location.href;
          var results = regex.exec( tmpURL );
               if( results == null )
                    return"";
               else
                   return results[1];
       }
<script>

Con esta función podemos obtener cualquiera de los parámetros incluidos en la URL, simplemente pasándole en su llamada a al misma, el nombre del parámetro a obtener, por ejemplo:

<script>
     var x=document.getElementById("omnisobject1");
     x.dataset.param1=gup('x');
     x.dataset.param2=gup('a’);
<script>

El ejemplo anterior, pasaría el valor 'y' a la columna "param1" y el valor 'b' a la columna "param2" de la variable parámetro "row", tan sólo deberemos tener en cuanta colocar éste ultimo script, detrás del div donde invocamos al "remote form".

NOTA: Si trabajamos con versiones de Onnis Studio anteriores a la 6, deberemos usar la notación x.attributes.param1.value=gup('x') en lugar de x.dataset.param1=gup('x').

27 enero 2016

Uso de las funciones strpbrk() y strspn()

Encuentro especialmente útil su uso para comprobar si los valores almacenados en una variable cumplen con un determinado patrón.

El formato de la primera función es strpbrk(cadena1,cadena2), ¿Qué hace?


Devuelve una subcadena de cadena1, desde el punto en que cualquiera de los caracteres de cadena2 sea localizado en cadena1. Si ninguno de los caracteres de cadena2 coincide con los de cadena1, la función nos devolverá una cadena vacía.

Veamos un ejemplo:

Supongamos que disponemos de un campo de entrada en el que sólo deseamos permitir el uso de letras no acentuadas, números y comas, es decir sin caracteres especiales. Un modo de impedirlo sería mediante el método siguiente:

On evKey
    If len(strpbrk(upp(pKey),'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789,'))=0&len(pKey)>0
        Quit event handler (Discard event)
    End If


Si pKey contiene (por ejemplo) el caracter #, la función strpbrk() anterior devolvería una cadena vacía, ya que el caracter # no está contenido la cadena: ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789,

El uso de "Quit event handler (Discard event)" anulará la introducción del caracter #. La comparación "len(pKey)>0" se ha añadido para evitar el uso de "SystemKey events" o dicho de otro modo, la generación de eventos del sistema mediante el teclado.

El formato de la segunda es strspn(cadena1,cadena2), ¿Qué hace?


Devuelve el índice del primer carácter de cadena1, no coincidente con los contenidos en cadena2. Si todos los caracteres son coincidentes, la función devolverá el valor correspondiente al "len(cadena1)+1", es decir la longitud de cadena1 más uno.

Si (por ejemplo) quisiéramos comprobar que todos los caracteres contenidos en una determinada cadena coincidan con los permitidos, podríamos usar lo siguiente:

If strspn(upp(NumeroDeTelefono),'0123456789() -/')>len(NumeroDeTelefono)
    ; Todos los caracteres de variable NumeroDeTelefono
    ; pertenecen o están contenidos en el grupo 0123456789() -/
End If


Suponiendo que NumeroDeTelefono="01\5551234", la función strspn() anterior devolvería '3', ya que el tercer carácter no está entre el grupo de los permitidos, pero si su valor fuera NumeroDeTelefono="01/5551234" la función strspn() devolvería '11', ya que su longitud es '10'.

20 enero 2016

Como abrir documentos en Mac OS y en Windows, desde Omnis.

Abrir documentos en Mac OS.


Calculate applescript as con('property target_URL : "', lvpath,'"',kCr,'open location target_URL')
Do method $doApplescript (applescript,results) Returns #F


Si lvpath es 'file://pathtofile') --≥ abre un archivo
Si lvpath es 'http://www.myurl.org/path.html' --≥ abre el navegador
Si lvpath es 'mailto:name@email.com'  --≥ abre el cliente e-mail
Si lvpath es 'feed:rssfeed path'  --≥ abre el lector de rss

Abrir documentos en Windows.


Calculate lvPath as 'C:\Users\Tom\Downloads\demo\demo.html'
Register DLL ("SHELL32.DLL","ShellExecuteW","JJCCCCJ")
Call DLL ("SHELL32.DLL","ShellExecuteW",0,"open",lvPath,"","",0) Returns lvHandle



13 enero 2016

Tabla de componentes externos

Bajo el directorio "xcomp" del raíz de instalación Omnis, podemos observar una larga lista de al menos 120 componentes, pero... ¿Donde pueden usarse y con qué propósito?

A continuación os dejo una tabla que he confeccionado, donde indico, donde puede ser usado un determinado componente y cual es su propósito, para conocer detalles específicos sobre su uso les recomiendo que utilicen el "Interface Manager".


NOMBRE

NO-VISUALES

VENTANAS

INFORMES

WEB

IOS

USO

Accordion Library



X







Presenta una lista de opciones hipervínculo, que se expandne para mostrar más información.

AMAZONDAM

X









Acceso base de datos AMAZON.

BlowFish Library

X









Permite cifrar y descifrar contraseñas.

Calendar Library



X

X





Presenta el mes en curso y la fecha de actual, en un formato de calendario estándar.

Clock Library



X







Permite visualizar la hora actual, teniendo en cuenta la zona horaria actual del cliente.

Cool DropList Library



X







Permite listas desplegable de iconos, estilos de líneas, y otros.

Document Viewer Library



X

X





Visor de documentos Omnis

FadePict Library



X







Permite aplicar un efecto de fundido a una imagen mientras se carga, dispone de más de 30 estilos diferentes.

FileList Library



X







Pueden mostrar el contenido de una carpeta, ya sea en un formato de lista estándar o como una lista desplegable

FileOps

X









Permite gestionar archivos.

FishEye Library



X







Muestra una fila o columna con iconos clicables.

Flic Library



X







Permite cargar y presentar archivos de películas de tipo “flc” y "fli”.

FontOps

X









Permite gestionar fuentes.

FORMROLL Library



X







Botón gráfico, que se pone de relieve cuando el usuario pasa el ratón sobre él.

Gif Library



X

X





Utilizado para guardar y mostrar archivos “GIF” animados o estáticos.

Graph2 Library

X

X

X





Programación de gráficas.

Help utilities



X







Gestión de textos y documentos de ayuda.

HOTPICT Library



X







Permite crear áreas "clicables" sobre fotos, mapas e ilustraciones.

HTML Device





X





Permite visualizar documentos HTML.

HYPLINKS Library



X







Permite crear hipervínculos al estilo de la web.

iActivity









X

Componente para iOS

iButton









X

Componente para iOS

IconArray Library



X







Permite mostrar listas de elementos, identificados mediante iconos.

iDateTime









X

Componente para iOS

iImageView









X

Componente para iOS

iLabel









X

Componente para iOS

iMap









X

Componente para iOS

iNavigationbar









X

Componente para iOS

iPage









X

Componente para iOS

iProgress









X

Componente para iOS

iSearchBar









X

Componente para iOS

iSegmented









X

Componente para iOS

iSlider









X

Componente para iOS

iSwitch









X

Componente para iOS

iTabbar









X

Componente para iOS

iTable









X

Componente para iOS

iTextField









X

Componente para iOS

iTextView









X

Componente para iOS

iWebView









X

Componente para iOS

JavaCore

X









Motor java de Omnis

JavaObjs Library

X









Objetos Java

JDBCDAM

X









Acceso base de datos mediante JDBC.

JPEG Library



X

X





Permite guardar y mostrar gráficos en formato JPEG.

jsActivity







X



Componente JavaScript.

jsBack







X



Componente JavaScript.

jsButton







X



Componente JavaScript.

jsCheckbox







X



Componente JavaScript.

jschrt1







X



Componente JavaScript.

jschrt2







X



Componente JavaScript.

jsComboBox







X



Componente JavaScript.

jsDatePicker







X



Componente JavaScript.

jsDevice







X



Componente JavaScript.

jsDgrd







X



Componente JavaScript.

jsDropList







X



Componente JavaScript.

jsEdit







X



Componente JavaScript.

jsFile







X



Componente JavaScript.

jsHtml







X



Componente JavaScript.

jsHypl







X



Componente JavaScript.

jsLabel







X



Componente JavaScript.

jsList







X



Componente JavaScript.

jsmap







X



Componente JavaScript.

jsNativeList







X



Componente JavaScript.

jsNativeSlider







X



Componente JavaScript.

jsNativeSwitch







X



Componente JavaScript.

jsNavbar







X



Componente JavaScript.

jsNavMenu







X



Componente JavaScript.

jsPage







X



Componente JavaScript.

jsPict







X



Componente JavaScript.

jsPopm







X



Componente JavaScript.

jsProg







X



Componente JavaScript.

jsRadioGroup







X



Componente JavaScript.

jsRich







X



Componente JavaScript.

jsSlider







X



Componente JavaScript.

jsSwitch







X



Componente JavaScript.

jsTabs







X



Componente JavaScript.

jsTimer







X



Componente JavaScript.

jsTrans







X



Componente JavaScript.

jsTree







X



Componente JavaScript.

jsVideo







X



Componente JavaScript.

Marquee Library



X







Permite la visualización en desplazamiento continuo áreas de texto.

MYSQLDAM

X









Acceso base de datos MYSQL.

Navigation Menu Library



X







Permite crear menús en cascada interactivos.

NPAPI Library



X







Componenete NPAPI

ODBCDAM

X









Acceso base de datos mediante ODBC.

OJSON

X









Gestión de documentos JSON

Omnis PDF Device

X









Gestión de documentos PDF

OmnisIcn Library



X







Permite mostrar cualquier icono de los existentes en “OmnisPIC”, “USERPIC”, o “#ICONS”.

OMSQLDAM

X









Acceso base de datos df1 mediante SQL.

ORACLE8DAM

X









Acceso base de datos ORACLE.

OWEB

X









Implemetación del protocolo HTML

OXML

X









Gestión de documentos XML

PCX Library



X

X





Permite visualizar imágenes PCX.

PGSQLDAM

X









Acceso base de datos POSTGRE.

PicList Library



X







Permite mostrar cualquier icono de los existentes en “OmnisPIC”, “USERPIC”, o “#ICONS”.

PortProfile

X









Configuración de puertos de comunicación.

Progress Library



X







Permite visualizar una barra de progreso

QuickTime3 Library



X







Gestión de documentos Quick Time.

RegAdmin

X









Permite el acceso al registro del sistema.

Report Lists Library





X





Muestra una variable de tipo "list" en un informe.

Report Object Library





X





Permite incrustar clases "report" en ventanas.

RTF Device

X









Permite mostrar archivos RTF.

Sidebar Library



X







Permite visualizar una serie de iconos o botones en una barra vertical.

Slider Library



X







Proporciona un deslizador gráfico graduado, que el usuario podrá modificar.

SpreadSheet Grid Library



X







Funciona como una hoja de cálculo de sólo lectura, con los datos contenidos en una variable de tipo "list".

SQLITEDAM

X









Acceso base de datos SQLITE.

Stix Library



X







Control Stix

StringTable

X

X

X





Permite la localización de etiquetas en diferentes idiomas.

SYBASEDAM

X









Acceso base de datos SYBASE.

TabBar Library



X







Presenta una serie de “thumb tabs” o pestañas, sobre las que el usuario podrá hacer clic.

Tile Library



X







Permite mostrar un icono que se propagará, sobre toda la zona.

Timer Library

X

X







Proporciona un temporizador de segundos o milisegundos.

ToolPal Library



X







Control tool pal

Tooltip Library



X







Control de tool tip's

TransButton Library



X







Implementa un “rollover” de tipo botón.

Transform Library



X







Permite efectos de animación y transformación.

Tree Library



X







Proporciona una forma gráfica de mostrar elementos u opciones dispuestos en forma de árbol.

Wash Library



X







Permite añadir un efecto de degradado de color, sobre toda la zona.

WAV Library

X

X







Permite cargar y reproducir archivos de sonido en formato “WAV”.

WBMP Library

X









Permite cargar y reproducir archivos de imagen en formato “WBMP”.

Zoom Library



X







Permite ampliar áreas de la pantalla.