Generale

Introduzione

L'applicazione geobasisdaten.ch mappa in modo coerente i mandati giuridici e tecnici dal punto di vista del [Servizio specializzato] autorizzato ad emanare direttive nel suo ambito di competenza. Tali direttive riguardano specifiche legali e tecniche che devono essere rispettate al momento dell'attuazione. Inoltre, viene specificato il Servizio competente responsabile della raccolta, gestione e aggiornamento dei geodati di base. Qualora la responsabilità dell'attuazione sia in capo ad un'autorità di un livello amministrativo inferiore, il mandato viene delegato al livello amministrativo immediatamente inferiore (in questo caso, il [Servizio specializzato] che emette il mandato non lo delega ad un Servizio competente, ma alle istituzioni/autorità del livello amministrativo immediatamente inferiore). Queste ultime non possono in alcun modo modificare il mandato ricevuto, tuttavia, il loro stesso [Servizio specializzato] può descrivere il mandato per l'attuazione dal punto di vista legale e tecnico sulla base dei propri regolamenti. Pertanto, non vengono apportate modifiche al mandato conferito, ma vengono descritte le normative specifiche applicabili e viene designato il Servizio competente per l'attuazione. Questo permette al Cantone, ad esempio, di definire la propria applicazione in linea con le proprie esigenze senza modificare il mandato originale della Confederazione.

I comuni, i distretti, le regioni, ecc. hanno la stessa flessibilità quando i cantoni conferiscono loro dei mandati. Il mandato di livello superiore può essere indicato come set di dati "genitore" nell'applicazione, ma non può essere modificato. In base alle regole di cui sopra, devono essere specificati nell'applicazione solo gli enti amministrativi di terzo livello che effettivamente definiscono dei mandati che gli sono propri. Il fatto che sia stato loro delegato un mandato dal Cantone non significa di per sé che gli enti amministrativi di terzo livello debbano essere definiti esplicitamente nell'applicazione, in quanto l'attuazione può avvenire direttamente sulla base del mandato definito dal Cantone.

• Parliamo qui dei set di dati giuridici e tecnici per i mandati definiti nell'applicazione. Questi non vanno confusi con i set di dati risultanti dall'attuazione, come ad esempio i set di geodati di base che non fanno parte di geobasisdaten.ch.

Principi di base

Diverse modifiche sono state apportate all'applicazione geobasisdaten.ch. I punti principali sono brevemente descritti di seguito ...

1. la parte giuridica e quella tecnica di una voce di catalogo vengono sempre considerate insieme
   a. una voce tecnica presuppone sempre l'esistenza di una relativa voce giuridica
2. ogni set di dati è assegnato ad un catalogo ed ogni catalogo è assegnato ad un'istituzione
3. le voci di catalogo sono sempre presentate dal punto di vista dell'istituzione che ha conferito il mandato
4. sono gestiti solo tre livelli amministrativi
5. tutti i casi d'uso a tutti i livelli amministrativi sono riprodotti utilizzando uno stesso schema di catalogo
6. ad ogni catalogo è assegnato un identificatore, che può essere presente una sola volta all'interno di un catalogo o di una successione di deleghe e non può essere riassegnato
7. la sistematica degli identificatori è prescritta e gli identificatori vengono assegnati automaticamente quando viene creato un set di dati
   a. l'identificatore della parte giuridica è composto dall'ID del set di dati, dalla designazione del catalogo e dall'etichetta per la delega e la suddivisione
   b. gli identificatori delle parti tecniche associate ricevono un suffisso (numero progressivo) che completa l'identificatore della parte giuridica corrispondente
8. una voce giuridica riceve un'etichetta aggiuntiva, sotto forma di lettera [A], per ogni ulteriore livello amministrativo
   a. se un set di dati viene diviso in due, al nuovo set di dati creato viene assegnata la lettera successiva dell'alfabeto [B-Z]
   b. tale etichetta non viene visualizzata nel caso di set di dati non delegati e non suddivisi o nel caso di set di dati di livello federale
9. ogni voce legale/tecnica può essere pubblicata ad una determinata data
10. i set di dati sono sempre filtrati secondo almeno un'istituzione
11. è possibile visualizzare gli stati storici dei set di dati a partire da una data specifica
12. se l'utente lo desidera, per un set di dati può essere presentato il set di dati "genitore" con il mandato di rango superiore
13. la ricerca viene effettuata sull'intero set di dati, tenendo conto dei filtri impostati. La ricerca riguarda solo i campi attributo selezionati
14. per impostazione predefinita, le voci del catalogo sono elencate per istituzione (in ordine alfabetico), per catalogo (CH, BE), per ID della parte giuridica (1-999) e per etichetta (A-ZZ)
15. la visualizzazione e l'editing (modifica) non sono più separati. Stesso look&feel
16. le modifiche alle voci dei metacataloghi devono sempre essere effettuate prima di poter essere selezionate nel catalogo principale
17. non è più possibile modificare le voci del catalogo principale cancellate e storicizzate, anche se una voce del metacatalogo viene modificata
18. se una voce del metacatalogo viene modificata, i campi interessati delle voci attive del catalogo principale vengono adeguati automaticamente, poiché si tratta di una relazione.

Migrazione dei dati

I dati sono stati trasferiti dalla vecchia applicazione con un'unica operazione il 21 marzo 2019. Ciò significa che anche gli errori presenti nel vecchio database (cronologia) sono stati trasferiti. Le correzioni manuali dei dati (in particolare della cronologia) possono essere effettuate dall'amministratore (admin@geobasisdaten.ch).

A differenza della vecchia applicazione, solo i comuni attivi, il cui catalogo è regolarmente aggiornato, sono stati inclusi nell'applicazione attuale. Se manca un comune o se vuoi crearne uno nuovo, contatta l'amministratore (admin@geobasisdaten.ch).

API

L'applicazione geobasisdaten.ch dispone di un'API che offre funzionlità di lettura, creazione, modifica e l'eliminazione.

L'API è documentata con Redoc al seguente URL: https://geobasisdaten.ch/api/v1/redoc/.

Login utente

Agli utenti può essere assegnato uno dei seguenti ruoli:

1. Modifica: l'utente può modificare il catalogo e tutte le altre informazioni pertinenti, come le basi legali, i servizi specializzati e le persone di contatto. L'utente ha anche accesso a tutti gli endpoint dell'API.
2. Lettura: l'utente può visualizzare le bozze registrate nel catalogo, ma non può modificarle. L'utente ha accesso alle bozze di registrazione anche tramite l'endpoint Data dell'API.

Il login utente è composto da e-mail e password. Queste informazioni permettono di effettuare il login nella home page, selezionando la voce di menu Login:

Figura 01: Login utente

Richiesta nuovo utente

Per ottenere un profilo utente, contattare l'amministratore via e-mail (admin@geobasisdaten.ch) e fornire le seguenti informazioni:

• Nome, Cognome
• e-mail (Nome utente)
• l'entità (cantone/comune/regione/distretto/società) per la quale si richiedono i diritti di modifica
• Ruolo (Edit oppure Read)
• si tratta di persona di contatto? Si/No (Responsabile di catalogo. Le informazioni di contatto compariranno nella scheda dei Contatti)

Reimpostare la password

La password non perde mai di validità. Per reimpostare la password, contattare l'amministratore via e-mail (admin@geobasisdaten.ch) e fornire le seguenti informazioni:

• e-mail (Nome utente)
• nuova password

Lingue

L'applicazione è disponibile in tedesco, francese ed italiano. La lingua può essere scelta nella meta navigazione in alto a destra. Per impostazione predefinita, l'applicazione viene mostrata nella lingua impostata nel browser: qualora la lingua impostata dal browser è diversa da una di quelle disponibili, viene usato il tedesco.

La lingua di visualizzazione può essere impostata manualmente con i tasti in lato a destra nella metanavigazione.

Figura 02: Scelta della lingua

L'impostazione della lingua influisce a livello di interfaccia dell'applicazione e non necessariamente a livello del contenuto. Il contenuto (dati del catalogo) non è necessariamente tradotto e può quindi essere visualizzato nella lingua utilizzata al momento della creazione dei dati.

Esempio: selezionando la lingua italiana, i contenuti relativi al catalogo del Cantone Zurigo saranno visualizzati in tedesco.

⚠️ Il romancio non è più disponibile come lingua dell'applicazione.

Notifiche

L'applicazione informa l'utente sulle modifiche effettuate tramite notifiche che appaiono nella parte superiore destra del browser. Gli errori e le notifiche vengono visualizzati e scompaiono dopo un certo tempo. Una notifica standard ha il seguente aspetto:

Figura 03: Notifiche

Supporto

L'applicazione ha un'interfaccia auto esplicativa. La presente documentazione contiene tutte le procedure più comuni. Contattare l'amministratore (admin@geobasisdaten.ch) via e- mail in caso di problemi o domande.

ℹ️ Le traduzioni mancanti o errate dell'applicazione possono essere segnalate all'amministratore (admin@geobasisdaten.ch) via e-mail.