VBO Export
Proporciona acciones de exportación masiva para el módulo Views Bulk Operations, permitiendo a los usuarios exportar las filas seleccionadas de una vista a formatos de archivo CSV, Excel (XLSX) y PDF.
vbo_export
Install
composer require 'drupal/vbo_export:^4.1'
Overview
VBO Export es un módulo de extensión para Views Bulk Operations (VBO) que añade tres potentes acciones de exportación a cualquier vista con un campo VBO. Los usuarios pueden seleccionar filas de una vista y exportarlas a formato CSV, Excel (XLSX) o PDF con una única operación masiva.
El módulo está diseñado para sitios que necesitan exportar datos desde vistas, como inventarios de contenido, listas de usuarios, datos de pedidos o cualquier otra información estructurada mostrada en una vista. Cada formato de exportación tiene sus propias opciones configurables, incluyendo eliminación de etiquetas HTML, anulación de selección de campos y configuraciones específicas del formato como separadores CSV u orientación de página PDF.
Los archivos de exportación se generan automáticamente y se presentan a los usuarios como enlaces descargables. Los archivos se almacenan como archivos temporales que son limpiados automáticamente por el proceso cron de Drupal. Por seguridad, cuando se configura un sistema de archivos privado, los archivos de exportación se almacenan en el directorio privado.
Features
- Exportar filas seleccionadas de la vista a formato CSV con separador configurable (punto y coma, coma o barra vertical)
- Exportar filas seleccionadas de la vista a formato Excel XLSX con formato profesional (encabezados en negrita, autofiltro, columnas autoajustadas, ajuste de texto)
- Exportar filas seleccionadas de la vista a formato PDF con tamaño de papel y orientación configurables
- Opción para eliminar etiquetas HTML de los datos exportados para obtener una salida de texto plano limpia
- Configuración de anulación de campos para seleccionar campos específicos y personalizar sus etiquetas para la exportación
- Soporte de procesamiento por lotes para exportaciones grandes mediante el sistema batch de VBO
- Almacenamiento automático de archivos en directorio privado cuando está disponible para mayor seguridad
- Encabezado UTF-8 BOM para archivos CSV para asegurar compatibilidad adecuada con Excel
- Plantilla de tema para personalización de PDF
- Integración con el sistema de archivos temporales de Drupal para limpieza automática
Use Cases
Exportación de inventario de contenido
Cree una vista que liste todo el contenido con campos como título, autor, fecha de creación, estado y tipo de contenido. Añada el campo VBO y habilite la acción de exportación CSV o Excel. Los editores de contenido pueden entonces seleccionar todo el contenido (o filtrar y seleccionar elementos específicos) y exportar un inventario completo de contenido en hoja de cálculo para propósitos de auditoría o informes.
Exportación de lista de usuarios para marketing
Construya una vista de usuarios con campos de email, nombre, fecha de registro y rol. Con VBO Export, los administradores pueden exportar registros de usuarios seleccionados a formato CSV para importar en plataformas de email marketing o sistemas CRM, asegurando el cumplimiento del RGPD exportando solo usuarios que hayan dado su consentimiento.
Exportación de datos de pedidos para contabilidad
Para sitios de comercio electrónico, cree una vista de pedidos con campos de número de pedido, fecha, cliente, total y estado. Use la acción de exportación Excel para generar hojas de cálculo con aspecto profesional y formato con el que los contables pueden trabajar inmediatamente, incluyendo autofiltros para un análisis de datos fácil.
Generación de informes PDF
Cree una vista que muestre registros de eventos o registros de membresía. Use la acción de exportación PDF para generar informes imprimibles con formato personalizado mediante la plantilla. Esto es útil para generar listas de asistencia, certificados de membresía o registros oficiales que necesitan ser impresos o enviados por correo electrónico como adjuntos.
Preparación de migración selectiva de datos
Al migrar contenido entre sistemas, use VBO Export para exportar selectivamente elementos de contenido específicos. Configure la anulación de campos para seleccionar solo los campos necesarios para la migración y personalice las etiquetas para que coincidan con los encabezados de columna esperados por el sistema de destino.
Tips
- Configure el sistema de archivos privado en Drupal para mayor seguridad - los archivos exportados usarán automáticamente el almacenamiento privado cuando esté disponible.
- Use la opción 'Eliminar etiquetas HTML' cuando exporte datos que serán procesados programáticamente o importados a otros sistemas.
- Anule la configuración de campos cuando necesite selecciones de campos o etiquetas diferentes a las que se muestran en la vista misma.
- Para exportaciones muy grandes, el procesamiento por lotes de VBO maneja los datos en fragmentos para prevenir problemas de memoria y tiempos de espera agotados.
- Personalice la plantilla PDF (vbo-export-pdf.html.twig) en su tema para que coincida con los requisitos de marca y formato de su organización.
- La exportación Excel incluye automáticamente autofiltro en la fila de encabezado, facilitando a los usuarios filtrar y ordenar datos inmediatamente después de abrir el archivo.
- Los archivos CSV incluyen un carácter UTF-8 BOM, asegurando que los caracteres especiales se muestren correctamente al abrirlos en Excel.
- Los archivos de exportación temporales se limpian automáticamente mediante el cron de Drupal - asegúrese de que cron se ejecute regularmente para prevenir la acumulación de archivos en el sistema.
Technical Details
Hooks 2
hook_help
Implementa hook_help para mostrar el contenido del README.md en la página de ayuda del módulo.
hook_theme
Implementa hook_theme para definir el tema vbo_export_pdf para el renderizado de PDF.
Troubleshooting 7
Instale la biblioteca PhpSpreadsheet usando Composer: composer require phpoffice/phpspreadsheet ^2.2. Luego limpie las cachés.
Instale la biblioteca Dompdf usando Composer: composer require dompdf/dompdf. Soporta versiones ^1.0, ^2.0 o ^3.0.
Asegúrese de que el módulo vbo_export esté habilitado. Limpie todas las cachés. Las acciones deberían aparecer en la lista 'Selected actions' al configurar un campo Views Bulk Operations.
El módulo añade UTF-8 BOM para compatibilidad con Excel. Si los problemas persisten, intente abrir el CSV en Excel usando 'Importar' en lugar de 'Abrir', y seleccione explícitamente la codificación UTF-8.
Asegúrese de que la plantilla vbo-export-pdf.html.twig sea accesible. Si usa plantillas personalizadas, verifique la sintaxis de la plantilla. HTML o CSS complejos pueden no renderizarse correctamente en Dompdf.
VBO Export usa procesamiento por lotes para conjuntos de datos grandes. Asegúrese de que max_execution_time y memory_limit de PHP sean adecuados. Verifique que VBO esté configurado para procesar elementos en tamaños de lote razonables.
Verifique los permisos del sistema de archivos en el directorio de archivos públicos o privados. Asegúrese de que el servidor web pueda escribir en la ubicación de archivos temporales.
Security Notes 5
- Los archivos de exportación se almacenan en el sistema de archivos privado cuando está configurado, previniendo el acceso directo no autorizado a los datos exportados.
- Los archivos se crean como temporales, asegurando la limpieza automática mediante el proceso cron de Drupal.
- El permiso de acceso 'view' de las entidades se verifica antes de permitir la exportación - los usuarios solo pueden exportar contenido que tienen permiso para ver.
- Considere la sensibilidad de los datos que se exportan - asegure controles de acceso apropiados en las vistas con funcionalidad de exportación.
- Sea cauteloso con la configuración 'Eliminar etiquetas HTML' deshabilitada, ya que los datos exportados pueden contener marcado que podría ser interpretado inesperadamente por las aplicaciones que los consuman.