Categoria:Formulario: differenze tra le versioni

Da Diritto Pratico.
(nome)
Riga 24: Riga 24:
 
<code>$[nome:Nome Campo;descrizione:Descrizione;(opzioni;)]</code>
 
<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 della relativa variabile riutilizzabile nel corpo del documento.
+
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).  
Ogni "istruzione" ha sintassi: <code>istruzione:parametri;</code> (istruzione, due punti, parametri dell'istruzione, punto e virgola).  
+
  
 
Ad esempio:
 
Ad esempio:
  
<code>Ciao a tutti, mi chiamo $[nome:nome avvocato;descrizione:Inserisci il nome dell'Avvocato;].
+
<syntaxhighlight lang="text">
 +
Ciao a tutti, mi chiamo $[nome:nome avvocato;descrizione:Inserisci il nome dell'Avvocato;].
  
firmato: $nome_avvocato.</code>
+
firmato: $nome_avvocato.</syntaxhighlight>
  
In questo caso stiamo creando un campo di nome "nome_avvocato" (gli spazi nel nome saranno sostituiti con il carattere _) la cui descrizione mostrata all'utente nel form sarà "Inserisci il nome dell'Avvocato". 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.
+
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===
 
===Istruzioni===
 
====nome====  
 
====nome====  
E' l'istruzione più importante e l'unica indispensabile: definisce il nome del campo e la relativa variabile che sarà riutilizzabile nel testo.
+
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:Indirizzo;]</code>
+
Esempio: <code>$[nome:Nazione;]</code>
  
 
Con la stessa istruzione è possibile specificare un valore di default per la prevalorizzazione del campo semplicemente indicandolo fra parentesi:
 
Con la stessa istruzione è possibile specificare un valore di default per la prevalorizzazione del campo semplicemente indicandolo fra parentesi:
  
Esempio: <code>$[nome:Indirizzo(Via Roma n. 123);]</code>
+
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:
 
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:
  
<code>
+
<syntaxhighlight lang="text">
 
$[nome:Capitale;formato:valuta;]
 
$[nome:Capitale;formato:valuta;]
  
 
$[nome:iva($Capitale*22/100);formato:valuta;]
 
$[nome:iva($Capitale*22/100);formato:valuta;]
 
Iva calcolata: $iva
 
Iva calcolata: $iva
</code>
+
</syntaxhighlight>
  
 
calcolerà l'IVA sull'importo <code>$Capitale</code> assegnandolo alla variabile <code>$iva</code>.
 
calcolerà l'IVA sull'importo <code>$Capitale</code> assegnandolo alla variabile <code>$iva</code>.

Versione delle 17:27, 24 giu 2015

Questa pagina ha bisogno di te!

Collabora al suo sviluppo, accedi/registrati e modificala!

Perché farlo? Dai un'occhiata qui!

Cos'è?

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.

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 apps di Diritto Pratico:

  1. scelta del modello da utilizzare
  2. compilazione dei campi
  3. personalizzazione libera del testo
  4. 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, fomule matematiche ecc.). I modelli sono navigabili direttamente dall'applicazione ma anche raggiungibili direttamente via URL.

Campi e variabili

I campi possono essere inseriti nel testo con la seguente sintassi:

$[nome:Nome Campo;descrizione:Descrizione;(opzioni;)]

Semplificando abbiamo un "contenitore" $[...] 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: istruzione:parametri; (istruzione, due punti, parametri dell'istruzione, punto e virgola).

Ad esempio:

Ciao a tutti, mi chiamo $[nome:nome avvocato;descrizione:Inserisci il nome dell'Avvocato;].
 
firmato: $nome_avvocato.

In questo caso sarà creato un campo testuale che assegnerà alla variabile $nome_avvocato (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 $nome_avvocato 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: $[nome:Nazione;]

Con la stessa istruzione è possibile specificare un valore di default per la prevalorizzazione del campo semplicemente indicandolo fra parentesi:

Esempio: $[nome:Nazione(Italia);]

Infine, se fra parentesi indichiamo un'espressione matematica (comprensiva di eventuali variabili) ne sarà calcolato il valore risultante e assegnato alla variabile $nome. Ad esempio:

$[nome:Capitale;formato:valuta;]
 
$[nome:iva($Capitale*22/100);formato:valuta;]
Iva calcolata: $iva

calcolerà l'IVA sull'importo $Capitale assegnandolo alla variabile $iva.

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: $[nome:Indirizzo;descrizione:Inserisci il tuo indirizzo;]

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: $[nome:Indirizzo;formato:stringamultipla;]

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 //

tuttomaiuscolo

Istruzione senza parametri che consente di trasformare in maiuscolo quanto inserito dall'utente.

Esempio: $[nome:tribunale;tuttomaiuscolo;]

opzionale

Istruzione senza parametri che consente di rendere opzionale la valorizzazione del campo;

Esempio: $[nome:titolo;descrizione:Inserisci l'eventuale titolo (es. avv., dott. ecc.);opzionale;]

persistente

il campo registrerà un cookie per ricordare quanto inserito dall'utente anche ad futuro accesso.

Esempio: $[nome:nome;descrizione:Indica il tuo nome;persistente;]

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 =[formula]. Ad esempio:

{{modello|1=
 
Somma: $[nome:primo;] + $[nome:secondo;] = =[$primo+$secondo]
 
Sottrazione: $primo - $secondo = =[$primo-$secondo]
 
Moltiplicazione: $primo x $secondo = =[$primo*$secondo]
 
}}
 
[[Categoria:Formulario]]

Variabili globali

Le variabili globali sono variabili valorizzate dal sistema, riconoscibili per convenzione perchè indicate in maiuscolo (attenzione, maiuscolo e minuscolo sono differenti!):

$DATA inserisce la data odierna.

Come creare un modello personalizzato

Per creare un modello occorre semplicemente 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:

{{modello|1=
 
Ciao a tutti, mi chiamo $[nome:nome avvocato;descrizione:Inserisci il nome dell'Avvocato;]!
 
}}

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 forum di Diritto Pratico.

Sottocategorie

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