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)
{
    switch ($action) {
      /// Boton de Accion: 'clone'
      case 'clone':
          $data = $this->request->request->all();
          $result = $this->cloneDocument($data);
          if (!empty($result)) {
              $this->setTemplate(false);
              $this->response->headers->set('Refresh', '0;' . $result);
              return false;  /// detiene la ejecucion del controlador
          }
          return true;  /// continua con la ejecucion del controlador

      default:
          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)
{
    switch ($action) {
        case 'insert':
            /// Load default values for new record
            $this->views['EditRegularizacionImpuesto']->model->loadNextPeriod();
            break;

        default:
            parent::execAfterAction($action);
    }
}

  Siguiente

Necesita identificarse para continuar con esta acción. Haga clic en iniciar sesión o cree una cuenta.

Iniciar sesión
neorazorx_1
neorazorx_1
4718 Puntos 8 años
Fecha de creación 05-07-2018 00:00:00
Última actualización 30-12-2020
Contador de visitas 2429
Curso básico de usuario

Con este curso aprenderá a gestionar el día a día de su negocio con FacturaScripts 2021: hacer facturas, albaranes, pedidos y presupuestos. Gestionar clientes, proveedores y tarifas. Y a realizar la regularización de impuestos (trimestre de IVA). ¿A quién va dirigido? A cualquier usuario que ya tenga FacturaScripts instalado en su PC o hosting y quiera aprender rápidamente el manejo diario del programa. ¿Qué incluye? 18 lecciones con 17 vídeos explicativos.

214 4,99 €
Curso básico de programación

Con este curso aprenderá cómo crear un plugin sencillo para FacturaScripts 2021: añadir nuevas páginas, tablas y columnas. Para entender este curso no se necesita mucha experiencia en programación, le enseñaremos los básico para modelar problemas sencillos. ¿A quién va dirigido? A cualquier persona con unos conocimientos muy básicos de programación. ¿Qué incluye? 18 lecciones con 14 vídeos explicativos.

214 8,99 €
Sesiones de programación 2021

Esta es una recopilación de vídeos y documentación de pequeños desarrollos sobre FacturaScripts 2021 y sus plugins. Perfecto para expandir tus conocimientos de programación. ¿A quién va dirigido? A personas que ya hayan superado el curso básico de programación y busquen ampliar sus conocimientos. ¿Qué incluye? 9 lecciones con 9 vídeos explicativos (más de 5 horas de vídeos) y el código fuente de los ejemplos. Novedades mensuales: Este curso se amplía cada mes con nuevas lecciones.

35 14,99 €

Copyright (c) 2013-2021 FacturaScripts