Cómo funciona dwXport — Inmersión técnica

Una mirada detrás de escena a la arquitectura, pipeline de exportación, modelo de seguridad e infraestructura de dwXport.

For the technically curious — here's exactly what happens when you run an export.

The Export Pipeline

Six stages from configuration to download — every step isolated, encrypted, and ephemeral.

1

Create Export

An isolated Azure Blob Storage container is provisioned in a dedicated Azure tenant. The storage credentials are uniquely generated and bound to your export job.

Azure Switzerland North

2

Connect DocuWare

Enter your DocuWare credentials. We validate the connection using our dedicated implementation of the DocuWare REST API, covering all available endpoints.

codebar/laravel-docuware · Custom REST interface? Let's connect.

3

Validate & Preview

Your configuration is sent to an isolated Microsoft Azure Container Instance — a fresh virtual machine spun up exclusively for this job. Nothing is shared between exports.

4

Encrypted Handoff

DocuWare credentials and Azure Blob Storage configuration are passed as an AES-256-CBC encrypted payload into the isolated container instance. Secrets never touch disk unencrypted.

AES-256-CBC

5

Stream & Export

Documents are streamed directly from your DocuWare instance to Azure Blob Storage based on your export configuration. No intermediate storage — files never land on our servers.

6

Monitor & Download

Your dashboard polls for real-time status updates. Once the job completes, a dedicated download link is provided — valid for 48 hours before the storage instance is completely destroyed.

48h download window

Security & Privacy by Design

Every architectural decision prioritises your data privacy. Here's what that means in practice.

Zero-Retention Policy

No backups are made — ever. Your export data exists only for the duration of the job and the 48-hour download window. After that, it's gone.

Credentials Destroyed

Sensitive data such as DocuWare credentials and storage keys are purged immediately after the export job completes. Nothing persists.

Ephemeral Storage

The entire Azure Blob Storage instance is deleted after the download window expires. There is no recovery, no archive, no trace.

Fully Isolated Execution

Each export runs in its own Azure Container Instance with encrypted payloads, dedicated storage, and HTTPS everywhere. No export ever shares infrastructure with another.

Under the Hood

For those who want the full technical picture — rate limiting, DocuWare compatibility, and more.

El pipeline de exportación

Cada exportación pasa por tres fases secuenciales, cada una ejecutada dentro de la instancia aislada de Azure Container:

Fase 1: Validación

El sistema se autentica contra su instancia DocuWare y verifica que las credenciales proporcionadas, el ID del archivador y el diálogo de búsqueda sean válidos. Si algo está mal configurado — URL incorrecta, credenciales expiradas, archivador inaccesible — la exportación falla rápidamente con un mensaje de error claro antes de que se transfieran datos.

Fase 2: Preprocesamiento

Usando la API de la plataforma DocuWare, dwXport consulta el archivador seleccionado a través del diálogo de búsqueda configurado. Aplica cualquier filtro que haya establecido (rangos de fechas, condiciones de campos de índice) y cuenta el número total de documentos coincidentes. Este conteo se utiliza para calcular los porcentajes de progreso durante la exportación.

Fase 3: Exportación

Los documentos se obtienen en lotes configurables (por defecto: 100 documentos por lote) y se transmiten directamente a su Azure Blob Storage. Para cada documento, el sistema:

  1. Descarga el binario del documento desde DocuWare a través de la API de la plataforma
  2. Resuelve la ruta de destino usando su estructura de carpetas y patrón de nombre de archivo (ej. {YEAR}/{DEPARTMENT}/{DWDOCID}.{DWEXTENSION})
  3. Sube el archivo a Azure Blob Storage con la clave resuelta
  4. Opcionalmente escribe un archivo de metadatos .json complementario con todos los campos de índice de DocuWare
  5. Actualiza el estado de progreso con los conteos actuales y totales de bytes

Limitación de velocidad y throttling

Para proteger su instancia DocuWare de carga excesiva, dwXport aplica límites de velocidad configurables:

Configuración Por defecto Descripción
Solicitudes por segundo 10 Máximo de llamadas API por segundo
Tamaño de lote 100 Documentos procesados por lote
Pausa entre lotes 1.000 ms Período de enfriamiento entre lotes

Estos valores por defecto son conservadores. Para instancias DocuWare Cloud, recomendamos mantener los valores predeterminados. Las instalaciones On-Premise con recursos dedicados pueden aumentar estos valores de forma segura.

Basándose en estos límites de velocidad, las velocidades de exportación típicas oscilan entre 0,7 y 1,2 segundos por documento, dependiendo del tamaño de los documentos y las condiciones de red.

Progreso en tiempo real

Durante una exportación, el panel muestra el progreso en vivo:

  • Total de documentos coincidentes
  • Documentos procesados y fallidos
  • Bytes transferidos
  • Tiempo estimado de finalización

Tras completarse, dwXport genera un informe HTML detallado con resumen de exportación, listado por documento y detalles de errores para cualquier documento fallido.

Compatibilidad con DocuWare

dwXport funciona tanto con DocuWare Cloud como con instalaciones On-Premise. El sistema se comunica exclusivamente a través de la API REST de la plataforma DocuWare, por lo que no se necesitan plugins especiales ni modificaciones del lado del servidor.

Se soportan todos los tipos de documentos almacenados en DocuWare — PDFs, imágenes, documentos de Office y cualquier otro formato de archivo. Los documentos se exportan en su formato original junto con sus metadatos completos (todos los campos de índice).

Questions? Let's Talk.

Whether you need a custom integration or just want to understand the architecture better — we're here to help.

Solicitar acceso Contact Us