Configurazione workspace

Come gestire l'archiviazione dati, i backup e la sincronizzazione cloud.

Cos'è il Workspace Root?

Il Workspace Root è la cartella centrale in cui PDF Mail Engine archivia tutti i dati dell'applicazione.

Invece di nascondere i dati in cartelle di sistema complesse, tutto viene conservato in un'unica posizione trasparente. Questo include:

  • Profiles: Le configurazioni dei processi e le impostazioni email.
  • Templates: I file di layout YAML per i design PDF.
  • Backups: I backup automatici delle impostazioni.
  • Output: I PDF generati vengono salvati qui per impostazione predefinita (salvo diversa configurazione).
  • Logs: I log delle operazioni per la risoluzione dei problemi.

Comportamento predefinito

Per impostazione predefinita, l'applicazione crea una cartella nella directory Documenti: Documents/PDFMailEngine_Workspace


Modifica del workspace

È possibile cambiare questa posizione dalla pagina delle impostazioni System.

  1. Vada alla scheda System.
  2. Sotto Workspace Configuration, clicchi Browse.
  3. Selezioni una nuova cartella.

Deployment strategico (casi d'uso)

Poiché il workspace è semplicemente una cartella, può essere posizionato ovunque in base alle esigenze di sicurezza e operative.

1. Disco locale (predefinito)

Ideale per: Privacy rigorosa e velocità Mantenere il workspace sul PC locale (es. C:\Users\You\Documents\...) garantisce che nessun dato lasci la macchina fisica. Questo offre le massime prestazioni e soddisfa i requisiti più severi di residenza dei dati.

2. Unità esterna / NAS

Ideale per: Ridondanza e condivisione locale È possibile impostare il workspace su un disco rigido esterno (RAID) o un dispositivo NAS.

  • Sicurezza: Protegge da guasti hardware del PC.
  • Condivisione: Consente l'accesso agli stessi profili da diversi computer sulla stessa rete (assicurarsi che solo un utente scriva alla volta).

3. Cloud Storage (Google Drive / OneDrive)

Ideale per: Backup automatico e mobilità È possibile puntare il workspace a una cartella cloud sincronizzata (es. C:\Users\You\OneDrive\PDFMailEngine_Workspace).

  • Backup continuo: Ogni volta che si salva un modello o si genera un log, il servizio cloud lo salva istantaneamente.
  • Gestione dello storage: Scarica lo spazio dal disco locale.
  • Mobilità: È possibile impostare il workspace sullo stesso percorso cloud su un secondo computer (es. un laptop) per accedere alla configurazione da un'altra posizione.

Dettagli tecnici (avanzati)

Per amministratori di sistema e tecnici.

Archiviazione della configurazione

Il percorso del workspace è memorizzato nel file di configurazione locale dell'utente:

  • Path: %LOCALAPPDATA%\OFFICEKAMIYA\PDFMailEngine\config\user_settings.json
  • Key: workspace_root

Se questo valore è vuoto o il file manca, l'applicazione torna alla logica predefinita Documents.

Risoluzione dei percorsi

L'applicazione utilizza un'architettura a "percorsi relativi".

  • I riferimenti interni (es. collegamento di un'immagine in un modello) vengono risolti relativamente al Workspace Root.
  • Questo garantisce la portabilità: è possibile copiare l'intera cartella del workspace su un altro computer (es. da C:\Users\Alice\Docs a D:\Backups) e, puntando l'app alla nuova radice, tutti i collegamenti funzioneranno immediatamente.

Logica di cambio

La modifica del workspace è un cambio di stato, non una migrazione.

  • Action: Aggiorna immediatamente il puntatore in user_settings.json.
  • Side Effect: L'interfaccia si aggiorna mostrando i profili contenuti nella nuova destinazione.
  • Cleanup: La vecchia cartella del workspace viene lasciata intatta.