====== Creazione e modifica di un documento base ====== ===== Ricercare un documento base ====== Accedere alla funzione **40. Fascicoli Elettronici - 10. Archivi - 160. Documenti Base**. Per ricercare un documento base specifico è possibile valorizzare uno o più campi dei campi presenti (Fig. 1): * Codice * Descrizione * Interno/Esterno * Tipo * Funzione * Bozza {{ :guide:suapsue:documenti_base:fig1.png |}} Fig. 1: Maschera per la ricerca di un documento base Per avviare la ricerca cliccare il bottone **[Elenca]** (Fig. 1), se non si valorizza nessun campo cliccando il bottone **[Elenca]** vengono elencati tutti i documenti base presenti (Fig. 2) {{ :guide:suapsue:documenti_base:fig2.png |}} Fig. 2: Elenco dei documenti base estratti ===== Importare un documento base ====== E' possibile importare un documento base in formato ".xml" e compresso in un file ".zip", per procedere cliccare il bottone **[Import]** (Fig. 1) e se i file vengono riconosciuti correttamente viene visualizzato un elenco dei documenti basi importabili contenuti nel file ".zip". Selezionare uno o più documenti base cliccando sul flag della prima colonna, per terminare l'inserimento cliccare il bottone **[Conferma]**. ===== Esportare massivamente i documenti base ====== E' possibile esportare tutti i documenti base, compressi in un file con formato ".zip", per procedere cliccare il bottone **[Export]** (Fig. 2), verrà scaricato nella cartella predefinita del browser (solitamente "Download") il file ".zip". ===== Creare un documento base ====== Prima di procedere ad aggiungere un documento base si consiglia sempre di verificare, tramite la ricerca, che non sia già presente. Per creare un nuovo documento base cliccare il bottone **[Nuovo]** (Fig. 1), se invece si preferisce partire da un documento base già esistente cliccare il bottone **[Copia Da]**, vengono elencati tutti i documenti base presenti, per selezionarne uno fare doppio click con il bottone sinistro del mouse sopra alla riga desiderata. Valorizzare i seguenti campi (Fig. 3): * **Codice**: Inserire un codice alfanumerico che non sia già stato utilizzato, utilizzare testo in maiuscolo ed evitare l'utilizzo di caratteri accentati o speciali, al posto dello spazio utilizzare l'underscore **_** * **Descrizione**: Inserire il nome da dare al documento base * **Classificazione**: Selezionare il tipo di classificazione da assegnare al testo * **Tipo**: Selezionare **"DOCX"** {{ :guide:suapsue:documenti_base:fig3.png |}} Fig. 3: Maschera per l'inserimento di un documento base Cliccare il bottone **[Aggiungi]** (Fig. 3) per confermare l'inserimento, vengono visualizzati dei nuovi bottoni (Fig. 4) sulla colonna di destra cliccare il bottone **[Apri / Visualizza]**. {{ :guide:suapsue:documenti_base:fig4.png |}} Fig. 4: Maschera per la modifica dei documenti base ===== OnlyOffice ====== Il testo viene aperto con **"OnlyOffice"** (Fig. 5) una suite per ufficio online sicura e altamente compatibile con i formati MS Office, tra cui appunto i DOCX, che permette di creare e personalizzare il testo. {{ :guide:suapsue:documenti_base:fig5.png |}} Fig. 5: OnlyOffice ===== Il dizionario e le variabili ====== Una volta aperto il testo che si intende modificare tramite l'editor di testo "OnlyOffice" cliccare, nella barra del menù in alto, la voce **"Plugin"** (Fig. 6) e successivamente il bottone **[Dizionario]** che permette l'inserimento delle variabili. {{ :guide:suapsue:documenti_base:fig6.png?400 |}} Fig. 6: Barra del menù di OnlyOffice Cliccando il bottone **[Dizionario]** {{:guide:suapsue:documenti_base:dizionario.png?20|}} il sistema visualizza un pannello (Fig. 7) tramite il quale è possibile ricercare e selezionare la variabile che si intende inserire nel testo. E' possibile anche filtrare i dati presente in ciascuna delle tre colonne semplicemente digitando la chiave di ricerca nell'intestazione della colonna desiderata. Per navigare all'interno delle varie categorie è possibile utilizzare i bottoni **[>]** e **[<]** posizionati nella prima colonna. Una volta individuata la variabile che si intende inserire nel testo, basta selezionarla con un click per caricarla nel punto in cui il cursore è posizionato ma è possibile trattarla come una qualsiasi altra parte del testo; è dunque possibile tagliarla, copiarla ed incollarla in altri punti del testo o formattarla col carattere, la dimensione ed ogni altra caratteristica specifica (grassetto, corsivo, ecc.). {{ :guide:suapsue:documenti_base:fig7.png |}} Fig. 7: Dizionario delle variabili Le variabili sono delle stringhe di testo standardizzate e per lo più predefinite, attraverso le quali il sistema completa il documento base selezionato sostituendole automaticamente con i corrispettivi dati, questi ultimi vengono presi direttamente dal sistema, dai fascicoli elettronici, ecc. La variabile è composta da una stringa alfanumerica (solitamente **nometabella.nomecampo** o in alternativa **nometabella.specifica.nomecampo**) preceduta dal simbolo **$** e racchiusa prima tra parentesi graffe **{ }** e poi tra chiocciole **@ @**, ad esempio la variabile da utilizzare per l'oggetto del fascicolo elettronico è **@{$PRABASE.GESOGG}@**. La sostituzione delle variabili con i relativi dati corrispondenti avviene nel momento in cui, dopo aver inserito tra gli allegati di un passo il documento base desiderato, si clicca il bottone con l'ingranaggio per visualizzarne l'anteprima o lo si trasforma in PDF. ===== Esempio di utilizzo delle variabili in un testo base ====== Ipotizzando di voler inserire in un testo i dati di varie figure (es. Esibente, Tecnico, ecc.), le variabili evitano il lavoro manuale di dover ricercare ed inserire ogni volta tutti i dati necessari (es. "Cognome", "Nome", "Codice Fiscale", ecc.), utilizzando le variabili infatti si va a strutturare una sola volta il documento base che potrà essere riutilizzato per qualsiasi fascicolo elettronico svolgendo il lavoro sopra citato in automatico. Nell'esempio sopra citato è possibile infatti strutturare un documento base tipo: \\ \\ //Il sottoscritto __@{$PRASOGGETTI.SOGGETTO0001.DESNOM}@__, C.F. __@{$PRASOGGETTI.SOGGETTO0001.DESFIS}@__, nato il __@{$PRASOGGETTI.SOGGETTO0001.DESNASDAT}@__ a __@{$PRASOGGETTI.SOGGETTO0001.DESNASCIT}@__ prov. (__@{$PRASOGGETTI.SOGGETTO0001.DESNASPROV}@__) e residente all'indirizzo __@{$PRASOGGETTI.SOGGETTO0001.DESIND}@__ n. __@{$PRASOGGETTI.SOGGETTO0001.DESCIV}@__ nel comune di __@{$PRASOGGETTI.SOGGETTO0001.DESCIT}@__ prov. (__@{$PRASOGGETTI.SOGGETTO0001.DESPRO}@__) \\ INCARICA / AFFIDA \\ l'architetto __@{$PRASOGGETTI.SOGGETTO0007.DESNOM}@__ con studio tecnico in __@{$PRASOGGETTI.SOGGETTO0007.DESCIT}@__ prov. (__@{$PRASOGGETTI.SOGGETTO0007.DESPRO}@__), all'indirizzo __@{$PRASOGGETTI.SOGGETTO0007.DESIND}@__ n. __@{$PRASOGGETTI.SOGGETTO0007.DESCIV}@__, ecc.// \\ \\ Utilizzando questo testo in un passo, al momento della visualizzazione dell'anteprima o della generazione del PDF le variabili vengono sostituite dal relativo testo, generando ad esempio:\\ \\ //Il sottoscritto __Rossi Mario__, C.F. __RSSMRA12A34B567C__, nato il __01/01/1950__ a __Roma__ prov. __RM__ e residente all'indirizzo __Piazza Giacomo Leopardi__ n. __1__ nel comune di __Milano__ prov. __(MI)__ \\ INCARICA / AFFIDA \\ l'architetto __Bianchi Luigi__ con studio tecnico in __Torino__ prov. __(TO)__, all'indirizzo __Corso Giuseppe Mazzini__ n. __2__, ecc.// \\ \\ Nel documento base originale è possibile notare la presenza di variabili molto simili ma che fanno riferimento a dati differenti, ad esempio tra la variabili __//@{$PRASOGGETTI.SOGGETTO0001.DESNOM}@//__ e __//@{$PRASOGGETTI.SOGGETTO0007.DESNOM}@//__ la differenza è nel numero centrale dove **0001** indentifica l'**esibente** e **00007** il **tecnico professionista**.\\ ===== Variabili personalizzate ====== Se si desidera è possibile creare una variabile personalizzata, presenti nel dizionario sotto la voce **"PRAANAVAR - Tabella Gestione Variabili"** (Fig. 7) tramite la seguente guida **__[[guide:suapsue:variabili_personalizzate|[Creazione e modifica di una variabile personalizzata]]]__**. ===== Sostituzione di un documento base ====== E' possibile sostituire un documento base con un file ".docx" presente nel proprio computer ricercare il documento base desiderato tramite la ricerca (Fig. 1), accedere al dettaglio del testo base tramite il doppio click con il tasto sinistro del mouse sulla riga desiderata e cliccare il bottone **[Sostituisci]** (Fig. 4). Nella finestra per la selezione del file cliccare il bottone con il **floppy disk** {{:guide:suapsue:floppy.png?nolink&20|}}, selezionare il file ".docx" da caricare e confermare cliccando il bottone **[Apri]**, un messaggio nuova lista elenca tutte le versioni presenti per il testo base selezionato (Fig. 8), tramite il doppio click con il tasto sinistro del mouse sulla riga desiderata è possibile selezionare un'altra versione del file, il messaggio //"File caricato correttamente."// confermerà l'avvenuta sostituzione. ===== Ripristino di una versione precedente (XHTML) ====== Quando si modifica un documento base, in formato XHTML, si crea uno storico delle versioni, questo permette ad esempio di poter recuperare una versione più vecchia che magari era stata modificata per errore. Per procedere ricercare il documento base desiderato tramite la ricerca (Fig. 1), accedere al dettaglio del testo base tramite il doppio click con il tasto sinistro del mouse sulla riga desiderata e cliccare il bottone **[Versioni Precedenti]** (Fig. 4). Una nuova lista elenca tutte le versioni presenti per il testo base selezionato (Fig. 8), tramite il doppio click con il tasto sinistro del mouse sulla riga desiderata è possibile selezionare un'altra versione del file, il messaggio //"È stato caricato il testo della versione 1. Prestare attenzione.."// confermerà l'avvenuta selezione. {{ :guide:suapsue:documenti_base:fig8.png?500 |}} Fig. 8: Elenco delle versioni precedenti E' possibile cliccare sulla tab **"Testo"** per apportare le modifiche desiderate, finché non si provvederà a salvare la nuova versione del testo, cliccando il bottone **[Aggiorna]**, al di sotto del campo **"Descrizione"** viene visualizzata in rosso **"TESTO IN USO: VERSIONE N. ..."** (Fig. 9) con indicata il numero della versione selezionata. {{ :guide:suapsue:documenti_base:fig9.png |}} Fig. 9: Esempio di selezione di una versione precedente ===== Esportare singolarmente un documento base ====== E' possibile esportare anche singolarmente un documento base, per procedere ricercare il documento base desiderato tramite la ricerca (Fig. 1), accedere al dettaglio del testo base tramite il doppio click con il tasto sinistro del mouse sulla riga desiderata e cliccare il bottone **[Export]** (Fig. 4). Viene scaricato nella cartella predefinita del browser (solitamente "Download") il file ".zip" contenente il documento base desiderato in formato ".xml". ===== Eliminare un documento base ====== E' possibile eliminare un documento base, in due modi: * Ricercare il documento base desiderato tramite la ricerca (Fig. 1), cliccare sopra alla riga del testo base desiderato e cliccare il bottone con il **cestino** {{:guide:suapsue:cestino.png?nolink&15|}}, nel messaggio di conferma che viene visualizzato cliccare il bottone **[Conferma]** * Ricercare il documento base desiderato tramite la ricerca (Fig. 1), accedere al dettaglio tramite doppio click con il tasto sinistro del mouse sulla riga desiderata e cliccare il bottone **[Cancella]** (Fig. 4), nel messaggio di conferma che viene visualizzato cliccare il bottone **[Conferma]**.