Controladores extendidos

Para facilitar el desarrollo hemos creado un controlador para listados (ListController) y dos controladores para editar registros (EditController y PanelController). Utilice estos controladores siempre que sea posible. Reducirá el tiempo de desarrollo y conseguirá la mayor integración con el resto de FacturaScripts. Además las futuras mejoras que se implementen estarían disponibles automáticamente en su desarrollo.

Primero listar, después editar

La filosofía de diseño de interfaces de usuario de FacturaScripts es:

• El usuario primero debe ver un listado de registros sobre el que buscar o filtrar (esto lo implementamos con ListController).
• Al hacer clic sobre un registro o pulsar el botón nuevo, el usuario podrá editar ese registro (esa edición se implementa con un EditController o PanelController).

Conceptos generales

La ejecución del controlador se realiza en los pasos:

1. Recepción de los parámetros enviados por la vista, normalmente por post.
2. Ejecutar las tareas previas a la carga de datos. (método execPreviousAction)
3. Cargar los datos de los modelos. (método loadData)
4. Ejecutar las tareas posteriores a la carga de datos. (método execAfterAction)

Esta manera de trabajar simplifica el entendimiento y seguimiento del código del controlador, y aunque no todos los controladores se ajustan a este patrón se anima a mantenerlo de cara a futuros mantenimientos del código.

execPreviousAction

Se ejecuta justo antes de la carga de datos y tiene la posibilidad de interrumpir la ejecución del controlador devolviendo false. Esto lo hace ideal para tareas especiales solicitadas desde la vista mediante AJAX o por los botones de acción incluidos en la vista. Algunas de las tareas que actualmente se gestionan son: autocomplete, save y delete.

Ejemplo: Adición de nuevas acciones

protected function execPreviousAction($action)
{
   if($action === 'hello') {
      /// si el controlador recibe action=hello, ejecutamos esta función
      $this->toolBox()->log()->notice('hello');
      return true; /// continuamos con la carga normal

   } elseif($action === 'hello-json') {
      /// devolvemos un json
      $this->request->setContent(json_encode(['message' => 'hello']));
      return false; /// no continuamos con la carga de datos
   }

   return parent::execPreviousAction($action);
}

execAfterAction

Se ejecuta después de la carga de datos y antes de visualizar los datos al usuario. Como ya se han leido los datos de los modelos, cualquier cambio que se realice sobre los datos cargados, no se verán reflejados en la vista. Algunas de las tareas que actualmente se gestionan son: insert (permite establecer valores por defecto cuando es una alta), export, megasearch.

protected function execAfterAction($action)
{
   if($action === 'bye') {
      $this->toolBox()->log()->notice('hello');
      return;
   }

   parent::execAfterAction($action);
}