Herramientas de usuario

Herramientas del sitio


wiki:2.-desarrollo-app:2.4.-scripting-modelo-objetos:a.-objetos-sistema:1.-vbscript:1.5.-objeto-replica:start

Objeto Réplica

El objeto replica permite acceder a la información de Réplica del dispositivo.

Start


Tipo Método
Tipo de Dato devuelto Ninguno
Plataforma Android, Blackberry (5.0), iPhone, Windows Phone


Este método fuerza la réplica. Equivalente al AppData.UserInterface.StartReplica

En el caso de IOS y Windows Phone, si el dispositivo ya está replicando en el momento en que se invoca este método, continúa haciéndolo. En Android, este código implica que se ponga en cola una petición de réplica que se ejecutará cuando se termine el ciclo en proceso.

Ejemplo de Uso:

	Replica.Start

Stop


Tipo Método
Tipo de Dato devuelto Ninguno
Plataforma Android, Blackberry (5.0), iPhone, Windows Phone


Este método detiene la réplica. Equivalente al AppData.UserInterface.StopReplica
En estos momentos está obsoleto, no debería usarse porque provocaría problemas de pérdidas de datos. En su lugar, se aconseja el uso de colecciones de mantenimiento.


Ejemplo de Uso:

	Replica.Stop

Log


Tipo Función
Tipo de Dato devuelto Texto
Plataforma Android, Blackberry (5.0), iPhone, Windows Phone


Función que retorna el LOG de réplica.


Ejemplo de Uso:

	This("MAP_LOG")= Replica.Log

RecordsPend


Tipo Función
Tipo de Dato devuelto Entero
Plataforma Android, Blackberry (5.0), iPhone, Windows Phone


Función que retorna la cantidad de registros en cola, pendientes de enviar en el dispositivo.


Ejemplo de Uso:

	This("MAP_RECORDSPEND")= Replica.RecordsPend 

RecordsRX


Tipo Función
Tipo de Dato devuelto Entero
Plataforma Android, Blackberry (5.0), iPhone, Windows Phone


Función que retorna la cantidad de registros recibidos.


Ejemplo de Uso:

	This("MAP_RECORDSRX")=Replica.RecordsRX

RecordsTX


Tipo Función
Tipo de Dato devuelto Entero
Plataforma Android, Blackberry (5.0), iPhone, Windows Phone


Función que retorna la cantidad de registros enviados. En IOS y Windows Phone, este contador es relativo al ciclo de réplica. En Android, es más general, se inicializa al hacer LOGIN y se incrementa en cada ciclo.


Ejemplo de Uso:

	This("MAP_RECORDSTX")=Replica.RecordsTX

TotalRecordsRX


Tipo Función
Tipo de Dato devuelto Entero
Plataforma Android, Blackberry (5.0), iPhone, Windows Phone


Función que retorna la cantidad total de registros recibidos. En IOS y Windows Phone, este contador es relativo al ciclo de réplica. En Android, es más general, se inicializa al hacer LOGIN y se incrementa en cada ciclo.


Ejemplo de Uso:

	This("MAP_RECORDSRX")=CStr(Replica.RecordsRX) + "/" + CStr(Replica.TotalRecordsRX)

TotalRecordsTX


Tipo Función
Tipo de Dato devuelto Entero
Plataforma Android, Blackberry (5.0), iPhone, Windows Phone


Función que retorna la cantidad total de registros enviados.


Ejemplo de Uso:

	This("MAP_RECORDSTX")=CStr(Replica.RecordsTX) + "/" + CStr(Replica.TotalRecordsTX)

GetHostName


Tipo Función
Parámetros IDX: Índice del HostName que se quiere obtener. Si no se pasa nada, se devuelve el primero
Tipo de Dato devuelto Texto
Plataforma Android, Blackberry (5.0), iPhone, Windows Phone


Función que retorna el host que se haya definido el en license.ini. Como parámetro se pasa el índice: 1 o 2, que se quiere obtener. Por defecto, devuelve el primer HostName de la configuración.


Ejemplo de Uso:

	This("MAP_HOSTNAME")=Replica.GetHostName 

GetLicense


Tipo Función
Tipo de Dato devuelto Texto
Plataforma Android, Blackberry (5.0), iPhone, Windows Phone


Función que retorna el número de licencia del dispositivo. Se lee del license.ini.


Ejemplo de Uso:

	This("MAP_LICENSE")=Replica.GetLicense 

GetMid


Tipo Función
Tipo de Dato devuelto Texto
Plataforma Android, Blackberry (5.0), iPhone, Windows Phone


Función que retorna el MID del dispositivo. Se obtiene de la licencia definida en el licence.ini.
Equivalente a la macro ##MID##, que usamos en ocasiones como: <action name=“setval” field=“MAP_MID” value=“##MID##” />


Ejemplo de Uso:

	This("MAP_MID")=Replica.GetMid 

GetDatabaseId


Tipo Función
Tipo de Dato devuelto Texto
Plataforma Android, Blackberry (5.0), iPhone, Windows Phone


Función que retorna el número de base de datos. Se obtiene de los primero caracteres de la licencia definida en el licence.ini.


Ejemplo de Uso:

	This("MAP_DBASEID")=Replica.GetDatabaseId 



ReplicaSetRestriction


Tipo Función
Tipo de Dato devuelto Texto
Plataformas Android, Blackberry (5.0), iPhone, Windows Phone


Dos parámetros, el primero una cadena con la restricción que queremos configurar y el segundo un array con los valores de la restricción.

ReplicaClearRestriction


Tipo Función
Tipo de Dato devuelto Texto
Plataformas Android, Blackberry (5.0), iPhone, Windows Phone


Se le pasa como parámetro una cadena con las restricciones que quieres eliminar, separadas por comas.

ReplicaClearAllRestriction


Tipo Función
Tipo de Dato devuelto Texto
Plataformas Android, Blackberry (5.0), iPhone, Windows Phone


Elimina todas las restricciones de réplica que se hubieran establecido.

Restricciones de Réplica


Se han implementado unas claves en el license.ini para poder restringir la réplica, de forma que se limiten los días o las horas a las que se puede replicar así como evitar que se repliquen ficheros o datos si estamos conectados con los datos 3G-4G del teléfono.

Claves


RestrictionAllowedHours


Tipo Función
Tipo de Dato devuelto Texto
Plataformas Android, Blackberry (5.0), iPhone, Windows Phone


Array de intervalos horarios donde la réplica está permitida.

RestrictionWithMobileNetwork


Tipo Función
Tipo de Dato devuelto Texto
Plataformas Android, Blackberry (5.0), iPhone, Windows Phone


Dos posibles parámetros: files y data a los cuales hay que ponerle valor true o false para activar o desactivar la réplica de ficheros y de datos, respectivamente, cuando estamos conectados a los datos 3G-4G del teléfono.
Estas claves pueden formarse por script, de forma que en lugar de ser “fijas” en el license.ini, se puedan cambiar estas claves dinámicamente:

Establecer las claves con VBScript:

  Dim restrictionData(2)
  restrictionData(0)="files:false"
  restrictionData(1)="data:true"
  replica.SetRestriction "WithMobileNetwork", restrictionData
 
  Dim restrictionHours(1)
  restrictionHours(0)="allowedHours:8:30-14:00,16:00-18:00"
  replica.SetRestriction "AllowedHours", restrictionHours
 
  Dim restrictionWeekdays(1)
  restrictionWeekdays(0)="allowedWeekdays:Monday,Tuesday,Wednesday,Thursday,Friday"
  replica.SetRestriction "AllowedWeekdays", restrictionWeekdays
 
  Se pueden eliminar las restricciones con el comando:
 
  replica.ClearRestrictions "WithMobileNetwork,AllowedHours" Aqui separaremos por comas los parámetros que queremos eliminar de las restricciones.
 
  replica.ClearAllRestrictions Para eliminar todas las restricciones que tengamos actualmente.



Establecer las claves con JavaScript:

 var restrictionData = {
files: false,
data: true
 };
 replica.setRestriction("WithMobileNetwork", restrictionData);
 var restrictionHours = {
allowedHours: ["8:30-14:00", "16:00-18:00"]
 };
 replica.setRestriction("AllowedHours", restrictionHours);
var restrictionWeekdays = {
allowedWeekdays: ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"]
 };
 replica.setRestriction("AllowedWeekdays", restrictionWeekdays);
Para eliminar las restricciones:
replica.clearRestrictions("WithMobileNetwork,AllowedHours"); Separadas por comas ponemos las restricciones que queremos eliminar.
replica.clearAllRestrictions(); Para quitar todas las restricciones.

RestrictionAllowedWeekdays


Tipo Función
Tipo de Dato devuelto Texto
Plataformas Android, Blackberry (5.0), iPhone, Windows Phone


Array de días de la semana donde la réplica está permitida.

Vista de las claves en el fichero license.ini:

restrictionallowedhours={"allowedHours":["8:30-14:00","16:00-18:00"]}
restrictionwithmobilenetwork={"files":false,"data":true}
restrictionallowedweekdays={"allowedWeekdays":["Monday","Tuesday","Wednesday","Thursday","Friday"]}


También pueden formarse estas claves por script, de forma que en lugar de ser “fijas” en el license.ini, se puedan cambiar estas claves dinámicamente.

wiki/2.-desarrollo-app/2.4.-scripting-modelo-objetos/a.-objetos-sistema/1.-vbscript/1.5.-objeto-replica/start.txt · Última modificación: 2018/01/22 12:06 (editor externo)