Agentes Aplicación de Pedidos de Ventas para tablets en Android

Transcripción

1 INGENIERÍA TÉCNICA DE INFORMÁTICA DE GESTIÓN Desarrll de aplicacines para dispsitivs móviles Agentes Aplicación de Pedids de Ventas para tablets en Andrid Autr JOSÉ ÁNGEL GARCÍA LÓPEZ Cnsultr Víctr Carceler Hntria Juni de 82

2 Índice 1. Presentación del pryect Intrducción Características del sistema Justificación de la tecnlgía elegida Objetivs del pryect Descripción de funcinalidades Planificación Calendari del pryect Diagrama de Gantt Diseñ técnic Subsistemas Intrducción sbre el sistema prpuest Subsistemas prpuests Clases Diagrama general de clases Diagramas de clases y fichas CRC Cass de us Mdifica Parámetrs Usuari Cnsulta Cliente Cnsulta Artícul Alta Pedid Baja Pedid Mdifica Pedid Realiza Sincrnización Interfaces principales Menú Parámetrs usuari Cnsultar clientes Cnsultar artículs Pedids Líneas de Pedids Sincrnización Diseñ de la persistencia Mdel de dats Diagrama ER (Entidad-Relación) Mdel relacinal Script de creación de la base de dats Diseñ del prttip y evaluación Intrducción Prttip vertical de alta fidelidad Prttip de pantalla menú Prttip de pantalla de parámetrs usuari Evaluación del prttip Navegación Funcinalidad Cntrl Lenguaje Realimentación Cnsistencia de 82

3 3.3.7 Prevención y crrección de errres Claridad visual Implementación Entrn de desarrll Estructura de la aplicación Carpeta /src Carpeta /gen Carpeta /bin Carpeta /res Ficher AndridManifiest.xml Análisis de Testing Pruebas de integración Test unitaris Dcumentación Técnica Relación de clases Clases entidad Clases cntrladras Clases gestras Layuts (pantallas) Códig fuente de la aplicación Relación de funcinalidades Funcinalidades actuales de la aplicación Funcinalidades futuras a añadir en la próxima revisión Manuales Manual de instalación Descarga Instalación Manual de usuari Parámetrs de usuari Carga inicial Cnsultar clientes Cnsultar artículs Pedids clientes Sincrnización Índice de figuras Bibligrafía de 82

4 1. Presentación del pryect 1.1 Intrducción El presente pryect tiene cm bjet el desarrll de una aplicación para la red de ventas de una empresa que distribuye prducts de mda (rpa, calzad y cmplements). Actualmente ls agentes cmerciales intrducen ls pedids en un PC prtátil equipad cn Windws XP. Tant ls equips, que llevan ls agentes cmerciales, cm la aplicación han quedad bslets. Así mism, en numersas casines, ls agentes cmerciales ns han cmentad que sería más práctic, cómd y liger pder intrducir ls pedids mediante tablets. La empresa se ha plantead la renvación de ls equips prtátiles pr dispsitivs móviles. El cambi de PCs prtátiles a dispsitivs móviles (tablets) supndría un gran ahrr. 1.2 Características del sistema El principi, se necesitarían tablets equipadas cn sistema perativ Andrid. El frmat de pantalla de 7 cn Wifi sería más que suficiente. N se necesita mucha capacidad. Hay gran variedad de dispsitivs que tienen estas características. En la central, se necesitaría una carpeta cmpartida en el servidr para intercambiar infrmación entre ls cmerciales y el ERP. Las tablets deberán cnectarse a la VPN de la empresa para pder acceder al servidr. A cntinuación mstrams un diagrama de cóm sería la cmunicación entre las tablets y la central. Figura 1. Diagrama general de cmunicacines 1.3. Justificación de la tecnlgía elegida La elección del dispsitiv. Actualmente ls agentes cmerciales viajan cn prtátiles l que les supne una carga más a la hra de visitar a ls clientes. Ells necesitan dispsitivs ligers y fáciles de manejar. Se pdría haber elegid un smartphne, per ests dispsitivs tienen la pantalla pequeña y la intrducción de pedids se pdría demrar much llegand inclus a ser tedisa y 4 de 82

5 desesperante. Sin embarg, las tablets sn más ligeras que ls PCs prtátiles y tienen la pantalla más grande que ls smartphnes. Pr es he pensad que las tablets sn ideales para interactuar cn este tip de tareas. La elección del sistema perativ. Dentr del mercad de las tablets ls sistemas perativs predminantes sn: el Andrid de Ggle y el ios de Apple. A este mercad, dminad principalmente pr ests ds grandes, se ha incrprad recientemente Micrsft cn su Windws RT (versión de Windws 8 ptimizad para tablet). A pesar que ios llevaba ventaja en este mercad, Andrid ha id recrtándle en ls últims añs hasta igualarl. Seguramente, en un futur cercan, Andrid terminará superand a ios en el mercad de las tablets, cm ya ha sucedid cn ls smartphnes. Las tablets de Apple, ipad en sus diferentes versines, sn dispsitivs estéticamente bien diseñads, fáciles de manejar, existen multitud de aplicacines en AppSre y sn bastante segurs. Sin embarg, sn excesivamente prpietaris, td pasa pr Apple, n sn multitarea (más bien pseud-multitarea), las pcines de persnalización sn reducidas y el cste del dispsitiv (ipad) es car. Figura 2. ipad cn ios En cambi tenems multitud de dispsitivs en Andrid, que van desde las de baj preci (mens de 200 ) hasta las de alta gama. Andrid es un sistema multitarea, bastante persnalizable, abiert, dispnibilidad de la tecnlgía NFC, tiene rganizadr de archivs, existen multitud de aplicacines en Ggle Play, permite expansión de almacenamient y recncimient de vz ffline. Figura 3. Nexus 10 cn Andrid Pr td ell, y además que el SDK de Andrid se pueda instalar en Eclipse y permita Java, herramientas que ya cnzc, han hech que elija Andrid cm platafrma para implementar la aplicación. 1.4 Objetivs del pryect El bjetiv que persigue el presente pryect es dtar a la red cmercial de una aplicación, para tablets cn sistemas Andrid, que les permita realizar sus tareas básicas en las accines cmerciales que llevan a cab diariamente. Las tareas básicas que realizarán serán: cnsultar las fichas de clientes, cnsultar el catálg de artículs y creación de nuevs pedids. La sustitución de ls PCs prtátiles, que actualmente usan, pr tablets permitirá a ls agentes trabajar más cómds y ligers. También supndrá un gran ahrr para la empresa. Si la 5 de 82

6 empresa sustituyera ls PCs prtátiles pr nuevs tendría que hacer una inversión de 700 pr unidad. En cambi, se puede cnseguir una buena tablet en Andrid pr 350. Est supne casi un 50% de ahrr. 1.5 Descripción de funcinalidades A cntinuación detallams las funcines principales que realizará la aplicación: Opcines: Aquí definiríams parámetrs cm el códig de cmercial, la cntraseña para acceder a la aplicación, la ruta de la carpeta del servidr y trs parámetrs. Carga inicial: Mediante esta pción se haría un vlcad de tds ls artículs, clientes y pedids en curs a la base de dats lcal del dispsitiv. Cnsulta de clientes: Aparecería la lista de clientes del cmercial. Pdríams hacer búsquedas pr nmbre. También debería tener alguns filtrs pr pblación prvincia. Cnsulta de artículs: Ns mstraría el catálg de artículs, pr tempradas, familias y artículs. Al seleccina un artícul entraríams dentr de su ficha. Cnsulta de pedids: Ns aparecerían ls pedids pendientes de servir rdenads pr fecha de servici de la más próxima hacia delante. Al seleccinar un pedid ns aparecería el desglse de las líneas de dich pedid. Creación de nuevs pedids: En esta pantalla ns pediría el cliente y fecha de servici en la cabecera. A cntinuación iríams intrduciend líneas de pedid. Para ell, iríams añadiend líneas. Para cada nueva línea seleccinaríams el artícul del catálg. Si tiene tallas le intrduciríams la cantidad pr talla y sin la cantidad ttal. Así, hasta finalizar el pedid. Sincrnización: En esta pción, una vez cnectads a la VPN, haría ds prcess. El primer recibiría tdas las altas y mdificacines de clientes, artículs y pedids. El segund prces, enviaría ls nuevs pedids. 6 de 82

7 1.6 Planificación Calendari del pryect Figura 4. Calendari del pryect 7 de 82

8 1.6.2 Diagrama de Gantt Figura 5. Diagrama de Gantt del pryect 8 de 82

9 2. Diseñ técnic 2.1 Subsistemas Intrducción sbre el sistema prpuest Para el sistema prpuest hems decidid usar una estructura pr capas. Dicha estructura se aprxima al patrón Mdel-Vista-Cntrladr. Este mdel de abstracción separa ls dats de una aplicación, la interfaz de usuari y la lógica de negci en tres cmpnentes distints (mdel, vista y cntrladr). Figura 6. Diagrama que muestra la relación de ls cmpnentes MVC A cntinuación vams a describir ls cmpnentes de este patrón: Mdel: Esta es la representación específica de la infrmación cn la cual el sistema pera. Vista: Usualmente viene a ser la interfaz de usuari dnde se presenta el mdel en un frmat adecuad para interactuar. Cntrladr: Este respnde a events, usualmente accines de usuari, e invca peticines al mdel y, prbablemente, a la vista. Cn la utilización de dich patrón se pretende separar la capa visual gráfica de su crrespndiente prgramación y acces a dats, alg que mejra el desarrll y mantenimient de la Vista y el Cntrladr en paralel, ya que ambs cumplen cicls de vida muy distints entre sí. En el pryect, que se intenta acmeter, las tres capas bien diferenciadas serán: pantalla, cntrladr y gestr Pantalla Esta capa se refiere al interfaz gráfic cn el que tendrá que interactuar el usuari. Este tip de clases, en Andrid, heredan del cmpnente Activity. En cncret, las pantallas en Andrid se crrespnden cn ls Layuts que están en frmat XML y que darán la apariencia a las vistas. Mediante estas clases se capturarán y validarán las entradas de dats pr parte del usuari. También mstrarán tda la infrmación necesaria que se necesite para la navegación entre las diferentes pantallas. La clase pantalla se cmunicará cn la clase cntrladr para respnder a las accines de ls usuaris. Esta clase n debería realizar funcinalidades tales cm crear mdificar bjets de negci, sin slamente ntificar que se desean realizar estas funcinalidades a la capa cntrladr. 9 de 82

10 Cntrladr Mediante esta capa se encapsula la lógica de negci. Las clases de este tip prprcinan métds a las clases superires, que les permiten cnsultar, crear, mdificar, enlazar, etc. diferentes bjets de frma sencilla y transparente a su implementación. Una clase cntrladr n debería acceder a la base de dats, ni cncer la estructura lógica que psee (tablas, clumnas, etc.). N debe cntener nada de códig SQL. Dicha capa para acceder a la base de dats enviará peticines a la capa gestr Gestr Esta capa se encarga de la persistencia, y realizará tdas las funcines de acces a la base de dats. Dicha capa cnce la estructura de la base de dats (tablas, clumnas, índices, relacines, etc.). Además cnce el mape que existe entre ls bjets de negci y la base de dats. A su vez, prprcina a la capa superir ls métds que permiten insertar, cnsultar, mdificar y brrar en la base de dats Subsistemas prpuests De cara a facilitar el desarrll psterir de la aplicación, dividirems la aplicación en cuatr subsistemas. Ests subsistemas crrespnden a diferentes funcinalidades que desempeñará la aplicación. A cntinuación enumerams ls subsistemas que cnfrmarán la aplicación: Subsistema de menú y parámetrs de usuari Este subsistema estará frmad pr el menú de pcines de la aplicación y ls parámetrs del usuari. Cuand entrams a la aplicación se ns muestra el menú. En dicha pantalla verems ls btnes para acceder a ls diferentes apartads de la aplicación. Ls btnes tendrán que ser identificativs de cada acción a realizar. Ls parámetrs de usuari cntendrán dats relativs al perfil del agente. Dicha pantalla se accederá desde el menú. Entre ls dats que pdrá cntener serán el códig de usuari, nmbre del agente, etc Subsistema de cnsultas de clientes y artículs La cnsulta de clientes y la cnsulta de artículs frmarán este subsistema. Su función es permitir al agente buscar dats relativs a clientes y artículs. A la cnsulta de clientes se accederá desde el menú principal y ns mstrará una lista de clientes. En dicha lista pdrems aplicar diferentes criteris de búsquedas (nmbre, pblación, etc.). Igualmente la cnsulta de artículs, tras acceder desde el menú, ns mstrará la lista de ls artículs. También, pdrems aplicar diferentes filtrs de búsquedas (descripción, familia, temprada, etc.) Subsistema de pedids Mediante el subsistema de pedids pdrems crear nuevs pedids, cnsultar ya creads y mdificar aquells que tdavía n se hayan enviad. Accederems a la pantalla de pedids a través del menú. En dicha pantalla, ns mstrará la lista de pedids que tenems. Pdrems hacer búsquedas cn diferentes criteris (cliente, 10 de 82

11 temprada, fecha servici, etc.). Para crear nuevs pedids pulsarems el btón añadir pedid. Para mdificar, seleccinarems un pedid primer, y, pulsarems el btón mdificar, si el pedid está enviad n ns dejará mdificarl. Para cnsultar, igualmente, seleccinarems un pedid un pulsarems el btón cnsultar Subsistema de sincrnización Este subsistema será el encargad de intercambiar la infrmación entre la aplicación que maneja el agente cmercial y la central. Pr un lad, recibirá las mdificacines de clientes y artículs de la central, y pr tr, enviará ls nuevs pedids que se han cread. Tras acceder a esta pción a través del menú, la aplicación, a través de la VPN, accederá a la carpeta del servidr y recibirá el ficher cn las mdificacines en clientes y artículs. A cntinuación, recrrerá el ficher y actualizará las tablas de clientes y artículs. Psterirmente enviará el ficher cn ls nuevs pedids a la carpeta del servidr Clases Diagrama general de clases A cntinuación mstrams un diagrama general de las clases prpuestas para el pryect. Figura 7. Diagrama general de clases 11 de 82

12 2.2.2 Diagramas de clases y fichas CRC Para n extenderns demasiad en la memria, en el Anex 1 mstrams ls diagramas de clases y jerarquías UML de ls diferentes subsistemas. También se muestran las fichas CRC (clase, respnsabilidad y clabración) Cass de us Mdifica Parámetrs Usuari Descripción El agente entrará en la pantalla de parámetrs de usuari. Al entrar, la aplicación buscará el primer usuari que tenga. Si existe se mstrarán ls dats, en cas de que n exista la aplicación devlverá un mensaje de que n hay usuaris. Prcederems entnces a rellenar ls camps crrespndientes. Para finalizar la intrducción pulsarems el btón de Guardar. Si n existía ningún usuari se insertará un nuev en la base de dats y el prgrama devlverá el mensaje de que se ha insertad el usuari. En cas de que ya existiera, se prcederá a mdificar el usuari y el prgrama devlverá el mensaje de que el usuari ha sid mdificad. Tras insertar mdificar el usuari en la base de dats saldrá de la pantalla. Si en vez de pulsar Guardar se pulsara el btón Cancelar avisará de que ls dats n van a ser guardads y pedirá cnfirmación para salir de la pantalla Diagrama del cas de us A cntinuación se muestra el diagrama de cas de us. Figura 8. Cas de us Mdificar Parámetrs Usuari 12 de 82

13 2.3.2 Cnsulta Cliente Descripción El agente entrará en la pantalla de clientes a través de menú. En la cabecera de la pantalla, tendrá un camp de edición dnde intrducirá el nmbre del cliente a buscar. A cntinuación pulsará el btón Buscar y le aparecerán abaj en la lista ls clientes que cincidan cn la búsqueda. Tras seleccinar el que querems ver, debaj de la lista aparecerán tds ls dats de dich cliente Diagrama del cas de us A cntinuación se muestra el diagrama de cas de us Cnsulta Artícul Descripción Figura 9. Cas Cnsulta Cliente El agente entrará en la pantalla de artículs a través de menú. En la cabecera de la pantalla, tendrá un camp de edición dnde intrducirá la descripción del artícul a buscar. A cntinuación pulsará el btón Buscar y le aparecerán abaj en la lista ls artículs que cincidan cn la búsqueda. Tras seleccinar el que querems ver, debaj de la lista aparecerán tds ls dats de dich artícul Diagrama del cas de us A cntinuación se muestra el diagrama de cas de us. 13 de 82

14 2.3.4 Alta Pedid Descripción Figura 10. Cas Cnsulta Artícul El agente entrará en la pantalla de pedids. A cntinuación pulsará el btón + que se encuentra a la derecha de la lista de pedids. Act seguid irá a la cnsulta de clientes para seleccinar un cliente. Después de seleccinarl vlverá a la pantalla de pedids de clientes y le pedirá la fecha de servici. Para grabar ls dats de la cabecera de pedid pulsarems el btón de Guardar. El prgrama devlverá el mensaje de que se ha insertad el pedid. Si en vez de pulsar Guardar se pulsara el btón Cancelar avisará de que ls dats n van a ser guardads y pedirá cnfirmación para salir del alta del pedid. Una vez grabada la cabecera del pedid, pdems seguir graband líneas de pedids Diagrama del cas de us A cntinuación se muestra el diagrama de cas de us. 14 de 82

15 2.3.5 Baja Pedid Descripción Figura 11. Cas de us Alta Pedid El agente entrará en la pantalla de pedid a través de menú. En la cabecera de la pantalla, tendrá un camp de edición dnde intrducirá el nmbre del cliente a buscar. A cntinuación pulsará el btón Buscar y le aparecerán abaj en la lista ls pedids de ls clientes que cincidan cn la búsqueda. Tras seleccinar el que querems ver, debaj de la lista aparecerán tds ls dats de dich pedid. A la derecha de la lista de pedids tenems el btón -, el cual tendrems que pulsar para dar de baja el pedid. Si se ha enviad, ns aparecerá el mensaje de que está enviad y n se puede brrar. Si n estuviera enviad, ns aparecerá un diálg para cnfirmar la baja del pedid. Si aceptams se dará el pedid y sus líneas de pedid. En el cas de cancelar, n se brrará nada Diagrama del cas de us A cntinuación se muestra el diagrama de cas de us. Figura 12. Cas de us Baja Pedid 15 de 82

16 2.3.6 Mdifica Pedid Descripción El agente entrará en la pantalla de pedid a través de menú. En la cabecera de la pantalla, tendrá un camp de edición dnde intrducirá el nmbre del cliente a buscar. A cntinuación pulsará el btón Buscar y le aparecerán abaj en la lista ls pedids de ls clientes que cincidan cn la búsqueda. Tras seleccinar el que querems ver, debaj de la lista aparecerán tds ls dats de dich pedid. Y pdrems mdificarls siempre y cuand el pedid n haya sid enviad. Para grabar ls dats de la cabecera de pedid pulsarems el btón de Guardar. El prgrama devlverá el mensaje de que se ha mdificad el pedid. Si en vez de pulsar Guardar se pulsara el btón Cancelar avisará de que ls dats n van a ser guardads y pedirá cnfirmación para salir de la mdificación del pedid. También tenems en las líneas de pedids, a la derecha de la lista, ds btnes: el + para añadir líneas y el - para brrar líneas de pedids Diagrama del cas de us A cntinuación se muestra el diagrama de cas de us Realiza Sincrnización Descripción Figura 13. Cas de us Mdifica Pedid El agente entrará en la pantalla de sincrnización y pulsará el btón sincrnizar. El prces de sincrnización cnsta de ds partes. La primera recibirá ls dats de clientes y artículs que se recgerán en el ficher input.txt de la carpeta del servidr. Prcesará secuencialmente este ficher y hará las mdificacines en las tablas de clientes y artículs. Tda esta actividad se irá registrand a la derecha en un cuadr de text de Registr de Actividad. La segunda parte enviará ls pedids que estén pendientes de enviar (aquells que tengan la fecha de enviad 16 de 82

17 en blanc). Ests pedids, cn sus líneas crrespndientes, se grabarán en el ficher utputaammddhhmmss.txt de la carpeta del servidr y se marcarán ls pedids cm enviads. Igualmente la actividad del prces se recgerá en el cuadr Registr de Actividad situad a la derecha de las barras de prgres. Una vez finalizad el prces de sincrnización, ns aparecerá un mensaje de que el prces ha finalizad Diagrama del cas de us A cntinuación se muestra el diagrama de cas de us. Figura 14. Cas de us Realiza Sincrnización 17 de 82

18 2.4. Interfaces principales Menú Descripción La pantalla de menú es muy sencilla. Cnsta de 5 btnes mediante ls cuales se pdrá acceder al rest de las pantallas de la aplicación. De entre las frmas que pdems cnfeccinar un menú hems elegid esta pr la simplicidad que tiene. También pdríams haber realizad un menú cn pestañas, en vez de cn btnes Prttip de pantalla A cntinuación mstrams el prttip de la pantalla de menú. Figura 15. Prttip de Pantalla Menú 18 de 82

19 2.4.2 Parámetrs usuari Descripción En la pantalla de parámetrs usuari pdems ver ds partes. En la primer parte tenems las etiquetas de ls camps del frmulari. En la segunda parte pdems ver ls camps de edición de text que ns permitirán editar y mdificar ls dats del frmulari. Pr últim, en el pie de la pantalla encntrams 2 btnes (Guardar y Cancelar), un para guardar ls cambis intrducids y el tr para cancelar cualquier cambi Prttip de pantalla A cntinuación mstrams el prttip de la pantalla de parámetrs usuari. Figura 16. Prttip de Pantalla Parámetrs Usuari 19 de 82

20 2.4.3 Cnsultar clientes Descripción En la pantalla de cnsultar clientes, pdems diferenciar 3 partes. En la primera, sería el apartad de búsqueda, dnde intrducims ls valres que querems que ns aparezcan en la lista. Aquí tenems un camp de edición para pner el nmbre del cliente a buscar y un btón Buscar que efectúa la acción. En la segunda parte, tenems la lista cn ls clientes que cinciden cn el criteri de búsqueda. Y en la tercera parte, tenems ls dats del cliente que hems seleccinad en la lista Prttip de pantalla A cntinuación mstrams el prttip de la pantalla de cnsultar clientes. Figura 17. Prttip Pantalla Cnsultar Cliente 20 de 82

21 2.4.4 Cnsultar artículs Descripción En la pantalla de cnsultar artículs, al igual que en la de clientes, pdems diferenciar 3 partes. En la primera, sería el apartad de búsqueda, dnde intrducims ls valres que querems que ns aparezcan en la lista. Aquí tenems un camp de edición para pner la descripción del artícul a buscar y un btón Buscar que efectúa la acción. En la segunda parte, tenems la lista cn ls artículs que cinciden cn el criteri de búsqueda. Y en la tercera parte, tenems ls dats del artícul que hems seleccinad en la lista Prttip de pantalla A cntinuación mstrams el prttip de la pantalla de cnsultar artículs. Figura 18. Prttip Pantalla Cnsultar Artículs 21 de 82

22 2.4.5 Pedids Descripción En la pantalla de pedids, pdems diferenciar 4 partes. En la primera, sería el apartad de búsqueda, dnde intrducims ls valres que querems que ns aparezcan en la lista. Aquí tenems un camp de edición para pner el nmbre del cliente a buscar y un btón Buscar que efectúa la acción. En la segunda parte, tenems la lista cn ls pedids de ls clientes que cinciden cn el criteri de búsqueda. También a la derecha de la lista tenems ds btnes, el del + para añadir un nuev pedid y el del - para brrar un pedid n enviad. En la tercera parte, tenems ls dats del pedid seleccinad de la lista que hems añadid. Y en la cuarta parte, tenems las líneas del pedid seleccinad. Aquí, también tenems ds btnes a la derecha, el + para añadir una línea al pedid y el - para brrar la línea seleccinada Prttip de pantalla A cntinuación mstrams el prttip de la pantalla de pedids. Figura 19. Prttip de Pantalla Pedids Clientes 22 de 82

23 2.4.6 Líneas de Pedids Descripción En esta pantalla entrams desde la pantalla de pedids, pulsand el btón + de añadir línea. Pdems diferenciar, en esta pantalla, 3 partes. En la primera, tenems ls dats del pedid al cual pertenece la línea. La segunda parte cntiene ls dats del artícul que estams añadiend a la línea y las cantidades pr tallas que ns pide el cliente. Y pr últim, en la tercera parte, tenems ds btnes, un Guardar que graba la línea del pedid y tr Cancelar que ignra l intrducid Prttip de pantalla A cntinuación mstrams el prttip de la pantalla de líneas de pedids. Figura 20. Prttip Pantalla Líneas de Pedids 23 de 82

24 2.4.7 Sincrnización Descripción En esta pantalla pdems diferenciar 3 partes. En la primera parte tenems el apartad de recibir dats, tant clientes cm artículs. A la derecha encntrams un cuadr de text dnde registrarems la actividad el prces de recibir dats. En la segunda parte de la pantalla encntrams el apartad para enviar dats, tant pedids cm sus líneas. Igualmente tenems un cuadr de text dnde se registrará la actividad del prces de enviar dats. Pr últim, en la tercera parte encntrams el btón Sincrnizar que activa el prces de sincrnización Prttip de pantalla A cntinuación mstrams el prttip de la pantalla de sincrnización. Figura 21. Prttip Pantalla Sincrnización 24 de 82

25 2.5. Diseñ de la persistencia A cntinuación describims ls distints elements que cnfrmarán el diseñ de la persistencia: entidades, atributs y relacines. El cnjunt resultante servirá cm base para la creación de la futura base de dats en SQLite Mdel de dats Desde al análisis de clases, que se manejan en ls diferentes subsistemas, se han identificad las siguientes entidades: Usuaris Clientes Articuls Pedids PedidsLineas En las distintas entidades se han detectad ls siguientes atributs: Usuaris idusuari (númer identificativ del usuari) nmbre passw (cntraseña del usuari) idempresa (númer identificativ de la empresa en el ERP) bservacines Clientes idcliente (númer identificativ del cliente) nmbre nif (dcument identificativ del cliente NIF, NIE, Pasaprte, VAT, ) direccin cdig_pstal pblacin prvincia pais telefn 25 de 82

26 mvil frma_pag bservacines Articuls idarticul (númer identificativ del artícul) descripcin familia temprada preci pvpr (preci venta al públic recmendad) tienetallas (cuantas tallas tiene el artícul) talla1 talla2 talla3 talla4 talla5 talla6 talla7 talla8 talla9 talla10 bservacines Pedids idpedid (númer identificativ del pedid) Clientes_idCliente (númer identificativ del cliente que hace el pedid) fechapedid (fecha en que se realiza el pedid, frmat dd-mm-aaaa) fechaservici (fecha en que se tiene que servir, frmat dd-mm-aaaa) 26 de 82

27 fechaenviad (fecha en que se envía el pedid a la central, frmat dd-mmaaaa, si está enviad n se pdrá mdificar el pedid) bservacines PedidsLineas Pedids_idPedid (númer identificativ del pedid) idlinea (númer de rden de línea en el pedid) Articuls_idArticul (númer identificativ del artícul) cantalla1 (cantidad para la talla 1) cantalla2 (cantidad para la talla 2) cantalla3 (cantidad para la talla 3) cantalla4 (cantidad para la talla 4) cantalla5 (cantidad para la talla 5) cantalla6 (cantidad para la talla 6) cantalla7 (cantidad para la talla 7) cantalla8 (cantidad para la talla 8) cantalla9 (cantidad para la talla 9) cantalla10 (cantidad para la talla 10) cantidad (ttal cantidad línea pedid) bservacines En cuant a las relacines, se han detectad las siguientes: Entre Clientes y Pedids (1:N) Entre Pedids y PedidsLineas (1:N) Entre Articuls y PedidsLineas (1:N) 27 de 82

28 2.5.2 Diagrama ER (Entidad-Relación) Figura 22. Diagrama ER (Entidad-Relación) 28 de 82

29 2.5.3 Mdel relacinal USUARIOS (idusuari, nmbre, passw, idempresa, , bservacines) CLIENTES (idcliente, nmbre, nif, direccin, cdig_pstal, pblacin, prvincia, pais, telefn, mvil, , frma_pag, bservacines) ARTICULOS (idarticul, descripcin, familia, temprada, preci, pvpr, tienetallas, talla1, talla2, talla3, talla4, talla5, talla6, talla7, talla8, talla9, talla10, bservacines) PEDIDOS (idpedid, Clientes_idCliente, fechapedid, fechaservici, fechaenviad, bservacines) dnde {Clientes_idCliente} referencia CLIENTES(idCliente) PEDIDOSLINEAS (Pedids_idPedid, idlinea, Articuls_idArticul, cantalla1, cantalla2, cantalla3, cantalla4, cantalla5, cantalla6, cantalla7, cantalla8, cantalla9, cantalla10, cantidad, bservacines) dnde {Pedids_idPedid} referencia PEDIDOS(idPedid) y dnde { Articuls_idArticul} referencia ARTICULOS(idArticul) Script de creación de la base de dats A cntinuación mstrams el script de creación de la base de dats en SQLite. CREATE TABLE Usuaris ( idusuari INTEGER NOT NULL, nmbre TEXT NULL, passw TEXT NULL, idempresa INTEGER NULL, TEXT NULL, bservacines TEXT NULL, PRIMARY KEY(idUsuari) ); CREATE TABLE Clientes ( idcliente INTEGER NOT NULL, nmbre TEXT NULL, nif TEXT NULL, direccin TEXT NULL, cdig_pstal TEXT NULL, pblacin TEXT NULL, prvincia TEXT NULL, pais TEXT NULL, telefn TEXT NULL, mvil TEXT NULL, TEXT NULL, frma_pag TEXT NULL, bservacines TEXT NULL, PRIMARY KEY(idCliente) ); CREATE TABLE Articuls ( idarticul INTEGER NOT NULL, descripcin TEXT NULL, familia TEXT NULL, temprada TEXT NULL, preci REAL NULL, pvpr REAL NULL, tienetallas INTEGER NULL, talla1 TEXT NULL, talla2 TEXT NULL, talla3 TEXT NULL, talla4 TEXT NULL, talla5 TEXT NULL, talla6 TEXT NULL, talla7 TEXT NULL, talla8 TEXT NULL, talla9 TEXT NULL, talla10 TEXT NULL, bservacines TEXT NULL, PRIMARY KEY(idArticul) ); CREATE TABLE Pedids ( idpedid INTEGER NOT NULL, 29 de 82

30 Clientes_idCliente INTEGER NOT NULL, fechapedid TEXT NULL, fechaservici TEXT NULL, fechaenviad TEXT NULL, bservacines TEXT NULL, PRIMARY KEY(idPedid), ); CREATE TABLE PedidsLineas ( Pedids_idPedid INTEGER NOT NULL, idlinea INTEGER NOT NULL, Articuls_idArticul INTEGER NOT NULL, cantalla1 INTEGER NULL, cantalla2 INTEGER NULL, cantalla3 INTEGER NULL, cantalla4 INTEGER NULL, cantalla5 INTEGER NULL, cantalla6 INTEGER NULL, cantalla7 INTEGER NULL, cantalla8 INTEGER NULL, cantalla9 INTEGER NULL, cantalla10 INTEGER NULL, cantidad INTEGER NULL, bservacines TEXT NULL, PRIMARY KEY(Pedids_idPedid, idlinea), ); 30 de 82

31 3. Diseñ del prttip y evaluación 3.1 Intrducción En el presente apartad intentarems cnstruir un prttip de alta fidelidad, es decir, elabrarems un mdel l más próxim al sistema que pretendems diseñar y desarrllar. Anterirmente hems diseñad un prttip de baja fidelidad cn las pantallas más imprtantes. Sin embarg, en el prttip que vams a abrdar en este apartad, este tip de prttip se utiliza para evaluar de manera más precisa aspects funcinales de usabilidad. En cncret vams a elabrar un prttip vertical, cncretamente del apartad crrespndiente al menú y al de parámetrs de usuari, que ns permitirá interactuar cn la misma apariencia y funcinalidad que tendría si el pryect estuviera cmpletamente terminad. 3.2 Prttip vertical de alta fidelidad Vams a elabrar un prttip vertical, cncretamente del apartad crrespndiente al menú y al de parámetrs de usuari Prttip de pantalla menú A cntinuación mstrams cm quedaría la pantalla del menú principal: Figura 23. Prttip en alta definición de la Pantalla de Menú Prttip de pantalla de parámetrs usuari A cntinuación mstrams cm quedaría la pantalla de parámetrs usuari: 31 de 82

32 Pulsa Guardar Figura 24. Prttip en alta definición de la Pantalla Parámetrs Usuari Cuand pulsams el btón Guardar ns aparecerá el siguiente diálg: Figura 25. Prttip de alta definición Diálg Grabar Parámetrs Usuari 32 de 82

33 Si pulsams el btón Sí ls dats se actualizarán y aparecerá el siguiente mensaje: Al Aceptar se sale al menú. En cas de pulsar el btón N n se actualizará nada y aparecerá el siguiente mensaje: Al Aceptar cntinúa en la pantalla de usuaris. Pulsa Cancelar Cuand pulsams el btón Cancelar ns aparecerá el siguiente diálg: Figura 26. Prttip de alta definición Diálg Cancelar Parámetrs Usuari 33 de 82

34 Si pulsams el btón Sí ls dats n se actualizarán y aparecerá el siguiente mensaje: Al Aceptar se sale al menú. En cas de pulsar el btón N n se actualizará nada y aparecerá el siguiente mensaje: Al Aceptar cntinúa en la pantalla de usuaris. 3.3 Evaluación del prttip Este test ns va a ayudar a evaluar la usabilidad del prttip de la aplicación que hems diseñad. Hems marcad las diferentes cuestines tal y cm creems que están implementadas Navegación Hay indicacines claras en la lcalización actual Está claramente identificad el enlace del menú de Inici La mayría de las pcines sn accesibles desde el menú de inici. La estructura de la aplicación es simple, sin innecesaris niveles Siempre A veces Nunca Ntas X X X X Funcinalidad Tda la funcinalidad está claramente etiquetada Tda la funcinalidad necesaria está dispnible sin salir de la aplicación Siempre A veces Nunca Ntas X X 34 de 82

35 N sn usads innecesaris plugins X Cntrl El usuari puede cancelar tdas las peracines Hay un punt de salida clara en tdas las pantallas La aplicación sprta el fluj de trabaj del usuari Siempre A veces Nunca Ntas X X X Lenguaje El lenguaje usad es simple Se evitan las jergas Siempre A veces Nunca Ntas X X Realimentación Está siempre clar que está sucediend en la aplicación Tda la realimentación está sugerida Si fuera necesari, la ayuda nline está dispnible Siempre A veces Nunca Ntas X X X Cnsistencia Una palabra términ sól es usada para describir ítem Ls enlaces se crrespnden cn ls títuls de las pcines a ls Siempre A veces Nunca Ntas X X 35 de 82

36 cuales se refieren La terminlgía es cnsistente cn el us de la aplicación en general X Prevención y crrección de errres Siempre A veces Nunca Ntas Ls errres n curren innecesariamente X Ls mensajes de errr sn en lenguaje llan Ls mensajes de errr describen que acción es necesaria Ls mensajes de errr prveen un punt clar de salida X X X Ls mensajes de errr prveen ls detalles de cntact para asistencia X Claridad visual El layut está clar Hay suficiente espaci en blanc Se evitan animacines innecesarias Siempre A veces Nunca Ntas X X X 36 de 82

37 4. Implementación 4.1 Entrn de desarrll La aplicación la hems desarrllad baj Andrid. Para desarrllar aplicacines Andrid se necesita el ADT (Andrid Develper Tls). El entrn de desarrll integrad que hems utilizad ha sid Eclipse. Este entrn esta baj la supervisión de la Fundación Eclipse, cmunidad de códig abiert cuys pryects están enfcads en crear una platafrma de desarrll de sftware libre. Puest que ya estábams utilizand Eclipse cm IDE de Java, sól hems tenid que instalar: el ADT Plug-in para Eclipse, el Andrid SDK Tls y el Andrid Platfrm Tls. En resumen, para el desarrll de la aplicación hems necesitad: -Eclipse + ADT Plug-in -Andrid SDK Tls -Andrid Platfrm Tls Sin embarg, para ls nuevs desarrlladres de Andrid, se recmienda descargar el paquete de ADT (Andrid Develper Tls) al cmplet. Este paquete incluye ls cmpnentes esenciales de Andrid SDK y una versión de Eclipse cn el Plug-in ADT incluíd. Cn una sóla descarga, pdrems cmenzar rápidamente a desarrllar aplicacines en Andrid. Este instaladr, así cm las instruccines necesarias, l pdems descargar desde Estructura de la aplicación A cntinuación mstrams una imagen de la estructura principal de la aplicación Agentes baj el Explradr de Paquetes de Eclipse: Figura 27. Estructura de la aplicación 37 de 82

38 Muchas de estas carpetas y fichers se btuviern autmáticamente cuand se creó el pryect Agentes. A cntinuación vams a describir ls elements principales (carpetas y fichers) que cmpnen la aplicación Carpeta /src Esta carpeta cntiene el códig fuente Java de nuestra aplicación. Dicha carpeta la hems estructurad en paquetes, ls cuales cntienen las clases Java encargadas de suministrar la lógica a nuestra aplicación. Figura 28. Carpeta /src Pdems ver que de la carpeta cuelgan cuatr paquetes: agentes.adapters: dnde se tienen las clases adaptadras de las vistas de listas. agentes.app: que cntiene las clases cntrladras de la aplicación. agentes.bdd: que cntiene las clases gestras de la base de dats. agentes.beans: que cntiene las clases tip entidad de la aplicación Carpeta /gen Este directri cntiene ls elements de códig generads autmáticamente pr Andrid al cmpilar el pryect. Ests fichers fuente Java van dirigids al cntrl de ls recurss de la aplicación. Figura 29. Carpeta /gen Cabe destacar el ficher R.java dnde se tiene la clase R. Esta clase R cntiene una serie de cnstantes cn ls identificadres de tds ls recurss de la aplicación incluids en la carpeta /res. 38 de 82

39 4.2.3 Carpeta /bin En esta carpeta cuelgan ls elements cmpilads de la aplicación y trs fichers auxiliares. Figura 30. Carpeta /bin Cabe destacar el ficher cn extensión.apk, en nuestr cas Agentes.apk, que es el ejecutable de la aplicación que se instalará en el dispsitiv Carpeta /res Esta carpeta cntiene tds ls fichers de recurss necesaris para el pryect: icns, imágenes, cadenas de text, etc. Figura 31. Carpeta /res 39 de 82

40 Tenems varias carpetas dependiend del cntenid que albergan. Vams a citar las más imprtantes: /res/drawable-?dpi/: cuelgan las imágenes usadas pr la aplicación dependiend la reslución (baja, media, alta y muy alta). /res/layut/: cntiene ls fichers de definición XML de las diferentes pantallas de la interfaz gráfica de la aplicación. /res/values/: cntiene trs fichers XML de recurss de la aplicación. Las cadenas de text se albergan en el ficher strings.xml. /res/values-en/: cntiene ls fichers de recurss, principalmente las cadenas de text, traducids al inglés Ficher AndridManifiest.xml Este ficher es generad autmáticamente y se encuentra en la raíz del directri del pryect. Describe de una frma genérica tds ls cmpnentes que frman la aplicación. También este ficher es el encargad de establecer ls permiss de seguridad que tendrá nuestra aplicación. A cntinuación mstrams el cntenid del ficher AndridManifiest.xml de nuestra aplicación: <?xml versin="1.0" encding="utf-8"?> <manifest xmlns:andrid=" package="cm.agentes" andrid:versincde="1" andrid:versinname="1.0" > <uses-sdk andrid:minsdkversin="11" andrid:targetsdkversin="17" /> <applicatin andrid:allwbackup="true" andrid:icn="@drawable/ic_launcher" andrid:label="@string/app_name" andrid:theme="@style/apptheme" > <activity andrid:name="agentes.app.cntrladrmenu" andrid:label="@string/app_name" > <intent-filter> <actin andrid:name="andrid.intent.actin.main" /> <categry andrid:name="andrid.intent.categry.launcher" /> </intent-filter> </activity> <activity andrid:name="agentes.app.cntrladrusuari" andrid:label="@string/title_activity_pantalla_usuari" > 40 de 82

41 </activity> <activity andrid:name="agentes.app.cntrladrcliente" > </activity> <activity andrid:name="agentes.app.cntrladrarticul" > </activity> <activity andrid:name="agentes.app.cntrladrpedid" > </activity> <activity andrid:name="agentes.app.cntrladrpedidlinea" > </activity> <activity andrid:name="agentes.app.cntrladrsincrnizacin" > </activity> </applicatin> <uses-permissin andrid:name="andrid.permissin.write_external_storage" > </uses-permissin> </manifest> Figura 32. AndridManifiest.xml 41 de 82

42 5. Análisis de Testing 5.1 Pruebas de integración El prpósit del análisis de testing es reflejar el resultad de las pruebas sbre la aplicación Agentes para cmprbar su crrect funcinamient, nivel de funcinalidad y psibles errres. A cntinuación irems evaluand cada pantalla. PARÁMETROS USUARIO Códig Accines a verificar Resultad esperad Verificación 001 Realizar el alta de un usuari intrduciend tds ls dats 002 Realizar el alta de un usuari sin nmbre, , Ls dats se intrducen crrectamente en la BD Avisa de que el camp n puede estar vaci N 003 Pulsa Mstrar cntraseña Se muestra la cntraseña 004 Pulsa Guardar Aparece el diálg que pregunta si se quieren grabar ls dats 005 Pulsa Cancelar Aparece el diálg que pregunta si se quieren cancelar y advierte que n se grabarán ls dats 006 En el diálg de guardar pulsa Sí La aplicación inserta mdifica ls dats del usuari y se sale. 007 En el diálg de guardar pulsa N La aplicación infrma de que se puede seguir mdificand 008 En el diálg de cancelar pulsa Sí La aplicación n graba ningún dats y se sale 009 En el diálg de guardar pulsa N La aplicación infrma de que se puede seguir mdificand Observacines Pruebas crrectas Errres Valración ,88% Figura 33. Pruebas Parámetrs Usuari 42 de 82

43 CONSULTAR CLIENTES Códig Accines a verificar Resultad esperad Verificación 001 N pnems nada en el Nmbre de clientes y pulsams Buscar 002 Escribims en nmbre las iniciales de un cliente y pulsams Buscar 003 Pulsams en la lista de clientes sbre un Se carga la lista cn tds ls clientes rdenads alfabéticamente pr nmbre Se carga la lista cn tds ls clientes rdenads alfabéticamente que cntiene en su nmbre las iniciales que hems escrit La aplicación infrma que se ha seleccinad el cliente y carga ls dats del cliente en la mitad inferir Observacines Pruebas crrectas Errres Valración ,00% Figura 34. Pruebas Cnsultar Clientes CONSULTAR ARTÍCULOS Códig Accines a verificar Resultad esperad Verificación 001 N pnems nada en el Descripción y pulsams Buscar 002 Escribims en Descripción las iniciales de un artícul y pulsams Buscar 003 Pulsams en la lista de artículs sbre un Se carga la lista cn tds ls artículs rdenads alfabéticamente pr descripción Se carga la lista cn tds ls artículs rdenads alfabéticamente que cntiene en su descripción las iniciales que hems escrit La aplicación infrma que se ha seleccinad el artícul y carga ls dats del artícul en la mitad inferir Observacines Pruebas crrectas Errres Valración 43 de 82

44 ,00% Figura 35. Pruebas Cnsultar Artículs PEDIDOS CLIENTES Códig Accines a verificar Resultad esperad Verificación 001 N pnems nada en el Nmbre Cliente y pulsams Buscar 002 Escribims en Nmbre Cliente las iniciales de un cliente y pulsams Buscar Se carga la lista cn tds ls pedids rdenads pr númer de pedid Se carga la lista cn tds ls pedids que el cliente cntiene en su nmbre las iniciales que hems escrit 003 Pulsams en la lista de pedids La aplicación infrma que se ha seleccinad el pedid y carga ls dats del pedid y las líneas que cntiene cn sus artículs 004 Pulsams el + de Pedids Clientes Se inicia el alta de un pedid. La aplicación va a Cnsultar Clientes para que seleccinems un cliente 005 Seleccinams un cliente La aplicación retrna al pedid para cntinuar cn el alta 006 N seleccinams un cliente La aplicación avisa de que n se ha seleccinad ningún cliente 007 Se pnen mal las fechas La aplicación avisa de que las fechas n sn crrectas 008 Pulsa Guardar Aparece el diálg que pregunta si se quieren grabar ls dats 009 Pulsa Cancelar Aparece el diálg que pregunta si se quieren cancelar y advierte que n se grabarán ls dats 010 En el diálg de guardar pulsa Sí La aplicación inserta mdifica ls dats del pedid. 011 En el diálg de guardar pulsa N La aplicación infrma de que se puede seguir mdificand N 012 En el diálg de cancelar pulsa Sí La aplicación n graba ningún 44 de 82

45 dats y se sale 013 En el diálg de guardar pulsa N La aplicación infrma de que se puede seguir mdificand 014 Pulsams el + de Líneas de Pedids 015 Pulsams la M de Líneas de Pedids sin seleccinar una línea 016 Pulsams el - de Líneas de Pedids sin seleccinar una línea 017 Pulsams la M de Líneas de Pedids cn una línea seleccinada. 016 Pulsams el - de Líneas de Pedids cn una línea seleccinada 017 En el diálg de brrar línea de pedid si se pulsa Sí 018 En el diálg de brrar línea de pedid si se pulsa N 019 Pulsams el - de Pedids Clientes sin seleccinar un pedid 020 Pulsams el - de Pedids Clientes cn un pedid seleccinad 021 En el diálg de brrar el pedid si se pulsa Sí 022 En el diálg de brrar el pedid si se pulsa N 023 Si se intenta mdificar brrar un pedid ya enviad Se inicia el alta de una línea de pedid. Pasa a la pantalla de Líneas Pedids Advierte cn un mensaje de que la línea n ha sid seleccinada Advierte cn un mensaje de que la línea n ha sid seleccinada Se inicia la mdificación de la línea de pedid. Pasa a la pantalla de Líneas Pedids Aparece el diálg que pregunta si se quiere brrar la línea de pedid La aplicación brra la línea de pedid. La aplicación infrma de que se puede seguir mdificand Advierte cn un mensaje de que el pedid n ha sid seleccinad Aparece el diálg que pregunta si se quiere brrar el pedid La aplicación brra el pedid. La aplicación infrma de que se puede seguir mdificand La aplicación infrma de que ha sid enviad y n se puede mdificar N N N Observacines 007 Se debería implementar un btón en cada fecha (pedid, servici) y que aparezca un calendari para pder fijarlas. 015 Se debería implementar un mensaje avisand que n se ha seleccinad la línea. Ahra aparece un mensaje avisand per es cnfus. 45 de 82

46 016 Se debería implementar un mensaje avisand que n se ha seleccinad la línea. Ahra aparece un mensaje avisand per es cnfus. 019 Se debería implementar un mensaje avisand que n se ha seleccinad el pedid. Ahra aparece un mensaje avisand per es cnfus. Pruebas crrectas Errres Valración ,60% Figura 36. Pruebas Pedids Clientes LÍNEAS PEDIDOS CLIENTES Códig Accines a verificar Resultad esperad Verificación 001 Realizar el alta de una línea pedid intrduciend tds ls dats 002 Realizar el alta de una línea de pedid sin artícul, cantidades, etc Ls dats se intrducen crrectamente en la BD Avisa de que el artícul n existe y que n se grabará la línea 003 Pulsa en el btón Artícul La aplicación va a la pantalla Cnsultar Artículs para seleccinar un 004 Seleccinams un artícul La aplicación retrna a línea de pedid para cntinuar cn el alta mdificación 005 Intrducims las cantidades pr talla Actualiza el camp cantidad e imprte N 006 Pulsa Guardar Aparece el diálg que pregunta si se quieren grabar ls dats 007 Pulsa Cancelar Aparece el diálg que pregunta si se quieren cancelar y advierte que n se grabarán ls dats 008 En el diálg de guardar pulsa Sí La aplicación inserta mdifica ls dats de la línea y retrna al pedid. 009 En el diálg de guardar pulsa N La aplicación infrma de que se puede seguir mdificand 010 En el diálg de cancelar pulsa Sí La aplicación n graba ningún dats y retrna al pedid 46 de 82

47 011 En el diálg de guardar pulsa N La aplicación infrma de que se puede seguir mdificand Observacines 005 Al intrducir la cantidad pr talla deberíams llamar a la rutina que suma ls ttales pr talla en el camp cantidad y multiplica pr el preci para sacar el imprte. Pruebas crrectas Errres Valración ,90% Figura 37. Pruebas Líneas Pedids Clientes SINCRONIZACIÓN Códig Accines a verificar Resultad esperad Verificación 001 Pulsams el btón Sincrnizar Se inicia la sincrnización. 002 Recibir Dats Se carga el ficher de ls dats a recibir. Cmienza la inserción y mdificación de clientes y artículs. Se refleja la actividad en el Registr de dats recibids 003 Enviar Dats Se genera el ficher cn ls pedids a enviar. Se refleja la actividad en el Registr de dats enviads. Observacines Debería tener la aplicación un btón para cancelar la sincrnización. Pruebas crrectas Errres Valración ,00% Figura 38. Pruebas Sincrnización Cm se puede bservar en las estadísticas, ls resultads de las pruebas, en general, han sid satisfactris cn una media de valración del 93,73%. En general, la aplicación cumple cn las principales funcinalidades slicitadas y ls prblemas detectads n impiden el funcinamient principal para el que se ha cncebid la aplicación. Aun así, se han encntrad alguns errres, en algunas pantallas, que necesitan de accines crrectivas. 5.2 Test unitaris Se han verificad, sbre td, las clases gestras. En las pruebas que se han realizad, se ha cntrastad tant la estructura interna de cada cmpnente cm el crrect funcinamient cn el rest de cmpnentes de la aplicación. 47 de 82

48 6. Dcumentación Técnica 6.1 Relación de clases A cntinuación citams las clases principales, que hems utilizad en la implementación, agrupadas en packages (paquetes). Al final, también citams ls layuts (pantallas) que hems diseñad en la aplicación Clases entidad Paquete: agentes.beans -Articul.java : Clase entidad de Artículs -Cliente.java : Clase entidad de Clientes -Pedid.java : Clase entidad de Pedids -PedidLinea.java : Clase entidad de Pedids Líneas -Usuari.java : Clase entidad de Usuaris Clases cntrladras Paquete: agentes.app -CntrladrArticul.java : Clase cntrladra de la pantalla de Artículs -CntrladrCliente.java : Clase cntrladra de la pantalla de Clientes -CntrladrMenu.java : Clase cntrladra de la pantalla del Menú -CntrladrPedid.java : Clase cntrladra de la pantalla de Pedids -CntrladrPedidLinea.java : Clase cntrladra de la pantalla de Pedids Líneas -CntrladrSincrnizacin.java : Clase cntrladra de la pantalla de Sincrnización -CntrladrUsuari.java : Clase cntrladr de la pantalla de Usuaris Paquete: agentes.adapters -ArticulListAdapter.java : Clase adaptadr para la vista de la lista de Artículs -ArticulRecrd.java : Clase registr de la lista de Artículs -ClienteListAdapter.java : Clase adaptadr para la vista de la lista de Clientes -ClienteRecrd.java : Clase registr de la lista de Clientes -PedidListAdapter.java : Clase adaptadr para la vista de la lista de Pedids -PedidRecrd.java : Clase registr de la lista de Pedids -PedidLineaListAdapter.java : Clase adaptadr para la vista de la lista de Líneas de Pedids 48 de 82

49 -PedidLineaRecrd.java : Clase registr de la lista de las Líneas de Pedids Clases gestras Paquete: agentes.bbdd -GestrBD.java : Clase gestra de la Base de Dats -GestrArticul.java : Clase gestra de la tabla Articuls -GestrCliente.java : Clase gestra de la tabla Clientes -GestrPedid.java : Clase gestra de la tabla Pedids -GestrPedidLinea.java : Clase gestra de la tabla PedidsLineas -GestrUsuari.java : Clase gestra de la tabla Usuaris Layuts (pantallas) carpeta: /res/layut -pantalla_menu.xml : Vista de la pantalla del menú principal de la aplicación -pantalla_usuari.xml : Vista de la pantalla de Parámetrs Usuari -pantalla_cliente.xml : Vista de la pantalla de Cnsultar Clientes -cliente_list_item.xml : Vista de un element de la lista de clientes dentr de Cnsultar Clientes -pantalla_articul.xml : Vista de la pantalla de Cnsultar Artículs -articul_list_item.xml : Vista de un element de la lista de artículs dentr de Cnsultar Artículs -pantalla_pedid.xml : Vista de la pantalla de Pedids Clientes -pedid_list_item.xml : Vista de un element de la lista de pedids dentr de Pedids Clientes -pantalla_pedidlinea.xml : Vista de la pantalla de Pedids Clientes -pedidlinea_list_item.xml : Vista de un element de la lista de pedids líneas dentr de Líneas Pedids -pantalla_sincrnizacin.xml : Vista de la pantalla de Sincrnización 6.2 Códig fuente de la aplicación Para n extenderns demasiad en la memria, en el Anex 2 mstrams el códig fuente Java de las clases, ls layuts (pantallas) y ls values (valres de recurss) de la aplicación. 49 de 82

50 6.3 Relación de funcinalidades Tdas las funcinalidades, que al principi del pryect queríams incluir, n las hems pdid desarrllar pr falta de tiemp. Sin embarg, se han desarrllad las funcines principales que queríams que realizará la aplicación. A cntinuación detallams las funcinalidades actuales que se realizan en la aplicación y las que se deberían incluir en una revisión futura Funcinalidades actuales de la aplicación -Parámetrs Usuari: Aquí definims parámetrs cm el códig de cmercial, la cntraseña para acceder a la aplicación y trs parámetrs. -Carga inicial: Mediante este prces se hace un vlcad de tds ls artículs y clientes a la base de dats lcal del dispsitiv. -Cnsultar clientes: Busca ls clientes que cntengan el text a buscar en el nmbre, sin se pne nada cge tds ls clientes. A cntinuación, ls clientes se muestran en una lista. Tras seleccinar el cliente que ns interesa, se muestra la ficha del cliente cn tds sus dats. -Cnsultar artículs: Busca ls artículs que cntengan el text a buscar en la descripción, sin se pne nada cge tds ls artículs. A cntinuación, ls artículs se muestran en una lista. Tras seleccinar el artícul que ns interesa, se muestra la ficha del artícul cn tds sus dats. -Pedids Clientes: Busca ls pedids de clientes que cntengan el text a buscar en el nmbre, sin se pne nada cge tds ls pedids. A cntinuación, ls pedids de clientes se muestran en una lista. Tras seleccinar el pedid que ns interesa, se muestran sus dats de cabecera y de líneas. Pdrems mdificar y brrar el pedid (si el pedid n ha sid enviad). También pdrems añadir, brrar y mdificar líneas de pedid (si el pedid n ha sid enviad). -Creación de nuevs pedids de clientes: Añadir pedids pudiend seleccinar el cliente a través de la cnsulta de clientes. Añadir líneas de pedids seleccinand ls artículs a través de la cnsulta de artículs. -Sincrnización: Recibir altas y mdificacines de clientes y artículs de la central. Enviar nuevs pedids realizads pr el cmercial. -Idimas: Actualmente la aplicación está dispnible en españl e inglés Funcinalidades futuras a añadir en la próxima revisión -Acces a la aplicación: Cuand se acceda a la aplicación preguntar el usuari y la cntraseña. -Cnsultar clientes: Además de pr el nmbre, pder hacer búsquedas pr trs camps cm pblación, prvincia, , etc. -Cnsultar artículs: Pder filtrar artículs, pr tempradas, familias y artículs. Tener una ft del artícul y que se muestre tant en la lista cm en su ficha. -Cnsultar pedids de clientes: Pder filtrar pedids, pr fechas de pedid, servici y enviad. 50 de 82

51 -Pedids de clientes: Añadir en ft artícul en las lista de líneas de pedid y en la pantalla de líneas de pedid. Al finalizar pder enviar una cpia del pedid en PDF al cliente. -Idimas: Añadir idimas catalán, francés y alemán. -Ayuda: Tener dispnible la ayuda n-line. 7. Manuales 7.1 Manual de instalación Para pder instalar la aplicación Agentes, en una tablet cn Andrid, necesitarems descargar el paquete de instalación. Dich paquete pdrá estar aljad tant en Ggle Play, Drpbx, Ggle Drive, cualquier ubicación en internet. Es preferible tener en nuestra tablet la versión 4.2 de Andrid superir, aunque la versión mínima de Andrid, cn la que funcina la aplicación, es la 3.0. A cntinuación mstrams cm se realizaría la instalación Descarga L primer que harems es ntificar a nuestrs agentes cmerciales la dirección en Drpbx dnde se ubica nuestr paquete de instalación. Para ell les mandarems un indicand la URL desde dnde se tienen que descargar la aplicación. Figura 39. URL de descarga de la aplicación 51 de 82

52 A cntinuación el agente cmercial pulsará en el enlace y le aparecerá la siguiente pantalla para iniciar la descarga: Figura 40. Página de Drpbx para la descarga Una vez descargada la aplicación, ns irems hasta el apartad de Descargas para iniciar la instalación Instalación Una vez estems en Descargas, pulsarems sbre el icn de Agentes.apk para iniciar la instalación de la aplicación. Figura 41. Descargas en la Tablet 52 de 82

53 Se prcederá entnces a instalar la aplicación. Antes de iniciar la instalación ns advierte que la aplicación pdrá acceder a la tarjeta SD. Figura 42. Advertencia de instalación A cntinuación pulsarems el btón Instalar para iniciar el prces de instalación. Figura 43. Prces de instalación de la aplicación 53 de 82

54 Una vez finalizada la instalación ns aparecerá el siguiente mensaje indicand que se ha terminad de instalar: Figura 44. Mensaje finalización de la instalación Pulsarems el btón Abrir para iniciar la aplicación. Y ns aparecerá la pantalla del menú cn las diferentes pcines. Figura 45. Pantalla del menú principal de la aplicación 54 de 82

55 7.2 Manual de usuari Cuand entrams en la aplicación se ns muestran las pcines que tenems dispnibles. Para entrar en cada una de las pcines pulsarems sbre el btón crrespndiente Parámetrs de usuari El agente entrará en la pantalla de parámetrs de usuari. Al entrar, la aplicación buscará el primer usuari que tenga. Al principi n tendrems ningún usuari grabad y ns aparecerá la pantalla sin dats del usuari. Figura 46. Pantalla inicial de Parámetrs Usuari A cntinuación prcederems a rellenar ls dats del agente: Id. Usuari: el identificadr numéric que tenems asignad al agente. Nmbre de Usuari: nmbre del agente. crre electrónic del agente. Cntraseña: para acces segur a la aplicación. Si está marcad la pción Mstrar Cntraseña pdrems verla, sin aparecerá culta cuand la pngams. Id. Empresa: el identificadr numéric de la empresa asciada a este agente. Observacines: camp para agregar las ntas que se cnsideren necesarias. Así quedaría la pantalla una vez intrducids ls dats: 55 de 82

56 Figura 47. Dats intrducids en Parámetrs Usuari Para finalizar la intrducción pulsarems el btón de Guardar. Ns aparecerá el siguiente diálg preguntand si querems grabar ls parámetrs del usuari: Figura 48. Diálg para Grabar Parámetrs Usuari Si pulsams N ns aparecerá el siguiente mensaje indicand que pdems seguir mdificand: Si pulsams Sí el prgrama devlverá el siguiente mensaje indicand que se ha insertad el usuari: En el cas de que estems graband un usuari que se ha mdificad ns aparecerá el siguiente mensaje: 56 de 82

57 La aplicación, tras pulsar Aceptar, se saldrá al menú inicial. Si vlvems a entrar a Parámetrs Usuari ns aparecerá el usuari cn tds sus dats, teniend la pción de mdificarls. Figura 49. Dats guardads de Parámetrs Usuari En cas de que mdifiquems dats y n querams grabarls pulsarems el btón Cancelar y ns aparecerá el siguiente diálg preguntand si deseams cancelar y n grabar ls dats: Figura 50. Diálg para Cancelar Parámetrs Usuari Si pulsams el btón Si ns aparecerá el siguiente mensaje indicand que se ha cancelad: Tras pulsar Aceptar saldrems al menú principal. 57 de 82

58 7.2.2 Carga inicial Mediante este prces cargarems ls artículs y clientes del agente de la central a la base de dats lcal. Para ell entrarems en la pción de Sincrnización: Figura 51. Pantalla para la Carga Inicial Ls fichers a sincrnizar estarán ubicads en la carpeta cmpartida para el agente en el servidr. En nuestr cas, de cara a hacer las pruebas, l cgerems de la tarjeta SD del dispsitiv. En cncret: -el ficher a recibir dats será: /sdcard/agentes/input.txt -el ficher a enviar dats será: /sdcard/agentes/utputaaaammddhhmmss.txt Una vez explicada la ubicación de ls fichers a sincrnizar, cntinuams cn el prcedimient. Pulsarems el btón Sincrnizar y la aplicación empezará a insertar clientes y artículs. Cuand haya finalizad ns aparecerá el siguiente diálg: Pulsarems Aceptar, y se ns quedará la pantalla de Sincrnización. 58 de 82

59 Figura 52. Pantalla Sincrnización finalizada en la Carga Inicial En esta pantalla pdrems bservar en el apartad de Registr de dats recibids la traza de l que ha id imprtand la aplicación. Pdems vez una traza de clientes recibids: Figura 53. Dats de clientes recibids en la Carga Inicial Aquí pdems ver una traza de artículs recibids: Figura 54. Dats de Artículs recibids en la Carga Inicial En el registr de dats enviads n tendrems ningún pedid puest que se trata de una carga inicial. 59 de 82

60 7.2.3 Cnsultar clientes Figura 55. Dats enviads en la Carga Inicial Al entrar el agente en la pantalla de cnsultar clientes ns aparecerá: Figura 56. Pantalla inicial de Cnsultar Clientes Si n pnems ningún Nmbre y pulsams Buscar ns aparecerán Tds ls clientes pr rden alfabétic en la lista, tal y cm vems en la siguiente figura: 60 de 82

61 Figura 57. Lista de tds ls clientes Para ver ls dats de un cliente l buscarems en la lista y pulsarems encima de él. A cntinuación ns aparece el mensaje de que el cliente ha sid seleccinad: Figura 58. Diálg al seleccinar un cliente Tras pulsar Aceptar pdrems ver sus dats cargads en la mitad inferir de la pantalla. 61 de 82

62 Figura 59. Carga de un cliente tras ser seleccinad Si querems buscar un cliente determinad, a partir de su nmbre, l que harems será escribirl en Nmbre Cliente. Figura 60. Búsqueda de un cliente A cntinuación pulsarems Buscar y la aplicación buscará tds ls clientes en ls que el nmbre cntenga l que hems escrit, tal y cm mstrams a cntinuación. 62 de 82

63 Figura 61. Lista de clientes tras buscar un cliente cncret A cntinuación seleccinarems el cliente en la lista. Y ns aparecerá el mensaje infrmativ de que el cliente ha sid seleccinad: Tras pulsar Aceptar pdrems ver en la pantalla inferir que han sid cargads tds sus dats. Figura 62. Carga de un cliente tras ser seleccinad 63 de 82

64 7.2.4 Cnsultar artículs Tras entrar el agente en la pción Cnsultar Artículs aparecerá la siguiente pantalla: Figura 63. Pantalla inicial Cnsultar Artículs Si n pnems nada en Descripción y pulsams Buscar ns aparecerán tds ls artículs pr rden alfabétic en la lista. Si querems buscar un artícul cncret, a partir de su descripción, l que harems será escribir en Descripción, tal y cm pdems ver en la siguiente figura: Figura 64. Buscar un artícul pr descripción A cntinuación pulsarems Buscar y la aplicación buscará tds ls artículs en ls que la descripción cntenga l que hems escrit, tal y cm mstrams a cntinuación. 64 de 82

65 Figura 65. Lista de artículs que cntienen la descripción a buscar A cntinuación seleccinarems el artícul en la lista. Y ns aparecerá el mensaje infrmativ de que el artícul ha sid seleccinad: Figura 66. Diálg tras ser seleccinad un artícul Tras pulsar Aceptar pdrems ver en la pantalla inferir que han sid cargads tds ls dats del artícul seleccinad. Figura 67. Carga de un artícul tras ser seleccinad 65 de 82

66 7.2.5 Pedids clientes Cuand el agente seleccina la pción de Pedids Clientes entra en la siguiente pantalla: Alta de un Pedid Figura 68. Pantalla inicial Pedids Clientes Para añadir un pedid de un cliente tendrems que pulsar el btón + situad en el área de Pedids Clientes: Figura 69. Lcalización btón + de Pedids Clientes Tras pulsar el btón + se irá a la pantalla de Cnsultar Clientes para seleccinar un cliente para el nuev pedid. Buscams el cliente tal y cm hems explicad en el apartad de Cnsultar Clientes. 66 de 82

67 Figura 70. Selección de un cliente desde el alta de un pedid Tras buscar y seleccinar el cliente vlverá a la pantalla de pedids dnde pndrá el cliente que hems seleccinad anterirmente. Figura 71. Pantalla del alta de un pedid tras ser seleccinad el cliente A cntinuación cmpletarems ls dats de la cabecera del pedid. 67 de 82

68 Figura 72. Alta de cabecera de un pedid Tendrems que grabar el pedid para pder dar de alta las líneas de pedid. Para ell, una vez cmpletads ls dats de la cabecera del pedid, pulsarems el btón Guardar y ns aparecerá el siguiente diálg: Figura 73. Diálg para Guardar un Pedid Si pulsams N ns aparecerá el siguiente mensaje indicand que pdems seguir mdificand: Si pulsams Sí el prgrama devlverá el siguiente mensaje indicand que se ha insertad el pedid: Para añadir una línea al pedid tendrems que pulsar el btón + situad en el área de Líneas de Pedid: Figura 74. Lcalización btón + para el alta de Líneas de Pedid A cntinuación se mstrará la pantalla de Líneas de Pedids. Autmáticamente ns cgerá el siguiente númer de línea. 68 de 82

69 Figura 75. Pantalla inicial alta Líneas Pedid Para añadir el artícul pulsarems el btón Artícul. Seguidamente la aplicación mstrará la pantalla de Cnsultar Artículs para que busquems y seleccinems un artícul. Figura 76. Selección de un artícul desde el alta de una línea de pedid 69 de 82

70 Tras seleccinar el artícul que querems, se vlverá a la pantalla de Líneas de Pedids dnde aparecerán ls dats del artícul seleccinad. Figura 77. Lcalización dnde pner las cantidades pr talla A cntinuación pndrems las cantidades pr talla para este artícul. Figura 78. Alta de una línea de pedid 70 de 82

71 Una vez intrducidas las cantidades del artícul, que querems pedir, pulsarems el btón Guardar para insertar la línea de pedid y ns aparecerá el siguiente diálg: Figura 79. Diálg para Grabar Línea de Pedid Si pulsams N ns aparecerá el siguiente mensaje indicand que pdems seguir mdificand: Si pulsams Sí el prgrama devlverá el siguiente mensaje indicand que se ha insertad la línea de pedid: A cntinuación vlverems a la pantalla del Pedid de Clientes. Así, se irían añadiend líneas del pedid hasta cmpletar el pedid. Figura 80. Pedid cmpletad cn varías líneas 71 de 82

72 Para mdificar una línea de pedid tendríams que seleccinarla primer de la lista de Líneas Pedid. Pr ejempl, si querems seleccinar la línea 4 de la figura anterir, pulsaríams sbre ella y ns aparecería el mensaje siguiente: Figura 81. Diálg al seleccinar una línea de pedid Tras pulsar Aceptar tendrems la línea seleccinada: Figura 82. Lcalización dnde se muestra la línea de pedid que está seleccinada Una vez tenems la línea seleccina pdrems mdificarla brrarla. Para mdificar una línea de pedid pulsarems sbre el btón M de Líneas Pedid. Figura 83. Lcalización btón M para mdificar la línea de pedid seleccinada A cntinuación irems a la pantalla de Líneas de Pedids dnde pdrems mdificar la línea. En el cas de querams brrar la línea deberems pulsar sbre el btón de Líneas Pedid. 72 de 82

73 Figura 84. Lcalización btón - para brrar la línea de pedid seleccinada Ns aparecerá el siguiente diálg preguntándns si querems brrar la línea: Figura 85. Diálg Brrar Línea de Pedid Si pulsams N ns aparecerá el siguiente mensaje indicand que pdems seguir mdificand: Si pulsams Sí el prgrama devlverá el siguiente mensaje indicand que se ha brrad la línea de pedid: Baja de un Pedid L primer que harems será seleccinar el pedid que querems dar de baja. Un pedid se pdrá dar de baja si n se ha enviad a la central. Para ell teclearems el nmbre del cliente en Nmbre del Cliente y pulsarems el btón Buscar. 73 de 82

74 Figura 86. Búsqueda de un pedid de un cliente para dar de baja Una vez ns aparece el pedid en la lista de pedids l seleccinams, ns aparece el mensaje de que ha sid seleccinad, y, a cntinuación, se cargará el pedid. Figura 87. Pedid del cliente que querems dar de baja Para dar de baja el pedid, pulsarems sbre el btón - de Pedids Clientes. 74 de 82

75 Figura 88. Lcalización btón - para de baja un pedid Ns aparecerá el siguiente diálg preguntándns si querems brrar el pedid: Figura 89. Diálg para dar de baja un pedid Si pulsams N ns aparecerá el siguiente mensaje indicand que pdems seguir mdificand: Si pulsams Sí el prgrama devlverá el siguiente mensaje indicand que se ha brrad el pedid: Mdificar Cnsultar un Pedid L primer que harems será seleccinar el pedid que querems mdificar cnsultar. Para ell teclearems el nmbre del cliente en Nmbre del Cliente y pulsarems el btón Buscar. 75 de 82

76 Figura 90. Búsqueda del pedid de un cliente para mdificar Una vez ns aparece el pedid en la lista de pedids l seleccinams, ns aparece el mensaje de que ha sid seleccinad. Figura 91. Diálg de pedid seleccinad para mdificar Tras pulsar Aceptar se cargarán ls dats en la pantalla y pdrems verls. Figura 92. Dats del pedid para mdificar 76 de 82

77 Pdrems mdificar el pedid siempre que n se haya enviad. Ls pedids se envían a la central en el prces de Sincrnización. Una vez enviad el pedid registrará la fecha en que se ha transmitid en el camp de Enviad. Figura 93. Lcalización dnde indica la fecha en que el pedid ha sid enviad En el cas de intentar mdificar el pedid, brrar el pedid, añadir una línea, mdificar una línea brrar una línea, de un pedid que ya ha sid enviad a la central, ns aparecerá el siguiente mensaje advirtiéndns de que n se puede: Figura 94. Diálg que muestra que el pedid n se puede mdificar pr estar enviad Sincrnización Mediante este prces cargarems las actualizacines de ls artículs y clientes del agente de la central a la base de dats lcal. Y enviarems ls nuevs pedids que ha grabad el agente a la central. Figura 95. Pantalla inicial de Sincrnización 77 de 82

78 Ls fichers a sincrnizar estarán ubicads en la carpeta cmpartida para el agente en el servidr. En nuestr cas, de cara a hacer las pruebas, l cgerems de la tarjeta SD del dispsitiv. En cncret: -el ficher a recibir dats será: /sdcard/agentes/input.txt -el ficher a enviar dats será: /sdcard/agentes/utputaaaammddhhmmss.txt Una vez explicada la ubicación de ls fichers a sincrnizar, cntinuams cn el prcedimient. Pulsarems el btón Sincrnizar y la aplicación empezará a insertar clientes y artículs. A cntinuación enviará ls nuevs pedids cn sus líneas de pedid. Cuand haya finalizad ns aparecerá el siguiente diálg: Figura 96. Diálg que indica que ha terminad la sincrnización Pulsarems Aceptar, y se ns quedará la pantalla de Sincrnización. Figura 97. Pantalla de sincrnización tras recibir y enviar ls dats En esta pantalla pdrems bservar en el apartad de Registr de dats recibids la traza de l que ha id imprtand la aplicación. Pdems vez una traza de clientes recibids: 78 de 82

79 Figura 98. Clientes recibids en la sincrnización Aquí pdems ver una traza de artículs recibids: Figura 99. Artículs recibids en la sincrnización En el registr de dats enviads tendrems ls pedids que se ha enviad. Figura 100. Dats enviads en la sincrnización A cntinuación pdems ver el final del registr de dats enviads: Figura 101. Pedids enviads en la sincrnización 79 de 82