Sintassi dei codici

Da Opera Wiki.

(Differenze fra le revisioni)
 
(7 revisioni intermedie non mostrate.)
Riga 1: Riga 1:
-
{{WIP}}
 
-
{{BR}}
 
{{NB|La funzione sintassi codici nasce con lo scopo di creare delle limitazioni o, più in generale, delle regole da utilizzare sui nomi degli articoli dell'archivio. Tali regole possono essere usate ad esempio per forzare l'utilizzo di un numero minimo o massimo di caratteri, un sottoinsieme di caratteri, o vietarne altri.}}
{{NB|La funzione sintassi codici nasce con lo scopo di creare delle limitazioni o, più in generale, delle regole da utilizzare sui nomi degli articoli dell'archivio. Tali regole possono essere usate ad esempio per forzare l'utilizzo di un numero minimo o massimo di caratteri, un sottoinsieme di caratteri, o vietarne altri.}}
Riga 13: Riga 11:
* il simbolo '''*''': quantificatore (tra 0 e n volte)
* il simbolo '''*''': quantificatore (tra 0 e n volte)
* '''[a-z]''': identifica lettere minuscole comprese tra a e z
* '''[a-z]''': identifica lettere minuscole comprese tra a e z
 +
* '''[0-9]''' identifica numeri compresi tra 0 e 9
 +
* il simbolo '''$''' identifica la fine della stringa
-
Un esempio di espressione regolare potrebbe essere quindi: '''^60TT-[a-z]*-xxx''' che identifica tutte le stringhe che iniziano con i caratteri 60TT-, hanno un numero qualsiasi di lettere minuscole e terminano con la sottostringa -ALL
+
Un esempio di espressione regolare potrebbe essere quindi: '''^60TT-[a-z]*-ALL$''' che identifica tutte le stringhe che iniziano con i caratteri 60TT-, hanno un numero qualsiasi di lettere minuscole e terminano con la sottostringa -ALL
Data la vastità dell'argomento, questo capitolo non affronterà tutte le regole e la sintassi delle espressioni regolari, ma si rimanda alla bibliografia online per ulteriori approfondimenti.
Data la vastità dell'argomento, questo capitolo non affronterà tutte le regole e la sintassi delle espressioni regolari, ma si rimanda alla bibliografia online per ulteriori approfondimenti.
Riga 41: Riga 41:
Proviamo tuttavia ad utilizzare questa espressione regolare come esempio per creare una Sintassi codice nel programma:
Proviamo tuttavia ad utilizzare questa espressione regolare come esempio per creare una Sintassi codice nel programma:
-
* Apriamo l'archivio e creiamo una nuova voce assegnando nome e una descrizione.
+
* Apriamo l'archivio e creiamo una nuova voce assegnando un nome e una descrizione.
-
* Scegliamo a quale tipo di codice si applicherà questa regola scegliendolo dalla lista.  
+
* Scegliamo a quale tipo di codice si applicherà questa regola selezionandolo dalla lista.  
-
* Scriviamo nel campo sintassi la regola scelta, per esempio abcde oppure 60TT-123-ALL.
+
* Scriviamo nel campo sintassi la regola scelta, per esempio abcde oppure 60TT-123-ALL.
Attiviamo poi il campo ''Forza sintassi'' per far sì che il programma vieti la registrazione
Attiviamo poi il campo ''Forza sintassi'' per far sì che il programma vieti la registrazione
Riga 56: Riga 56:
-
*Nell'archivio profili, creare un profilo nuovo per il sistema e la serie selezionata nel quadro ''Sintassi codici'' e incollare il testo '''abcde'''
+
*Nell'archivio profili, creare un profilo nuovo per il sistema e la serie selezionata nel quadro ''Sintassi codici'' e incollare nel campo ''Nome'' il testo '''abcde'''
*Il programma non consente di salvare il nuovo profilo perchè il codice inserito non è conforme.
*Il programma non consente di salvare il nuovo profilo perchè il codice inserito non è conforme.
Riga 69: Riga 69:
|[[File:inserimentocodice2.png|800px|Esempio di codice corretto]]
|[[File:inserimentocodice2.png|800px|Esempio di codice corretto]]
|}
|}
 +
 +
 +
[[Category: JM/Manuale]]
 +
<!-- HELP: JM/W10744 -->

Versione corrente delle 12:37, 3 ott 2023

Note N.B: La funzione sintassi codici nasce con lo scopo di creare delle limitazioni o, più in generale, delle regole da utilizzare sui nomi degli articoli dell'archivio. Tali regole possono essere usate ad esempio per forzare l'utilizzo di un numero minimo o massimo di caratteri, un sottoinsieme di caratteri, o vietarne altri.


Indice


Alcune nozioni di base

La creazione di una regola di sintassi prevede una conoscenza di base sulle espressioni regolari: una espressione regolare è una sequenza di simboli che identifica un insieme di stringhe. Ogni simbolo ha un significato ben definito, ad esempio:

  • il simbolo ^: identifica l'inizio della stringa
  • il simbolo *: quantificatore (tra 0 e n volte)
  • [a-z]: identifica lettere minuscole comprese tra a e z
  • [0-9] identifica numeri compresi tra 0 e 9
  • il simbolo $ identifica la fine della stringa

Un esempio di espressione regolare potrebbe essere quindi: ^60TT-[a-z]*-ALL$ che identifica tutte le stringhe che iniziano con i caratteri 60TT-, hanno un numero qualsiasi di lettere minuscole e terminano con la sottostringa -ALL

Data la vastità dell'argomento, questo capitolo non affronterà tutte le regole e la sintassi delle espressioni regolari, ma si rimanda alla bibliografia online per ulteriori approfondimenti.

Descrizione dei contenuti

La finestra della Sintassi dei codici


  • Tipo/Sistema/Serie: campi filtro per identificare il sistema, la serie e il tipo di articolo al quale è stato applicato il codice.
  • Test: campo per la verifica e il filtro dei codici abbinati agli articoli.
  • Nome: nome della sintassi.
  • Desc: descrizione della sintassi.
  • Tipo/Sistema/Serie File:menutendina.png: campi per la scelta del sistema, della serie e del tipo di articolo a cui abbinare la sintassi.
  • Sintassi: campo per la registrazione dell'espressione regolare.
  • Forza sintassi: se attivato, non permette la registrazione dell'espressione se la sintassi non viene rispettata.
  • Test: campi per testare la validità della sintassi.




Come creare una Sintassi codice

Proviamo tuttavia ad utilizzare questa espressione regolare come esempio per creare una Sintassi codice nel programma:

  • Apriamo l'archivio e creiamo una nuova voce assegnando un nome e una descrizione.
  • Scegliamo a quale tipo di codice si applicherà questa regola selezionandolo dalla lista.
  • Scriviamo nel campo sintassi la regola scelta, per esempio abcde oppure 60TT-123-ALL.

Attiviamo poi il campo Forza sintassi per far sì che il programma vieti la registrazione della voce in archivio qualora la regola di sintassi non fosse rispettata.

Come potete notare, la sezione in basso prevede una serie di campi in cui è possibile testare la sintassi su delle stringhe a piacere.

Se la stringa non supera la verifica di conformità, affianco al testo comparirà un simbolo di errore; viceversa, comparirà un simbolo di conferma.

Utilizzo nel programma

  • Nell'archivio profili, creare un profilo nuovo per il sistema e la serie selezionata nel quadro Sintassi codici e incollare nel campo Nome il testo abcde
  • Il programma non consente di salvare il nuovo profilo perchè il codice inserito non è conforme.

Se, invece usiamo il codice 60TT-abcd-ALL, il nuovo profilo può essere registrato.


Esempio di codice errato Esempio di codice corretto
Strumenti personali