FSx-Connector pCron


Este componente permite definir una URL para descargar directamente los Pedidos (y Clientes). Esta URL se puede llamar directamente, o introducir en el Cron de su Sistema como una Tarea Programada (Cron Job) y automatizar el proceso.


Este componente es opcional, y no forma parte del núcleo de FSx-Connector. Si este componente está disponible en su sistema, aparecerá en el menú de FSx-Connector.

fsxpcron_menu

Cuando recibe un Pedido en la Tienda, debe ir a la Zona de Administración de su Tienda (Back-Office) y descargarlo (además del Cliente) mediante el Componente FSx-Pedidos. A continuación deberá importar los ficheros generados desde FactuSOL. El Componente FSx-pCron permite automatizar esta tarea, sin necesidad de acceder a la Zona de Administración de su Tienda.

El Componente FSx-pCron permite configurar una Tarea para descargar automáticamente los Clientes y Pedidos de la Tienda PrestaShop. Esta tarea se puede agregar al Sistema de Tareas Programadas del Servidor donde está la Tienda (cron del Servidor) para que se realice en los momentos que decida. Luego deberá importar los ficheros generados desde FactuSOL, tarea que también se puede programar en FactuSOL para que se ejecute automáticamente en los intervalos de tiempo que necesite.

La Tarea Programada del Componente FSx-pCron utiliza la configuración del Componente FSx-Pedidos de FSx-Connector.

lamp El Componente FSx-pCron sólo podrá instalarse si se han instalado (y configurado correctamente) previamente los módulos básicos: FSx-Configuración, FSx-Diccionario, FSx-Catálogo, FSx-Pedidos y FSx-LOG.

La Caja FSx-pCron le informa sobre las opciones para configurar la Tarea programada de Descarga de Clientes y Pedidos:

fsxpcron_box_pcron

La URL que se muestra:

     http://<su_tienda>/modules/fsxpcron/fsxpcronjob.php?secure_key=PGFAZJYMNNZJPACQ

es específica de su instalación de PrestaShop; en lugar de "<su_tienda>" aparecerá la URL de su Tienda PrestaShop.

La variable "secure_key" es un elemento de seguridad. El valor que toma es específico de su Tienda PrestaShop, y se determina automáticamente durante la instalación de FSx-pCron. Si este valor falta o es incorrecto, la Tarea no se ejecutará.

Recuerde que la Tarea Programada utiliza la configuración del Componente FSx-Pedidos de FSx-Connector (consulte la documentación del Componente FSx-Pedidos).


Configuración Descarga automática de Pedidos

Enviar el LOG al email

El LOG con el resultado de la descarga de Clientes y Pedidos se enviará a esta dirección.

  • Valor: una dirección de correo electrónico válida.
  • Por defecto: la dirección de correo electrónico de la Tienda.

Cómo funciona la Descarga automática de Pedidos

La Tarea programada de Descarga de Clientes y Pedidos se añade al Sistema de Tareas Programadas del Servidor donde está la Tienda (cron del Servidor). Cuando se ejecuta (según los intervalos especificados en el crontab del Servidor) sucede:

  • Descarga de Clientes y Pedidos, de igual manera a como se hace manualmente con el Componente FSx-Pedidos. Se obtiene como resultado los ficheros en el Servidor correspondientes a los Pedidos y Clientes descargados. Estos deberán importarse a FactuSOL manualmente (consulte la documentación del Componente FSx-Pedidos) o automáticamente (vea el siguiente apartado).

  • Los procesos que activa el Módulo pCon pueden generar información en tiempo real sobre el éxito o error en la operación, y por tanto producen entradas en el LOG del Conector (Componente FSx-LOG). Por ejemplo, si no fue posible descargar un Pedido, se le informará de este hecho, indicando el número de Pedido y la causa que produjo el error. Para que el LOG tenga persistencia, o sea, para evitar que las entradas del LOG de una tarea se sobreescriban la próxima vez que se ejecute, las entradas del LOG se vuelcan en un fichero HTML identificado por la fecha y hora en que se realizó la Tarea Programada. Podrá consultar este fichero desde su navegador.

  • Notificación de la tarea realizada, a la dirección de correo electrónico indicada en la configuración del Componente FSx-pCron.

El correo de notificación, que puede personalizarse modificando la plantilla correspondiente, es similar a:

fsxpcron_mail

Proporciona un enlace directo al fichero que contiene el LOG. En este caso el nombre es:

     cron_2013-06-28_11-19-17.html

que está en la carpeta del Servidor:

     /<ruta_prestashop>/modules/fsxpcron/cronLOG/

La ruta completa no se da en el correo por razones de seguridad, que será algo como:

     /public_html/<ruta_prestashop>/modules/fsxpcron/cronLOG/

El contenido del fichero que contiene el LOG es similar al que produce el Componente FSx-LOG:

fsxpcron_log

lamp La Tarea programada de Descarga de Clientes y Pedidos se puede ejecutar manualmente desde un navegador web (o desde un acceso directo en el escritorio del ordenador); el proceso es el mismo, y se obtienen idénticos resultados.


Importación a FactuSOL

La importación a FactuSOL de Pedidos y Clientes puede automatizarse, indicando la frecuencia con la que FactuSOL se conectará a la web para verificar si existen nuevos ficheros de Pedidos y/o Clientes pendientes de desacargar.

fsxfsol_confmenu

Descargar Clientes automáticamente a FactuSOL

fsxpcron_factusol_cli

"Descargar los clientes On-line": Indique la frecuencia con la que el programa descargará los nuevos clientes desde la web.


Descargar Pedidos automáticamente a FactuSOL

fsxpcron_factusol_pec

"Descargar los pedidos de cliente On-line": Indique la frecuencia con la que el programa descargará los nuevos pedidos de clientes desde la web.


Cómo usar las Tareas Programadas del Servidor (Cron Jobs)

Las Tareas Programadas del Servidor (Cron Jobs) suelen ser una opción del Panel de Administración de su Hosting (si no la encuentra, consulte a su proveedor). Esta opción permite crear tareas u operaciones para ser realizadas cada cierto tiempo por el Servidor. Por ejemplo puede crear una Tarea Programada para eliminar archivos temporales cada semana y así evitar que se sobrepase la capacidad de almacenamiento para su sitio web.

Para introducir una nueva Tarea Programada, encontrará un formulario similar a:

fsxpcron_cronjobs

Los cinco primeros campos definen el momento en que se ejecutará la tarea, el siguiente es el comando (la tarea que se ejecutará) y el último es la dirección de correo electrónico a la que se notificará la ejecución de la tarea, y la salida (output) de la misma. Otros proveedores de hosting pueden ofrecer un sistema diferente, similar a:

fsxpcron_cronjobs_conf

Los cinco primeros campos definen el momento en que se ejecutará la tarea deben contener un valor válido, o no se realizará la tarea. Los valores válidos son:

  • Una estrella (*), es un comodín, equivale a cualquier valor (o "siempre")

  • Un número entero

  • Una lista de números separados por comas, ej.: 2,3,7,19,25

  • Un rango de números, ej.: 5-9 que es equivalente a: 5,6,7,8,9

  • Una estrella (*), barra (/) y un número. Ej.: */15 que haría que la tarea se realice cada 15 minutos, o sea 0,15,30,45

  • Una combinación de los anteriores, ej.: 9-12,14,18,20-22, que es equivalente a: 9,10,11,12,14,18,20,21,22

Los rangos para cada campo son:


* * * * * /comando/a/ejecutar
| | | | |
| | | | |----- día de la semana (0 - 6) (0-> Domingo)
| | | |------- Mes (1 - 12)
| | |--------- Día del mes (1 - 31)
| |----------- Hora (0 - 23)
|------------- Minuto (0 - 59)

Ejemplos de repetición:


30 10 * * *
Todos los días a las 10:30 hrs.

0 0 1,10,20 * *
Los días 1, 10 y 20 de cada mes a la media noche.

0,30 * * * 1
Cada 30 minutos los días lunes, (00:00hrs., 00:30hrs., 01:00hrs., ...).

0 22 * 1,2,3,4,5,6,7 * 5
El primer viernes de cada mes a las 10 de la noche.

El comando que se ejecutará puede ser cualquiera. Para realizar automáticamente la Descarga de Pedidos con el Componente FSx-pCron (Tareas Programadas) de FSx-Connector, se ha de ejecutar el script que se indica en el Componente. Una forma de hacerlo es especificando que el script debe ser ejecutado con el intérprete PHP, ya que el script no es ejecutable por sí mismo. La forma más sencilla es especificar un comando como


/usr/local/bin/php /full/path/to/your/script.php

Donde "/full/path/to/your/script.php" debe reemplazarse por la ruta completa (absoluta) de su script:


/usr/local/bin/php /htdocs/…/fsxpcronjob.php?secure_key=PGFAZJYMNNZJPACQ

Normalmente recibirá un email cuando se realiza cada Tarea Programada originado por el Sistema de Tareas Programadas del Servidor. Si no desea esta notificación, añada


>/dev/null

al final del comando. En muchas instalaciones esto elimina toda la salida (output) del script, excepto los mensajes de error. Si esto no funciona en su instalación, pruebe


&>/dev/null

o bien


>/dev/null 2>&1

Otra forma de realizar automáticamente la Descarga de Pedidos con el Módulo pCron de FSx-Connector es mediante "wget". En este caso, el comando que se ejecutará es:


wget -nv -O /dev/null http://www.dominio.com/archivo.php

donde "http://www.dominio.com/archivo.php" debe reemplazarse por la URL completa de su script:


wget -nv -O /dev/null http://<su_tienda>/.../fsxpcronjob.php?secure_key=PGFAZJYMNNZJPACQ

Y si no quiere recibir el email cada vez que se ejecute el cron:


wget -nv -O /dev/null http://www.dominio.com/archivo.php >/dev/null 2>&1

Usuarios avanzados pueden crear Tareas Programadas editando directamente el fichero "crontab" a través de una conexión segura SSH.



Su mensaje:

Cerrar [X]

Gracias por su colaboración.

Cerrar [X]

COMPARTIR