Professional Documents
Culture Documents
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
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
Perfildemetadatos
PortalAndino
PaqueteparalaaperturadedatosdelaRepblicaArgentina
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.
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:
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.
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 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.
Recomendamosverune
jemplotextualdemetadatosdeunc
atlogo.
Estossonlosmetadatosnecesariosparadescribirelcatlogo:
S Nombredadoalcatlogo.Debeserclaro,breve DatosArgentina
ylosuficientementeabstractocomopara
Nombre
abarcarlamultiplicidaddedatasetsque
contiene.
S Descripcindelcontenidodelcatlogo. PortaldeDatosAbiertosdel
Descripcin GobiernodelaRepblica
Argentina
Dataset
Recomendamosverune
jemplotextualdemetadatosdeund
ataset.
A continuacin, describimos los metadatos que se deben completar para describir un dataset a lahora
desucargaoactualizacinenelcatlogo:
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.
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
Distribucin
Recomendamosverune
jemplotextualdemetadatosdeunad
istribucin.
Estos son los metadatos que se deben completar al cargar o actualizar una distribucin de un dataset
enelcatlogoparadescribirla:
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
12
Lostiposincluidosenestalistason:
string(text):valoresdetexto.
number(double,float,numeric):nmerosquepuedan
noserenteros(incluyendecimales).
integer(int):nmerosquesiempresonenteros.
boolean(bool):valoresverdadero/falso.
binary:representacindedatosbinariosbase64.
geojson:verenhttp://geojson.org/
array:listadevalores.
object(json):objetodeJSON.
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
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.
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.
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)
"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
16
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.
Direccinwebdeaccesoalapgina
Pginaweb
Recomendado principal del catlogo. Enlace a la http://datos.gob.ar homepage String
delcatlogo
pginaprincipaldelcatlogo.
17
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.
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)
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
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).
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.
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.
21
"datasetejemplo35782
(a)ISO6391(2letras)
"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
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.
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)
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.
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
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
25
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)
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.
26
boolean(bool):Valoresverdadero/falso.
geojson:Verenhttp://geojson.org/
array:Listadevalores.
object(json):ObjetodeJSON.
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)
27
ElPortalNacionaldeDatosusalataxonomatemticadefinidaporlaUninEuropea.
Cada catlogo de datos puede desarrollar su propia taxonoma, cuyo uso se expresa en los
siguientescamposdemetadatos(ysusequivalentesparaelPortalAndino):
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.
28
(authority
code)
29
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
33
34
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
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
39