Smart Devices & GAM

Prctico

Prctico Curso Smart Devices & GAM Evolution 3

Copyright Artech Consultores S. R. L. 1988-2015.

Todos los derechos reservados. Este documento no puede ser reproducido en cualquier medio sin el
consentimiento explcito de Artech Consultores S.R.L. La informacin contenida en este documento es para
uso personal nicamente.

Marcas Registradas
Artech y GeneXus son marcas registradas de Artech Consultores S.R.L. Todas las dems marcas
mencionadas en este documento son propiedad de sus respectivos dueos.

Prctico Curso Smart Devices & GAM Evolution 3

1. PRIMEROS PASOS .......................................................................................................... 4

2. APLICACIN WEB Y DOMINIOS SEMNTICOS ................................................................ 4
3. APLICANDO EL PATTERN WORK WITH FOR SMART DEVICES.......................................... 6
Ejecutando la aplicacin en forma Compilada ........................................................................ 11

4. DESARROLLANDO LA APLICACIN ............................................................................... 12

Diseo - Themes e Imgenes .................................................................................................. 12
Personalizando los Objetos .................................................................................................... 14
Multiples Layouts per Row ..................................................................................................... 15
Agregando nuevas Transacciones ........................................................................................... 16
Transaccin Restaurant .......................................................................................................... 19
Personalizando las Pantallas de View y Edit ........................................................................... 20
Modificando el Estilo de Navegacin (Navigation Style) ......................................................... 22
Transitions ............................................................................................................................. 23
rdenes y filtros ..................................................................................................................... 23
Comportamiento .................................................................................................................... 24
Integracin con el calendario y la libreta de direcciones ........................................................ 26
Transaccin EventSetting ....................................................................................................... 27

6. ACTIVACIN DEL GAM ................................................................................................. 28

Configuracin de la Seguridad a nivel de Objeto .................................................................... 31

7. CONVIRTIENDO LA APLICACIN A OFFLINE.................................................................. 32

Prctico Curso Smart Devices & GAM Evolution 3

1. Primeros Pasos
A lo largo de este prctico se desarrollar una aplicacin para un Evento (en ingls: EventDay).
Se prototipar en Android, dado que se cuenta con un emulador. Si se tiene algn dispositivo
(Android, BlackBerry, iOS, Windows 8) podr probar la aplicacin en l.

Crear una nueva Knowledge Base (si usa la versin Trial se crear con Environment
.NET con generador Default C# Web)
Observar las propiedades del generador Default (C# Web usando la versin Trial
encontrar el nodo Generators en el propio Folder View), en particular las del grupo
Execution
Utilizar la opcin Deploy to Cloud (propiedad del Generador propiedad Deploy to
Cloud = Yes) usando la Trial es la opcin default y la nica posible.
Observar las propiedades del Data Store Default que indica dnde se va a crear la
aplicacin en la versin Trial esta informacin no est visible.

En el servidor samples.genexusserver.com/xev3/ podr acceder a la aplicacin EventDay, ms

compleja, que fue modelo para este prctico, as como para el terico. Para probarla, haga desde
GeneXus un New Knwoledge Base from GXserver. El archivo EventDay_BeforeGAM.xpz contiene
todos los objetos de la KB solucin de este prctico hasta el fin del punto 5 (es decir, antes de la
aplicacin de GAM).
En la confeccin de este prctico, hemos utilizado el emulador gratuito genymotion, con un virtual
device Samsum Galaxy S4. Este emulador es bastante ms veloz que el que viene con el SDK de
Android. Le sugerimos descargrselo de genymotion.com y crearse los virtual devices en los que
desee probar la aplicacin.

2. Aplicacin Web y Dominios Semnticos

Crear la Transaccin Country de acuerdo a la siguiente figura:

Crear los siguientes Dominios:

Id - Numeric(8.0)
Name - Varchar(20)

Configurar en el atributo CountryId la propiedad Autonumber (en el atributo, no en el dominio).

Prctico Curso Smart Devices & GAM Evolution 3

Crear la Transaccin Speaker de acuerdo a la siguiente figura:

Configurar la propiedad Autonumber en el atributo SpeakerId

Definir el dominio Surname = VarChar(40)
SpeakerFullName es un atributo frmula = SpeakerSurname.trim()+
SpeakerName.Trim()

Observar los dominios predefinidos en GeneXus. Varios corresponden a dominios

semnticos. Qu significa esto?

Agregar reglas:
Error( 'The Speaker Name must not be empty')
if SpeakerName.IsEmpty();
Error( 'The Speaker Surname must not be empty' )
if SpeakerSurname.IsEmpty();
Msg( 'Curriculum Vitae should not be empty')
if SpeakerCVMini.IsEmpty();

Aplicar a ambas Transacciones el Pattern Work With for Web

Importar en la KB el archivo: 1-InitializeCountries_and_Speakers.xpz. Aqu
bsicamente importar dos procedimientos para inicializar las tablas con datos. Para ello:
Agregar en el Evento Start del Web Panel Home (se encuentra en el folder GeneralWeb)
la invocacin a los siguientes procedimientos que se importaron con el xpz anterior:
Event Start
InitializeCountries()
InitializeSpeakers()
Endevent

Prctico Curso Smart Devices & GAM Evolution 3

Ejecutar la aplicacin presionando F5 (tendr que reorganizar). Ejecutar el Web Panel

Home para la inicializacin y ver los datos cargados. Acceda al Work With Countries
y al Work With Speakers, para comprobar que efectivamente se hayan cargado.

3. Aplicando el Pattern Work With for Smart

Devices

Aplicar el Pattern Work With for Smart Devices a las Transacciones

Para ello: Seccin Patterns de la transaccin. Elegir el patrn apropiado y Apply this pattern
on save.

Observar los nodos List, Detail y Section(General) de la instancia, viendo en cada

caso la pantalla que aparece.

Grabar y observar qu sucede con los siguientes elementos:

o Propiedades de la transaccin:
Business Component = True
Expose as Web Service = True
Web Services Protocol = ReST Protocol
o Observar cmo aparece el objeto Work with for Smart Devices en el Folder View,
bajo la TRN.
o Se agreg el generador para Smart Devices como generador secundario.

Crear el Dashboard EventDay (respetar el nombre para las importaciones de objetos

posteriores), de acuerdo a la siguiente figura:

Observar el evento asociado a cada opcin.

En el primer tem se est invocando al Work With de pases. A qu parte del mismo? Al List.

Prctico Curso Smart Devices & GAM Evolution 3

Asociar una imagen a cada opcin (puede utilizar las del folder Android Icons que los
instructores le proveern):

Grabar y observar que la propiedad Main Program est en True.

Abrir el virtual device de genymotion antes de presionar F5. De lo contrario, GeneXus
abrir automticamente el provisto por el SDK de Android. Djelo abierto de aqu en ms.
En la imagen mostramos la pantalla de genymotion donde deber elegir el virtual device
que desea abirr, y ejecutarlo. Por ejemplo, el Samsum Galaxy S4:

Presionar F5 para generar y ejecutar la aplicacin en el emulador (si va a utilizar el

emulador del SDK de Android, esta operacin puede demorar en la primera ejecucin,
cuando se abre el emulador. No cerrarlo para prximos F5s. Si al abrirse el emulador no
se carg el KBN, haga otro F5, sin cerrar el emulador).

Notas:

Dado que no se ha especificado ningn Startup Object, GeneXus abrir tanto el Developer Menu
web en el navegador predeterminado, como el emulador Android (o ejecutar la aplicacin en el
emulador que tenga abierto, por ejemplo, el virtual device de genymotion) para probar tanto la
aplicacin Web (.NET), como la de Smart Devices (Android), respectivamente.
En el Developer Menu, adems de los links para ejecutar los objetos de la aplicacin Web,
aparecern QR codes: uno que encapsula la URL para poder ejecutar desde el KBN en el dispositivo
que corresponda (a la derecha aparece el link para descargar el KBN para iOS, dado que cada vez
ms se aconseja probar la aplicacin compilada, ya que en el KBN las funcionalidades estn
reducidas; el de iOS se sigue disponibilizando puesto que se necesita una Mac para compilar, lo
que restringe las posibilidades de test); los otros contendrn la aplicacin para Smart Devices
compilada, tanto para Android como para Blackberry. Para Windows 8 o Phone, el compilado no
puede descargarse directamente en un dispositivo, y tampoco se tiene KBN puesto que no crea
metadata para la UI. La forma de prototipar all es a travs del emulador especfico o enchufando
el dispositivo a la computadora.
No siempre se crear el archivo compilado. Depender de si se tiene Startup object configurado
y de la modalidad de ejecucin que se emple (si F5, Run o Run with this only sobre un objeto

Prctico Curso Smart Devices & GAM Evolution 3

main, etc.) En nuestro caso an no tenemos el archivo compilado, por lo que aparecen
deshabilitados.

En este caso el emulador est abriendo el KBN (Knowledge Base Navigator) que muestra
la URL para ejecutar el dashboard de la aplicacin (nico objeto main que se tiene
hasta el momento). Si no abri el emulador genymotion antes, GeneXus abrir el del SDK
de Android:

Si abri antes del F5 el emulador genymotion, ver una pantalla como la que sigue:

Prctico Curso Smart Devices & GAM Evolution 3

Nota: si tiene un dispositivo iOS, y quiere probar all, instlese el KBN (obtngalo en forma
gratuita del market place), ejectelo, y mediante el men, elija la opcin Add Knowledge
Base y luego +. Escanee el QR code que aparece en el Developer Menu para el KBN (el
nico que aparece habilitado). Grabe y pruebe.
En el emulador Android:

Al hacer tap sobre la URL, se muestra el layout correspondiente al Dashboard:

Hacer tap sobre Speakers

o Observar que aparecen los mismos oradores que se ingresaron desde la
aplicacin Web
o Observar los atributos que se estn mostrando de cada orador. Ir a GeneXus a
buscar en el Pattern el Layout de este List, para ver la correspondencia.

Prctico Curso Smart Devices & GAM Evolution 3

Hacer tap sobre un orador cualquiera, y vea cmo aparece el detalle del mismo
(este es el Layout correspondiente al modo View o al Edit?):

Editar el Orador que est visualizando (para ello observe el cono que aparece arriba a
la derecha)
Al hacerlo qu Layout se est desplegando para esta Seccin General del detalle? El
del modo View o Edit?

Insertar un nuevo Speaker. Para ello:

10

Prctico Curso Smart Devices & GAM Evolution 3

Intentar dejar vaco el nombre o el apellido. A quin se invoca cuando se presiona el

cono a la derecha de CountryId? Grabar. Por qu no le permite realizar la operacin?
Ingresar el nombre o apellido y volver a probar. Observar cmo aparece el nuevo orador
en la lista.
Pruebe hacer bsquedas de oradores por nombre. Luego pruebe por apellido. Por qu
otros datos puede hacer searchs? Vaya al Work With a observar dnde estn
configuradas esas bsquedas. Elimine alguna si no le parece conveniente.
Pruebe filtrar por el pas:

Ejecutando la aplicacin en forma Compilada

En lugar de interpretar la aplicacin a travs del KBN, ejecutar en el emulador el

compilado.

Para esto existen varias alternativas:

11

Prctico Curso Smart Devices & GAM Evolution 3

Hacer botn derecho sobre la pestaa del Dashboard y elegir la opcin Run With this
Only o Run. (Elegir una de estas opciones, as el F5 sigue generando la aplicacin
Web y la de Smart Devices interpretada).
Si NO est usando la Trial: Especificar el Dashboard como Startup Object. (botn
derecho sobre la pestaa del mismo / Set As Startup Object o Preferences/.Net
Environment, propiedad Startup Object). En el prximo F5 se compilar slo la aplicacin
que depende de este objeto, es decir, en este caso, slo la aplicacin para Smart Devices
cuyo punto de entrada es el Dashboard. No abrir el Developer Menu Web, sino slo el
Emulador con el Dashboard compilado ejecutndose.
Existen ms alternativas. Sugerimos buscarlas en el wiki: wiki.genexus.com

Recordar que al compilar, aparecer en el Developer Menu el QR Code correspondiente.

Puede obtenerlo mediante View / Show QR Codes:

Si cuenta con dispositivo Android, pruebe, a travs de su programa de lectura de QR

Codes, descargarse e instalar la aplicacin compilada.

4. Desarrollando la Aplicacin
Diseo - Themes e Imgenes

Observe los themes que tiene en su KB, y qu theme se utiliza para cada plataforma
(para ello, acceda al folder Customization, nodo Themes y SD Platforms Any Android,
Any iOS, Blackberry Phone, Any iOS7, Any Windows 8, Windows Phone). Abra, por
ejemplo, el theme SimpleAndroid. Observe las clases bajo la de nombre Table. Existe
una de nombre TableColored?

Importar 2-ThemesImagesDomains.xpz
Este xpz contiene las imgenes de launch y de los conos (para Android e iOS), tambin
las imgenes tab_*. Adems incluye algunos otros Themes y el dominio Colors.

12

Prctico Curso Smart Devices & GAM Evolution 3

Suponga que usted querr desarrollar su aplicacin para Android, iOS e iOS7, por lo que
el diseador grfico le enva estos themes. Nos vamos a concentrar en Android. Abra el
theme EventGXAndroid, y observe la clase TableColored, que se utilizar ms adelante.
Observe cmo se agreg automticamente a los themes preexistentes, como el
SimpleAndroid.

Cambiar el theme para Android, pasando del SimpleAndroid, al nuevo, EventGXAndroid:

Hacer lo mismo para Any iOS (especificndole el theme EventGXiOS) y para Any iOS7
(especificndole el theme EventGXiOS7).

Especificar los conos y launch images de la aplicacin, en las propiedades del

Dashboard, como se muestra en la siguiente figura:

Tambin asignar el title de la aplicacin:

Si tiene dispositivo, compile, instale, y ejecute la aplicacin compilada en su dispositivo,

para ver las imgenes de launch.

13

Prctico Curso Smart Devices & GAM Evolution 3

Personalizando los Objetos

Agregar al Grid que muestra la lista de Speakers, el pas del orador (sin etiqueta) y
cambiar el Name por el FullName.

Agregar una columna entre medio, de 10 dips, para dar espacio entre los contenidos de
la primera columna y la segunda. A la primera asignarle el 30% del ancho restante,
y a la ltima el 70%. Adems, hacer que la imagen ocupe dos filas, y no una
(propiedad Row span).

Cambiar el color de fondo a las filas para que cuando no estn seleccionadas se vean
grises y cuando se seleccionan, azules, como se muestra en la siguiente imagen (para
poder ver el azul de fondo al seleccionar, demore el tap djelo presionado un rato antes
de soltar:

14

Prctico Curso Smart Devices & GAM Evolution 3

Observar que el atributo SpeakerFullName tambin debe ser modificado.

(Observar las clases importadas: AttributeFontColorBlue y TableColoredBlueFront. Si lo
desea, puede modificar la tonalidad del gris en la propia clase, para que se vea ms
claro. Modifique a su gusto las tonalidades de los colores. Tambin podr necesitar
cambiar el color del nombre del pas. Observe las subclases de la Attribute en el theme)
Si est ejecutando el KBN en su dispositivo, haga back hasta la url de entrada, para que
se actualice la metadata automticamente.

Observe que la imagen no est ocupando todo el espacio destinado a la primera columna.
Por qu? Y si se quiere que lo haga? (Fill Keeping Aspect Ratio, observe las clases que
se agregaron en los themes importados, bajo la class Image).
Observe que en el List aparece el caption Work With Speaker arriba. Cmbielo por
Speakers:

Multiples Layouts per Row

Ahora se quiere que cuando el usuario hace tap sobre un Speaker en el List, en lugar de
ir directamente a mostrar la informacin detallada del Speaker, se ample la propia lnea,
mostrando all el Curriculum Vitae.

Para ir al detalle, el usuario deber hacer tap sobre una imagen de flecha (imagen
arrow_blue_right.png que se encuentra en folder Icons)

15

Prctico Curso Smart Devices & GAM Evolution 3

Habr que crear otro tem layout para ese grid y especificar cul debe mostrarse
cuando la lnea/tem est seleccionada. Pista: posicinese sobre el grid, en su extremo
superior derecho y haga clic.
Preste atencin en las propiedades Default Action y Default Selected Item Layout del
grid. Deber deshabilitar la invocacin al Detail cuando se hace tap sobre la lnea, para
que en esta accin se cargue el nuevo layout.
Al agregar la imagen con la flecha, en una cuarta columna, deber redefinir los tamaos
de las columnas: 30%;10dip;55%;15%.
Para el CV, le recomendamos que se expanda a las 4 columnas y que pueda crecer (Auto
Grow en true ocupando el tamao que necesite)
Recuerde que a los controles en el form se les pueden asociar eventos relativos a las
acciones que el usuario puede realizar con el dedo sobre ellos (haga botn derecho sobre
el control imagen, Go to Event y vea qu sucede). Recuerde cul era la sintaxis de las
invocaciones al Detail:
(solucin: WorkWithDevicesSpeaker.Speaker.Detail(SpeakerId))

Agregando nuevas Transacciones

Importar 3-MoreTransactions.xpz.
Este xpz contiene, entre otras cosas:

TRNs: Track, Room, Session, Restaurant, y FavoriteSessions

Folder SampleData con los data providers:

16

Prctico Curso Smart Devices & GAM Evolution 3

o DPRestaurant
o DPTrack
o DPRoom
o DPsession
Dominios: Description, Discount, Floor
Folder: EventProcsDP con los procedimientos
o Procedure: GetSessionSpeakers
o Procedure: GetSessionTracks
o Procedure: GetEventDates (para obtener fecha inicial y fecha final del
evento)
o Procedure: IsFavoriteSession
o Procedure: SetFavoriteSession
Web panel Home
Imgenes:
o Sample_restaurant*
o Sample_room*
o Clock*
o no_favorites
o favorite*
o set_favorite*
Theme: EventGXAndroid y EventGXiOS7 (si haba modificado alguna propiedad de
las clases de estos themes, tenga cuidado, pues sern sobreescritos. Grbelos con
otro nombre)
Dashboard: EventDay

Hacer un Rebuild all, reorganizando. Ejecutar. Ir al Web Panel Home para inicializar
con datos las nuevas entidades.

Tomarse un tiempo para familiarizarse con la estructura de la Transaccin Session que

almacena la informacin de las Conferencias del evento

Ejecutar el Dashboard, ir a la opcin Sessions (mostrar el List del Work with)

17

Prctico Curso Smart Devices & GAM Evolution 3

Observar
que
cada
Session
se
carga
con
un
color
determinado.
Observar qu sucede con el color mientras hace tap sobre una lnea. Cmo se program
ese comportamiento?

Las Sessions salen agrupadas por da y hora Cmo se hizo esto?

Si ahora quiere que cuando la Session es una Keynote, se muestre distinta la

informacin, por ejemplo, agregando la descripcin (como se ve en la pantalla que
sigue, para la primera session GeneXus and the technology context). Cmo se
implementa?

18

Prctico Curso Smart Devices & GAM Evolution 3

Recuerde la propiedad ItemLayout dinmica, del grid. Y la Auto Grow, esttica, para
SessionDescription.
Observar cmo el detalle de una Session solamente puede ser visualizado (no tiene
posibilidad de CRUD). Cmo se logr?

Si en vez de mostrar la info de Detail como Tabs (imagen de la izquierda), se desea

mostrar Inline la primera seccin y como Link la segunda (la de los Speakers, imagen
de la derecha), Cmo se consigue?

Recuerde que al eliminar el control <All Sections Content> del Detail, en la Toolbox
reaparecer, junto con uno por cada <Section> individual. Si coloca las dos sections
individuales, recuerde observar la propiedad Rows Styles, y asegrese de colocar el valor
pd (Platform Default) para la segunda

Transaccin Restaurant

Observar la Transaccin Restaurant. Se quiere que la lista de Restaurants no se muestre

de la manera estndar, sino que los restaurantes se muestren como puntos en un
mapa, ya que contienen un atributo geolocation. Y que al hacer tap sobre un punto, se
vea su informacin, y al hacer tap de vuelta, sobre sta, se muestre su detalle.

19

Prctico Curso Smart Devices & GAM Evolution 3

Pista: refiere a la manera de mostrar la informacin del grid: al tipo de control que es.
Debe tener instalado en el emulador o en el dispositivo la aplicacin de mapas.

Personalizando las Pantallas de View y Edit

Personalizar las pantallas de View y de Edit del Detail del Speaker para que luzcan en
ejecucin de manera diferente, por ejemplo, como se muestran en las siguientes figuras:

20

Prctico Curso Smart Devices & GAM Evolution 3

Probar en ejecucin. El objetivo es familiarizarse con los distintos layouts de un mismo

objeto.
Si se desea que el Detail del Work With Sessions se muestre de manera diferente
cuando se ejecuta en Android que cuando se ejecuta en iOS, tal como se ve en las
imgenes que siguen, cmo se implementa?
Observe que en iOS se estn mostrando los speakers como un grid horizontal en la
misma pantalla en la que se muestra la infomacin general, mientras que en Android los
speakers se visualizan en otra pantalla, siguiendo un link.
Adjuntamos el xpz 4-WorkWithDevicesSession por si desea obtener una implementacin
ya realizada.

21

Prctico Curso Smart Devices & GAM Evolution 3

Modificando el Estilo de Navegacin (Navigation Style)

Modifique el orden de las opciones del dashboard, para que la primera sea Sessions
Modificar el estilo Navegacin de la aplicacin para que al ejecutarse en telfonos
Android sea Slide
Ejecutar y probar los cambios realizados
Observar que se puede acceder al Dashboard desplazando con el dedo el borde izquierdo
de la pantalla hacia la derecha, o con el smbolo
Bar, a la izquierda:

que aparece en la Application

Observar que se abre directamente el List de Sessions

Si desea que en ese caso se muestre una pantalla de bienvenida, en lugar del List
cmo lo implementa? Tendr que crear un Panel for Smart Devices para implementar
dicha pantalla. Ahora, en ejecucin, cuando abra la aplicacin, se ver la pantalla como
se muestra en la figura de la izquierda. Y podr acceder a todas las opciones deslizando
el men: (pantalla derecha).

22

Prctico Curso Smart Devices & GAM Evolution 3

Si tiene algn dispositivo distinto de un Android Phone, o tiene tambin creado un

dispositivo virtual tableta en genyumotion, pruebe en l. No deber abrirse la pantalla de
bienvenida.
Ahora vuelva al estilo de navegacin Default y observe si se ejecuta o no la pantalla de
bienvenida.

Transitions
Hacer que el List de Sessions se abra desde abajo (Push up) cuando se lo invoca desde el
dashboard y slo en ese caso.

Recordar las CallOptions para configurar una invocacin.

rdenes y filtros
Abra el List de Speakers y observe el orden por el que se est mostrando la informacin. Vaya a
GeneXus y modifquelo por SpeakerFullName. Prubelo en ejecucin.
Y si ahora quiere adems dar la posibilidad al usuario de ordenar por pas? Implemntelo.

23

Prctico Curso Smart Devices & GAM Evolution 3

Y si quiere que de elegir esta segunda opcin, la informacin se muestre agrupada por pas y
ordenada dentro de cada pas por SpeakerFullName?

Observar los atributos por los que se puede hacer Search. Quitar algunos (por ejemplo el CVMini)
y probar.

Comportamiento
Querremos mostrar slo los primeros 145 caracteres del CV de un Speaker en el List y no todo
su contenido:

24

Prctico Curso Smart Devices & GAM Evolution 3

Pista: recuerde la funcin substr. Tambin le puede ser til el mtodo Length.

Y si desea cambiar el color de fondo de la tabla, en forma dinmica, y el color del Speaker Full
Name?:

Observe las clases TableColoredWhite y AttributeFontColorViolet en el theme

EventGXAndroid.
Solucin:
Event Load
Table1.Class = "TableColoredWhite"
SpeakerFullName.Class = "AttributeFontColorViolet"
If SpeakerCVMini.Length() > 145
&SpeakerCVMini = substr(SpeakerCVMini,1,145) + "..."
Else
&SpeakerCVMini = SpeakerCVMini
EndIf
Endevent

25

Prctico Curso Smart Devices & GAM Evolution 3

Integracin con el calendario y la libreta de direcciones

Observar que al visualizar la informacin detallada de una conferencia, se ofrece shedularla, es
decir, se abre el Calendar instalado en el dispositivo. Tambin se le ofrece compartir la
informacin de la conferencia, para lo que se le abre una ventana para que el usuario seleccione
la aplicacin para compartir esa informacin. Ver cmo se program esto en GeneXus (Section
(General)).

Si ahora desea que cuando se inserta un nuevo Speaker en el sistema (a travs del List),
inmediatamente se ofrezca insertarlo en la libreta de direcciones del dispositivo, cmo lo
implementa?

Solucin: siendo &speaker un Business Component.

Event 'Insert'
Composite
WorkWithDevicesSpeaker.Speaker.Detail.Insert(&speaker)
Confirm( "Insert it as a contact?")
AddressBook.AddContact(&speaker.SpeakerName, &speaker.SpeakerSurname,
&speaker.SpeakerEmail, &speaker.SpeakerPhone, "", &speaker.SpeakerImage,
"")
endcomposite
EndEvent

26

Prctico Curso Smart Devices & GAM Evolution 3

Si lo desea, importe el 5-Event_Twitter.xpz para observar cmo se puede implementar la

integracin con Twitter, a travs de un panel para mostrar los tweets asociados al evento. Vaya
a su dashboard y agregue una opcin, con cono tab_tweets, que invoque al Panel for Smart
Devices EventTweets. Ejecute esa opcin y vea cmo se muestras los tweets del hashtag
#Genexus.
Nota: La TwitterAPI slo funciona con la aplicacin compilada, no con el KBN.

Transaccin EventSetting
Si no import el xpz para implementar la integracin con Twitter, cree la siguiente transaccin.
En caso contrario, ignore lo que sigue pues ya viene implementado en el xpz.

En esta Transaccin se configuran las preferencias generales del Evento, como el

hashtag que se usar en Twitter para referenciar al evento, y la clave de desarrollador
en https://dev.twitter.com/, la fecha de inicio y fin del evento, y el lugar donde se
realizar el mismo.

Aplicar el WWSD a la Transaccin EventSetting y agregar un item en el Dashboard

para invocarlo. Configurar la imagen tab_Settings al item del dashboard:

Ejecutar la aplicacin presionando F5 y agregar datos.

27

Prctico Curso Smart Devices & GAM Evolution 3

6. Activacin del GAM

Antes de continuar, congele la versin actual de desarrollo, para tener un respaldo del
estado actual de la KB.

Esto se logra desde la opcin View/Versions, Freeze sobre la versin.

Incorporar el GeneXus Access Manager (GAM) para obtener un control de acceso

automtico.
Para ello: Configurar la propiedad a nivel de la Versin Enable Integrated Security en True,
y presionar Install:

Nota importante: asegrese, cuando finalice la importacin de todos los objetos del
GAM, que la propiedad Enable Integrated Security haya quedado efectivamente en
True. Si no es as, pngala nuevamente en True y presione Install nuevamente.

28

Prctico Curso Smart Devices & GAM Evolution 3

Observar:

Las propiedades que aparecen luego de la Activacin del GAM

Todos los objetos que se importan en la KB tras el cambio anterior (en el Folder
View encontrar dos nuevas carpetas, GAM_Examples y GAM_Library)
Qu objetos son los que se configuran automticamente en las propiedades
Login Object for Web y Login Object for SD?

Hacer Rebuild All (tomar su tiempo) y luego F5. Confirme que desea crear la base de
datos del GAM:

Nota: Se requiere el driver MySQL para .NET (libmySQL.dll ) para poder crear la base de datos del
GAM contra MySql. Si no est prototipando con .NET (en ese caso ya la tiene), asegrese de
instalarla en C:\Windows\SysWOW64 si su CPU es de 64 bits y en C:\Windows\System si es de 32
bits, desde el siguiente link: http://sourceforge.net/projects/mysqldrivercs. Ver ms informacin en
el wiki: http://wiki.gxtechnical.com/commwiki/servlet/hwikibypageid?2041

Ejecutar la aplicacin en el Smart Device o emulador. Ver que como pantalla inicial,
ahora aparece la de login. Ingresar con los siguientes datos de login:

User: admin
Password: admin123

29

Prctico Curso Smart Devices & GAM Evolution 3

Ejecutar el Developer Menu, e intentar acceder a una Transaccin. No podr, sin pasar
antes por el Login. Prubelo.

Ingresar con los siguientes datos:

usuario: admin
password: admin123

Desde el Developer Menu ejecutar el Web panel GAM Home y observar el Backend
para administrar la Seguridad

30

Prctico Curso Smart Devices & GAM Evolution 3

Definir un nuevo usuario desde la opcin Users

Asignarle rol de administrador.

Configuracin de la Seguridad a nivel de Objeto

En realidad no queremos tener seguridad para toda la aplicacin, sino solamente para acceder
a la informacin de EventSetting. Implemntelo.
Para ello:

Configurar la propiedad Integrated Security Level = None a nivel de la Versin:

Configurar la propiedad Integrated Security Level = Authentication slo para el

Work With for Smart Devices correspondiente a la transaccin EventSettings.
Esta configuracin permite que no sea necesario loguearse para ingresar a las opciones
del Evento, SALVO, para ingresar a la opcin Settings, donde aparecer la pantalla de
login.

31

Prctico Curso Smart Devices & GAM Evolution 3

Realizar un Rebuild All, y ejecutar la aplicacin presionando F5 para verificar los

cambios realizados.

Nota: Al ingresar al Dashboard, primero seleccionar Menu/Logout para desloguear el usuario que se
haba usado anteriormente. Si tiene el estilo de navegacin Slide, cmbielo al Default, y pruebe.

7. Convirtiendo la Aplicacin a Offline

Queremos que toda la aplicacin, a excepcin de la parte que requiere autenticacin (en
nuestro caso, los settings del evento) pueda ejecutarse offline. Implemntelo.
Para ello:
Configurar en el Dashboard la propiedad Connectivitiy Support = Offline
Configurar en la Transaccin EventSetting la Connectivitiy Support = Online
Y tambin el panel EventTweets.

Recordar que el login del GAM solo se puede realizar desde un objeto Online.

Hacer un Rebuild All y verificar que se crea el objeto Offline Database indicando
cules sern las tablas que se crearn en el dispositivo.
Configurar el mecanismo de Sincronizacin de datos (Propiedades para el Send y
Receive) que desee. Es decir, cundo desea enviar los datos (en nuestro caso, los que
se puedan haber ingresado/actualizado/eliminado en el dispositivo a travs de los Work
With que s tienen los modos de Edit disponibles vimos que Session no lo tiene) y
cundo y cmo recibir datos del servidor cuando se est conectado.
Ejecutar la aplicacin (recuerde que deber necesariamente ejecutarla compilada. No
podr utilizar el KBN) y observar que se realiza la carga de datos en la base de datos
local del dispositivo.

Desconectar el dispositivo y verificar que la aplicacin funciona correctamente. Ingrese

algn registro nuevo, por ejemplo, un nuevo pas. Marque como favorita alguna Session.

32

Prctico Curso Smart Devices & GAM Evolution 3

Intentar ingresar a la opcin Settings, verificar que el login slo funciona si el

dispositivo est conectado.
Ingrese algn pas nuevo a travs del Developer Menu web. Observe que lo ingresado
en el dispositivo, no est en la DB centralizada. Luego conecte el dispositivo a internet y
observe que los datos son sincronizados, de acuerdo a los criterios que usted defini para
send y receive (dej para receive el criterio On launch application y after 600 seconds?
Qu deber hacer entonces para recibir en el dispositivo los cambios hechos a travs
del Developer Menu?)

33