jsClient: El objeto SQL (Sincronización de la base de datos)

El objeto SQL proporciona dos métodos adicionales que facilitan la sincronización dinámica con otro servidor. En caso de usarse una base de datos UltraLite, será necesario disponer de conexión con un servidor Sybase Mobilink. Disponible con SQLAnywhere 12.01

Consulte la Guía de usuario en http://download.sybase.com/pdfdocs/awg0901e/dbmlen9.pdf para obtener más información sobre las siguientes cuestiones:

• Configuración del servidor MobiLink sincronización.
• Configuración de usuarios MobiLink, tablas y secuencias de comandos.
• Creación de una base de datos consolidada e instalación de las tablas del sistema Mobilink.

La guía del usuario también proporciona un útil tutorial de primeros pasos. Como guía de inicio rápido, lea las lecciones 1-5 del tutorial indicado a continuación, deberá llegar a un punto en el que usted pueda probar la sincronización con soltura:

http://dcx.sybase.com/1201/en/mlstart/ml-sc-tutorial.html

 

$syncinit()

Do oSQL.$syncinit(syncParams) Returns id

Inicializa la sincronización contra un servidor MobiLink. Los parámetros de sincronización son específicos para cada implementación y son suministrados a través de una variable de tipo row. Si la sincronización inicial tiene éxito, también se ejecutará un 'sync' inicial. Ver $sync() para más detalles.

El módulo UltraLite actualmente reconoce los siguientes parámetros:

Username         Nombre del usuario de sincronización MobiLink.
Password         Contraseña del usuario MobiLink, si es necesaria. 

NewPassword      Permite al usuario MobiLink cambiar su contraseña por otra, si así

                 se indica en NewPassword.
Version          Determina qué versión del script de sincronización se utilizará

                 en las diversas acciones.
Stream           Determina el protocolo de red que se utilizará, por ejemplo: tcpip
StreamParams     Permite especificar parámetros adicionales de conexión,

                 específicos del protocolo en uso, por ejemplo: host
Publications     Lista las publicaciones MobiLink suscritas por el usuario.
AdditionalParams Una cadena en la forma nombre=valor; Especificando parámetros

                 adicionales.
Ping             Si es usado, permite conformar que hay comunicación con el

                 servidor Mobilink. No se produce la sincronización.
UploadOnly       Si es usado, indica que no se permitirán descargas sobre CDB, sólo

                 se procesaran las subidas de archivos.
DownloadOnly     Si es usado, indica que no se permitirán subidas en el CDB,

                 sólo se permitirán las descargas. 

ResumePartialDownload   Si es usado, UltraLite únicamente reanudará cualquier

                        descarga fallida. No se permitirán subidas.  

Al finalizar, se invocará el método $sqldone() pasando los siguientes parámetros:

• El ID de la solicitud (el mismo que retornó el $syncinit()).

Ejemplo:

        Calculate config as row(Username,Version,Stream,StreamParams)
                ;; se define mediante el uso de variables locales
        Do config.$assigncols('ml_ventas','default','tcpip','host=192.168.0. 10')
        Do oSQL.$syncinit(config) Returns id  

$sync()

Do oSQL.$sync() Returns id

Una vez que la sincronización haya sido iniciada mediante $syncinit(), el método $sync() se encargará de realizar la sincronización "ad-hoc" entre la base de datos (UltraLite) y el servidor de sincronización (MobiLink). Si es necesario modificar los parámetros de sincronización, podrá invocarse al método $syncinit() en su lugar, ya que con esto también se lleva a cabo.

Al finalizar, se invocará el método $sqldone() pasando los siguientes parámetros:

• El ID de la solicitud (el mismo que retornó el $sync()).