{{indexmenu_n>1}}
===== Colecciones OnLine =====

La plataforma XOne, por regla general, opera con una Base de Datos local en el dispositivo, de forma que aunque no haya conexión de datos, podamos trabajar en todo momento con la aplicación.

Ello no implica que siempre tenga que trabajarse "OFF-LINE", es la forma más cómoda y rápida para trabajar con un dispositivo, pero la tecnología también nos permite crear colecciones "ON-LINE" para recuperar determinados datos o incluso crear la aplicación completa "ON-LINE" si fuese necesario.

<WRAP round alert center>
  - El nombre de los nodos **connection** debe ser único para todo el mappings.xml, aunque estén en distintas colecciones. Si bien pueden definirse en cualquier colección, para tener todas las conexiones localizadas, <wrap hi>mejor definirlos en el nodo app al inicio del mappings</wrap>.\\
  - Todas las colecciones ONLINE cargan los datos con LOADALL, NO se pueden recorrer los datos con STARTBROWSE.
</WRAP>

==== Comprobar Conectividad ====
Antes de lanzar una Coleccion ONLINE tenemos que asegurarnos de tener conexión a internet, y para ello podemos hacer uso de esta función y colección para hacer la comprobación:\\
\\
<code javascript>
//FUNCION PARA COMPROBAR SI TIENE CONEXION CON ALGUNA DIRECCION
function comprobarConexionJS() {
	var conexion=0;
	$http.get( "https://www.google.es/", function() {
		conexion=1
		//self.setFieldPropertyValue("MAP_CONNECTION", "text-forecolor-disabled", "#509c16");
		//self.MAP_CONNECTION="**  DISPOSITIVO CON CONEXION  **";
		//ui.refresh("MAP_CONNECTION");
	}, function(){ 
		//No hay conexión
		//self.setFieldPropertyValue("MAP_CONNECTION", "text-forecolor-disabled", "#CC3333");
		//self.MAP_CONNECTION="!!!  DISPOSITIVO SIN CONEXION  !!!";
		//ui.refresh("MAP_CONNECTION");
	}); 
	return conexion;
}
</code>

=== Comprobar Conexión con Proxy JSON ===
<code javascript>
//FUNCION PARA COMPROBAR SI TIENE CONEXION CON UN PROXY JSON
function ComprobarConexion() {
	var conexion=0;
	try{
		//appdata.Error.Clear
		//on error resume next  
		var coll=appData.getCollection("ContentComprobarConexion");
		coll.startBrowse();
		//appdata.Error.Clear
		if (coll.getCurrentItem()!==null) {
			//Si nos ha devuelto algún registro quiere decir que tenemos conexión.
			//if (coll.getCurrentItem().RESULTADO==="##OK##") {
				conexion=1;
			//}
		}
		coll.endBrowse();
		coll.clear();
		coll=null; 
		return conexion;
	}catch(err){
		return conexion;
	}
}
</code>

<code xml>
<coll name="ContentComprobarConexion" title="XoneCollvacia" 
	sql="select ##COMPROBAR_CONEXION## from gen_empresa" connection="json_comprobar" 
	objname="ComprobarConexion" updateobj="ComprobarConexion" progid="ASData.CASBasicDataObj">
	<connection name="json_comprobar" connstring="Provider=Xone Remote Provider;Data Source=http://xoneisp.com/XOneJSONAllbyXOne/default.aspx;ProgID=com.xone.db.json.JSONConnection;Timeout=5;Security Level=0" />
	<group name="General" id="1">
		<prop name="RESULTADO" type="T" visible="0" />
	</group>
</coll>
</code>

==== Opciones Online ====

En la plataforma XOne, tenemos varias formas de conectarnos para obtener datos remotos:
<WRAP center>
|< 80% 20% 25% 25% 30% >|
^ Nombre Conexión Online ^ Servidor de Conexión  ^ Conexión a ERP Cliente ^ Plataformas ^
| **JSONBD** | Proxy intermedio que devuelve JSON  | Conexión a BD | Android, IOS, W8 (En desarrollo) |
| **JSONWS** | Proxy intermedio que devuelve JSON  | Conexión a Web Service | Android, IOS, W8 (En desarrollo) |
| **<nowiki>xoneonline</nowiki>** | Proxy intermedio que devuelve XML  | Conexión a BD | Android, IOS, Windows Mobile, <nowiki>blackberry</nowiki> |
| **<nowiki>xonedirect</nowiki>** | Directo a Web Services del Cliente  | Web Services del Cliente | Android, IOS (En desarrollo) |
</WRAP>
\\
==== NODO connection en mappings ====
\\
En las colecciones ONLINE, tenemos que tener un nodo **connection** con la cadena de conexión al Proxy intermedio, o Web Service del que obtendremos los datos.\\
\\


^ Parámetros Connection ^ Descripción ^
| **name** | Debe ser único en TODO el mappings.  |
| **connstring** | Llamada al Proxy o Web Service al que nos vamos a conectar, pasándole diferentes parámetros: \\ -**Provider** :**Xone Remote Provider**. Este valor debe ser siempre así ya que es de sistema. \\ -**Data Source**:Nombre del web service al que llamamos. \\ -**<nowiki>namespace</nowiki>**: Nombre que se obtiene del WSDL del atributo targetNamespace. \\ -**<nowiki>progid</nowiki>**:Nombre del progID utilizado por la maquinaria, los valores son: \\ -**1.com.xone.db.soa.SOAConnection**: Utilizada para atacar directamente a los web service desde el frame. \\ -**2.com.xone.db.json.JSONConnection**:Utilizada para conectarse a los web service a traves de proxy JSON. \\ -**3.CGSProxy.CProxy** :Utilizada para conectarse con proxy genérico que devuelve XML, a los web services. |
| **Timeout** | Tiempo de espera de una respuesta antes de que de error. (En segundos)  |
| **Security Level** | Tipo de seguridad (Numérico). Dependiente del proxy utilizado.  |
| **method** | El método de obtener los datos del Proxy, GET o POST.|

\\
==== Proxy JSONBD ====
\\
Proxy que atacará la Base de Datos del Cliente y devolverá los resultados en forma JSON al framework XOne. (Más rápido que el antiguo método de colecciones ONLINE que devolvía XML).\\
\\
Se puede obtener la última versión del Proxy descargándola de la web <nowiki>xonesupport</nowiki>.\\
\\
<WRAP center 80%>
{{    :b.-programacion:colecciones_online:coll_online_json_bd.png?nolink    }}
</WRAP>
\\
=== Web.Config de JSONBD ===
\\
Dentro del fichero Web.Config del proxy, nos encontramos con el nodo appSettings:\\
\\
<code xml>
<appSettings>
	<add key="debug" value="true"/>
	<add key="Connection String" value="Provider=System.Data.SqlClient;Data Source=AQUI LA CADENA DE CONEXION A LA BASE DE DATOS;"/>
	<add key="Security Level" value="0"/>
	<add key="Database Operations Allowed" value="select,insert,delete,update"/>
</appSettings>
</code>
|< 100% 20% 80% >|
^ Parámetros del nodo appSettings ^ Valores ^
| **debug** | **true - false**\\ <wrap em>Se deja log en el visor de sucesos.</wrap>  |
| **Connection String** | Cadena de Conexión a la Base de Datos  |
| **Security Level** | **0 - 1 - 2 - 3**\\ 0.- Sin seguridad. La llamada se procesa tal cual.\\ 1.- Seguridad con http header authentication. Se envía el usuario y la contraseña para comparar en local.\\ 2.- Por mantenimiento de sesión. Se necesita un token de sesión que envía el servidor cuando se autentica.\\ 3.- Por certificado. (En Desarrollo). |
| **Database Operations Allowed** | **select - insert - delete - update**\\ Operaciones permitidas a la hora de trabajar contra la Base de Datos.  |
\\
=== Ejemplo de tipo JSONBD ===
\\
<code xml>
<!-- ########################## LLAMADA ONLINE ENTRE FRAMEWORK___PROXY JSON_BASE DE DATOS  ############################# -->
<coll name="MapaReservas" fontsize="8" title="MapaReservas" objname="MapaReservas" updateobj="MapaReservas" progid="ASData.CASBasicDataObj" 
sql="SELECT t1.ID,t1.CODEDIFICIO,t1.CODPLANTA,t1.CODSALA,t1.DATE_START,t1.CAPACIDAD,t1.MATRIZ
	FROM gen_MapaReservas t1" filter="" sort="DATE_START limit 50" connection="mapa" userawsql="true">

	<!-- Aqui lo dividimos en 2 líneas para que se vea mejor el ejemplo, DEJAR EN UNA SOLA LINEA. -->
	<connection name="mapa" connstring="Provider=Xone Remote Provider;Data Source=http://xone.es/XoneJSONReservaSalas/Default.aspx;
	ProgID=com.xone.db.json.JSONConnection;Timeout=60;Security Level=0" />

	<group name="General" id="1" />
	<prop name="CODEDIFICIO" type="T" visible="0" group="1" />
	<prop name="CODPLANTA" type="T" visible="0" group="1" />
	<prop name="CODSALA" type="T" visible="0" group="1" />
	<prop name="DATE_START" title="F.Inicio" type="D" visible="1" group="1" />
	<prop name="CAPACIDAD" title="Capacidad" type="N" visible="1" group="1" />
	<prop name="MATRIZ" title="Matriz" type="T" visible="1" group="1" />
</coll>
</code>
|< 100% 20% 80% >|
^ Parámetro del mappings ^ Observaciones ^
| **sql** | Igual que siempre, como si fuese OFFLINE, la diferencia es que la SQL se ejecuta en una BD remota.  |
| **filter y sort** | Como siempre, el WHERE y el ORDER BY de la sentencia SQL  |
| **connection** | Valor del atributo name del nodo connection definido más abajo . |
| **userawsql** | Para que el framework no intente parsear la SQL y la ponga en forma de subconsulta, que la deje tal cual está en el atributo SQL.  |
| **loadall** | Poner a "true". Todas las colecciones ONLINE cargan los datos con LOADALL, no se pueden recorrer los datos con STARTBROWSE. |
\\
==== Proxy JSONWS ====
\\
Proxy que atacará los Web Services del Cliente y devolverá los resultados en forma JSON al framework XOne. (Más rápido que el antiguo método de colecciones ONLINE que devolvía XML).\\
\\
Se puede obtener la última versión del Proxy descargándola de la web <nowiki>xonesupport</nowiki>.\\
\\
<WRAP center 80%>
{{    :b.-programacion:colecciones_online:coll_online_json_web_services.png?nolink    }}
</WRAP>
\\
=== Ejemplo de tipo JSONWS ===
\\
<code xml>
<!-- ########################### LLAMADA ONLINE ENTRE FRAMEWORK___PROXY JSON_WEBSERVICE  ##############################
    Coleccion online para llamar al Web Service a partir del Proxy.
    En Android: se le puede indicar el endpoint, ya que se puede tener un único proxy llamando a varios WebService.  
    Lo que hace la llamada es en el SQL se le pone a que opción del web service se llama, que en el ejemplo es CheckLic2 y en el
    filter se pasan los parametros que pueda permitir el webservice.
-->
<coll name="CheckLic2" title="CheckLic" objname="CheckLic" updateobj="CheckLic" progid="ASData.CASBasicDataObj" 
	sql="SELECT * FROM CheckLic" filter="stPIN=355136053971720" sort="" connection="CheckLic2" loadall="true">
	<connection name="CheckLic2" connstring="Provider=Xone Remote Provider;Data Source=http://xoneisp.com/XoneJSONWebService/;endpoint=xoneisp.com;ProgID=com.xone.db.json.JSONConnection;Timeout=60;Security Level=0" />
	<group name="General" id="1" />
	<prop name="Result" type="T" visible="7" group="1" />
</coll>
</code>
\\
=== Web.Config de JSONWS ===
\\
Dentro del fichero Web.Config del proxy, nos encontramos con los nodos **appSettings** y **client**:\\
\\
<code xml>
<appSettings>
	<add key="debug" value="true"/>
    
    <!-- Direccion del WSDL del Web Service al que nos tenemos que conectar si solamente tiramos contra un web service -->
	<add key="EndPoint" value="http://www.cgsoft.net/geoipservice.asmx?WSDL"/>
	<add key="Class" value="GeoIPServiceSoapClient"/>
    <!-- 	 -->

    <!-- Direcciones WSDL de los Web Services a los que queramos conectar en caso de que tiremos contra varios web services,
         desde un mismo proxy -->
	<add key="EndPoint(xoneisp.com)" value="http://xoneisp.com/Xonelive/xonelivews.asmx?wsdl"/>
	<add key="Class(xoneisp.com)" value="ServiceSoapClient"/>
    
	<add key="EndPoint(xone.es)" value="Http://xone.es/services/listadatos.asmx?WSDL"/>
	<add key="Class(xone.es)" value="listadatosSoapClient"/>
    <!-- 	 -->
    
	<add key="Security Level" value="0"/>
</appSettings>
.....
.....
.....
<client>
      <endpoint address="http://www.cgsoft.net/geoipservice.asmx" binding="basicHttpBinding"
        bindingConfiguration="httpbinding" contract="GeoIPServiceSoap"
        name="GeoIPServiceSoap" />

      <endpoint address="http://xoneisp.com/Xonelive/xonelivews.asmx" binding="basicHttpBinding"
        bindingConfiguration="httpbinding" contract="ServiceSoap"
        name="ServiceSoap" />

      <endpoint address="http://xone.es/services/listadodatos.asmx" binding="basicHttpBinding"
        bindingConfiguration="httpbinding" contract="listadatosSoap"
        name="listadatosSoap" />
</client>
</code>
\\
|< 100% 20% 80% >|
^ Parámetros del nodo appSettings ^ Valores ^
| **debug** | **true - false**\\ <wrap em>Se deja log en el visor de sucesos.</wrap>  |
| **<nowiki>endpoint</nowiki>** | <WRAP>Direccion del WSDL del Web Service al que nos tenemos que conectar. P.Ej: http://www.cgsoft.net/geoipservice.asmx?WSDL\\ 
\\
Si se van a llamar a distintos Web Services desde el proxy, tenemos que poner <nowiki>endpoint</nowiki>(Loquesea), siendo el valor entre paréntesis el valor del atributo "**endpoint=Loquesea;**" especificado en la llamada del mappings.xml para llamar a un Web Service u otro.\\ 
\\

Ejemplo de llamada a web service en mappings.xml: \\
\\
<code xml><connection name="CheckLic2" 
connstring="Provider=Xone Remote Provider;Data Source=http://xoneisp.com/XoneJSONWebService/;endpoint=xoneisp.com;
ProgID=com.xone.db.json.JSONConnection;Timeout=60;Security Level=0" /> </code></WRAP>|
| **Class** | Es la clase del WSDL. La misma se obtiene al final del WSDL, en el apartado **wsdl:service name="Service"** (Normalmente hay 2 en el WSDL, cogemos el primero de ellos) y se le añade "Client" al final, por ejemplo, para <wsdl:port name="**<nowiki>servicesoap</nowiki>**"... > el Class sería "**<nowiki>servicesoapclient</nowiki>**"  |
| **Security Level** | **0 - 1**\\ 0.- Sin seguridad. La llamada se procesa tal cual.\\ 1.- Seguridad con http header authentication. Se envía el usuario y la contraseña para comparar en local. La Seguridad por cabecera debe de tenerlo implementado el web service que sea. |
^ Parámetros del nodo client ^ Valores ^
| **address** | La dirección del web service. (SIN el **?wsdl** al final de la dirección) |
| **contract** | El contrato del wsdl que está al final del mismo, dentro del apartado **wsdl:service name="Service"**  |
| **name** | Se le indica el mismo que el contract.  |
\\

==== XOneOnline ====
\\
Antigua forma de realizar las conexiones ONLINE, que devolvía los datos en formato XML.\\
\\
<WRAP center 80%>
{{    :b.-programacion:colecciones_online:coll_online_xml_bd.png?nolink    }}
</WRAP>
\\
=== Ejemplo de código XOneOnline ===
\\
<code xml>
<coll name="VisitasOnline" title="VisitasOnline" fontsize="8" progid="ASData.CASBasicDataObj"
	objname="" updateobj="" sql="SELECT t1.* FROM ##PREF##kk t1"
	connection="proyecto_online1" cache="false" loadall="true" useextdata="true" stringkey="true" idfieldname="SECUENCIA" check-owner="false" >

	<connection name="proyecto_online1" connstring="Provider=CGSoft Remote Provider;Data Source=http://123.123.123.123/Proxy/Default.aspx?;ProgID=CGSProxy.CProxy;appname=CGMobile;Timeout=60;network=0"/>

	<group name="General" id="1"/>
	<prop name="ID" visible="7" group="1" type="N" fieldsize="10"></prop>
	<prop name="SECUENCIA" visible="7" group="1" type="N" fieldsize="10"></prop>
	<prop name="STATUS" visible="7" group="1" type="N" fieldsize="10"></prop>
	<prop name="ERRDESC" visible="7" group="1" type="T" fieldsize="40"></prop>
</coll>
</code>
\\
<WRAP info box round>
  * El **SQL** de la colección: "**SELECT t1.* FROM ##PREF##kk t1**" NO SIRVE para nada, y tanto **objname** como **updateobj** están vacíos, puesto que NO vamos a tratar con una base de datos local.
  * A nivel del nodo COLL, tenemos un parámetro **connection="<wrap em>proyecto_online1</wrap>"** que es el que especifica que la colección, es una colección **ONLINE**.
  * Posteriormente, tenemos el nodo **<connection name="<wrap em>proyecto_online1</wrap>" ...>**, que será donde se define realmente la conexión con el webservice contra el que va a funcionar la colección. <wrap em>MUY IMPORTANTE</wrap>, **<wrap hi>el valor de este atributo debe ser unico para todo el mappings</wrap>**.
</WRAP>
\\
La respuesta del <nowiki>webservice</nowiki> debe ser algo como esto:\\
\\
<code xml>
<xml>
  <R>
    <F N="SECUENCIA" T="T" V="9482e7e4-fee3-4a7a-8e1f-6e5b0e294b54" />
    <F N="STATUS" T="N" V="0" />
    <F N="ERRDESC" T="T" V="Parametros incompletos" />
  </R>
</xml>
</code>