Etiqueta

3 de junio de 2015

Uso de ODB en Windows

El manual Omnis sobre ODB (el odb.pdf) explica exhaustivamente el uso de ésta útil herramienta que nos permite construir un servidor de base de datos con nuestros df1, por lo que en éste artículo, sólo mostraré algunos de los últimos cambios introducidos y en concreto para la plataforma Windows. Recordemos que su última versión disponible es la 1.6.5

Uno de éstos cambios es que el ODB para ésta plataforma es ahora una aplicación sólo ejecutable desde la línea de comandos de Windows, habiendo sido eliminada la anterior aplicación denominada ODBService.exe.

Como iniciar ODB en Windows 2000/XP/Vista/7


Una vez actualizado el archivo de configuración con los detalles de los archivos de datos (ver el manual odb.pdf), podremos iniciar el ODB ejecutando el odbridge.exe ubicado en la carpeta ODB.
Abra el símbolo del sistema, (línea de comandos de Windows) sitúese sobre el directorio ODBC y escriba…

odbridge (o odbridge start)

...y pulse retorno.

Si todo ha funcionado como debe, verá lo siguiente:

Executing start...
...see messages.txt for success

Puede ver el contenido del fichero “messages.txt” de la carpeta ODBC para comprobar si el DB se ha iniciado correctamente. Si se ha producido un error este archivo contendrá los detalles del error, o (si todo fue bien) la línea siguiente:

ODB is now listening for requests from your clients

Nota: También es posible iniciar el ODB mediante hacer doble-clic en odbridge.exe mientras esté a la vista en una ventana. En este caso el servidor “data bridge” se iniciará de modo silencioso, pero aún se podrá consultar sobre su resultado en el archivo “messages.txt”.

Como parar el ODB


Para detener el servidor “data bridge”, escriba…

odbridge shutdown

…y pulse retorno.

Si todo ha funcionado como debe, verá lo siguiente:

Executing shutdown...
...see messages.txt for success

Si en el momento del cierre existen usuarios conectados, se producirá un error. En éste caso no es seguro que el ODB haya sido detenido realmente. Deberá asegurarse de que no existan usuarios conectados (es decir, que hayan cerrado sus archivos de datos) antes de volver a intentarlo.

Sin embargo, es posible forzar el apagado del OBD aún cuando existan usuarios conectados. Para ello escriba…

odbridge kill

…y pulse retorno.

Nota: Tenga en cuenta, que con esta acción se corre el riesgo potencial de corrupción del archivos de datos, si coincide que un usuario esté escribiendo en el archivo, durante el cierre.

Como instalar un servicio Windows para lanzar el ODB


Puede instalar el ODB como un servicio Windows, con el fin de que sea iniciado automáticamente junto con el sistema. Para ello, asegúrese primero de que el OBD no este ejecutándose, después, escriba…

odbridge install

…y pulse retorno.

Si todo ha funcionado como debe, verá lo siguiente:

Installing “C:\....\odbridge.exe” as a service
The operation completed successfully.

En caso de producirse un error, en lugar de lo anterior verá el mensaje de error correspondiente. Por defecto, el servicio (denominado “Omnis Data Bridge”) es configurado para iniciarse automáticamente, pero, usted puede modificar dicha configuración desde “Panel de control≥≥Herramientas administrativas≥≥Servicios” si así lo desea.

Como eliminar el servicio Windows


Para detener y eliminar el servicio “Omnis Data Bridge”, escriba…

odbridge remove

…y pulse retorno.

Si todo ha funcionado como debe, verá lo siguiente:

Uninstalling service: odbridge
The operation completed successfully.

En caso de producirse un error, en lugar de lo anterior verá el mensaje de error correspondiente.

Nota: La eliminación del servicio es equivalente a ejecutar el comando “odbridge kill”. Por lo que, (como en el caso anterior) deberá asegurarse de que no existan clientes conectados antes de eliminarlo.

27 de mayo de 2015

Uso del nuevo archivo de configuración del servidor de aplicaciones

Desde Omnis Studio 6.1 se incluye un nuevo archivo de configuración en formato JSON denominado "config.json" y situado en la carpeta "studio".

Es utlizado para configurar el servidor de aplicaciones Omnis, incluyendo propiedades de arranque, modo de uso y otras concernientes al uso de servicios web (Web Services). También incluye una sección específica para activar la caché de clases Java y otros elementos.

Habitualmente la configuración del servidor Omnis Server puede hacerse mediante seleccionar la opción "Server Configuration" del menú "File" desde el propio Omnis Server, pero, ahora también podrá hacerse mediante la edición del fichero "config.json" usando para elo cualquier editor de texto compatible, pero el archivo debe ajustarse al formato JSON.

La primera parte del archivo "config.json" contiene la siguiente distribución:

{
    "server": {
    "port": 5988,
    "stacks": 20,
    "timeslice": 1,
    "webServiceURL": "",
    "webServiceConnection": "",
    "webServiceLogging": "full",
    "webServiceLogMaxRecords": 100,
    "webServiceStrictWSDL": true,
    "RESTfulURL": "",
    "RESTfulConnection": "",
    "start": false,
    "retryBind": false,
    "showBindRetryMessage": true,
    "bindAttempts": 10
    }
}

donde...
 
  • port, stacks, timeslice 
  • Permiten definir el modo en que se ejecutará el servidor Omnis.

  • webService...
  • Definen los servicios web basados en SOAP/WSDL.

  • RESTful...
  • Definen los servicios web basados en REST.

  • start
  • Si es "true" significa que el servidor Omnis será activado automáticamente al arrancar.

  • retryBind
  • La propiedad "retryBind" deberá establecerse a "false" si no se desea que el servidor Omnis vuelva a intentar la conexión al puerto especificado, tras un primer intento. Por defecto o si el parámetro es omitido "retryBind" es "true".

  • showBindRetryMessage
  • Si "retryBind" es "true", "showBindRetryMessage" determinará si se mostrará o no, un mensaje de estado durante el tiempo que se esté re-intentando la conexión.

  • bindAttempts
  • Si "retryBind" es "true", "bindAttempts" anula el número predeterminado de intentos de conexión, obligando al servidor Omnis a realizar un intento cada segundo.
 

20 de mayo de 2015

Texto HTML en botones

Una nueva característica soportada por los controles JavaScript "Button" y "TransButton" nos permiten aportar textos con etiquetas HTML a los botones.

Para ello deberemos fijar su nueva propiedad "$textishtml" a "true"
, ésto afectará al modo en que será tratado el texto indicado para el botón (propiedad $text), el cual podrá ahora contener etiquetas HTML, ésto significa que podremos hacer uso de cualquier etiqueta HTML para aportar estilo al texto. Por ejemplo, podríamos insertar un salto de línea mediante la etiqueta "≤br≥".

La activación de la propiedad "$textishtml", no impide el uso del resto de atributos ya presentes para los controles de botón mencionados, por lo que no habrá problema alguno en seguir usando los elementos habituales para la asignación de estilo, tipo de letra y color.

Tenga en cuenta que modo-diseño no podremos observar el resultado de aplicar la etiqueta HTML (sólo veremos el código HTML) y si usamos atributos dentro del código HTML deberán ir situados entre comillas simples.