L'abilitazione nell'applicazione DocWay di questa funzionalità richiede alcune configurazioni di seguito elencate.

La funzionalità è disegnata per funzionare sia con il server eXtraWay Standard che con il server eXtraWay Enterprise Edition. Richiede la presenza di alcuni script LUA e di fascicoli opportunamente costituiti. Esiste un processo di Generazione automatica dei Fascicoli del Personale di cui si da in seguito esemplificazione. Gli script LUA necessari sono reperibili nel repository CVS cvs.3di.it/var/opt/cvs/docway4/archivi_conf_xml/lua_script, e nello specifico sono:

• pfolders.lua: Script che vengono evocati da alcune particolari funzionalità di DocWay per la restituzione della struttura dei Fascicoli del Personale, corredati da alcuni metadati, e per ottenere l'esportazione dei contenuti multimediali dei fascicoli scelti.
• pfolderscfg.lua: File di configurazione necessario al processo. Nella cartella CVS ne esistono alcuni esempi (pfodlerscfg.nome_cliente.lua). Il file configurazione deve sostanzialmente contenere:
  • La configurazione della cartella dove collocare i file zip una volta completati. L'applicazione ha facoltà di scaricarli ovvero di indicare all'operatore in quale cartella condivisa di rete può acquisirli autonomamente.
  • La configurazione di due comandi di copy e rename adeguati alla piattaforma in cui opera il server.

Vediamo due esempi per installazioni Windows e Linux:
Windows

pfolderscfg.lua

pfolderscfg = {
  zipDir = "c:\\3di.it\\extraway\\xwee\\share\\",
  copyCmd = "copy /Y ##from## ##to##.filepart",
  renCmd = "move /Y ##to##.filepart ##to##",
}

Linux

pfolderscfg.lua

pfolderscfg = {
  zipDir = "/opt/3di.it/extraway/xwee/share/",
  copyCmd = "cp ##from## ##to##.filepart",
  renCmd = "mv ##to##.filepart ##to##",
}

Sono stati realizzati degli script per la generazione automatica dei fascicoli del personale. Essi sono stati realizzati su esplicita richiesta del cliente quindi tutto il materiale indicato questo capitolo dev'essere considerato come materiale dal quale trarre spunto per realizzare ulteriori personalizzazioni.

• Repository CVS:
  • cvs.3di.it/var/opt/cvs/docway4/archivi_conf_xml/lua_script/ader.script
• Contenuto:
  • fascper.lua: Script per la generazione automatizzata dei fascicoli del personale, comprensivi di tutti i sottofascicoli.
  • fascpercfg.lua: Configurazioni necessarie per la generazione automatica dei fascicoli del personale. Nello specifico indica il template del codice fascicolo da adottare, il separatore del file CSV che si andrà ad importare, l'architettura degli alberi di fascicoli con la loro descrizione nell'ordine in cui essi andranno creati e le estensioni degli allegati riconosciuti come immagini.
  • template
    • folder.xml: Template del fascicolo di primo livello
    • subfolder.xml: Template del sottofascicolo
    • varie.xml: Template del record da generare nel sottofascicolo con riferimento all'allegato desiderato.
• Richiede:
  • Un file CSV in formato “Microsoft centro europeo”¹⁾ composto da 5 colonne per la generazione dei fascicoli di ciascun dipendente. Le colonne sono:
    • Nominativo
    • Matricola
    • Codice Fiscale
    • Data di Nascita (in formato gg/mm/aaaa)
    • Data di Assunzione (in formato gg/mm/aaaa)
  • Un file CSV in formato “Microsoft centro europeo”²⁾ composto da 9 colonne per la generazione dei record di tipo varie internamente ai fascicoli con i relativi allegati. Le colonne sono:
    • Nome identificativo del file
    • Codice fiscale del dipendente
    • Classificazione
    • Identificazione dell'Inserto
    • Oggetto
    • Nome Persona RPA
    • Codice Persona RPA
    • Nome Ufficio RPA
    • Codice Ufficio RPA

Lo script espone tre metodi:

• help: Ritorna la descrizione dei metodi esposti, l'indicazione dei parametri in ingresso ed in uscita ed altre informazioni utili.
• folderBuilder: Compie la costituzione dell'albero di fascicoli del personale per ciascuna delle persone indicate in apposito file CSV.
• recordBuilder: Crea i record di tipo varie associandoli ai vari sottofascicoli ed associando loro uno specifico allegato per ciascuna dei file indicati in apposito file CSV.