# \[LG-Interoperabilità\] 2.8 Uniformità e Naming **URL:** \ **Category:** Linee Guida Modello di Interoperabilità\ **Created:** [6 Giugno 2018, 8:44am UTC](https://forum.italia.it/t/lg-interoperabilita-2-8-uniformita-e-naming/3556 "2018-06-06T08:44:00Z")\ **Posts on this page:** 5\ **Page:** 1
**Author:** ![Gabri](https://forum.italia.it/letter_avatar_proxy/v4/letter/g/59ef9b/32.png) [@Gabri](https://forum.italia.it/u/Gabri)\ **Post date:** [6 Giugno 2018, 8:44am UTC](https://forum.italia.it/t/lg-interoperabilita-2-8-uniformita-e-naming/3556/1 "2018-06-06T08:44:00Z")
Sarebbe utile avere indicazioni sulla lingua da utilizzare per il naming delle risorse e payload delle API. Nel caso in cui il naming fosse inglese, sarebbe opportuno avere il dizionario di riferimento. Un possibile utilizzo potrebbe essere lo IATE ([http://iate.europa.eu/switchLang.do?success=mainPage&lang=en](http://iate.europa.eu/switchLang.do?success=mainPage&lang=en)). Sempre in questo paragrafo occorre disambiguare alcuni aspetti poiché nei documenti INSPIRE citati come riferimento per i Core Vocabularies i nomi sono in camelCase (countryOfBirth), il che contraddice la prassi snake\_case delle API riportata in questo paragrafo, nel quale è scritto: “… Il campo Query dovrebbe: • essere in snake\_case minuscolo; • non essere in camelCase;…” Nella nota 74 poi si specifica di “…usare parole minuscole separate da trattino «-«;…” ma nello snake\_case non si usa il trattino. ---
**Author:** ![Roberto\_Polli](https://forum.italia.it/user_avatar/forum.italia.it/roberto_polli/32/1127_2.png) [@Roberto\_Polli](https://forum.italia.it/u/Roberto_Polli)\ **Post date:** [6 Giugno 2018, 8:54am UTC](https://forum.italia.it/t/lg-interoperabilita-2-8-uniformita-e-naming/3556/2 "2018-06-06T08:54:01Z")
Buongiorno Gabriella, e grazie per il suggerimento! Ne terremo conto. Chiarisco il contenuto delle Linee Guida: - dove esiste uno standard specifico, eg. INSPIRE, va’ seguito lo standard; - dove non esiste uno standard, deve preferirsi (dovrebbe, non deve) lo snake case; La nota 74 fa’ riferimento al path delle API, e non ai nomi delle variabili e/o ai parametri. Esempio: [https://api.example.com/documenti/dichiarazioni-redditi?codice\_fiscale=AAABBB77T05A512W](https://api.example.com/documenti/dichiarazioni-redditi?codice_fiscale=AAABBB77T05A512W) Questo permette di individuare chiaramente quello che è un URL path da quello che invee è un parametro. Se hai altre domande fai sapere! ---
**Author:** ![Guido](https://forum.italia.it/letter_avatar_proxy/v4/letter/g/b77776/32.png) [@Guido](https://forum.italia.it/u/Guido)\ **Post date:** [7 Giugno 2018, 1:11pm UTC](https://forum.italia.it/t/lg-interoperabilita-2-8-uniformita-e-naming/3556/3 "2018-06-07T13:11:27Z")
Buongiorno Roberto, rispetto alla prima parte della domanda posta da Gabriella relativa alla lingua da utilizzare per il naming ed al corrispondente dizionario di riferimento, intendete dare indicazioni in merito in uno dei prossimi documenti? Grazie. ---
**Author:** ![Roberto\_Polli](https://forum.italia.it/user_avatar/forum.italia.it/roberto_polli/32/1127_2.png) [@Roberto\_Polli](https://forum.italia.it/u/Roberto_Polli)\ **Post date:** [7 Giugno 2018, 2:50pm UTC](https://forum.italia.it/t/lg-interoperabilita-2-8-uniformita-e-naming/3556/4 "2018-06-07T14:50:53Z")
Ciao Guido, per il naming delle risorse, le linee guida indicano [qui](http://lg-modellointeroperabilita.readthedocs.io/it/latest/doc/doc_02_cap_04.html#id43) e [qui](http://lg-modellointeroperabilita.readthedocs.io/it/latest/doc/doc_02_cap_04.html#id44) il punto di partenza: - gli standard di riferimento del dominio applicativo (sanitario, geografico, …) - le linee guida sul patrimonio pubblico [http://lg-patrimonio-pubblico.readthedocs.io/it/latest/](http://lg-patrimonio-pubblico.readthedocs.io/it/latest/) - i vocabolari controllati [https://github.com/italia/daf-ontologie-vocabolari-controllati](https://github.com/italia/daf-ontologie-vocabolari-controllati) Nei casi non coperti da indicazioni specifiche quindi: - non c’è l’obbligo di scrivere in inglese. - qualora si optasse per l’inglese, è stata ripresa la [convenzione di IEEE di usare la dizione statunitense](http://ewh.ieee.org/cmte/substations/Draft%20document%20style%20guide%20etc./2009_Style_Manual.pdf) L’utilizzo di un dizionario specifico - eg. quello segnalato da Gabriella - è un’idea interessante ma non in roadmap. Se volete proporre emendamenti specifici alle Linee Guida - eg. per renderle più chiare anche alla luce di questi scambi - potete farlo tramite github. Fatemi sapere se avete bisogno di qualche indicazione in più, e grazie ancora per i commenti, R: ---
**Author:** ![docs-italia](https://forum.italia.it/user_avatar/forum.italia.it/docs-italia/32/709_2.png) [@docs-italia](https://forum.italia.it/u/docs-italia)\ **Post date:** [26 Giugno 2019, 7:32am UTC](https://forum.italia.it/t/lg-interoperabilita-2-8-uniformita-e-naming/3556/7 "2019-06-26T07:32:51Z")
Chiuso il 26 Giugno 2019, 7:32am UTC