En esta práctica veremos cómo conectarnos a un sitio externo para obtener información en tiempo real. Usa un componente Web y, para comunicarse con el proveedor externo, utiliza una API JSON.
La aplicación convierte una cantidad expresada en pesos (mexicanos) a una de las tres monedas: dólares, euros o libras esterlinas. El propósito del proyecto es mostrar cómo conectarse a un proveedor externo para obtener las cotizaciones en tiempo real. Explicaremos el proceso más adelante, por ahora una figura mostrando la app en ejecución:
Una 'Disposición Horizontal' para preguntar con ella los pesos a convertir y leer esta cantidad.
Una 'Etiqueta,' PesosLabel, dentro de la Disposición Horizontal para preguntar la Cantidad.
Un 'CampoDeTexto', Input, para que el usuario escriba ahí la cantidad que desea convertir.
Un (menú) 'Desplegable', MonedaSpinner, que muestra una ventana emergente que contiene la lista de las monedas a las cuales se puede convertir los pesos. Los valores a desplegar se pueden definir en el Diseñador -así lo hemos hecho- poniendo en la propiedad 'ElementosDesdeCadena' los elementos separados por comas. En este caso hemos puesto los cuatro valores: Moneda?,USD,EUR,GBP. Es conveniente que el primer valor sea no realmente un valor en sí mismo sino una indicación de la naturaleza de los valores (Moneda? para nosotros). Los otros tres valores USD, EUR y GBP son las siglas que identifican las monedas a las cuales convertiremos. Más adelante veremos como obtener estas siglas, que las hemos puesto en lugar de los nombres de las moneda como Dólares, Euros, etc. por facilidad.
Otra 'Etiqueta', ResultadoLabel, para mostrar el resultado.
Un componente no visible 'Web', de Conectividad. Con ayuda de este componente solicitaremos al proveedor las cotizaciones actuales. El proveedor es Fixer: https://fixer.io/. Como lo indica en su página, Fixer es una API simple y ligera para obtener tipos de cambio actuales e históricos. Para poder usar su servicio es necesario obtener de ellos una llave API que es la llave que utilizaremos en nuestra app para hacer la consulta. Nosotros hemos solicitado una llave gratuita que basta para nuestros fines prácticos. El resultado de la consulta es un valor Json que es una lista entre llaves { } de parejas de la forma clave:valor separadas por coma. Más adelante seguiremos esta explicación.
De tal modo que el diseño queda así:
Bloques
Usaremos cuatro variables globales:
'resultado', numérica, como su nombre lo indica, para guardar el resultado de la conversión.
'euroEnPesos', numérica. El proveedor proporciona las diferentes cotizaciones de una moneda base a diferentes monedas. En nuestro caso la moneda base es Euros, de tal manera que para convertir los pesos a otra moneda siempre usaremos los euros como intermediarios; debido a ello guardamos en esta variable el tipo de cambio de un euro en pesos.
'tipoDeCambioActual', numérica. Es el valor de un euro en la moneda escogida.
'tiposDeCambio', texto, en ella guardaremos en realidad la lista de cotizaciones de todas las monedas. A su vez, cada elemento de esta lista es una lista de dos elementos, el primer elemento contiene las siglas de la moneda y el segundo el valor de un euro en esa moneda.
Al inicio de la App, usando el método 'Obtener' del componente Web1 se solicitan las cotizaciones. A dónde se solicitan se indica poniendo como valor de la propiedad 'Url' la dirección del sitio del proveedor junto con la llave API previamente solicitada. En nuestro caso la llave API es: 8b7ceb31ca2eaf1e2af0e8ca780822b1 (por seguridad, el valor puesto aquí es ficticio).
Para tener una idea del valor que devuelve la petición anterior se puede realizar la misma consulta poniendo en un navegador, en la barra de direcciones, precisamente el valor que hemos puesto como Url, es decir, http://data.fixer.io/api/latest?access_key=8b7ceb31ca2eaf1e2af0e8ca780822b1. El resultado a esta consulta se muestra en la ventana del navegador de una manera más amigable y no en forma de lista, sino como una tabla de dos columnas, en donde en la primera aparecen las claves mientras que en la segunda aparecen los valores. Aquí podemos percatarnos del valor que nos interesa, 'rates', así como las siglas de las monedas: USD, EUR y GBP.
Después de que la respuesta a la petición ha sido recibida, al ocurrir el evento 'TuvoExito' de Web1, obtenemos dos valores que interesan guardándolos en dos variables globales. Los tipos de cambio de todas las monedas los guardamos como una lista de parejas (lista al estilo App Inventor) en la variable 'tiposDeCambio' mientras que la cotización del euro en pesos la guardamos en la variable 'euroEnPesos'. Para poder hacer esto primero transformamos la lista Json regresada -que viene dada en el valor 'contenidoDeRespuesta' (del evento 'TuvoExito') a lista en App Inventor, invocando el método 'DecodificarTextoJson' de Web1. Con ello pasamos de una lista Json de la forma:
{ success:true, base:"EUR", ... } a una lista (de listas) AppInventor de la forma [ [success, true], [base, "EUR"], ...].
En el 'Label2' hemos puesto la lista Json regresada para poder verla.
De la lista 'contenidoDeRespuesta' lo que nos interesa son los valores que están en la sublista cuyo primer valor es ´rates', es decir, queremos obtener los tipos de cambio. Esto lo hacemos usando el método de listas llamado 'buscar por parejas' que, dado un valor a buscar como primer valor -'rates' en nuestro caso- lo busca en la lista y devuelve el segundo valor, o bien 'not found' como especificamos si es que no encuentra dicho valor. El valor deseado lo guardamos en la variable 'tiposDeCambio'. A su vez, una vez obtenidos todos los tipos de cambio, buscamos, de la misma manera, el tipo de cambio de un euro en pesos mexicanos y lo guardamos en la variable euroEnPesos.
El proceso anterior es el preámbulo a la conversión de pesos a otra moneda, independientemente de cual sea ésta. Ahora, una vez que el usuario haya seleccionado la moneda y la cantidad de pesos a convertir, debemos efectuar la conversión. Es decir, después de que se ha seleccionado una moneda se activa el evento 'DespuésdeSeleccionar' del menú desplegable. En él primero se revisa que se haya escrito una cantidad, de lo contrario marca error. Pero si hay una cantidad en pesos a convertir, siguiendo el mismo proceso descrito anteriormente, se obtiene la cotización en euros de la moneda a la que se quiere convertir y que está indicada por la 'selección' hecha. Esta cotización se almacena en la variable 'tipoDeCambioActual'. Finalmente, para obtener la equivalencia de los pesos en dicha moneda se hace una regla de tres. El resultado se guarda precisamente en la variable 'resultado' y este valor se pone como texto de la etiqueta 'ResultadoLabel' así: