Un buen nombre de fichero

Un buen nombre de fichero

Cuando creamos un fichero que va a circular por emails, webs, ftps, google drive y el mundo en general, es importante pensar el nombre para evitar problemas y unificar criterios.

Consejos:

  1. Evitar espacios, usar guiones
    En navegadores o urls los espacios los convierte a %20 y se hace complicado de gestionar. Se aconseja sustituir con guiones.
    Correcto: visualms-instalable-23.exe
    Evitar: visualms instalable 23.exe
  2. Evitar mayúsculas
    En distintos sistemas operativos, la mayúscula y minúscula significan cosas distintas, es bueno tener siempre minúsculas para evitar tener el fichero duplicado con nombres iguales.
    Correcto: visualms-informe-anual-2018.pdf
    Evitar: VisualMs-Informe-Anual-2018.pdf
  3. Descriptivo
    Intentar que el fichero sea descriptivo, que no necesite tener información adicional para saber que significa.
    Correcto: visualms-gastos-davidgu-enero-2018.pdf
    Evitar: gastos.pdf
  4. Evitar símbolos (/\*?_<>)
    Algunos símbolos pueden significar algo en otros sistemas y puede provocarnos problemas de conversión. En el caso del guión bajo, puede ofrecer confusión en hiperenlaces que suelen estar subrayados y además, según Google, no es bueno para SEO.
    Correcto: visualms-resumen-fiesta-25-05-2018.avi
    Evitar: visualms->resumen_fiesta-;-).avi
  5. No usar tildes
    Quizá resulte raro, pero nuestros ficheros pueden pasar por sistemas que no gestionan bien las tildes o incluso pase por alguna persona “rara” que no entiende el idioma de Cervantes.
    Correcto: informacion-formulario-camion.png
    Evitar: información-formulario-camión.png

Son consejos, no son verdades absolutas, úsalos con moderación 😉

Enlaces de interés:

https://developers.google.com/style/file-names

https://www.csudh.edu/web-services/web-standards/file-folder-naming/

La diferencia entre 0,1 y 1 segundo

¿Como percibirá el usuario las acciones que realiza en tu aplicación?

De 0  –  0,1 segundosInterruptor

Es el tiempo máximo para que un usuario sienta que una acción suya esta provocando que ocurra algo en la aplicación de forma instantánea. Viene a ser como el interruptor de la luz.

 

0,1 – 0,3 segundos

Mando a distancia

El usuario siente una pequeña demora pero entiende que se está realizando su orden. Un ejemplo podría ser el tiempo que tarda en cambiar de cadena una televisión usando el mando a distancia.

 

1 segundo

Coche de juguete

Es el tiempo máximo en que el usuario sigue conectado a la tarea, sabe que manda una orden y el equipo la procesa en un tiempo adecuado sin que pierda la focalización mental. El encendido de un coche de gasolina puede ser un buen ejemplo.

Más información en este gran articulo de Jakob Nielsen Powers of 10: Time Scales in User Experience

El idioma de las aplicaciones

Nuestra necesidad

Durante los últimos meses estamos implantando internamente nuevas aplicaciones desarrolladas en Velneo. Por otro lado necesitamos conectarlas con otras aplicaciones de terceros que usamos en diferentes departamentos ( Google Apps, WordPress, Twitter, Zendesk, etc ).

Esta situación nos obligaba a marcar una estrategia de futuro en la comunicación entre aplicaciones.

Debíamos buscar una forma de comunicar cualquier aplicación entre sí, da igual si está en web, en escritorio o en móvil. Buscábamos un solo idioma para que se comuniquen nuestras aplicaciones.

Idioma elegido

Después de evaluar las opciones existentes todas nos llevan hacia las siglas REST / JSON

Al ser un servicio tipo REST  tenemos la garantía de que funcionaremos sobre HTTP/HTTPS con todas las ventajas que ello conlleva.

Nos decantamos por JSON respecto a XML por varios motivos :

  • Es muy sencillo y ligero
  • Fácilmente legible por máquinas y humanos 😉
  • Parece el estándar del futuro para comunicación de aplicaciones (WordPressGoogle Glass, Zendesk, Twitter )

Como creamos nuestro API

API-VERPLo primero que debíamos hacer era crear un API que permitiera que otras aplicaciones consumieran nuestras aplicaciones, para ello con el vJavascript de Velneo creamos una aplicación capaz de generar de forma dinámica todo el API en base a un proyecto de Velneo. Esta aplicación no solo nos genera los puntos de acceso, sino una web dinámica con toda la documentación del API

Para darle salida a la aplicación usamos el componente vModApache y configuramos el Apache para añadirle cache, compresión y encriptación.

Con este proyecto, cualquiera de nuestras aplicaciones de Velneo V7 tenían un API dinámico en base a las tablas y búsquedas ya creadas.

Como consumimos nuestro API

Necesitábamos obtener información de nuestras aplicaciones, en unos casos que Google Apps pudiera obtener diferente información de nuestro vERP, para ello desarrollamos scripts en Google Apps Script que acceden a nuestro API  y le consultan la información que necesita. El resultado devuelto en JSON se procesa de una forma muy sencilla y se realizan las operaciones necesarias.

Por otro lado nuestra web necesitaba mostrar información privada en los sitios que funcionan con WordPress. Desarrollamos un plugin en PHP que se conectaba a nuestro API para obtener información y mostrarla al visitante.

Desde los centros de soporte en Zendesk se consulta nuestro API para mostrar información de nuestro vERP en tiempo real

Desde Google Script se generan emails con los indicadores clave de la empresa calculados en diferentes aplicaciones

Que más cosas

Existen cientos de servicios web que ofrecen funcionalidades mediante sus APIs REST JSON

Nuestra idea es comunicar toda esta “nube” de aplicaciones con un mismo idioma, lo que nos permite ser más ágiles en cuanto a la implementación y mantenimiento de nuevos servicios.

Documentación de usuario para mi aplicación

ManualDurante los años que llevo en el desarrollo de software todavía no he dado con la forma “perfecta” para ofrecer una documentación clara y eficiente para los usuarios de la aplicación.

Una documentación de usuario efectiva debería permitir :

  • Resolver dudas sobre en que consiste la aplicación y cuales son sus características
  • Encontrar solución a los problemas generales que pueda encontrarme
  • Que tenga unos textos claros y concisos sin irse por las ramas
  • Aportar una información extra a lo que pueda ver en la aplicación
  • Consejos de como sacarle más partido a la aplicación
  • Indexable por los buscadores
  • Poder buscar por palabras internamente

Mantenimiento

Sin duda lo más complicado de una documentación de usuario es mantenerla. Un producto software esta vivo y se le van añadiendo funcionalidades, la documentación sea mucha o poca, debe ir actualizándose al mismo ritmo.

Elementos que van encontra del mantenimiento

  • El tamaño. Cuanto más grande sea la documentación más dificil será tenerla al día. Menos es más
  • Elementos gráficos, capturas de pantalla y vídeos son enemigos del mantenimiento, generalmente en poco tiempo quedan desfasados mostrando pantallas de versiones anteriores que confunden al usuario
  • Descripciones exageradas de las pantallas (Ejemplo. Pincha en el botón azul redondeado a la derecha del texto nombre ) esas descripciones no aportan mucho valor pero al igual que las capturas quedan desfasados al cabo de poco tiempo cuando un cambio en el interfaz de las aplicaciones provoca que la descripción no detalle lo que realmente ve el usuario.

Buenas ayudas que conozco

Ayudas de Google
Google se esmera en no incluir capturas de pantalla, siempre lo explica con texto, lo que facilita su mantenimiento respecto los constantes cambios que van añadiendo.

Jenkins
Esta documentación tiene una buena división general ( Conoce, Usa, Extiende ) que permite ubicarte facilmente en que información necesitas.

Usar un registro DNS CNAME para hacerte la vida más fácil

Velneo vClientLa nube de Velneo esta teniendo éxito y ya son muchos los que utilizan habitualmente v7cloud*.velneo.com, para desarrollar, ejecutar e implantar.

Esta sugerencia puede ayudarte a conseguir una dirección de Velneo Cloud más personal.

Si quieres acceder a tu vServer de una forma más directa, al estilo:

vatp://app.empresa.com:12345

Solamente debes añadir un registro CNAME en la configuración de DNS de tu dominio “empresa.com”

El registro DNS sería algo como esto:

app CNAME v7cloud1.velneo.com

Debes poner el nombre de v7cloud*.velneo.com que corresponde con tu vrl.

Un registro CNAME indica que las solicitudes de resolución para un nombre sea resueltas con el valor del dominio indicado.

De esta forma, no te tendrás que preocupar si Velneo cambia de ip alguno de sus servidores, tu DNS siempre estará correcta.

Hay muchas páginas en internet que nos dan pistas de como crear un registro CNAME, pero lo más cómodo es que consultes la información  donde tengas tu gestión de DNS

En este enlace de Google hay información de como configurar un registro CNAME en varios proveedores

¿Cómo repercute la latencia en mis aplicaciones?

Lo que dice Wikipedia de la latencia:

En redes informáticas de datos se denomina latencia a la suma de retardos temporales dentro de una red. Un retardo es producido por la demora en la propagación y transmisión de paquetes dentro de la red.

Vista de Gijón

En la era de las aplicaciones para internet hay que tener muy encuenta como la latencia puede ser nuestro enemigo.

Hasta hace poco tiempo el problema de una aplicación era el ancho de banda, que consiste en la cantidad de datos que podían viajar por segundo ( 1 Mb/s , 10 Mb/s ). Con el tiempo, en general, las conexiones ya permiten transmisiones de gran cantidad de datos por segundo.

Por otro lado la latencia es el tiempo que tarda en ir un paquete de un punto a otro.

¿Por qué es la latencia importante para las aplicaciones?

En las aplicaciones donde existe una parte cliente y servidora, la comunicación entre estos dos elementos es constante, enviandose y recibiendo datos para las distintas acciones del usuario. Si durante el desarrollo de la aplicación no se ha tenido en consideración la posible latencia, el usuario podrá llegar a odiar la aplicación ya que tendrá que sufrir constantes esperas entre una y otra acción.

¿Cuál es la latencia en red local?

Normalmente es menor a 1 ms, 50 veces más rapido que una conexión nacional y 100 veces más rápido que una conexión intercontinental.

¿Cómo podemos reducir la latencia entre el servidor y el cliente?

Esto está en manos de las redes de comunicaciones, y parece un problema complejo, porque nos encontramos con limites físicos ( Velocidad de la luz y esas cosas 😉 )
Siempre te queda la opción de poner el servidor más cerca de los usuarios.

¿Cómo puedo reducir los efectos de la latencia?

Existen muchas técnicas, pero basicamente debemos de buscar que los efectos de la latencia no afecten a las acciones del usuario.

  • Evitar las multiples llamadas consecutivas al servidor.
  • Utiliza procesos en segundo plano.
  • Utiliza procesos en el servidor.
  • Programa en un entorno hostil para detectar en desarrollo los pequeños detalles que hacen una gran aplicación.

Te recomiendo el post de Jarboleya sobre consejos para programar aplicaciones en la nube