Categoria:Formulario: differenze tra le versioni

Da Diritto Pratico.
Riga 1: Riga 1:
{{template:wip}}
 
 
{{#seo:
 
{{#seo:
 
|keywords=redattore,pdf,formulario,modello,modelli,esempi,atti,documenti
 
|keywords=redattore,pdf,formulario,modello,modelli,esempi,atti,documenti
 
|description=Formulario aperto per il redattore PDF delle apps di Diritto Pratico
 
|description=Formulario aperto per il redattore PDF delle apps di Diritto Pratico
 
}}
 
}}
__TOC__
+
<big>I modelli e le formule appartenenti a queste categoria sono utilizzate dall'app '''[http://apps.dirittopratico.it/redattore.html Redattore PDF]''' per creare, previa valorizzazione dei campi variabili previsti nel modello medesimo, documenti completi scaricabili direttamente in formato PDF ovvero da copiare e incollare sul proprio elaboratore di testi preferito.</big>
==Cos'è?==
+
I modelli e le formule appartenenti a queste categoria sono utilizzate dall'app '''[http://apps.dirittopratico.it/redattore.html Redattore PDF]''' per creare, previa valorizzazione dei campi variabili previsti nel modello medesimo, documenti completi scaricabili direttamente in formato PDF ovvero da copiare e incollare sul proprio elaboratore di testi preferito.
+
  
 
'''Chiunque può creare/integrare/modificare i modelli e crearsi gratuitamente il proprio formulario personalizzato!'''
 
'''Chiunque può creare/integrare/modificare i modelli e crearsi gratuitamente il proprio formulario personalizzato!'''
  
La filosofia di funzionamento è quella di tutti i redattori assistiti delle [http://apps.dirittopratico.it/ apps di Diritto Pratico]:
+
<big>'''Vai alla [[Guida_Redattore_PDF|GUIDA]] per saperne di più...'''</big>
  
# scelta del modello da utilizzare
 
# compilazione dei campi
 
# personalizzazione libera del testo
 
# download del documento direttamente in formato PDF
 
 
La peculiarità, in questo caso, è che i modelli sono pagine wiki che '''chiunque può creare o modificare'''! Una semplice sintassi consente di inserire nel modello i campi variabili specificandone le regole di valorizzazione (testo semplice, email, codice fiscale, parole composte, valute) e di interazione con il testo. E' possibile inserire formule matematiche, attingere dati da tabelle (es. per l'individuazione automatica del contributo unificato, dei compensi ex DM 55/2014) calcolare automaticamente interessi e termini processuali. I modelli sono navigabili direttamente dall'applicazione ma anche raggiungibili direttamente via URL.
 
 
E' possibile inserire commenti esplicativi nei modelli racchiundendoli tra i caratteri (( e )). Ad esempio:
 
 
<code>(( Questo è un commento che non sarà riportato nel testo del modello. Tuttavia saranno eseguite tutte le istruzioni eventualmente contenute. ))</code>
 
 
==Campi e variabili==
 
I campi possono essere inseriti nel testo con la seguente sintassi:
 
 
<code>$[nome:Nome Campo;descrizione:Descrizione;(opzioni;)]</code>
 
 
Semplificando abbiamo un "contenitore" <code>$[...]</code> ove inserire all'interno le istruzioni per la creazione del campo e la valorizzazione della relativa variabile riutilizzabile nel corpo del documento. Ogni "istruzione" ha sintassi: <code>istruzione:parametri;</code> (istruzione, due punti, parametri dell'istruzione, punto e virgola).
 
 
Ad esempio:
 
 
<syntaxhighlight lang="text">
 
Ciao a tutti, mi chiamo $[nome:nome avvocato;descrizione:Inserisci il nome dell'Avvocato;].
 
 
firmato: $nome_avvocato.</syntaxhighlight>
 
 
In questo caso sarà creato un campo testuale che assegnerà alla variabile <code>$nome_avvocato</code> (gli spazi nel nome saranno sostituiti con il carattere _) quanto inserito dall'utente. Il valore inserito dall'utente sarà sostituito all'istruzione utilizzata per la creazione del campo e assegnato alla variabile <code>$nome_avvocato</code> per essere riutilizzata nel corpo del documento.
 
 
===Istruzioni===
 
====nome====
 
E' l'istruzione più importante e l'unica veramente indispensabile: definisce il nome del campo e la relativa variabile che sarà riutilizzabile nel testo.
 
 
Esempio: <code>$[nome:Nazione;]</code>
 
 
Con la stessa istruzione è possibile specificare un valore di default per la prevalorizzazione del campo semplicemente indicandolo fra parentesi:
 
 
Esempio: <code>$[nome:Nazione(Italia);]</code>
 
 
Infine, se fra parentesi indichiamo un'espressione matematica (comprensiva di eventuali variabili) ne sarà calcolato il valore risultante e assegnato alla variabile <code>$nome</code>. Ad esempio:
 
 
<syntaxhighlight lang="text">
 
$[nome:Capitale;formato:valuta;]
 
 
$[nome:iva($Capitale*22/100);formato:valuta;]
 
Iva calcolata: $iva
 
</syntaxhighlight>
 
 
calcolerà l'IVA sull'importo <code>$Capitale</code> assegnandolo alla variabile <code>$iva</code>.
 
 
'''N.B.:''' in caso di assegnazione di un valore calcolato ad una variabile, questo non sarà inserito direttamente nel testo ma occorrerà esplicitarlo ove occorra.
 
 
====descrizione====
 
Indica cosa richiedere all'utente in fase di compilazione del campo. E' opzionale e se non specificata sarà uguale al nome del campo stesso.
 
 
Esempio: <code>$[nome:Indirizzo;descrizione:Inserisci il tuo indirizzo;]</code>
 
 
====formato====
 
Indica il formato del campo, necessario se occorra la sua "validazione". Può assumere i seguenti valori:
 
*stringa: per stringhe di testo;
 
*stringamultipla: come sopra ma richiede che siano inserite almeno due parole (utile ad esempio se richiesto il nome ed il cognome, se l'utente inserisce solo il nome sarà segnalato un errore);
 
*cf: per il codice fiscale;
 
*piva: per la partita IVA;
 
*cfpiva: indifferentemente per codice fiscale o partita iva;
 
*email: per un indirizzo email;
 
*data: per una data (sarà possibile selezionare la data da un piccolo calendario);
 
*valuta: per una somma di denaro;
 
 
Esempio: <code>$[nome:Indirizzo;formato:stringamultipla;]</code>
 
 
====tipo====
 
Indica quale tipologia di campo utilizzare. Può assumere i seguenti valori:
 
*text: per campi testo su singola linea;
 
*textarea: per campi testo su più linee;
 
*select(opzione 1//opzione 2//opzione 3): per campi a scelta multipla indicando fra parentesi le singole voci separate dalla doppia barra //
 
 
====scaglione====
 
Assegna alla variabile <code>nome</code> il valore corrispondente ad un determinato scaglione preso a riferimento.
 
 
Esempio:
 
 
<code>$[nome:compensoprecetto($capitale+$interessi);formato:valuta;scaglione:precetto ord;]</code>
 
 
assegna alla variabile <code>$compensoprecetto</code> il valore corrispondente per scaglione sull'importo dato dalla somma delle variabili <code>$capitale+$interessi</code> prelevato dalla tabella <code>precetto</code>.
 
 
====tuttomaiuscolo====
 
Istruzione senza parametri che consente di trasformare in maiuscolo quanto inserito dall'utente.
 
 
Esempio: <code>$[nome:tribunale;tuttomaiuscolo;]</code>
 
 
====opzionale====
 
Istruzione senza parametri che consente di rendere opzionale la valorizzazione del campo;
 
 
Esempio: <code>$[nome:titolo;descrizione:Inserisci l'eventuale titolo (es. avv., dott. ecc.);opzionale;]</code>
 
 
====persistente====
 
Il campo registrerà un [[Diritto_Pratico:Informazioni_sulla_privacy#Cookie_policycookie|cookie]] per ricordare quanto inserito dall'utente anche ad futuro accesso.
 
 
Esempio: <code>$[nome:nome;descrizione:Indica il tuo nome;persistente;]</code>
 
 
====primononfestivo====
 
Istruzione senza parametri che indica al redattore, in caso di calcoli con le date, di posticipare il risultato alla prima data utile non festiva.
 
 
Esempio: <code>$[nome:termine(25 novembre 2015 + 30 gg);primononfestivo;]</code> assegnerà alla variabile <code>$termine</code> la data del 28 dicembre 2015 (il termine scadrebbe il giorno di  Natale ed il primo giorno utile non festivo è infatti lunedì 28).
 
 
====sospensioneferiale====
 
Istruzione senza parametri che indica al redattore, in caso di calcoli con le date, di tenere conto della sospensione feriale dei termini (mese di agosto).
 
 
Esempio: <code>$[nome:termine(15 luglio 2015 + 30 gg);sospensioneferiale;primononfestivo;]</code> assegnerà alla variabile <code>$termine</code> la data del 14 settembre 2015.
 
 
====solocampo====
 
Di default, quanto inserito dall'utente in un campo viene sostituito, in fase di compilazione del modello, anche in corrispondenza dell'istruzione utilizzata per generare il campo medesimo (es.: <code>Ciao $[nome:Inserisci il tuo nome;], come stai?</code>.
 
 
Ove si renda necessario utilizzare quanto inserito dall'utente più avanti nel modello solo con la variabile assegnata (nell'esempio precedente <code>$Inserisci_il_tuo_nome</code>) magari per ottenere la compilazione dei campi da parte dell'utente segua un ordine diverso da come questi si susseguono nel modello stesso, è possibile inserire l'opzione <code>solocampo</code>.
 
 
Esempio:
 
 
<syntaxhighlight lang="text">
 
$[nome:Inserisci il tuo nome;solocampo;]
 
 
Tanti saluti da $[nome:Luogo;]
 
 
Firmato: $Inserisci_il_tuo_nome.
 
</syntaxhighlight>
 
 
In tal modo sarà prima chiesto il nome e poi il luogo. In altre parole l'opzione <code>solocampo</code> permette di valorizzare una variabile riutilizzabile nel documento senza che questa debba necessariamente comparire (es. l'aliquota IVA da utilizzare per la generazione di una fattura).
 
 
===Calcoli con le variabili===
 
L'app è in grado di eseguire calcoli con le variabili inserite dall'utente in fase di compilazione del form. Per far questo è sufficiente, dopo aver definito i campi, utilizzare la sintassi <code>=[formula]</code>. Ad esempio:
 
 
<syntaxhighlight lang="text">
 
{{modello|1=
 
 
Somma: $[nome:primo;] + $[nome:secondo;] = =[$primo+$secondo]
 
 
Sottrazione: $primo - $secondo = =[$primo-$secondo]
 
 
Moltiplicazione: $primo x $secondo = =[$primo*$secondo]
 
 
}}
 
</syntaxhighlight>
 
 
====Arrotondamenti====
 
E' possibile arrotondare per eccesso o per difetto un determinato importo.
 
 
Esempio: <code>$[nome:importo_arrotondato($importo);eccesso10;formato:valuta;]</code>
 
 
assegnerà alla variabile <code>$importo_arrotondato</code> il valore di <code>$importo</code> arrotondato ai 10 euro superiori.
 
 
Le istruzioni di riferimento sono <code>eccessoX</code> e <code>difettoX</code> dove X è l'intero per l'arrotondamento.
 
 
Esempio: <code>$[nome:importo_arrotondato($importo);difetto5;formato:valuta;]</code>
 
 
assegnerà alla variabile <code>$importo_arrotondato</code> il valore di <code>$importo</code> arrotondato per difetto di 5 euro.
 
 
 
===Variabili globali===
 
Le variabili globali sono variabili valorizzate dal sistema, riconoscibili per convenzione perchè indicate in maiuscolo (attenzione, maiuscolo e minuscolo sono differenti!):
 
 
<code>$DATA</code> inserisce la data odierna.
 
 
==Come creare un modello personalizzato==
 
Per creare un modello occorre semplicemente [[Aiuto:Creazione_pagina|creare una nuova pagina]] nel wiki di Diritto Pratico. Scegli dunque il nome del tuo modello (che sarà il nome della pagina wiki) e crea la pagina. A questo punto puoi scrivere una breve introduzione/descrizione o quello che vuoi e poi inserire il testo del modello utilizzando il template "modello". Per far questo:
 
 
<syntaxhighlight lang="text">
 
{{modello|1=
 
 
Ciao a tutti, mi chiamo $[nome:nome avvocato;descrizione:Inserisci il nome dell'Avvocato;]!
 
 
}}
 
</syntaxhighlight>
 
 
===Sviluppo===
 
 
L'applicazione, online da domenica 14 giugno 2015, è in piena fase di sviluppo. Chiunque fosse interessato a collaborare segnalando anomalie o suggerendo nuove funzionalità può farlo tramite il [http://www.dirittopratico.it/forum/apps-avvocati.html forum di Diritto Pratico].
 
L'applicazione, online da domenica 14 giugno 2015, è in piena fase di sviluppo. Chiunque fosse interessato a collaborare segnalando anomalie o suggerendo nuove funzionalità può farlo tramite il [http://www.dirittopratico.it/forum/apps-avvocati.html forum di Diritto Pratico].

Versione delle 15:28, 28 lug 2015

I modelli e le formule appartenenti a queste categoria sono utilizzate dall'app Redattore PDF per creare, previa valorizzazione dei campi variabili previsti nel modello medesimo, documenti completi scaricabili direttamente in formato PDF ovvero da copiare e incollare sul proprio elaboratore di testi preferito.

Chiunque può creare/integrare/modificare i modelli e crearsi gratuitamente il proprio formulario personalizzato!

Vai alla GUIDA per saperne di più...

L'applicazione, online da domenica 14 giugno 2015, è in piena fase di sviluppo. Chiunque fosse interessato a collaborare segnalando anomalie o suggerendo nuove funzionalità può farlo tramite il forum di Diritto Pratico.

Sottocategorie

Questa categoria contiene le 7 sottocategorie indicate di seguito, su un totale di 7.