L'API di RNDT per l'implementazione di GeoDCAT-AP consente di trasformare i metadati dei dati documentati secondo il profilo italiano RNDT, dallo standard ISO TS 19139 allo standard DCAT-AP/DCAT-AP_IT (estensione italiana di DCAT-AP) utilizzato per i dati aperti.
L'API accetta sia richieste CSW (GET e POST) che richieste REST e restituisce i metadati in formato RDF/XML o JSON-LD.
Le richieste REST devono essere coerenti con le API RNDT.
Per ulteriori informazioni sull'uso dell'API, fare riferimento alla guida rapida per l'utente.
Una installazione della soluzione è disponibile sul portale RNDT.
La soluzione è stata sviluppata in PHP 7.1 e gira su qualsiasi web server che ospita quella versione di PHP. Essa è stata testata su Linux, Windows and iOS.
Utilizza le librerie EasyRDF e ML/JSON-LD di PHP che sono già disponibili nel repository.
Il repository include tutto ciò che è necessario per l'installazione e l'avvio, copiando la cartella di distribuzione geodcat-ap_it in una 'web folder'. Prima dell'avvio è necessario configurare i parametri presenti nel file function/config.properties
secondo le indicazioni ivi presenti.
NOTA 1 - Il file publiccode.yml
è un file di metadati richiesto per il software della pubblica amministrazione italiana e non è funzionale all'uso dell'API. Esso è stato inserito per consentire al crawler automatico di Developers Italia di raccogliere tutte le informazioni utili al popolamento del catalogo del software open source.
NOTA 2 - La cartella images/
contiene le immagini per il wiki
e non è funzionale all'uso del converter.
La licenza applicata è European Union Public License v. 1.2.
La soluzione è stata sviluppata da ESRI Italia per AgID nell'ambito della gara per le Infrastrutture Nazionali Condivise SPC.
La soluzione, inoltre, riusa ed estende l'API GeoDCAT-AP sviluppata da JRC e disponibile sul relativo repository GitHub.