Post on 24-Jul-2020
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 83
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Anexos A. Instalación y creación entorno trabajo
Instalación SugarCRM A.1.
Servidor WAMP A.1.1.
El fichero de instalación se puede obtener directamente desde la página
oficial de WampServer:
http://www.wampserver.com/en/
El segundo paso será ejecutar el archivo descargado y aparecerá un
asistente de instalación como este:
Figura 57: Asistente de instalación WampServer
Podemos verificar que las versiones de los programas incluidos sean las
correctas y pulsamos en Next. Aceptamos los términos de uso, indicamos la ruta
de instalación y si queremos accesos directos o no.
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 84
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Figura 58: Términos de uso
Figura 59: Ruta para la instalación
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 85
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Una vez termine la instalación, comprobaremos que nos aparece un
nuevo icono en la barra de tareas, desde el cual podemos iniciar los servicios,
reiniciarlos, cambiar configuraciones o acceder a los medios que se van a
publicar.
Figura 60: WampServer funcionando
Para comprobar el correcto funcionamiento del servidor, pinchamos en el
enlace Localhost y nos abrirá un navegador con la siguiente página. Si pulsamos
en phpinfo(), debe aparecer la pagina señalada.
Figura 61: Comprobación
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 86
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Creación base de datos MySQL A.1.2.
Este paso es opcional aunque altamente recomendado. Se trata de usar
la aplicación phpmyadmin para crear la base de datos necesaria para el
funcionamiento de SugarCRM. Esta aplicación solo es una interfaz gráfica (GUI o
graphical user interface) para administrar el servidor MySQL instalado, pero
también se puede administrar directamente en la consola con los comandos
SQL. En lo siguiente se detallará como crear una base de datos a través de esta
interfaz.
Para acceder a la aplicación phpmyadmin, desde el navegador accedemos
a la siguiente dirección:
http://localhost/phpmyadmin
Desde aquí podemos ver, gestionar, crear, eliminar o modificar
cualquier aspecto del servidor MySQL. Para crear una base de datos o un
usuario se accede a su ficha correspondiente como muestra la figura
superior. Si pinchamos en Crear Usuario y a su vez en Agregar Usuario
podremos crear un usuario y una base de datos para SugarCRM como
muestra la siguiente pantalla:
Figura 62: Interfaz de la aplicación Phpmyadmin
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 87
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Figura 63: Creando BD y usuario
En caso de querer usar la consola, los comandos equivalentes se
muestran a continuación:
CREATE USER '<USER>'@'%' IDENTIFIEDBY'<PASS>';
GRANT USAGE ON '<USER>' TO '<USER>'@'%' IDENTIFIEDBY'<PASS>';
CREATE DATABASE IF NOT EXISTS `<BD>`;
GRANT ALL PRIVILEGES ON`<BD>`.*TO'<USER>'@'%';
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 88
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Instalación SugarCRM A.1.3.
Accedemos a la página de descargas de SugarCRM del repositorio
SourceForge:
http://sourceforge.net/projects/sugarcrm/files/
Pinchamos en la última versión disponible en este caso la 6.5.
Figura 65: Página de descargas SugarCRM desde SourceForge
Seguimos las indicaciones para descargarnos el fichero .zip.
Figura 64: Descargando el fichero de instalación .zip
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 89
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Descomprimimos el fichero .zip, que contiene los archivos de SugarCRM,
y los colocamos todos en una carpeta dentro de nuestro directorio www de
WampServer. Por defecto la ruta es C:/wamp/www/.
Finalmente los ficheros de SugarCRM deberían quedar en una ruta tal
que así: <ruta hasta carpeta www>/sugar/.
Abrimos un navegador de internet y accedemos a la siguiente página:
http://localhost/sugar/install.php
Y nos debe aparecer la siguiente pantalla
Pulsamos en Next y la siguiente pantalla nos detalla los requerimientos
para la instalación, instrucciones de instalación y de chequeo iniciales.
Una vez leído, pinchamos en Next de nuevo, en la siguiente pantalla
deberemos aceptar los términos de uso para continuar. Las dos siguientes
pantallas preguntan acerca del tipo de instalación, si no se tiene conocimiento
acerca de lo que se esta realizando deben dejarse tal y como aparecen.
Figura 66: Instalación de SugarCRM 1
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 90
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
En la siguiente pantalla es necesario introducir los valores MySQL de la
base de datos anteriormente creada. Si se necesitan datos de ejemplo en la
base de datos, marcar la opción Populate with demo data que aparece al final.
Por último, saltará una ventana advirtiendo de que la base de datos ya existe y
se sobrescribirá, pulsamos en Agree
A continuación, tendremos que crear un administrador para gestionar el
portal, pondremos el nombre de usuario y la contraseña.
Figura 67: Instalación de SugarCRM 2
Figura 68: Valores de la BD
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 91
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
El siguiente paso es un chequeo automático del sistema para verificar si
se cumplen los requisitos, mostrando un resumen al finalizar. Si existe algún
problema, se puede solucionar modificando la configuración de Apache, PHP o
MySQL desde el acceso a WampServer de la barra de tareas.
Figura 69: Creación de administrador
Figura 70: Chequeo previo a la instalación
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 92
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
El último paso es la instalación en sí, para ello, pulsamos en el botón
Install y nos informará cuando haya terminado la operación.
Figura 71: Instalación completada
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 93
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Instalación del entorno de trabajo A.2.
JDK A.2.1.
El primer paso para la instalación del entorno de trabajo es instalar el
Java Development Kit, cuya última versión disponible es la 7u7:
http://www.oracle.com/technetwork/java/javase/downloads/jdk7u7-
downloads-1836413.html
Descargar el fichero necesario para el equipo (x86 o x64), ejecutar el
instalador y seguir las instrucciones en pantalla. Se pueden modificar las
características extras de la instalación pero no es necesario.
Figura 72: Descarga JDK
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 94
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Figura 73: Instalador JDK 7u7
Figura 74: Opciones de instalación por defecto
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 95
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Eclipse A.2.2.
Se puede descargar el entorno de desarrollo Eclipse desde su página
oficial, es necesario descargar el pack Eclipse IDE for Java Developers para la
arquitectura del ordenador (x86 o x64):
http://www.eclipse.org/downloads/
Se trata de un fichero .zip (no dispone de instalador), que se puede
descomprimir en cualquier sitio, por ejemplo en c:\eclipse. Cada vez que se
ejecute la primera ventana que aparecerá será la de selección del espacio de
trabajo, es irrelevante la opción.
Figura 75: Descarga de Eclipse
Figura 76: Selección de espacio de trabajo
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 96
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Android SDK A.2.3.
El SDK de Android puede ser descargado desde la página oficial de
desarrolladores Android:
http://developer.android.com/sdk/index.html
Se trata de un instalador, para poder ejecutarlo correctamente debe
estar instalado en el sistema el JDK, sino, nos pedirá que lo instalemos.
Figura 77: Descarga Android SDK
Figura 78: Instalador Android SDK
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 97
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Los siguientes pasos son para decidir la ruta y para qué usuario estará
disponible el SDK, opciones por defecto. Una vez termine la instalación, nos
pedirá que ejecutemos la aplicación SDK Manager.
Esta nueva aplicación nos permitirá descargar las API de desarrollo de
Android. Cada versión de Android tiene su propia API, siendo compatibles las
más nuevas con las más antiguas. Una aplicación desarrollada bajo una
determinada versión API podrá ser ejecutada en un dispositivo Android con la
Figura 79: Android SDK requiere JDK
Figura 80: Iniciar SDK Manager
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 98
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
misma versión o superior. Marcamos la versión Android 2.3.3 (API 10) o la que
corresponda en cada caso.
Una vez instalado el SDK, deberemos crear un dispositivo virtual para
poder emular el sistema Android y poder probar la aplicación desarrollada. Para
ello lanzamos la aplicación AVD Manager (Android Virtual Device Manager)
desde el menú inicio de Windows, en la carpeta Android SDK Tools.
Figura 81: API Android
Figura 82: Creando un dispositivo Android virtual
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 99
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Con el botón New, se despliega una nueva ventana con una serie de
opciones por defecto, como se puede ver en la captura anterior. Es necesario
seleccionar en Target la versión de Android que sea necesaria (en este caso, la
misma que se ha instalado en el paso anterior) y un dar un nombre al
dispositivo. Existen más opciones pero no son necesarias para este proyecto
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 100
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
.ADT A.2.4.
Para instalar el ADT debemos abrir Eclipse, pinchar en la pestaña Help,
opción Install new software.
En la primera línea se debe indicar la ruta del repositorio dónde se
encuentra el ADT: https://dl-ssl.google.com/android/eclipse/ y a continuación
pulsar en el botón Select All y luego en Next. Una vez aceptados los términos de
uso, se descargarán los ficheros necesarios y la instalación concluirá.
Figura 83: Instalación ADT
Figura 84: Añadir el repositorio ADT
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 101
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Instalación y manual de uso de la aplicación. A.3.
Instalación A.3.1.
La aplicación se encuentra en un archivo llamado sugar.apk, siendo apk la
extensión de las aplicaciones Android. Primero hay que colocar este archivo
dentro del dispositivo de cualquier forma: enviándolo por bluetooth, wifi o usb,
o accediendo a internet mediante dropbox o un correo. Una vez se encuentre
en el dispositivo, lo ejecutamos y pulsamos en Instalar.
Pantallas Login y Menú Principal A.3.2.
Al ejecutar la aplicación se mostrará por pantalla una breve presentación
que durará 5 segundos, que dará paso a la pantalla de login. Se debe introducir
el nombre de usuario y la contraseña de una cuenta debidamente registrada en
el portal SugarCRM. En el caso de no disponer una conexión a internet, existir
un error con el portal o de haber un error en el par usuario contraseña, la
aplicación no mostrará ningún texto por pantalla, limitándose a esperar la
solución de dichos problemas.
Figura 85: Instalación
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 102
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Una vez introducidos los valores correctos en la pantalla de login, se
mostrará un pequeño menú con cuatro opciones: Clientes, Compañías,
Campañas y Configuración. Sólo los dos primeros son funcionales, siendo los dos
restantes inútiles en el desarrollo actual de la aplicación.
Figura 86: Pantalla de inicio Figura 87: Pantalla de login
Figura 88: Pantalla del Menú principal
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 103
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Pantalla Clientes. A.3.3.
En la pantalla de clientes, la aplicación permite tanto crear un nuevo
registro como buscar uno existente en la base de datos. Tanto en la creación
como en la búsqueda se ha restringido el número de parámetros por
simplicidad.
En la pantalla de crear nuevo registro, la aplicación mostrará 6 cuadros
de texto para rellenar con los parámetros nombre, apellidos, título, teléfono,
móvil y e-mail. Sólo estos serán introducidos en el nuevo registro (se ha omitido
la dirección física). Una vez pulsado el botón Crear registro, la aplicación enviará
los datos al portal y mostrará por pantalla un mensaje de éxito.
La opción de búsqueda permite encontrar un cliente mediante su
nombre, apellido o e-mail. Para distinguir clientes, se ordenan alfabéticamente
y se muestra en una segunda columna el trabajador al que está asignado el
cliente. Para ver detalles más concretos de un cliente, se pincha en su nombre y
se mostrará una ficha mas completa.
Figura 90: Pantalla Clientes Figura 89: Crear un nuevo cliente
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 104
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Figura 92: Buscar un cliente Figura 91: Búsqueda de clientes
Figura 93: Ficha cliente
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 105
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Pantalla Compañías. A.3.4.
La opción de compañías es completamente análoga a la de clientes,
permite creación o búsqueda de compañías según parámetros. En la creación,
los parámetros requeridos son nombre, sector, sitio web, teléfono y e-mail.
La opción de búsqueda es idéntica a la de clientes, busca por nombre y e-
mail, mostrando por pantalla alfabéticamente y mostrando también el usuario
asignado a la compañía. En la ficha cambian los parámetros mostrados pero no
el diseño.
Figura 95: Pantalla de compañías Figura 94: Nueva Compañía
PROYECTO FIN DE CARRERA GUILLERMO GUERRERO GONZÁLEZ 106
APLICACIÓN ANDROID PARA ACCESO A SOLUCIÓN CRM
Figura 96: Búsqueda de compañías Figura 97: Buscar una compañía
Figura 98: Ficha compañía