Configurazione e installazione Documenta Web

Per poter configurare correttamente Documenta Web è necessario completare i seguenti passaggi:

Avviare l'Installer

Il file di installazione: DocumentaWeb3_x_x_x.exe deve essere Avviato come Amministratore.
Verrà richiesto, in vari passaggi, di confermare le opzioni di installazione.
In particolare, il percorso di installazione risulta essere significativo, in quanto il nome della cartella di installazione sarà anche il nome dell'applicazione (es. in grassetto "C:\inetpub\DocumentaWeb3").
Questa informazione andrà quindi ad influenzare l'indirizzo internet a cui l'applicazione sarà raggiungibile (es. "https://DocumentaWeb3").

Avvio del Setup

Il Setup viene avviato automaticamente durante la fase conclusiva dell'installazione.
Nel caso sia necessaria una sua successiva esecuzione, l'eseguibile deve essere avviato dalla cartella del sito, dove presente il file configData.json, in quanto l'esecuzione di questo applicativo porta alla sua modifica, in aggiunta alla scrittura di un file index.html, utilizzato per la pagina principale del sito.
E' consigliabile verificare possedere i permessi necessari per poter scrivere file in questa cartella, con l'utente Windows corrente.

Inserire il Nome dell'applicazione

Nel campo "Nome applicazione" viene inserito il nome che si desidera dare all'applicazione che verrà avviata sul server. Viene utilizzato per indicare l'indirizzo base per connettersi all'applicazione (es. http://DocumentaWeb3/), quindi DEVE essere coerente con quanto specificato precedentemente nell'Installer. Come segnalato all'interno del Setup, questa stringa è "case-sensitive".

Inserire IP e Porta del Server di Documenta

Per consentire all'applicazione web di connettersi ed interagire con Documenta, è necessario fornire il relativo IP del Server e la porta utilizzata. Questo IP è lo stesso utilizzato per la connessione tramite il client Desktop standard di Documenta.

Di seguito un esempio di schermata di login del client Desktop di Documenta, da cui poter ottenere i dati (Login → Avanzato):

Inserire il percorso della Cartella radice

La Cartella radice indica la cartella all'interno della quale verranno archiviati i file temporanei e le informazioni relative all'applicazione web da avviare. Questo campo deve essere impostato per riferirsi alla cartella del sito (la stessa da cui il Setup viene avviato). Di seguito un esempio:

Impostare il Timeout del login

Questo valore indica in minuti dopo quanto tempo avviene la scadenza della sessione Utente. Tale scadenza causa la disconnessione dell'Utente e l'eliminazione dei suoi relativi file temporanei (es. file scaricati sul Server).
IMPORTANTE: questo valore va a modificare anche il parametro "Timeout di inattività" presente nelle Impostazioni avanzate dell'Application pool su IIS. Per evitare problemi è bene che i valori siano sempre coincidenti.

Inserire le informazioni generiche del sito

I campi "Nome sito", "Titolo sito", "Descrizione sito", indicano delle informazioni utilizzate per impostare il nome della Tab nel browser, sottotitolo e la relativa descrizione.

Di seguito un esempio

Inserire percorso foto per condivisione link

In questo campo viene inserito il percorso dell'immagine da utilizzare per l'anteprima di condivisione link relativi all'applicazione web.

Di seguito un esempio:

 

Inserire le credenziali per Download senza autenticazione

Documenta Web fornisce una funzionalità di download di file dall'esterno, senza autenticazione. Per poterne usufruire è necessario impostare delle credenziali valide tramite Setup, nei relativi campi Username esterno e Password esterno.

Inserire indirizzi IP abilitati a download dall'esterno

Qualora non si voglia limitare in alcun modo chi può effettuare un download senza autenticazione (anche IP pubblici), è sufficiente lasciare vuoto il campo "IP abilitati esterno".

Se si intende invece porre delle limitazioni agli IP abilitati (es. solo rete locale) è necessario inserire in questo campo i range di IP autorizzati, separati da virgola.

Es. "192.168.0.0/16,127.0.0.0/8,192.168.0.53"

Com'è possibile notare dall'esempio, è possibile anche definire singoli IP (es. 192.168.0.53) che vengano autorizzati, senza indicare il suffisso relativo alla subnet mask.

Inserire configurazioni campi Documenti

Nell'ambiente di Documenta Web i documenti possiedono un gran numero di campi da poter visualizzare. Per consentire all'utente di focalizzarsi su quelli attualmente interessanti è necessario configurare l'applicazione web per richiedere solamente dei campi specificati. In particolare, è possibile indicare al Server Documenta Web di fornire delle configurazioni di default, utilizzabili da tutti gli utenti. Per farlo è necessario indicare un nome UNIVOCO di configurazione e una lista di campi VALIDA (non vuota), da visualizzare.
Questi campi devono essere inseriti con la sintassi seguente (es.): Codice,Estensione,Descrizione,Dimensione File,Proprietario,Data File. Deve esistere una corrispondenza diretta (case-sensitive) tra i campi inseriti e quelli presenti su Documenta.
Il numero massimo di configurazioni fornite dal Server è 5. Nel caso si decida di non utilizzare una o più configurazioni, è sufficiente lasciare vuoto il campo nome (a sinistra) di tale configurazione.

Inserire il filtro per abilitazione al download di specifici formati di file

Nel caso si faccia uso di permessi specifici per il download di file, che non consentono normalmente l'esportazione di file da parte di alcuni utenti in Documenta Client, è possibile inserire delle eccezioni nella parte Web.
In particolare, è possibile inserire alcuni formati specifici di file, separati da "virgola" (es. PDF,DWF) per fare in modo che TUTTI gli utenti siano abilitati a scaricare/visualizzare questi specifici formati di file nella parte Web, a prescindere da tali permessi.

Inserire i campi visualizzabili per tabelle di attività Gantt

Nell'ambiente Calendari è possibile visualizzare, una volta selezionato un Gantt dalla lista, le attività relative a tale Gantt. Queste attività vengono mostrate in forma tabellare, con multipli campi visualizzabili.

Tramite quest'impostazione, è possibile selezionare quali campi attività Gantt si desidera rendere visualizzabili agli utenti in tale situazione. In particolare, viene fornito un "selettore" che contiene i nomi interni di tali campi, seguiti da una descrizione esplicativa. Qualora non si sappia a quale campo i nomi attualmente selezionati corrispondano, è possibile aprire tale selettore per visualizzare tale descrizione esplicativa.

Si suggerisce di utilizzare sempre tale selettore per compilare il campo testuale, così da non commettere errori di battitura.

Limite numero elementi visualizzati lato Web

Considerato il carico maggiore di elaborazione dati nel contesto Web, è consigliabile limitare il numero massimo di elementi visualizzabili nelle liste/tabelle filtrabili in tale contesto. In particolare, si suggerisce un valore vicino a 1000 elementi così che siano contemporaneamente sfogliabili per ottenere una visione generale (mantenendo il "filtraggio" come operazione principale per la ricerca di specifici elementi), ma velocizzando significamente i tempi di risposta.

 


 

Configurazione sovraimpressioni per PDF tramite file OVO

Per poter visualizzare anche in contesto Web i PDF con le sovraimpressioni impostate in Documenta Client, è necessario impostare specifici file e percorsi nella cartella di installazione dell'applicazione Web.

In particolare, una volta avviata l'applicazione per la prima volta, verrà generata una cartella App_Data, nel percorso di installazione di Documenta Web.

In questa directory è necessario creare una cartella chiamata User, e trasferire dentro quest'ultima tutti i file ".ovo", relativi alle sovraimpressioni in Documenta Client. (trovati in "AppData\Local\Progetto Cartesio\Common\utente")
Si veda di seguito un esempio di risultato: