Compare commits

...

14 Commits

Author SHA1 Message Date
f1c3f711c4 Actualizar README.md 2026-08-07 21:14:12 -04:00
ce89e67181 Actualizar README.md 2026-08-07 21:07:36 -04:00
ab5c0e6d54 Actualizar README.md 2026-08-07 21:06:34 -04:00
Juan Burgos
4ff8888472 protección del token de mapbox 2026-08-07 23:19:25 +00:00
Juan Burgos
0ff577e8b1 Ajuste para dev/no_docker 2026-08-07 16:36:35 +00:00
96eb619a95 Actualizar pdf/views.py 2026-08-07 12:18:06 -04:00
ccaaca4b4e Actualizar copy2proyfolder.sh 2026-08-07 11:22:32 -04:00
ff4dcd2834 Actualizar copy2proyfolder.sh 2026-08-07 11:20:49 -04:00
423a904d7e Actualizar copy2proyfolder.sh 2026-08-07 11:19:29 -04:00
Juan Burgos
69dc786cac ajustes a la vista 2026-08-07 15:14:52 +00:00
Juan Burgos
8f64d2abdb vista actualizada 2026-08-06 01:39:21 +00:00
juse
3817618208 script de copia 2026-08-05 15:52:38 -04:00
Juan Burgos
f867cac9c1 captura actualizada 2026-08-05 19:38:51 +00:00
Juan Burgos
79debe5f46 Guía actualizada 2026-08-05 19:35:18 +00:00
4 changed files with 50 additions and 104 deletions

View File

@@ -1,89 +1,6 @@
# exportPDF
# exportPDF dev/no_docker
> **Precaución:**
> Para instalar en modo producción, utlize la rama main
Funcionalidad para implementar la capacidad de exportar los datos de un recurso a formato PDF.
Los modelos de recursos habilitados para la función son los siguientes:
* Patrimonio material - Bienes inmuebles
* Patrimonio material - Bienes muebles
* Patrimonio inmaterial
* Organización o persona
# Para agregar la funcionalidad ExportPDF a un proyecto de Arches puede seguir el siguiente procedimiento.
Procedimiento válido para un proyecto en modo desarrollo implementado con un enfoque tradicional sin contenedores.
Para el caso de un enfoque utilizando contenedores o en modo Producción, el proceso varía levemente.
### 0. Instalar dependencias y librerias de python (servidor Ubuntu)
Solo en caso de que su proyecto de arches resida en una implementación según la guía oficial de archesproject
```shell
sudo apt install build-essential python3.12-dev python3.12-pip python3.12-setuptools python3.12-wheel python3.12-cffi
sudo apt install build-essential python3-dev python3-pip python3-setuptools python3-wheel python3-cffi libcairo2 libpango-1.0-0 libpangocairo-1.0-0 libgdk-pixbuf2.0-0 libffi-dev shared-mime-info
```
y en el entorno de (arches) python:
```python
pip install django-weasyprint
pip install pypdf
```
### 1. Clonar este repositorio en alguna carpeta de su servidor.
```shell
# puede ser en el home del servidor
git clone https://gitea.patrimonio.org.bo/sysadmin/sprpcb-exportpdf-func.git
```
### 2. Copiar los archivos necesarios para crear una nueva plantilla de reporte que contendrá los botones necesarios:
```shell
cp -r ../sprpcb-exportpdf-func/reportes ./mi_proyecto/reportes
cp ../sprpcb-exportpdf-func/templates_views_report-templates/export-pdf-report.htm ./mi_proyecto/templates/views/report-templates/
cp ../sprpcb-exportpdf-func/media_js_reports/export-pdf-report.js ./mi_proyecto/media/js/reports/
```
### 3. Registrar la plantilla personalizada de proyecto que agrega los botones necesarios:
```python
python manage.py report register -s mi_proyecto/reportes/export-pdf-report.json
```
### 4. Agregar la vista personalizada creando (copiando) las carpetas indicadas y luego los contenidos respectivos:
```shell
# en caso de que el repo clonado esté en el home y desde la 1er carpeta mi_proyecto
cp -r ../sprpcb-exportpdf-func/pdf ./mi_proyecto/pdf
```
### 5. Copiar las plantillas pdf correspondientes a los modelos de recursos:
```shell
cp -r ../sprpcb-exportpdf-func/templates_reports ./mi_proyecto/templates/reports
```
### 6. Agregar una fuente y una entrada de ruta en el archivo urls.py como valor de urlpatterns:
```shell
from .pdf.views import export_resource_pdf
#urlpatterns = [
# ...
path('export/pdf/<str:resourceid>/<str:printubic>/<str:printimgs>/<str:printpdfs>/', export_resource_pdf, name='export_resource_pdf'),
# project-level urls
#]
```
### 7. A continuación, asegúrese de reconstruir la interfaz de su proyecto para habilitar los cambios:
```
npm run build_development
```
### 8. Configuración final
Por último, se deben modificar los modelos de recursos para que adopten la nueva plantilla de reporte registrada:
Cuando haya terminado, debería ver los botones de exportar en la ventana de vista de reporte de su modelo de recursos:
![Alt Text](captura_exportPDF.jpg)
### 9. Forma de uso:
El botón "Exportar a PDF", de manera predeterminada, crea el reporte PDF incluyendo casi todos los datos del recurso. Y de manera opcional se pueden incluir 3 características adicionales a través de los botones adyacentes que controlan los siguientes parámetros:
* Incluir ubicación detallada: Se puede incluir datos de ubicación (geo-localización) que podrían estar contraindicados en algunos tipos de recursos.
* Incluir imágenes adjuntas: Una galería de imágenes distribuida en mosaicos de 2x6 imágenes por hoja a manera de Anexo al informe (existen recursos que tienen más de 20 imágenes relacionadas)
* Incluir documentos (pdf) adjuntos: se ajuntan los documentos relacionados en el mismo archivo pdf del informe
esta rama es para el caso de un entorno de desarrollo clásico, es decir sin utilizar contenedores

Binary file not shown.

Before

Width:  |  Height:  |  Size: 23 KiB

26
copy2proyfolder.sh Executable file
View File

@@ -0,0 +1,26 @@
#!bin/bash
#Script demostrativo para copiar del repo clonado a las carpetas de proyecto
#Utilize con precaución
echo -e "\n\t Script para copiar a carpeta de proyecto"
read -p "Escribe la carpeta de proyecto ( ejem: ~/mi_proy/miproy ): " destino
echo $destino
if [ ! -d "$destino" ]; then
echo "La carpeta de destino no existe. Intente nuevamente!"
exit 1
fi
mkdir -p $destino/pdf
cp ./pdf/views.py $destino/pdf/
cp ./media_js_reports/export-pdf-report.js $destino/media/js/reports/
cp -r ./reportes $destino/
mkdir -p $destino/templates/views/report-templates
cp ./templates_views_report-templates/export-pdf-report.htm $destino/templates/views/report-templates/
mkdir -p $destino/templates/reports
cp ./templates_reports/* $destino/templates/reports/

View File

@@ -1,10 +1,11 @@
# mi_proyecto/pdf/views.py
# dpsk - 2026
import io
from pathlib import Path
from django.http import HttpResponse
from django.template.loader import render_to_string
from weasyprint import HTML
from arches.app.models.models import GraphModel
from arches.app.models.resource import Resource
from django.contrib.auth.models import Group
from datetime import datetime
@@ -19,9 +20,14 @@ import json
import ast
def static_map_view(geojson_colec, sat_map):
g_sys_cfg=GraphModel.objects.get(name='{"en": "Arches System Settings"}')
r_sys_cfg=Resource.objects.get(graph=g_sys_cfg)
r_sys_cfg_data=r_sys_cfg.to_json()
access_token = r_sys_cfg_data['Map Settings']['Mapbox']['MAPBOX_API_KEY']
geojson_dict = ast.literal_eval(geojson_colec)
if sat_map:
style_id = "satellite-streets-v12" # streets-v12 | outdoors-v11 | satellite-streets-v12
for geo in geojson_dict['features'] :
if geo['geometry'].get('type') == 'Polygon':
geo['properties'] = {
@@ -42,25 +48,20 @@ def static_map_view(geojson_colec, sat_map):
"stroke-width": 2,
"stroke-opacity": 0.8
}
else:
style_id = "light-v11"
geojson_string = json.dumps(geojson_dict, separators=(',', ':'))
encoded_geojson = urllib.parse.quote(geojson_string)
username = "mapbox"
if sat_map:
style_id = "satellite-streets-v12" # streets-v12 | outdoors-v11 | satellite-streets-v12
else:
style_id = "light-v11"
width, height = 340, 340
# Procedimiento pendiente para extraer el token desde la configuración del sistema
access_token = 'pk.eyJ1IjoianNidXJnb3N2IiwiYSI6ImNsaWhoN3ZtMTBxeHUzZm1xaGM0cGpxOXIifQ.ki3vldVB5MwZMqDSpLSjLg'
width, height = 400, 400
padding = 100
mapbox_url = (
f"https://api.mapbox.com/styles/v1/{username}/{style_id}/static/"
f"geojson({encoded_geojson})/auto/{width}x{height}"
f"?access_token={access_token}"
f"?padding={padding}&access_token={access_token}"
)
response = requests.get(mapbox_url)
@@ -216,7 +217,9 @@ def export_resource_pdf(request, resourceid, printubic, satmap, printimgs, print
if ruta_medios is not None and bool(int(printpdfs)) :
for medio in reduce(getitem, ruta_medios[:-1], resource_data)[ruta_medios[-1]] :
if medio['formato'] == 'application/pdf' :
merger.append(PdfReader(f'{root_path}/uploadedfiles/{medio["file"]}'))
medio_file = f'{root_path}/uploadedfiles/{medio["file"]}'
with open(medio_file,'rb') as pdf_file :
merger.append(pdf_file)
output_buffer = io.BytesIO()
merger.write(output_buffer)
merger.close()
@@ -224,7 +227,7 @@ def export_resource_pdf(request, resourceid, printubic, satmap, printimgs, print
output_buffer = io.BytesIO()
merger.write(output_buffer)
merger.close()
response = HttpResponse(output_buffer.getvalue(), content_type='application/pdf')
output_buffer.seek(0)
response = HttpResponse(output_buffer.read(), content_type='application/pdf')
response['Content-Disposition'] = f'attachment; filename="{nombre_pdf}.pdf"'
return response