1

NDICE

P3.G losario

P4.Introduccin

Estadoyalcancedeestagua
Qusonlosmetadatos?
Cmosepublican?
Pblicoobjetivodeestagua

P6.P ortalAndino

Catlogo
Dataset
Distribucin
Campo
Tema

P14.O troscatlogos

Estndarutilizado
Camposdelperfil
C
atlogo

D
ataset

D
istribucin

C
ampo

T
ema

P29.A nexoITaxonomatemticaglobaldelaAPNparalosdatasets(tabla)

P31.A nexoIIPautasparalaseleccindeetiquetas

P32.A nexoIIIEspecificacindefrecuencias(segnISO8601)

P33.A nexoIVEjemplodedata.json

P36.A nexoVTaxonomatemticaglobaldelaAPNparalosdatasets(JSON)

P38.A nexoVIEjemplodemetadatoscomotexto

Glosario

Activodedatos

Es cualquier coleccin de datos con valor informativo, de propiedad de una entidad u organismo,
que reflejan su actividad y son relevantes para el desarrollo de sus misiones y funciones, o para los
actores de su ecosistema. Aunque puede designar piezas aisladas de informacin, suele emplearse
para identificar y tratar conjuntos de datos que pueden ser comprendidos y tratados como una
nicaunidadaefectosdesugestin,uso,proteccineintercambio.

Distribucinorecurso

Es la unidad mnima de un catlogo de datos. Se trata de los activosdedatosquesepublicanally

que pueden ser descargados y reutilizados por un usuario como archivos. Losrecursospuedentener
diversos formatos (.csv, .shp, etc.). Estn acompaados de informacin contextual asociada
(metadata) que describe el tipo de informacin que se publica, el proceso por el cual se obtiene, la
descripcin de los campos del recurso y cualquier informacin extra que facilite su interpretacin,
procesamientoylectura.

Dataset

Tambinllamadoconjuntodedatos,eslapiezaprincipalentodocatlogo.Setratadeunactivode
datos que agrupa recursos referidos a un mismo tema, que respetan una estructura de la informacin.
Los recursos que lo componen pueden diferir en el formato en que se los presenta (por ejemplo: .csv,
.json, .xls, etc.), la fecha a la que se refieren, el rea geogrfica cubierta o estar separados bajo algn
otrocriterio.

Catlogodedatos

Es un directorio de conjuntos de datos, que recopila y organiza metadatos descriptivos, de los

datosqueproduceunaorganizacin.Unportaldedatosesuncatlogo.

Perfildemetadatos

Es un estndar para documentar los activosdedatosdeuncatlogo.Enestaguadocumentamos

unperfildemetadatosquebuscaunificarelmodoenelqueestossecompartendesdelaAdministracin
PblicaNacional.

PortalAndino

Es el portal empaquetado y distribuible desarrollado sobre la base delaplataformaCKAN(portal

dedatosabiertos),diseadoparafacilitarlaaperturayfederacindeactivosdedatosenlaArgentina.

PaqueteparalaaperturadedatosdelaRepblicaArgentina

Es un conjunto de herramientas y guas de buenas prcticas creadas para hacer ms fcil la

publicacindedatosabiertose
nlaArgentina.

Introduccin
Esta gua busca ayudar a los organismos a instrumentar la PolticadeDatosAbiertosimpulsadadesde
elGobiernodelaNacinArgentina,atravsdelDecretoN117/2016del12deenerode2016.

Objetivodeestagua
Esta es una gua de recomendaciones y buenas prcticas, para el uso y la publicacin de
metadatos.

Para hacer estas recomendaciones, nos basamosenestndaresusadosanivelnacionaleinternacional

y en la experiencia de trabajo del equipo de la Direccin Nacional de Datos e Informacin Pblica del
Ministerio de Modernizacin de la Nacin.

Esta es una gua colaborativa y en progreso. Valoramos, y alentamos, aorganizacionesyciudadanosa

plantear ideas, sugerencias, y comentarios que nos ayuden a crear un mejor documento.

Este documento se complementa con la Gua para la publicacin de datos en formatos abiertos y la
Guaparalaidentificacinyusodeentidadesinteroperables.

Qusonlosmetadatos?
Los metadatos son los datos sobre los datos. Esdecir:elementosdescriptivosquedancontexto
a un conjunto de datos, y acercan al usuario la informacin necesaria para entenderlos y usarlos
eficazmente.

Un ttulo y una breve descripcin son los metadatos bsicos que cualquier conjunto de datos a
publicar debera tener. Despus, existen muchos otros elementos queayudanallectorahacerunbuen
usodelosdatos.Porejemplo:

Nombre, tipo de datos y descripcindeloscampos:qusignificacadacampo?qudatos

puedoencontrarenesacolumna?qudicenyqun
odicenesosdatos,cmodeboleerlos?
Palabrasclave:clasificanaundatasetcomopertenecienteaunconjuntodetpicos.
Tema: clasifican a un dataset como perteneciente a un determinado tema, dentro de una
jerarquatemtica.
Fechadepublicacin:cundosepublicporprimeravezestedataset?
Fechadeltimamodificacin:cundoseactualizporltimavezestedataset?
Frecuenciadeactualizacin:cadacuntoseactualizaestedataset?
URLdedescarga:cmodispongodelosdatos,desdedndepuedodescargarlos?

Una lista curada de campos de metadatos, junto con las instruccionesdecmodebenutilizarse,define

unp
erfildemetadatos.

En esta gua describimos el perfil de metadatos recomendado para los catlogos de la

AdministracinPblicaNacionalycmopublicarlo.

Cmosepublicanlosmetadatos?

La publicacin de los metadatos puede ser muy diversa en detalle, calidad y forma. Una
publicacin muy elemental es un documento de texto que ofrece una descripcin del dataset y de
cada uno de los recursos que lo componen. Es posible ver un ejemplo textual de los metadatos de un
catlogodedatosenelA
nexoVIEjemplodemetadatoscomotexto.

Sin embargo, las computadoras no pueden leer fcilmente documentos de texto. La organizacin
sistemtica de colecciones dedatasets(esdecir,lacreacindeuncatlogodedatos)exigeunnivelde
complejidad mayor para facilitar su descubrimiento, indexacin, y reutilizacin por parte de scripts y
aplicacionesdetodotipo.

La potencial reutilizacin de los conjuntos de datos y la posibilidad de que los mismos sean
correctamente federados desde el Portal Nacional de Datos Abiertos (datos.gob.ar) depender de la
calidad de sus metadatos. Adoptar y/o desarrollar estndares y vocabularios controladosesimportante
paralalecturaeinterpretacindelosconjuntosdedatosporpersonasyporaplicacionesinformticas.

Para esto, los catlogos de datos publican sus metadatos en un formato estructurado (JSON)
respetando un determinado perfil estandarizado. Recomendamos ver un ejemplo en JSON de los
metadatosdeuncatlogodedatosenelA
nexoIVEjemplodedata.json.

En el resto de este documento detallamos las caractersticas de los estndares y vocabularios

controladosadoptadosparacatlogosdedatos,datasetsydistribuciones.

Pblicoobjetivodeestagua
Estaguaintentaayudaraquienes:

Publican sus catlogos de datos mediante un adaptacin del portal Andino. Es decir, del
portal que el equipo de Datos de la Nacin Argentina dise sobre la base de CKAN y que
pueden adoptar las dependencias de la Administracin Pblica Nacional (as como tambin de
otros niveles gubernamentales subnacionales o incluso entidades del pblico general) para
gestionarlapublicacincentralizadadesusactivosdedatos.
El portal Andino incluye formularioswebparalacargadedatosymetadatos.Lapublicacinde
metadatos mediante este portal cumple con el perfil de metadatos recomendado en esta
gua. El Portal debe publicarse en un dominio de la forma http://datos.[entidad].gob.ar. Esto
asegura la publicacin automtica de los metadatos en formato data.json en
http://datos.[entidad].gob.ar/data.json

Siestsdentrodeestegrupo,r ecomendamosleerlaseccinP ortalAndino.Conella,podrs
comprendercmocompletarcadacampoenelformulariowebdelPortalAndino.

Publican sus catlogos de datos mediante otros medios. Esto es, en forma directa en el
dominio digital de laentidadresponsableodealgunaformaalternativaenlared.Esasentidades
debern publicar su catlogo de datos en un archivo estructurado (JSON) llamado data.json
alojado en un dominio de la forma http://datos.[entidad].gob.ar/data.json siguiendo las
especificacionesdelperfildemetadatosdeestagua.

En [entidad] recomendamos usar un nombre simple y breve que represente a la organizacin que
publicaelcatlogo(porejemplo:datos.jus.gob.ar,datos.tucuman.gob.ar,datos.pilar.gob.ar).

Silaaperturadetusdatosseinscribeenestamodalidad,t esugerimosleerlaseccinO
tros
catlogos.Teayudaracomprendercmogenerarypublicarunarchivod ata.jsonquecumplaconel
perfildemetadatosdelaAdministracinPblicaNacional.

PortalAndino

El portal Andino es una herramienta especialmente diseadaparafacilitarlapublicacinyaperturade

datosycumpleconelperfildemetadatosdelaAdministracinPblicaNacional.

Al cargar datasets y distribuciones a travs de sus formularios, segeneranlosmetadatosdelperfilyse

publicanenunarchivodata.jsonenelformatocorrecto.

El archivo data.json de un Portal Andino puede encontrarse en el directorio raz del portal:
http://datos.[entidad].gob.ar/data.json.

Catlogo
Elperfildemetadatospropuestoseconformadetrescomponentesprincipales:

Lainformacindelcatlogo.
Losdatasets
Lasdistribuciones.

El data.json de quienes usen el portal Andino contar con los metadatos correspondientes a los
datasetsydistribuciones.

Los metadatos a nivel de catlogo debern ser completados en una planilla de clculo y
publicados en formato CSV en el directorio raz del portal, quedando disponibles parasudescarga
enunaURLcomoh
ttp://datos.[entidad].gob.ar/catalog.csv.

El resto de los metadatos generados al cargar o actualizarundatasetounadistribucinenelportal,se

generan a travs de los formularios completados y se publican automticamente en
http://datos.[entidad].gob.ar/data.json.

Recomendamosverune
jemplotextualdemetadatosdeunc
atlogo.

Estossonlosmetadatosnecesariosparadescribirelcatlogo:

Nombre Requerido Descripcin Ejemplo

S Nombredadoalcatlogo.Debeserclaro,breve DatosArgentina
ylosuficientementeabstractocomopara
Nombre
abarcarlamultiplicidaddedatasetsque
contiene.
S Descripcindelcontenidodelcatlogo. PortaldeDatosAbiertosdel
Descripcin GobiernodelaRepblica
Argentina

Autor S Responsabledelapublicacindelcatlogo. MinisteriodeModernizacin

Correo S Correoelectrnicodecontactodelresponsable datos@modernizacion.gob.ar

electrnico delapublicacindelcatlogo.
delautor
Recomendado Fechadecreacinopublicacindelcatlogo. "20160414T19:48:05.433640"
Fechade SeescribesegnelformatoISO8601,tipeado paraespecificarfechayhora
creacino comofechasimpleofechaconhora,conel
publicacin mayordetalleposiblequesearelevanteparael "20160414"paraespecificar
dataset. fechanicamente
Recomendado Fechadeltimaactualizacin/modificacindel "20160419T19:48:05.433640"
Fechade
catlogo.SeescribesegnelformatoISO8601, paraespecificarfechayhora
ltima tipeadocomofechasimpleofechaconhora,
actualizacin/ conelmayordetalleposiblequesearelevante "20160419"paraespecificar
modificacin paraeldataset. fechanicamente
Recomendado Lenguajeparaladescripcindelosmetadatos ["es"]paraunlenguajeISO6391
delosdatasetscontenidosenelcatlogo.Hay
dosestndaresISOquepuedenserusados ["spa",eng"]paradoslenguajes
paraestecampo: ISO6392

(a)ISO6391(2letras)
Idioma(s) (b)ISO6392/T(3letras)eselms
recomendado.

Puededefinirseunoomslenguajesenuna
lista.(LinkalosestndaresISO:
https://www.loc.gov/standards/iso6392/php/cod
e_list.php)
S Eselsistemadeclasificacintemticaglobalde http://datos.gob.ar/superThemeT
Taxonoma
laAdministracinPblicaNacional.Compone axonomy.json
temtica
unalistadetemasglobalesyestpublicadaen
global "http://datos.gob.ar/superThemeTaxonomy.json".
Recomendado Indicalalicenciabajolacualtodoslosdatasets "http://opendatacommons.org/lice
ydistribucionesdelcatlogoestndisponibles nses/dbcl/10/"siseutilizaun
medianteunenlacealalicenciaodocumentode enlace
lalicenciaseleccionada,omedianteelttulo
textualdelalicenciatalcomoapareceenlalista "OpenDatabaseLicense(ODbL)
Licencia
dehttp://opendefinition.org/licenses/. v1.0"siseconsignaelnombrede
recomendamosusarlalicencia"OpenDatabase lalicenciaautilizar
License(ODbL)v1.0".Undatasetodistribucin
queespecifiqueunalicenciadiferente,
sobreescribealalicenciageneraldelcatlogo.

Recomendado Direccinwebdeaccesoalapginaprincipal http://datos.gob.ar

Pginaweb
delcatlogo.Enlacealapginaprincipaldel
delcatlogo
catlogo.
No Informacinsobrederechosaplicablesal
catlogoenelcasoquenosehayan
Derechos
especificadoenlalicencia.Losdatasetsysus
sobreel
distribucionesheredanlainformacinsobre
catlogo derechosaplicablesalcatlogo,amenosque
especifiquenunosderechosdistintos.
No Elreageogrficacubiertaporelcatlogo. "ARG"eselcdigoparala
Unareginounlugardeterminado.Puedetomar RepblicaArgentina.
valores:
a)Depasesy,provinciasymunicipios "06007"eselcdigodeun
argentinos,segnlasrecomendacionesdela departamento
Guaparalaidentificacinyusodeentidades
interoperables. [58.111111,35.111111,
b)Unreadecoordenadasrepresentadapor
Cobertura 57.111111,33.111111]esun
latitud/longitudenelorden:mnimalongitud,
geogrfica boundingbox
mnimalatitud,mximalongitud,mximalatitud.

c)Unpuntogeogrficorepresentadopor
[58.111111,35.111111]esun
latitud/longitud.
puntogeogrfico
d)Silareferenciageogrficonoestidentificada
enlaGuaparalaidentificacinyusode
entidadesinteroperablesindicarlaURIssegn "http://sws.geonames.org/625514
geonames.orgej: 6"
http://sws.geonames.org/6255146

Dataset
Recomendamosverune
jemplotextualdemetadatosdeund
ataset.

A continuacin, describimos los metadatos que se deben completar para describir un dataset a lahora
desucargaoactualizacinenelcatlogo:

Nombre Requerido Descripcin Ejemplo

S Nombreasignadoaldatasettalcomo Sistemadecontratacioneselectrnicas
serpublicado.Debeserclaroylo
suficientementeabstractocomopara
abarcarlamultiplicidaddedistribuciones
Ttulodel quecontiene.Serecomiendano
dataset excederlos100caracteresenla
mayoradeloscasos.Encasodeque
unttulomslargosejuzguenecesario
orelevante,estenodeberexcederlos
200caracteres.
S Descripcindelcontenidodeldatasetde DatoscorrespondientealSistemade
Descripcin unmodoclaroyconciso.Serecomienda ContratacionesElectrnicas(Argentina
deldataset noexcederlos500caracteresenla Compra)
mayoradeloscasos.Encasodeque
unadescripcinmslargasejuzgue

necesariaorelevante,stanodeber
excederlos1500caracteres.
S Responsabledelapublicacindel MinisteriodeModernizacin.Secretarade
dataset.Enelcasodeorganizaciones, ModernizacinAdministrativa.Oficina
detallarlaestructurajerrquica NacionaldeContrataciones.
separadaporpuntos,demanera
jerrquicamentedescendiente.Sila
Responsable organizacinespartedela
AdministracinPblicaNacionalyest
listadaeneldatasetllamado"Estructura
OrganicadelPoderEjecutivoNacional"
(http://datos.gob.ar/dataset/estructuraor
ganicapen),deberutilizarsela
denominacinalldocumentada.

Emaildel Recomendado Correoelectrnicodecontactodel onc@modernizacion.gob.ar

responsable responsabledelapublicacindel
dataset.
Recomendado rea/personadecontactoquepuede MinisteriodeModernizacin.Secretarade
Mantenedor brindarinformacinrelevantesobreel ModernizacinAdministrativa.Oficina
dataset. NacionaldeContrataciones.Direccinde
ComprasElectrnicas.

Emaildel Recomendado Correoelectrnicodelrea/personade onccompraselectronicas@modernizacion.gob

mantenedor contactoquepuedebrindarinformacin .ar
relevantesobreeldataset.
Si Temtica/socategora/sglobalesala/s ["ECON"]
queserefiereeldatasetalser
publicado.Undatasetpuedepertenecer
amsdeunacategoraglobal,de
maneraqueeltipodevalordeeste
Temas campoesunalistadecategoras.La/s
globales categora/sotemtica/sglobalesdeben
adoptarsesegnelcampo"Cdigo
(authoritycode)"delA nexoTaxonoma
temticaparalosdatasets,que
contieneunalistapredefinidade
temtica/sglobales.
Recomendado Temtica/socategora/sespecfica/sa ["Contrataciones","Compras",
la/squeserefiereeldatasetalser "Macroeconoma"]
publicado.Undatasetpuedepertenecer
Temas amsdeunacategoraespecfica,de
especficos maneraqueeltipodevalordeeste
campoesunalistadecategoras.La
taxonomaautilizardebesercreadapor
laautoridadresponsabledelCatlogo.
Recomendado Palabrasquedescribenelttulooel ["bienes","compras","contrataciones"]
contenidodelrecurso.Esnecesarioque
lasetiquetasseencuentren
correctamenteescritas,enpluraly
Etiquetas respetandolaexistenciadetags
anteriores.Etiquetasquecolaboranen
labsquedadelosusuarios.Cuanto
msampliayuniformesealalistade
tagsmayorsersueficiencia.Atales

finesserecomiendaverelA
nexo
Pautasparalaseleccindeetiquetas.
S Frecuenciaconlaqueseactualizael R/P1Yparadatasetsqueseactualizan
dataset.Serecomiendaespecificar anualmente
Frecuencia perodosnormalizadosconformato
de ISO8601,agregandoelcampo
actualizacin eventualparadatasetsquesepublican
conunafrecuenciaeventualono
especificada.A nexo"Especificacinde
frecuenciassegnISO8601".
S Fechadepublicacindeldataset.Segn "20160414T19:48:05.433640"para
Fechade elformatoISO8601,tipeadocomo especificarfechayhora
publicacin fechasimpleofechaconhora,conel
mayordetalleposiblequesearelevante "20160414"paraespecificarfecha
paraeldataset. nicamente
No Lenguajeparaladescripcindelos ["es"]paraunlenguajeISO6391
metadatosdeldataset.Haydos
estndaresISOquepuedenser ["spa",eng"]paradoslenguajesISO6392
utilizadosparaestecampo:

(a)ISO6391(2letras)
(b)ISO6392/T(3letras)eselms
recomendado.
Idioma

Puededefinirseunoomslenguajesen
unalista.Loslenguajesespecificados
paraundataset,sobreesribenalosdel
catlogo.Siestecampoestvacoel
datasetheredaloslenguajesdel
catlogo.(LinkalosestndaresISO:
https://www.loc.gov/standards/iso6392/
php/code_list.php)
No Unareginolugardeterminadoalque "ARG"eselcdigoparalaRepblica
eldatasethagareferencia. Argentina.

Unareginounlugardeterminado. "06007"eselcdigodeundepartamento
Puedetomarvalores:
[58.111111,35.111111,57.111111,
a)Depasesy,provinciasymunicipios 33.111111]esunboundingbox
argentinos,segnlasrecomendaciones
delaGuaparalaidentificacinyuso [58.111111,35.111111]esunpunto
deentidadesinteroperables. geogrfico
Cobertura
b)Unreadecoordenadas
geogrfica
representadaporlatitud/longitudenel "http://sws.geonames.org/6255146"
orden:minimalongitud,mnimalatitud,
mximalongitud,mximalatitud.
c)Unpuntogeogrficorepresentadopor
latitud/longitud.
d)Silareferenciageogrficanoest
identificadaenlaGuaparala
identificacinyusodeentidades
interoperablesindicarlaURIssegn
geonames.orgej:
http://sws.geonames.org/6255146"

10


Recomendado Perododetiempocubiertoporel 20150101/20151231

dataset.Elintervalodetiempoest
Cobertura formadoporunafechadeinicioyuna 20150101T00:45:00Z/20160115T00:06:00
temporal definseparadaspor/,enformatoISO Z
8601,conelniveldeespecificidad
requeridoporeldataset.
No URLdeunapginawebatravsdela http://datos.gob.ar/dataset/sistemadecontrat
Fuente cualsepuedeaccederaldataset,sus acioneselectronicasargentinacompra
recursosoinformacinadicionalsobre
elmismo.
Recomendado Indicalalicenciabajolacualeldatasety "http://opendatacommons.org/licenses/dbcl/1
todassusdistribucionesestn 0/"siseutilizaunenlace
disponiblesmedianteunenlaceala
licenciaodocumentodelalicencia "OpenDatabaseLicense(ODbL)v1.0"sise
seleccionada,omedianteelttulotextual consignaelnombredelalicenciaautilizar
delalicenciatalcomoapareceenla
listade
Licencia http://opendefinition.org/licenses/.
Recomendamosusarlalicencia"Open
DatabaseLicense(ODbL)v1.0".Un
datasetheredapordefaultlalicencia
generaldelcatlogosalvoquese
especifiqueunalicenciadiferenteen
estecampo.Lasdistribucionesdel
datasetheredanestalicenciasalvoque
especifiquenunadiferente.

Distribucin
Recomendamosverune
jemplotextualdemetadatosdeunad
istribucin.

Estos son los metadatos que se deben completar al cargar o actualizar una distribucin de un dataset
enelcatlogoparadescribirla:

Nombre Requerido Descripcin Ejemplo

Descripcin Recomendado Brevedescripcindeladistribucin.Serecomiendano Listadodelasconvocatoriasabiertas

delrecurso escribirmsdeunalnea.Todainformacinadicional duranteelao2015enelsistemade
puedeserincluidaenladescripcindeldataset. contratacioneselectrnicas
Recomendado Indicaelformatodelarchivodeladistribucin.Siel "text/csv"definicindeIANA
tipodeladistribucinestdefinidoporIANA
(http://www.iana.org/assignments/mediatypes/mediat "csv"caracteresfinalesdespusdel
Formato ypes.xml),debeusarseesadefinicin.Encaso punto
contrariodebernponerseloscaracteresdespusdel
puntofinaldelarchivo,quedeterminanelformato
(cuandonoestdefinidoporIANA).

Ttulodel Si Nombreasignadoaladistribucin. Convocatoriasabiertasduranteelao

recurso 2015

Licencia Recomendado Indicalalicenciabajolacualladistribucinest "http://opendatacommons.org/licenses

disponiblemedianteunenlacealalicenciao /dbcl/10/"siseutilizaunenlace

11


documentodelalicenciaseleccionada,omedianteel
ttulotextualdelalicenciatalcomoapareceenlalista "OpenDatabaseLicense(ODbL)v1.0"
dehttp://opendefinition.org/licenses/.recomendamos siseconsignaelnombredelalicencia
usarlalicencia"OpenDatabaseLicense(ODbL)v1.0". autilizar
Unadistribucinheredapordefaultlalicenciadel
datasetalquepertenece,salvoqueseespecifiqueuna
licenciadiferenteenestecampo.
No Informacinsobrederechosaplicablesaladistribucin
Derechos
quenosehayanespecificadoenlalicencia.Sise
sobrela especifican,estosderechossobreescribenalosdel
distribucin catlogo.Encasocontrario,lasdistribucionesheredan
losderechosespecificadosparaelcatlogo.
Recomendado Listadecamposquecontieneunadistribucintabular [{...},{...}]
(noaplicaparaaquellasdistribucionesquenosean
Camposdela tablas)ysusmetadatos.Cadacamposerepresenta
distribucin conunobjeto("{}")dondesedescribenlosmetadatos
especificadosparalaclase"field"deesteperfilde
metadatos(como"nombre","tipo"y"descripcin").


Campo
Como se ve en la tabla anterior, metadatos de una distribucin, recomendamos que las distribuciones
tabulares incluyan algunos metadatos que ayuden a entender lainformacinquecontienecadacampo.
Estos metadatos se completan en el mismo formulario que se utiliza para cargar o actualizar una
distribucin.

Estos son los metadatos que el responsable de cargar o actualizar una distribucindeundatasetenel
catlogodebecompletarparadescribirloscampos,encasodecorresponder:

Nombre Requerido Descripcin Ejemplo

Recomendado Elnombredelcampotalcomosedenominaenel Ejemploparaelcuartocampodela

encabezadodeladistribucin.Recomendamosverla distribucin"Convocatoriasabiertas
Nombre "Guaparalapublicacindedatosenformatos duranteelao2015",valorparael
abiertos"paraunaadecuadaeleccindelnombrede nombre:
uncampo. "unidad_operativa_contrataciones_desc"

12


Recomendado El tipo de dato contenido en el campo segn la lista Ejemploparaelcampo

por la librera recline.js "unidad_operativa_contrataciones_desc"
(http://okfnlabs.org/recline/docs/models.html#types). deladistribucin"Convocatoriasabiertas
duranteelao2015",valorparatipo:
"string"

Lostiposincluidosenestalistason:

string(text):valoresdetexto.

number(double,float,numeric):nmerosquepuedan
noserenteros(incluyendecimales).

integer(int):nmerosquesiempresonenteros.

date: fecha simple expresada segn el estndar ISO

8601 incluyendo nicamente ao, mes y da
(YYYYMMDD)comoen"20160201".

time: tiempo expresado segn el estndar ISO 8601

incluyendo nicamente horas, minutos y segundos
Tipo (hh:mm:ss)comoen"10:05:00".

datetime (datetime, timestamp): fecha completa

expresada segn el estndar ISO 8601 incluyendo
ao, mes, da, horas, minutos y segundos
(YYYYMMDDThh:mm:ssZ) como en
"20160201T10:05:00+03:00"

boolean(bool):valoresverdadero/falso.

binary:representacindedatosbinariosbase64.

geo_point: ver estructura en

https://www.elastic.co/guide/en/elasticsearch/referenc
e/current/geopoint.html.

geojson:verenhttp://geojson.org/

array:listadevalores.

object(json):objetodeJSON.

any: campo que puede contener valores decualquier

tipo.

Recomendado Ladescripcindelainformacinquecontieneel Ejemploparaelcampo

campo. "unidad_operativa_contrataciones_desc"
deladistribucin"Convocatoriasabiertas
Descripcin duranteelao2015",valorpara
descripcin:"Organismoquerealizala
convocatoria.Organismodemximonivel
jerrquicoalquepertenecelaunidad
operativadecontrataciones."

13


Tema
Cada catlogo de datos puede tener su propia taxonoma temticaquepermiteclasificaralosdatasets
como pertenecientes a una o mscategorastemticas.Recomendamosquelostemastenganalgunos
metadatosqueayudenaunusuarioaentenderlosmejor.

Estos son metadatos que el responsable de cargar o actualizar la taxonoma temtica de un catlogo
debecompletarparadescribirlostemasdelamisma:

Nombre Requerido Descripcin Ejemplo

Cdigo Recomendado Elidentificadordel AGRI

identificadordel tema.
tema

Etiquetaottulo Recomendado Laetiquetaottulode Agricultura,pesca,silviculturayalimentacin

deltema untema.

Descripcindel Recomendado Unabreveyconcisa Bajoesteconceptoseincluyendatasetsquecubrendominiostales

tema descripcindeltema. comoagricultura,pesca,forestacinoalimentos.

Otroscatlogos
Los usuarios que opten por una solucin alternativa al Portal Andino para publicar sus datos, debern
publicar los metadatos de su Catlogo en un archivo data.json en una URL como la siguiente:
http://datos.[entidad].gob.ar/data.json.

Este archivo deber estar construido tal como se puede ver en el ejemplo del Anexo IV Ejemplo de
data.json, respetando el perfil de metadatos de la Administracin Pblica Nacional tal como se lo
amposdelperfil.
describemsadelanteenlaseccinC

Estndarusado
El perfil de metadatos recomendado en esta gua es una adaptacin del estndar DCAT AP,
usado por los pases de la Unin Europea. DCAT es un vocabulario controlado definido por la W3C,
ampliamenteusadoanivelglobalparaladescripcindecatlogosdedatos.

Segn la W3C: Mediante la utilizacin deDCATparadescribirdatasetsencatlogosdedatos,quienes

publican aumentan la posibilidad de descubrimiento (discoverability) y permiten a aplicaciones

14


informticas consumir metadatos de manera simple desde mltiples catlogos. Adems permite la
publicacin descentralizada de catlogos y favorece la bsqueda federada de datasets a travs de
variossitios.

El perfil de metadatos propuesto para la Administracin Pblica Nacional se compone de 3 clases

principales (Catalog, Dataset y Distribution) y 2 auxiliares (Field y Theme) que se relacionan segn el
siguienteesquema:

A continuacin, describimos los metadatos que el data.json debe contener, para cada una de estas
clases.

15


Camposdelperfil

Catlogo

Recomendamosv erunejemplodemetadatosdeuncatlogoenJSON.

Estossonlosmetadatosqueeld
ata.jsondebecontener,aniveldecatlogo:

Variable Tipo
Nombre Requerido Descripcin Ejemplo
(data.json) (data.json)

Contiene una lista de los datasets

Datasets S [{...},{...}] dataset Array
queformanpartedelcatlogo.

Nombre dado al catlogo. Debe ser

claro, breve y lo suficientemente
Nombre S abstracto como para abarcar la DatosArgentina title String
multiplicidad de datasets que
contiene.

Portal de Datos Abiertos del

Descripcin del contenido del
Descripcin S Gobierno de la Repblica description String
catlogo.
Argentina

Responsable de la publicacin del publisher >

Autor S MinisteriodeModernizacin String
catlogo. name

Correo Correo electrnico de contacto del

datos@modernizacion.gob.a publisher >
electrnico S responsable de la publicacin del String
r mbox
delautor catlogo.

"20160414T19:48:05.4336
Fecha de creacin o publicacindel 40" para especificar fecha y
catlogo. Se escribe segn el hora
Fechade
formato ISO8601, tipeado como
creacino Recomendado issued String
fecha simple o fecha con hora, con
publicacin
el mayor detalle posible que sea "20160414" para
relevanteparaeldataset. especificar fecha
nicamente

"20160419T19:48:05.4336
Fecha de ltima 40" para especificar fecha y
Fechade actualizacin/modificacin del hora
ltima catlogo. Se escribe segn el
actualizacin Recomendado formato ISO8601, tipeado como modified String
/ fecha simple o fecha con hora, con
modificacin el mayor detalle posible que sea "20160419" para
relevanteparaeldataset. especificar fecha
nicamente

Lenguaje para la descripcin de los ["es"] para un lenguaje ISO

Idioma(s) Recomendado language Array
metadatos de los datasets 6391
contenidos en el catlogo. Hay 2

16


estndares ISO que pueden ser

utilizadosparaestecampo:
["spa", eng"] para dos
(a)ISO6391(2letras) lenguajesISO6392

(b) ISO 6392/T (3 letras) es el ms

recomendado.

Puede definirse 1 o ms lenguajes

en una lista. (Link a los estndares
ISO:
https://www.loc.gov/standards/iso63
92/php/code_list.php)

Es el sistema de clasificacin
temtica global de laAdministracin
Taxonoma Pblica Nacional. Compone una
http://datos.gob.ar/superThe superThemeTa
temtica S lista de temas globales y est String
meTaxonomy.json xonomy
global publicada en
"http://datos.gob.ar/superThemeTax
onomy.json".

Es el sistema de clasificacin
temtica especfica, creado por la
organizacin responsable del
catlogo. Compone una lista de
Taxonoma temas especficos a losdatasetsdel
themeTaxono
temtica Recomendado catlogo. Si se clasifica algn [{...},{...}] Array
my
especfica dataset del catlogo como
perteneciente a uno o ms temas,
este campo es obligatorioyaquese
debe explicitar una taxonoma
temticaparapoderusarsustemas.

Indica la licencia bajo la cual todos

los datasets y distribuciones del
catlogo estndisponiblesmediante "http://opendatacommons.or
un enlace a la licencia odocumento g/licenses/dbcl/10/" si se
de la licencia seleccionada, o utilizaunenlace
mediante el ttulo textual de la
licencia tal como aparece en la lista
Licencia Recomendado license String
de http://opendefinition.org/licenses/
. recomendamos usar la licencia "Open Database License
"Open Database License (ODbL) (ODbL) v1.0" si se consigna
v1.0". Un dataset o distribucin que el nombre de la licencia a
especifique una licencia diferente, utilizar
sobreescribe a la licencia general
delcatlogo.

Direccinwebdeaccesoalapgina
Pginaweb
Recomendado principal del catlogo. Enlace a la http://datos.gob.ar homepage String
delcatlogo
pginaprincipaldelcatlogo.

17


Informacin sobre derechos

aplicables al catlogo en el caso
que no se hayan especificado en la
Derechos licencia. Los datasets y sus
sobreel No distribuciones heredan la rights String
catlogo informacin sobre derechos
aplicables al catlogo, a menos que
especifiquen unos derechos
distintos.

El rea geogrfica cubierta por el

catlogo.

Una regin o un lugar determinado. "ARG" es el cdigo para la

Puedetomarvalores: RepblicaArgentina.

a) De pases y, provincias y
municipios argentinos, segn las
recomendaciones de laGuaparala "06007" es el cdigo de un
identificacin y uso de entidades departamento
interoperables.

b) Un rea de coordenadas
[58.111111, 35.111111,
Cobertura representada por latitud/ longituden String or
No 57.111111, 33.111111] es spatial
geogrfica el orden: minima longitud, mnima Array
unboundingbox
latitud, mxima longitud, mxima
latitud.

c)Unpuntogeogrficorepresentado [58.111111, 35.111111] es

porlatitud/longitud. unpuntogeogrfico

d) Si la referencia geogrfico no
est identificada en la Gua para la
identificacin y uso de entidades "http://sws.geonames.org/62
interoperables indicar laURIssegn 55146"
geonames.orgej:

http://sws.geonames.org/6255146

Es importante poner atencin a los dos campos que contienen una lista de objetos: dataset y
themeTaxonomy.

El primero contendr una lista de objetos que describen (cada uno) los metadatos de los distintos
datasets que componen el catlogo (en la prxima seccin se describen los metadatos que debe
contenercadaunodeestosobjetos).

El segundo tambin contiene una lista de objetos que, juntos, definen una taxonoma temtica parael
catlogo. Cada uno de estos objetos contiene losmetadatosquedescribenacadaunodelostemasde
estataxonoma.MsadelantesedescribenestosmetadatosenlaseccinT
ema.

18


Dataset

Recomendamosv erunejemplodemetadatosdeundatasetenJSON.

Detallamos los metadatos que el data.json debe contener, para describir a un dataset dentrodelalista
contenidaenelcampod
atasetdelcatlogo:
Tipo
Variable
Nombre Requerido Descripcin Ejemplo (data.jso
(data.json)
n)

Nombre asignado al dataset

tal como ser publicado.Debe
ser claro y lo suficientemente
abstracto como para abarcar
la multiplicidad de
distribuciones que contiene.
Sistema de contrataciones
Ttulo S Se recomienda no excederlos title String
electrnicas
100 caracteres en la mayora
de los casos. En caso de que
un ttulo ms largo se juzgue
necesario o relevante, este no
deber exceder los 200
caracteres.

Descripcin del contenido del

dataset de un modo claro y
conciso. Se recomienda no
exceder los 500 caracteres en Datos correspondiente al Sistema
Descripcin S la mayora de los casos. En de Contrataciones Electrnicas description String
caso de que una descripcin (ArgentinaCompra)
ms larga se juzguenecesaria
o relevante, sta no deber
excederlos1500caracteres.

Responsable de la publicacin
del dataset. En el caso de
organizaciones, detallar la
estructura jerrquica separada
por puntos, de manera
jerrquicamente descendiente.
Si la organizacin es parte de Ministerio de Modernizacin.
la Administracin Pblica Secretara de Modernizacin publisher >
Autor S String
Nacional y est listada en el Administrativa. Oficina Nacionalde name
dataset llamado "Estructura Contrataciones.
Organica del Poder Ejecutivo
Nacional"
(http://datos.gob.ar/dataset/est
ructuraorganicapen), deber
utilizarse la denominacin all
documentada.

19


Correo Correo electrnico decontacto

publisher >
electrnico Recomendado del responsable de la onc@modernizacion.gob.ar String
mbox
delautor publicacindeldataset.

Ministerio de Modernizacin.
rea/persona de contacto que Secretara de Modernizacin
rea/Persona contactPoint>
Recomendado puede brindar informacin Administrativa. Oficina Nacionalde String
decontacto fn
relevantesobreeldataset. Contrataciones. Direccin de
ComprasElectrnicas.

Correo
Correo electrnico del
electrnico
rea/persona de contacto que onccompraselectronicas@moderni contactPoint>
del Recomendado String
puede brindar informacin zacion.gob.ar hasEmail
rea/persona relevantesobreeldataset.
decontacto

Temtica/s o categora/s
globales a la/s que se refiere
el dataset al ser publicado.Un
dataset puede pertenecer a
ms de una categora global,
de manera que eltipodevalor
de este campo es una lista de
Temtica(s)
S categoras. La/s categora/s o ["ECON"] superTheme Array
globales
temtica/s globales deben
adoptarse segn el campo
"Cdigo (authority code)" del
Anexo Taxonoma temtica
para los datasets, que
contiene una lista predefinida
detemtica/sglobales.

Temtica/s o categora/s
especfica/s a la/s que se
refiere el dataset al ser
publicado. Un dataset puede
pertenecer a ms de una
categora especfica, de
manera que el tipodevalorde
este campo es una lista de
Temtica(s) categoras. La taxonoma a ["Contrataciones", "Compras",
Recomendado theme Array
especficas utilizar debe ser creada por la "Macroeconoma"]
autoridad responsable del
Catlogo. Se deben usar los
ids (ver campo "id" de laclase
Theme) delostemasdefinidos
en la taxonoma para
componer lalista(nosedeben
usar las etiquetas ni las
descripciones).

Palabras que describen el

ttulo o el contenido del ["bienes",
Etiqueta(s) Recomendado keyword Array
recurso. Es necesario que las "compras","contrataciones"]
etiquetas se encuentren
correctamente escritas, en

20


plural y respetando la
existencia de tags anteriores.
Etiquetas que colaboran en la
bsqueda de los usuarios.
Cuanto ms amplia yuniforme
sea la lista detagsmayorser
su eficiencia. A tales fines se
recomienda ver el Anexo
Pautas para la seleccin de
etiquetas.

Lista de distribuciones que

pertenecen al dataset y sus
metadatos. Cada distribucin
se representa con un objeto
Distribuciones S [{...},{...}] distribution Array
("{}") donde se describen los
metadatos especificados para
la clase "distribution" de este
perfildemetadatos.

Frecuencia con la que se

actualiza el dataset.
Recomendamos especificar
perodos normalizados con
formato ISO8601, agregando
Frecuenciade R/P1Y para datasets que se accrualPeriodi
S el campo eventual para String
actualizacin actualizananualmente city
datasets que se publican con
una frecuencia eventual o no
especificada. Anexo
"Especificacin de frecuencias
segnISO8601".

Fecha de publicacin del "20160414T19:48:05.433640"

dataset. Segn el formato paraespecificarfechayhora
Fechade ISO8601, tipeado como fecha
S issued String
publicacin simple o fecha con hora, con
el mayor detalle posible que "20160414" para especificar
searelevanteparaeldataset. fechanicamente

Fecha de ltima
actualizacin/modificacin del "20160419T19:48:05.433640"
dataset (ya seadesusdatoso paraespecificarfechayhora
Fechadeltima de sus metadatos). Segn el
actualizacin/ Recomendado formato ISO8601, tipeado modified String
modificacin comofechasimpleofechacon
hora, con el mayor detalle "20160419" para especificar
posible quesearelevantepara fechanicamente
eldataset.

Un identificador nico para el

Identificador nico del dataset, dataset. La URI uotroidentificador
nico en el contexto del catlogo,
Identificador No este identificador debe ser identifier String
nicoparatodoelcatlogo. ejemplo:

21


"datasetejemplo35782

Lenguaje para la descripcin

de los metadatos del dataset.
Hay 2 estndares ISO que
pueden ser utilizados para
estecampo:

(a)ISO6391(2letras)

(b) ISO 6392/T (3letras)esel ["es"]paraunlenguajeISO6391

msrecomendado.

Idioma(s) No language Array

["spa", eng"] para dos lenguajes
Puede definirse 1 o ms ISO6392
lenguajes en una lista. Los
lenguajes especificados para
un dataset, sobreesriben a los
del catlogo. Si este campo
est vaco el dataset hereda
los lenguajes del catlogo.
(Link a los estndares ISO:
https://www.loc.gov/standards/i
so6392/php/code_list.php)

Una regin o lugar

determinado al que el dataset
hagareferencia.

"ARG" es el cdigo para la
Una regin o un lugar RepblicaArgentina.
determinado. Puede tomar
valores:

"06007" es el cdigo de un
departamento
a) De pases y, provincias y
municipios argentinos, segn
las recomendaciones de la
Cobertura Gua para la identificacin y [58.111111,35.111111,57.111111, spatial Array or
No
geogrfica uso de entidades 33.111111]esunboundingbox String
interoperables.

b) Un rea de coordenadas
[58.111111, 35.111111] es un
representada por latitud/
puntogeogrfico
longitud en el orden: minima
longitud, minima latitud,
maxima longitud, maxima
latitud. "http://sws.geonames.org/6255146
"
c) Un punto geogrfico
representado por
latitud/longitud.

d) Si la referencia geogrfico
no est identificada enlaGua

22


para la identificacin y uso de

entidades interoperables
indicar la URIs segn
geonames.orgej:

http://sws.geonames.org/6255
146"

Perodo detiempocubiertopor
el dataset. El intervalo de 20150101/20151231
tiempo est formado por una
Cobertura fecha de inicio y una de fin
Recomendado temporal String
temporal separadas por /, en formato
ISO 8601, con el nivel de 20150101T00:45:00Z/20160115
especificidad requerido por el T00:06:00Z
dataset.

URL de una pgina web a

travs de la cual se puede http://datos.gob.ar/dataset/sistema
Pginade
No acceder al dataset, sus decontratacioneselectronicasarg landingPage String
referencias
recursos o informacin entinacompra
adicionalsobreelmismo.

Indica lalicenciabajolacualel
dataset y todas sus
distribuciones estn
disponibles mediante un
enlace a la licencia o
documento de la licencia
seleccionada, o mediante el "http://opendatacommons.org/licen
ttulo textual de la licencia tal ses/dbcl/10/" si se utiliza un
como aparece en la lista de enlace
http://opendefinition.org/license
Licencia Recomendado s/ . recomendamos usar la license String
licencia "Open Database
License (ODbL) v1.0". Un "Open Database License (ODbL)
dataset hereda por default la v1.0" si se consigna el nombre de
licencia general del catlogo lalicenciaautilizar
salvo que se especifique una
licencia diferente en este
campo. Las distribuciones del
dataset heredan esta licencia
salvo que especifiquen una
diferente.

Es importante prestar atencin al campo distribution que contiene una lista de objetos que describen
los metadatos de cada una de las distribuciones del daset. En la prxima seccin abordaremos estos
metadatos.

Distribucin

Recomendamosv erunejemplodemetadatosdeunadistribucinenJSON.

23


Estos son los metadatos que el data.json debe contener, para describir a una distribucin dentro de la
listacontenidaenelcampod
istributiond
eundataset:

Variable Tipo
Nombre Requerido Descripcin Ejemplo
(data.json) (data.json)

URL que permite el acceso a la

distribucin del dataset. Puedeser
una pgina, feed u otro tipo de
recurso que d acceso indirecto a http://datos.gob.ar/dataset/si
las distribuciones. Si las stemadecontratacionesele
URLdeacceso S distribuciones son solo accesibles ctronicasargentinacompra/ accessURL String
a travs de lapginadereferencia archivo/fa3603b30af743cc
del dataset, debe completarse el 9da990a512217d8a
valor de la URL de acceso a la
distribucin con el mismo valor de
lapginadereferenciadeldataset.

Breve descripcin de la
distribucin. Recomendamos no Listado delasconvocatorias
escribir ms de una lnea. Toda abiertasduranteelao2015
Descripcin Recomendado description String
informacin adicional puede ser en el sistema de
incluida en la descripcin del contratacioneselectrnicas
dataset.

Indica el formato del archivo de la

distribucin. Si el tipo de la
distribucin est definido porIANA
(http://www.iana.org/assignments/ "text/csv"definicindeIANA
mediatypes/mediatypes.xml),
Formatodel
Recomendado debe usarse esa definicin. En format String
archivo
caso contrario debern ponerse "csv" caracteres finales
los caracteres despus del punto despusdelpunto
final delarchivo,quedeterminanel
formato (cuando no est definido
porIANA).

Indica el tipo de archivo de la

distribucin, slo si este est "text/csv"definicindeIANA
definido por IANA

Tipodearchivo No (http://www.iana.org/assignments/ mediaType String
mediatypes/mediatypes.xml). En "" cuando el formato no
caso contrario este campo tienedefinicinenIANA
permanecevaco.

http://datos.gob.ar/dataset/b
URL que permite la descarga
ecaceb2dbd0487993bd5f
directa de la distribucin del
URLde 02bd3b8ca2/resource/bf2f67
S dataset, vincula directamente a un downloadURL String
descarga f49ab3479ba88156b4356
archivo descargable en unformato
5125e/download/contratos2
dado.
015.csv

Convocatorias abiertas
Ttulo S Nombreasignadoaladistribucin. title String
duranteelao2015

24


Indica la licencia bajo la cual la

distribucin est disponible
mediante un enlace a la licencia o
documento de la licencia "http://opendatacommons.or
seleccionada, o mediante el ttulo g/licenses/dbcl/10/" si se
textual de la licencia tal como utilizaunenlace
aparece en la lista de

Licencia Recomendado http://opendefinition.org/licenses/ . license String
recomendamos usar la licencia "Open Database License
"Open Database License (ODbL) (ODbL) v1.0" si se consigna
v1.0". Una distribucin hereda por el nombre de la licencia a
default la licencia del dataset al utilizar
que pertenece, salvo que se
especifique una licencia diferente
enestecampo.

Tamao de la distribucin en
Ejemplo para un archivo de
bytes. El tamao puede ser
Tamao No 5Kb aproximadamente: byteSize Integer
aproximado cuandonoseconozca
5120
eltamaoexacto.

"20160414T19:48:05.4336
Fecha de publicacin de la 40" para especificar fecha y
distribucin. Segn el formato hora
Fechade ISO8601, tipeado como fecha
S issued String
publicacin simple o fecha con hora, con el
mayor detalle posible que sea "20160414" para
relevanteparaeldataset. especificar fecha
nicamente

"20160419T19:48:05.4336
Fecha de ltima 40" para especificar fecha y
actualizacin/modificacin de la hora
Fechade
distribucin. Segn el formato
ltima
Recomendado ISO8601, tipeado como fecha modified String
actualizacin/
simple o fecha con hora, con el
modificacin "20160419" para
mayor detalle posible que sea
relevanteparaeldataset. especificar fecha
nicamente

Informacin sobre derechos

aplicables a la distribucin que no
se hayan especificado en la
Derechos licencia. Si se especifican, estos
sobrela No derechos sobreescriben a los del rights String
distribucin catlogo. En caso contrario, las
distribuciones heredan los
derechos especificados para el
catlogo.

Lista de campos que contiene una

distribucin tabular (no aplica para
Camposdela
Recomendado aquellas distribuciones que no [{...},{...}] field Array
distribucin
sean tablas) y sus metadatos.
Cada campo se representaconun
objeto("{}")dondesedescribenlos

25


metadatos especificados para la

clase "field" de este perfil de
metadatos (como "nombre", "tipo"
y"descripcin").

Recomendamos poner atencin al campo field que contiene una lista de objetos que describen los
metadatos de cada uno de los campos de la distribucin (en el caso de distribuciones tabulares,
nicamente).Enlaprximaseccinabordaremosestosmetadatos.

Campo

Recomendamosv erunejemplodemetadatosdeuncampoenJSON.

Estos son los metadatos que el data.json debe contener para describir a un campo deunadistribucin
tabulardentrodelalistacontenidaenelcampodemetadatosf ielddeunadistribucin:

Tipo
Variable
Nombre Requerido Descripcin Ejemplo (data.jso
(data.json)
n)

Ejemplo para el cuarto

El nombre del campotalcomosedenomina
en el encabezado de la distribucin. Vase
Nombre Recomendado la Gua para la publicacin de datos en
formatos abiertos para una adecuada
eleccindelnombredeuncampo.
campo de la distribucin
"Convocatorias abiertas
durante el ao 2015", title String
valor para el nombre:
"unidad_operativa_contr
ataciones_desc"

El tipodedatocontenidoenelcamposegn
la lista utilizada por la librera recline.js
(http://okfnlabs.org/recline/docs/models.html
#types).

Lostiposincluidosenestalistason:

Ejemplo para el campo
"unidad_operativa_contr
string(text):Valoresdetexto.
ataciones_desc" de la
Tipo Recomendado number (double, float, numeric): Nmeros distribucin type String
que puedan no ser enteros (incluyen "Convocatorias abiertas
decimales). durante el ao 2015",
valorparatipo:"string"
integer (int): Nmeros que siempre son
enteros.

date: Fecha simple expresada segn el

estndar ISO 8601 incluyendo nicamente
ao, mes y da (YYYYMMDD) como en
"20160201".

time: Tiempo expresado segn el estndar

ISO 8601 incluyendo nicamente horas,

26


minutos y segundos (hh:mm:ss) como en

"10:05:00".

datetime (datetime, timestamp): Fecha

completa expresada segn el estndar ISO
8601 incluyendo ao, mes, da, horas,
minutos y segundos
(YYYYMMDDThh:mm:ssZ) como en
"20160201T10:05:00+03:00"

boolean(bool):Valoresverdadero/falso.

binary: Representacin de datos binarios

base64.

geo_point: Ver estructura en

https://www.elastic.co/guide/en/elasticsearch
/reference/current/geopoint.html.

geojson:Verenhttp://geojson.org/

array:Listadevalores.

object(json):ObjetodeJSON.

any: Campo que puedecontenervaloresde

cualquiertipo.

Ejemplo para el campo

"unidad_operativa_contr
ataciones_desc" de la
distribucin
"Convocatorias abiertas
durante el ao 2015",
La descripcin de la informacin que valor para descripcin:
Descripcin Recomendado description String
contieneelcampo. "Organismo que realiza
la convocatora.
Organismo de mximo
nivel jerrquico al que
pertenece la unidad
operativa de
contrataciones."

Tema

Recomendamosv erunejemplodemetadatosdeuncampoenJSON.

Estos son los metadatos que el data.json debe contener, para describir a un tema de la taxonoma
temticadeuncatlogo:

Variable Tipo
Nombre Requerido Descripcin Ejemplo
(data.json) (data.json)

Identificador Recomendado Elidentificadordeltema. AGRI id String

27


La etiqueta o ttulo de un Agricultura, pesca, silvicultura y

Etiqueta Recomendado label String
tema. alimentacin

Bajo este concepto se incluyen

Una breve y concisa datasets que cubren dominiostales
Descripcin Recomendado description String
descripcindeltema. como agricultura, pesca,
forestacinoalimentos.

Anexo I Taxonoma temtica global de la

APNparalosdatasets(tabla)

ElPortalNacionaldeDatosusalataxonomatemticadefinidaporlaUninEuropea.

Cada catlogo de datos puede desarrollar su propia taxonoma, cuyo uso se expresa en los
siguientescamposdemetadatos(ysusequivalentesparaelPortalAndino):

themeTaxonomy: es un campo de metadatosdelcatlogoquedefineunalistadetemasquese

pueden usar para clasificar los datasets. Refierealesquemacompletodelataxonomaens,no
aalgunadesusetiquetasenparticular.

theme: es un campo de metadatos de un Dataset. Refiere a la/s etiqueta/s en particular bajos

la/s cuales un dataset es clasificado temticamente. Slo pueden usarse etiquetas que estn
definidasenlataxonomatemticadethemeTaxonomy.

Adems del uso de una taxonoma propia de cadacatlogodedatos,recomendamoslaclasificacin

de los datasets segn la taxonomadelPortalNacionaldeDatos.Estaesunaspertaxonomaala
que cada catlogo hace referencia mediante los siguientes campos de metadatos (y sus equivalentes
paraelPortalAndino):

superThemeTaxonomy: es un campo de metadatos delcatlogoqueapuntaalaURLdondeel

Portal Nacional de Datos documenta la taxonoma temtica de la Administracin Pblica
Nacional.

superTheme: es un campo de metadatos de un dataset. Refiere a la/s etiqueta/s en particular

bajos la/s cuales un dataset es clasificado temticamente, segn la sper taxonoma que es la
de la Administracin Pblica Nacional. Slo pueden usarse etiquetas que estn definidas en la
taxonomatemticades uperThemeTaxonomy.

La ventaja de usar una sper taxonoma temtica es que facilita la clasificacin de datasets por
parte de un usuario segn un conjunto de categoras temticas ms generales, que soninteroperables
con las usadas por otros pases del mundo. Esto, a su vez, facilita la clasificacin de datasets
cosechadosporelPortalNacionaldeDatos.

Cdigo Etiqueta(label) Descripcin(description)

28


(authority
code)

AGRI Agricultura,pesca, Bajoesteconceptoseincluyend

atasetsquecubren
silviculturay dominiostalescomoagricultura,pesca,forestacino
alimentacin alimentos.

ECON Economayfinanzas Bajoesteconceptoseincluyend

atasetsquecubren
dominiostalescomoeconomaofinanzas.

EDUC Educacin,culturay Bajoesteconceptoseincluyend

atasetsquecubren
deportes dominiostalescomoeducacin,culturaodeporte.

ENER Energa Bajoesteconceptoseincluyend

atasetsquecubreaspectos
deenerga.

ENVI Medioambiente Bajoesteconceptoseincluyend

atasetsquecubren
aspectosdemedioambiente.

GOVE Gobiernoysector Bajoesteconceptoseincluyend

atasetsquecubren
pblico dominiostalescomogobiernoysectorpblico.

HEAL Salud Bajoesteconceptoseincluyend

atasetsquecubren
aspectosrelacionadosalasalud.

INTR Asuntosinternacionales Bajoesteconceptoseincluyend

atasetsquecubren
aspectosrelacionadosaasuntosinternacionales.

JUST Justicia,sistemalegaly Bajoesteconceptoseincluyend atasetsquecubren

seguridadpblica dominiostalesjusticia,sistemalegaloseguridadpblica.

REGI Regionesyciudades Bajoesteconceptoseincluyend

atasetsquecubren
dominiostalescomoregionesociudades.

SOCI Poblacinysociedad Bajoesteconceptoseincluyend

atasetsquecubren
dominiostalescomosociedadopoblacin.

TECH Cienciaytecnologa Bajoesteconceptoseincluyend

atasetsquecubren
dominiostalescomocienciaytecnologa.

TRAN Transporte Bajoesteconceptoseincluyend

atasetsquecubren
aspectosrelacionadosaltransporte.

29


Anexo II Pautas para la seleccin de

etiquetas

Elegir buenas etiquetas hace msfcillabsquedadedatasetsparalosusuarios.Cuantomsampliay

uniformesealalistadeetiquetas,mayorsersuefectividad.

Estassonpautasparadefiniretiquetasaplicablesalapropiedadk eyworddelaclasedataset:

Escribircorrectamenteyenplural.
Usarmaysculasslodondecorresponda.
Identificarpalabrasclaves.
Respetarlaexistenciadeetiquetasanteriores.
Agregarsinnimosyemplearlenguajenatural.
Usarunaslapalabra.Siesmuynecesario,usarmsdeuna.
Si la etiqueta tiene ms de una palabra, debe estar separada por un espacio, ej:
declaracionesjuradas.

Preguntastilesalahoradepensarlosetiquetas:

Culeseltema?
Quaspectosserndeintersparalosusuarios?
Dequotromodobuscarasobreestainformacin?
Dequtipodeinformacinsetrata?
Qurealaprovee?

30


AnexoIIIEspecificacindefrecuencias
(segnISO8601)
Frecuencia ValorsegnISO8601
Cadadiezaos R/P10Y

Cadacuatroaos R/P4Y

Cadatresaos R/P3Y

Cadadosaos R/P2Y

Anualmente R/P1Y

Cadamedioao R/P6M

Cuatrimestralmente R/P4M

Trimestralmente R/P3M

Bimestralmente R/P2M

Mensualmente R/P1M

Cada15das R/P0.5M

Tresvecespormes R/P0.33M

Semanalmente R/P1W

Dosvecesalasemana R/P0.5W

Tresvecesalasemana R/P0.33W

Diariamente R/P1D

Cadahora R/PT1H

Continuamenteactualizado R/PT1S

Eventual1 eventual

1
Elcasoeventualesunagregadonuestro(noespartedelISO8601).
31


AnexoIVEjemplodedata.json
Esteesune
jemplodedata.json:

{
" title":" DatosArgentina",
" description":" PortaldeDatosAbiertosdelGobiernodelaRepblicaArgentina",
" publisher":{
" name":" MinisteriodeModernizacin",
" mbox":" datos@modernizacion.gob.ar"
},
" issued":" 20160414T19:48:05.43364003:00",
" modified":" 20160419T19:48:05.43364003:00",
" language":[
" spa"
],
" superThemeTaxonomy":" http://datos.gob.ar/superThemeTaxonomy.json",
" themeTaxonomy":[
{
" id":" convocatorias",
" label":" Convocatorias",
" description":" Datasetssobrelicitacionesenestadodeconvocatoria."
},
{
" id":" compras",
" label":" Compras",
" description":" Datasetssobrecomprasrealizadas."
},
{
" id":" contrataciones",
" label":" Contrataciones",
" description":" Datasetssobrecontrataciones."
},
{
" id":" adjudicaciones",
" label":" Adjudicaciones",
" description":" Datasetssobrelicitacionesadjudicadas."
},
{
" id":" normativa",
" label":" Normativa",
" description":" Datasetssobrenormativaparacomprasycontrataciones."
},
{
" id":" proveedores",
" label":" Proveedores",
" description":" DatasetssobreproveedoresdelEstado."
}
],
" license":" OpenDataCommonsOpenDatabaseLicense1.0",
" homepage":" http://datos.gob.ar",
" rights":" Derechosespecificadosenlalicencia.",
" spatial":" ARG",
" dataset":[
{

32


" title":" Sistemadecontratacioneselectrnicas",

" description":" DatoscorrespondientesalSistemadeContratacionesElectrnicas(ArgentinaCompra)",
" publisher":{
" name":" MinisteriodeModernizacin.SecretaradeModernizacinAdministrativa.OficinaNacionaldeContrataciones",
" mbox":" onc@modernizacion.gob.ar"
},
" contactPoint":{
"fn": "Ministerio de Modernizacin. Secretara de Modernizacin Administrativa. Oficina Nacional de Contrataciones.
DireccindeComprasElectrnicas.",
" hasEmail":" onccompraselectronicas@modernizacion.gob.ar"
},
" superTheme":[
" ECON"
],
" theme":[
" contrataciones",
" compras",
" convocatorias"
],
" keyword":[
" bienes",
" compras",
" contrataciones"
],
" accrualPeriodicity":" R/P1Y",
" issued":" 20160414T19:48:05.43364003:00",
" modified":" 20160419T19:48:05.43364003:00",
" identifier":" 99db6631d1c9470ba73ec62daa32c420",
" language":[
" spa"
],
" spatial":" ARG",
" temporal":" 20150101/20151231",
" landingPage":" http://datos.gob.ar/dataset/sistemadecontratacioneselectronicasargentinacompra",
" license":" OpenDataCommonsOpenDatabaseLicense1.0",
" distribution":[
{
"accessURL":
"http://datos.gob.ar/dataset/sistemadecontratacioneselectronicasargentinacompra/archivo/fa3603b30af743cc9da990a5
12217d8a",
" description":" Listadodelasconvocatoriasabiertasduranteelao2015enelsistemadecontratacioneselectrnicas",
" format":" CSV",
" mediaType":" text/csv",
"downloadURL":
"http://186.33.211.253/dataset/99db6631d1c9470ba73ec62daa32c420/resource/4b7447cb31ff435296c3589d212e1cc9/
download/convocatoriasabiertasanio2015.csv",
" title":" Convocatoriasabiertasduranteelao2015",
" license":" OpenDataCommonsOpenDatabaseLicense1.0",
" byteSize":" 5120",
" issued":" 20160414T19:48:05.43364003:00",
" modified":" 20160419T19:48:05.43364003:00",
" rights":" Derechosespecificadosenlalicencia.",
" field":[
{
" title":" procedimiento_id",
" type":" integer",
" description":" Identificadornicodelprocedimientodecontratacin"
},
{

33


" title":" organismo_unidad_operativa_contrataciones_id",

" type":" integer",
"description":"Identificadornicodelorganismoquerealizalaconvocatoria.Organismodemximoniveljerrquicoal
quepertenecelaunidadoperativadecontrataciones."
},
{
" title":" unidad_operativa_contrataciones_id",
" type":" integer",
" description":" Identificadornicodelaunidadoperativadecontrataciones"
},
{
" title":" organismo_unidad_operativa_contrataciones_desc",
" type":" string",
"description": "Organismo que realiza la convocatoria. Organismo de mximo nivel jerrquico al que pertenece la
unidadoperativadecontrataciones."
},
{
" title":" unidad_operativa_contrataciones_desc",
" type":" string",
" description":" Unidadoperativadecontrataciones."
},
{
" title":" tipo_procedimiento_contratacion",
" type":" string",
" description":" Tipodeprocedimientoalqueseadecualacontratacin."
},
{
" title":" ejercicio_procedimiento_anio",
" type":" date",
" description":" Aoenelqueseinicielprocesodelaconvocatoria."
},
{
" title":" fecha_publicacion_convocatoria",
" type":" date",
" description":" FechadepublicacindelaconvocatoriaenformatoAAAAMMDD,ISO8601."
},
{
" title":" modalidad_convocatoria",
" type":" string",
" description":" Modalidadbajolacualserealizalaconvocatoria."
},
{
" title":" clase_convocatoria",
" type":" string",
" description":" Clasedelaconvocatoria."
},
{
" title":" objeto_convocatoria",
" type":" string",
" description":" Objeto/objetivodelaconvocatoria"
}
]
}
]
}
]
}

34


Anexo V Taxonoma temtica global de la

APNparalosdatasets(JSON)

Estaeslataxonomatemticaglobal:

[
{
" id":" AGRI",
" label":" Agricultura,pesca,silviculturayalimentacin",
"description": "Bajo este concepto seincluyendatasetsquecubrendominiostalescomoagricultura,pesca,forestacino
alimentos."
},
{
" id":" ECON",
" label":" Economayfinanzas",
" description":" Bajoesteconceptoseincluyendatasetsquecubrendominiostalescomoeconomaofinanzas."
},
{
" id":" EDUC",
" label":" Educacin,culturaydeportes",
" description":" Bajoesteconceptoseincluyendatasetsquecubrendominiostalescomoeducacin,culturaodeporte."
},
{
" id":" ENER",
" label":" Energa",
" description":" Bajoesteconceptoseincluyendatasetsquecubreaspectosdeenerga."
},
{
" id":" ENVI",
" label":" Medioambiente",
" description":" Bajoesteconceptoseincluyendatasetsquecubrenaspectosdemedioambiente."
},
{
" id":" GOVE",
" label":" Gobiernoysectorpblico",
" description":" Bajoesteconceptoseincluyendatasetsquecubrendominiostalescomogobiernoysectorpblico."
},
{
" id":" HEAL",
" label":" Salud",
" description":" Bajoesteconceptoseincluyendatasetsquecubrenaspectosrelacionadosalasalud."
},
{
" id":" INTR",
" label":" Asuntosinternacionales",
" description":" Bajoesteconceptoseincluyendatasetsquecubrenaspectosrelacionadosaasuntosinternacionales."
},
{
" id":" JUST",

35


" label":" Justicia,sistemajudicialyseguridadpblica",

"description": "Bajo este concepto se incluyen datasets que cubren dominios tales justicia, sistema legal o seguridad
pblica."
},
{
" id":" REGI",
" label":" Regionesyciudades",
" description":" Bajoesteconceptoseincluyendatasetsquecubrendominiostalescomoregionesociudades."
},
{
" id":" SOCI",
" label":" Poblacinysociedad",
" description":" Bajoesteconceptoseincluyendatasetsquecubrendominiostalescomopoblacinosociedad"
},
{
" id":" TECH",
" label":" Cienciaytecnologa",
" description":" Bajoesteconceptoseincluyendatasetsquecubrendominiostalescomocienciaytecnologa."
},
{
" id":" TRAN",
" label":" Transporte",
" description":" Bajoesteconceptoseincluyendatasetsquecubrenaspectosrelacionadosaltransporte."
}
]

36


AnexoVIEjemplodemetadatoscomotexto

Esteesune
jemploenmarkdown:

Catlogo:DatosArgentina

PortaldeDatosAbiertosdelGobiernodelaRepblicaArgentina

Derechossobreelcatlogo:Derechosespecificadosenlalicencia.
Correoelectrnicodelautor:d atos@modernizacion.gob.ar
Autor:MinisteriodeModernizacin
Licencia:OpenDataCommonsOpenDatabaseLicense1.0
Idioma(s):spa
Fechadecreacinopublicacin:20160414T19:48:05.43364003:00
Taxonomatemticaglobal:h ttp://datos.gob.ar/superThemeTaxonomy.json
Fechadeltimaactualizacin/modificacin:20160419T19:48:05.43364003:00
Coberturageogrfica:ARG
Pginawebdelcatlogo:h
ttp://datos.gob.ar

Taxonomatemticaespecfica
Convocatorias(convocatorias):Datasetssobrelicitacionesenestadodeconvocatoria.
Compras(compras):Datasetssobrecomprasrealizadas.
Contrataciones(contrataciones):Datasetssobrecontrataciones.
Adjudicaciones(adjudicaciones):Datasetssobrelicitacionesadjudicadas.
Normativa(normativa):Datasetssobrenormativaparacomprasycontrataciones.
Proveedores(proveedores):DatasetssobreproveedoresdelEstado.

Datasets

Dataset:Sistemadecontratacioneselectrnicas

DatoscorrespondientesalSistemadeContratacionesElectrnicas(ArgentinaCompra)

Correoelectrnicodelautor:o
nc@modernizacion.gob.ar
Autor: Ministerio de Modernizacin. Secretara de Modernizacin Administrativa. Oficina
NacionaldeContrataciones
Pginadereferencias:
http://datos.gob.ar/dataset/sistemadecontratacioneselectronicasargentinacompra
Temtica(s)globales:ECON
Fechadepublicacin:20160414T19:48:05.43364003:00
Coberturatemporal:20150101/20151231

37


Fechadeltimaactualizacin/modificacin:20160419T19:48:05.43364003:00
Idioma(s):spa
Temtica(s)especficas:contrataciones,compras,convocatorias
Etiqueta(s):bienes,compras,contrataciones
Frecuenciadeactualizacin:R/P1Y
Coberturageogrfica:ARG
Licencia:OpenDataCommonsOpenDatabaseLicense1.0
Correoelectrnicodelrea/personadecontacto:
onccompraselectronicas@modernizacion.gob.ar
rea/Persona de contacto: Ministerio de Modernizacin. Secretara de Modernizacin
Administrativa.OficinaNacionaldeContrataciones.DireccindeComprasElectrnicas.
Identificador:99db6631d1c9470ba73ec62daa32c420

Distribuciones

Distribucin:Convocatoriasabiertasduranteelao2015

Listadodelasconvocatoriasabiertasduranteelao2015enelsistemadecontratacioneselectrnicas

URLdeacceso:
http://datos.gob.ar/dataset/sistemadecontratacioneselectronicasargentinacompra/archivo/fa36
03b30af743cc9da990a512217d8a
Derechossobreladistribucin:Derechosespecificadosenlalicencia.
Licencia:OpenDataCommonsOpenDatabaseLicense1.0
Tamao:5120
Formatodelarchivo:CSV
Tipodearchivo:text/csv
Fechadeltimaactualizacin/modificacin:20160419T19:48:05.43364003:00
URLdedescarga:
http://186.33.211.253/dataset/99db6631d1c9470ba73ec62daa32c420/resource/4b7447cb31ff
435296c3589d212e1cc9/download/convocatoriasabiertasanio2015.csv
Fechadepublicacin:20160414T19:48:05.43364003:00

Camposdeladistribucin

procedimiento_id(integer):Identificadornicodelprocedimientodecontratacin
organismo_unidad_operativa_contrataciones_id (integer): Identificador nico del organismo
que realiza la convocatoria. Organismo de mximo nivel jerrquico al que pertenece la unidad
operativadecontrataciones.
unidad_operativa_contrataciones_id (integer): Identificador nico de la unidad operativa de
contrataciones
organismo_unidad_operativa_contrataciones_desc (string): Organismo que realiza la
convocatoria. Organismo de mximo nivel jerrquico al que pertenece la unidad operativa de
contrataciones.
unidad_operativa_contrataciones_desc(string):Unidadoperativadecontrataciones.
tipo_procedimiento_contratacion (string): Tipo de procedimiento al que se adecua la
contratacin.
ejercicio_procedimiento_anio(date):Aoenelqueseinicielprocesodelaconvocatoria.

38


fecha_publicacion_convocatoria (date): Fecha de publicacin de la convocatoria en formato

AAAAMMDD,ISO8601.
modalidad_convocatoria(string):Modalidadbajolacualserealizalaconvocatoria.
clase_convocatoria(string):Clasedelaconvocatoria.
objeto_convocatoria(string):Objeto/objetivodelaconvocatoria

39