Carga masiva de información

ArchiHUB facilita la carga masiva de documentos mediante un script que respeta la jerarquía de carpetas de tu sistema. Esta guía te mostrará cómo configurar y utilizar esta herramienta para migrar grandes volúmenes de documentos de manera eficiente.

Requisitos previos

Python 3.8 o superior
Git instalado en tu sistema
Una llave de administración de ArchiHUB (aprende a generarla aquí)

Instrucciones paso a paso

Clonar el repositorio

Descarga el repositorio que contiene los scripts de carga:
Ventana de terminal
```
git clone https://github.com/ArchiHUB-App/getting-started.git
```
Configurar las credenciales de la API

Navega a la carpeta de scripts y crea un archivo de configuración:
Ventana de terminal
```
cd getting-started/scripts
touch .env
```
Configurar las variables de entorno

Abre el archivo .env y agrega las siguientes líneas, reemplazando con tus credenciales:
```
ARCHIHUB_API_KEY="tu-llave-de-administracion"
ARCHIHUB_API_URL="http://localhost:11000/adminApi"
```
Preparar el entorno de Python

Crea y activa un entorno virtual para instalar las dependencias:
Ventana de terminal
```
python3 -m venv folder_load
source folder_load/bin/activate
pip install -r requirements.txt
```
Ejecutar el script de carga

Navega a la carpeta de scripts y ejecuta el comando de carga. Asegúrate de ajustar la ruta según tu configuración:
Ventana de terminal
```
cd getting-started/scripts
python3 folder_load.py --folder ruta/a/tu/carpeta --publish true
```

Parámetros del script

El script de carga masiva acepta los siguientes parámetros:

Parámetros obligatorios

--folder
- Descripción: Ruta absoluta a la carpeta raíz que contiene los documentos a cargar.
- Ejemplo: /ruta/completa/a/la/carpeta
- Nota: La estructura de carpetas se mantendrá en ArchiHUB.

Parámetros opcionales

--publish
- Descripción: Publica automáticamente los documentos cargados.
- Valores: true o false
- Por defecto: false (los documentos se guardan como borrador)
- Recomendación: Usa true para producción, false para pruebas.

Ejemplo práctico

Supongamos que tienes la siguiente estructura de carpetas:

Documentos/
├── Proyecto A/
│   ├── Contrato.pdf
│   └── Presupuesto.xlsx
└── Proyecto B/
    ├── Factura.pdf
    └── Recibo.pdf

Para cargar estos documentos manteniendo la estructura, usarías:

python3 folder_load.py --folder /ruta/a/Documentos --publish true

Si deseas cargar la carpeta de ejemplos que viene con el repositorio, puedes usar el siguiente comando (ajusta la ruta según tu sistema):

cd getting-started/scripts
python3 folder_load.py --folder ~/dev/archihub/getting-started/scripts/Assets --publish true

Este comando cargará el contenido de la carpeta Assets que incluye archivos de ejemplo para probar la funcionalidad.

Solución de problemas

Error de autenticación: Verifica que la llave de API en el archivo .env sea correcta.
Ruta no encontrada: Asegúrate de que la ruta especificada en --folder existe.
Permisos denegados: Verifica que tengas permisos de escritura en la carpeta de destino.