Introducción a PHPRunner, es un tutorial para aprender y practicar realizando

una aplicación de simple a compleja y administrar una base de datos en MySQL

con PHP para un grupo de clientes y mandantes con sistema de usuarios, grupos

y administración sin tener previo conocimiento de programación.

1: Comenzando:

Hace no mucho descubrí PHPRunner, una aplicación de Xlinesoft bastante

interesante que permite desarrollar un administrador de base de datos incluso a

personas que en su vida han utilizado PHP o MySql y con aspectos bastantes

profesionales, sin embargo al momento de abordarlo por primera vez sin tener

mucho conocimiento de inglés, base de datos y programación, puede volverse

engorroso y tedioso.

No soy un experto programador o administrador de base de datos (db), no tengo

experiencia mayor con PHPRunner de la cual quizás tengan ustedes, sin embargo

como usuario común quiero compartir mis experiencias al comenzar a desarrollar

aplicaciones por medio de esta plataforma y de esta forma y por medio de

ejemplos poder orientarlos y resolver sus dudas básicas respecto al uso que

pueden llegar a tener y lo que pueden ser capaz de lograr en unas pocas horas de

su tiempo.

Una definición más comercial:

Descripción obtenida de PHPNuke

PHPRunner es un programa que permite gestionar las bases de datos desde una

interfaz Web sencilla, vistosa e intuitiva, sin necesidad de contar con

conocimientos en programación.

Las prestaciones que ofrecen los sitios Web que trabajan con bases de datos son

prácticamente ilimitadas, el problema es que gestionarlas no es sencillo, en la

mayoría de los casos es necesario contar con extensos conocimientos en

programación para lograr buenos resultados.

PHPRunner es un aplicación sencilla para gestionar bases de datos, incluye

soporte para MySQL, Oracle, PostgreSQL, MS Access, etc.

PHPRunner permite gestionar completamente una base de datos de forma fácil y

rápida, la aplicación Web funciona a modo de asistente y todas las opciones se

encuentran correctamente detalladas para mejorar la adaptación de los nuevos

usuarios.

Pueden obtener mas información de:

1. Pagina oficial de PHPRunner

2. ¿Que es PHPRunner? (Ingles)

Para este tutorial usaremos PHPRunner 6.1 Build 12662 la versión Trial que

expira en 21 días y es completamente funcional.

2: Requerimientos

Apache 2.4.3 o superior

PHP 5.4.7 o superior

MySql 5.5.27 o superior

phpMyAdmin 3.5.2.2 o superior

PHPRunner 6.1 o superior

Mínimos conocimientos de PHP y SQL

Para los primeros 4 requerimientos, basta instalar xampp en tu ordenador y el se

encargara de cargar todo los componentes y configurarlos por ti y mejor aun si

tienes un Hosting Web, el te proporcionara todo lo necesario para comenzar con

tu proyecto.

3: ¿Que queremos?

Lo mas importante antes de comenzar, es tener claro que pretendemos lograr con

nuestra aplicación, cuales son los datos que debemos almacenar, como deben ir

ordenados y que relación tiene entre ellos..

La forma mas fácil de lograr esto es graficar nuestras ideas en lápiz y papel, de

tal forma que podamos entenderlo.

Un ejercicio practico que funciona bastante bien, es realizar el bosquejo y

luego explicártelo a ti mismo como si desconocieras de que se trata, de este

forma responderás tus dudas y aclaras de una vez los inconvenientes. No es

recomendable este primer paso de dos o mas personas ya que cada

una interferirán en las ideas del otro, sin embargo pueden trabajar por separados

y luego reunirse a discutir los bosquejos y agregar nuevas ideas.

Ahora antes de proseguir, asumiré que todos saben lo que es una base de datos,

de modo contrario, ¿por qué querrían administrar algo que no conocen?

Bien para este ejemplo intentaremos algo básico y quizás no con mucho sentido,

pero la idea es lograr cubrir la mayoría de los aspectos posibles:

1. Tenemos varias empresa "M" que vende repuestos de vehículos a varias

empresas "C" y con sus ventas ofrecen a sus clientes (Empresas "C") la

instalación, cambio y mantención de los repuestos en terreno.

2. Para que las empresas "M" pueda entregar el servicio prometido a las

empresas "C", debe contratar una empresa a la que denominaremos

empresa "S", la cual se encarga de la instalación y mantención de dichos

repuestos y equipos y le facturaría a las empresas "M" quienes son las que

ofrecen el servicio.

3. La empresa "S" para obtener un mayor número de empresas "M", ofrece

como gancho un servicio donde las empresas "M" podrán ver en línea,

todo los servicios que se hallan realizado ya sea instalación de repuestos,

mantenciones a equipos, las fechas y horas en que se realizaron, un valor

de servicio, presupuesto y reportes donde podrán filtrar por fechas o

clientes y obtener el valor total a facturar entre los periodos

correspondientes. Además les ofrece a las empresas "M" la posibilidad de

que sus clientes, empresas "C" puedan ver las instalaciones, compras,

servicios que se han realizado, podrán filtrar por fechas o equipos y tener

un reporte en línea de que equipo ocupa mayor cantidad de repuestos,

servicios, etc.

Lograr que la empresa "S" pueda llevar el registro y control de todo esto, puede

ser un grave problema al manejar tanta cantidad de información, tenerla en línea

y asumir el costo. Lo que intentaremos hacer es manejar todo esto en una base de

datos de tal manera que una sola persona pueda hacerse cargo de ella y crearemos

grupos para que la empresa "S" tenga permisos de añadir nuevos datos, clientes,

mandantes, las empresas "M" pueda ver a todo sus clientes y equipos de sus

clientes, por categorías y costos asociados y que las empresas "C" ósea los

clientes, puedan ver sus equipos y los servicios que se le realizan, pero no podrán

ver equipos de otras empresas ni tampoco el valor o costo de servicio.

Desde mi punto de vista, este puede ser un buen ejemplo básico para comenzar

nuestra travesía en PHP y MySQL donde gracias a nuestro amigo PHPRunner

seremos capaz de desarrollar un administrador de datos de calidad profesional en

pocas horas.

Definamos:

Empresa "S" = Servidora: Acceso total a la base de datos, para añadir o

eliminar datos, mandantes, clientes, equipos e historial de trabajos.

Empresa "M" = Mandante: Acceso restringido, solo podrá ver a sus

clientes y los equipos e historiales de sus clientes, además tendrá acceso a

filtros y reportes donde podrá observar el flujo de trabajo y costos

asociados por fechas, equipos y/o clientes.

Empresa "C" = Clientes: Acceso restringido, no pueden ver costos de

servicios ni valores asociados, no pueden ver otros clientes o equipos que

no sean de su propiedad.

4: Antes de comenzar

Es necesario tener un servidor de base de datos y un espacio donde alojar nuestro

contenido.

La forma más fácil de obtener esto es instalando los servicios en tu computadora

y xampp es el candidato ideal para que lo haga por ti, en caso contrario puedes

buscar un hosting gratuito que te entregue todo lo necesario o pagar por uno

según tus necesidades.

5: PHPRunner

Esta es la pantalla de inicio de PHPRunner en ella podrán elegir varias planillas

ya predefinidas muy vistosas pero bastante simples, puedes

comenzar eligiendo una para tener un ejemplo de su funcionamiento.

Esta vez crearemos un proyecto nuevo seleccionamos la primera

opción "Application wizzard", en "Project name" le damos el nombre y luego

en "Location" la ubicación donde se guardaran los Sources de nuestro proyecto.

Como comentamos en un principio, trabajaremos con MySQL, así que deben

seleccionar la casilla marcada en rojo, sin embargo el programa les da

la posibilidad de trabajar con cualquier tipo de base de datos incluso MS Access

la cual puede ser una opción interesante para una intranet sin mucho movimiento.

El siguiente paso nos solicitara los datos de conexión de nuestra base de datos.

¿Donde estan esos datos?.

Si estas usando xampp, los tendrás que crear ingresando a http://localhost, luego

a phpMyAdmin con el usuario root sin contraseña. (a menos que le hayas puesto

alguna). y crear un nuevo usuario otorgándole todo los privilegios a esa base de

datos en particular.

para no profundizar mucho en esto, colocare una imagen con los pasos resumidos

y remarcado lo que deben rellenar.

el nombre que seleccionaron y la contraseña son los datos que necesitan para

conectarse a la db desde PHPRunner, si tienen hosting de pago o

gratuito, deberán hacer algo similar, pero desde el panel de administración de su

sitio.

Host/Server name (or ip): localhost

User: Nombre del usuario de la base de datos (suele ser el mismo nombre de la

base de datos)

Password: (su-contraseña)

Port: por defecto, a menos que se especifique lo contrario.

1 Base de datos:

En el articulo anterior, revisamos como crear una base de datos con

phpMyAdmin y su respectivo usuario para conectarnos con PHPRunner.

A continuación crearemos las tablas y campos correspondientes que

necesitaremos para nuestra aplicación de ejemplo.

Nota: si accedes como root o usuario con privilegios puedes crear la tabla desde

PHPRunner directamente como en este ejemplo, al final de la aplicación

luego podrás editar los datos por un usuario y contraseña seguros.

Ejemplo: como crear una tabla desde PHPRunner

A lo nuestro. Luego de tener La db, el usuario y los privilegios listos ya sea desde

phpMyAdmin o desde la interfaz de PHPRunner, comenzaremos a crear las

tablas y campos necesarios para nuestra aplicación de ejemplo. (Pueden ver las

características que buscamos en nuestra aplicación en la primera parte del

tutorial).

PHPRunner, nos entrega una interfaz bastante amigable a la hora de crear tablas

y relaciones entre ellas, las características principales que ofrece son Views,

Reports, Charts y obviamente las tablas. Trataremos de ver todas en este capítulo,

donde mi objetivo es que puedan ver las diferencias de cada una de ellas.

Para crear una tabla en PHPRunner, debemos darle click al botón "Add Table" y

nos aparecerá una ventana donde podremos crear los campos, elegir el tipo de

campo, tamaño, cual sera el indice y si usa o no Auto Increment.

Existen diferentes tipos de campos, todos ya definidos para una base de datos,

por lo cual no creo sea necesario profundizar demasiado en ellos, para su

proyecto ustedes podran agregar los campos que crean necesarios y el tipo que

corresponda según el uso que decidan darle, por ejemplo si solo quieren

son números "int", texto "varchar", Fecha "date", imagenes "mediumblob". etc

Nota: si almacenan imágenes en su base de datos, pueden

sobrecargarla demasiado tengan cuidado con esa opción, les recomiendo

guardar la imagen en una carpeta del servidor.

Para comenzar he creado 4 tablas esenciales para nuestro proyecto, "Mandantes",

"Clientes", "Equipos", "Historial", pueden agregar más tablas si lo desean, pero

con estas nos debería bastar para nuestro ejemplo. (Recuerden que la versión

trial, solo soporta 15 tablas en total)

Cada tabla mencionada arriba lleva un número predeterminado de campos, los

cuales nos servirán para ordenar y clasificar nuestros trabajos en la db. Los

campos que estos incluyan pueden ser muchos pocos o varios y depende 100%

de ustedes con excepción de los que nombrare a continuación pues son esenciales

para que nuestro proyecto funcione.

2 Campos y relaciones:

Los campos necesarios:

Tabla Mandantes: IDMandante; NombreMandante

Tabla Clientes: IDCliente; IDMandante; Usuario; Contraseña; NombreCliente

Tabla Equipos: IDEquipo; IDMandante; IDCliente; Patente (o identificador)

Tabla Historial: IDHistorial; IDMandante; IDCliente; IDEquipo; NumeroOrden

Antes de proseguir, reordenemos nuestra idea para que podamos entender por

qué son esenciales los siguientes campos y qué relación tienen cada uno de ellos.

En una situación normal, bastaría identificar cada tabla con su propio ID y

relacionar la ID entre tablas, sin embargo en el ejemplo estamos creando un id

por cada tabla y repitiendo en cada sub tabla siguiente, creando una cadena de

hijos y sub tablas que podrían parecer innecesarias.

Nuestra idea en un principio es crear dos grupos de usuarios, los mandantes y

clientes. Los mandantes pueden ver a todos los clientes que tengan relacionados,

todos los equipos de sus clientes, los valores, trabajos e historiales

correspondientes a ellos. Sin embargo los clientes, solo pueden ver los equipos

que les pertenecen y no pueden ver el valor de los trabajos si cuando fueron

realizados y filtrar la búsqueda por Fecha, hora y servicio.

Ya con nuestras tablas creadas y campos listos procederemos a relacionarlas con

sus respectivas ID.

Para crear una relación en PHPRunner, basta arrastrar con el mouse el campo que

desees hacia el campo que se relacionara en la siguiente tabla donde se les abrirá

una ventana como en la de imagen de arriba indicando el tipo de relación creada.

Para este ejemplo, relacionaremos como maestra siempre la de la izquierda y la

relación será de uno a mucho 1 --> ∞ donde cada vez los campos a relacionar

serán más dependiendo de qué tan a la derecha este la tabla (Como el ejemplo de

la imagen).

3 Custom Views

Podrán percatarse que solo la tabla cliente tiene Usuario y Contraseña, sin

embargo mandante y cliente son usuarios diferentes pues tienen diferentes rango

de acceso a la información y para esto PHPRunner, nos ofrece una magnifica

solución llamada Custom Views.

Para crear un custom view, deben dar click en "Add View" y crear 5 Custom

diferentes tal cual se muestra en la imagen de arriba.

3 Custom para mandantes: clientes, Equipos e Historial y 2 para clientes:

Equipos e Historial.

Expliquemos un poco de que trata esto, los Custom View, son forma de decirle a

PHPRunner que realice consultas y cree nuevo tipo de relaciones entre tablas sin

la necesidad de crear nuevas tablas, pues son un espejo de las tablas originales,

por lo tanto obtienen como resultados sus mismos datos.

Al igual que con las tablas originales, crearemos las relaciones para los Custom

Views y más adelante en un tutorial próximo veremos como asignar los permisos

para las tablas y Custom Views correspondientes.

Para Finalizar añadiremos un Report de la tabla clientes y un Charts de los

equipos los cuales configuraremos más adelante y deberíamos quedar con algo

similar a la siguiente imagen.

En el próximo tutorial, revisaremos las consultas y configuraciones básicas de

nuestra aplicación para luego proceder con la asignación de permisos e interfaz.