# exportPDF

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
pip install folium # provisional, se estan evaluando otras librerias como py-staticmaps y selenium
```

### 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. Agregar la vista personalizada creando (copiando) la carpeta indicada y moviendo la vista adentro:

```shell
# en caso de que el repo clonado esté en el home y se encuentra en la 1er carpeta mi_proyecto
cp -r ../sprpcb-exportpdf-func/pdf ./mi_proyecto/pdf # copia la carpeta incluida la vista
cp -r ../sprpcb-exportpdf-func/report-templates ./mi_proyecto/templates/views/report-templates # copia la carpeta incluida la plantilla
# o si prefiere crea la carpetas primero y luego copia los contenidos
```
### 3. Agregar la entrada de ruta en el archivo urls.py del proyecto:

```shell
# ...
urlpatterns = [
    # ...
    path('export/pdf/<str:resourceid>/<str:printubic>/<str:printimgs>/<str:printpdfs>/', export_resource_pdf, name='export_resource_pdf'),
    # project-level urls
]
# ...
```

### 4. Copiar las plantillas de la funcionalidad correspondientes a los modelos de recursos:
```python
python manage.py migrate
```

### 5. Copiar los arachivos necesarios para una nueva plantilla de reporte:
```python
python manage.py migrate
```

### 6. Registrar la plantilla personalizada de proyecto que agrega los botones necesarios:
```python
python manage.py migrate
```

### 7. A continuación, asegúrese de reconstruir la interfaz de su proyecto para incluir el complemento:

```
npm run build_development
```

### 8. Cuando haya terminado, debería ver los botones de exportar en la ventana de vista de reporte de su modelo de recursos:
![image.png](https://gitea.patrimonio.org.bo/sysadmin/sprpcb-resumen-app/attachments/a9b5011e-ce70-482e-8953-da45ff04ca1c)

### 9. Forma de uso:

```

```