English

 

Teknisk information

DDA landingpage format

Formatet for landingpagen er en udvidet udgave af det tyske da|ra format. Selve landingpagen er en delmængde af den information arkivversionen dokumenteret i DDI-L indeholder. DDA landingpage formatet er datagundlaget for HTML siden. For at søgemaskineoptimerer HTML siden er der i den ilagt schema.org tags.

URL-strukturen for landingpag'en er REST-baseret og begynder med catalouge / studienummer. Fx.:

  • http://dda.dk/catalogue/10

Næste niveau i URL'en 'doc' indeholder dokumentationen til studiet: Kodebogen og DDA landingpage formatet i en tilgængelig XML udgave.

  • http://dda.dk/catalogue/10/doc/codebook
  • http://dda.dk/catalogue/10/doc/ddastudymetadata

XML schemadefinitionen for DDA landingpage format kan downloades her:
DDA landing page XML schema

DDA klassifikationer

DDA anvender klassifikationer på studiebeskrivelses- metode og livscyklusniveau. Klassifikationerne er defineret i Genericode format og anvendes af DDA landingpage formatet og i DDI-L dokumentationen.

Download og dokumentation af DDA klassifikationer

DDA Kind Of Data

DDAKindOfData-1.0.0

CV defining kind of data
Dokumentation

DDA Time Method

DDATimeMethod-1.0.0

CV defining time methodology
Dokumentation

DDA Analysis Unit

DDAAnalysisUnit-1.0.0

CV defining analysis units in a study
Dokumentation

DDA Data Collection Methodology

DDADataCollectionMethodology-1.0.0

CV defining data collection methodology
Dokumentation

DDA Mode Of Collection

DDAModeOfCollection-1.0.0

CV defining modes of data collection
Dokumentation

DDA Collection Situation

DDACollectionSituation-1.0.0

CV defining context in the data collection situation
Dokumentation

DDA Sampling Procedure

DDASamplingProcedure-1.0.0

CV defining sampling procedures
Dokumentation

DDA Study State

DDAStudyState-1.0.0

CV defining the state of a study within DDA's curation proccess
Dokumentation

DDA Study State

DDAStudyState-2.0.0

CV defining the state of a study within DDA's curation proccess
Dokumentation

DDA Access Conditions

DDAAccessConditions-1.0.0

CV defining DDA access conditions
Dokumentation

Søge API dokumentation

Indexingplatformen udbyder en simple søgefunktion som en web service. Web servicen kan tilgås på to måder, enten via URL-parametre eller via medsende søgeparametrene som XML i anmodningen (se XML skemadocumentaion). Web servicen kan søge inden for:
  • Studiebeskrivelse
  • Variable navne og beskrivelse
  • Spørgsmålstekster og beskrivelse
  • Univers beskrivelse og navn
  • Koncept beskrivelse og navn
  • Kategoritekster

URL parameter metoden

Med parameterne:

  • search-string - søgetekst - [obligatorisk]
  • hits-perpage - antal hits pr. side med et maksimum på 500 - [optionel]
  • hit-start - starthit i resultatliste - [optionel]
  • lang - valgt resultatsprog - [optionel] alle sprog vises i resultatet
  • StudyUnit - true - [optionel]
  • Variable - true - [optionel]
  • QuestionItem - true - [optionel]
  • Universe - true - [optionel]
  • Concept - true - [optionel]
  • Category - true - [optionel]

Eksempel på at søge med URL parametere:

http://dda.dk/search-api?StudyUnit=treu&search-string=Europæisk

XML indlejret metode

En søgning med API URL'en foregår på samme måde som ved URL parametermetoden men uden parlamenterne. Parammeterne er i stedet tilføjet i forespørgslen som XML. Søge XML'en er defineret ud fra simple-search-parameters.xsd. Fx. ved brug af 'curl' ser en forespørgsel ud som følger:

curl -d '<ssp:SimpleSearchParameters xmlns:s="http://dda.dk/ddi/scope" xmlns:ssp="http://dda.dk/ddi/simple-search-parameters" xmlns:smd="http://dda.dk/ddi/search-metadata" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><ssp:search-string>Europæisk</ssp:search-string><smd:SearchMetaData hits-perpage="50" hit-start="1" lang="da"/><s:Scope><s:StudyUnit/></s:Scope></ssp:SimpleSearchParameters>' -H 'Content-Type: text/xml' http://dda.dk/search-api

JSON eller XML søgeresultat

En søgning med API'et giver mulighed for at returnere resultatet i JSON eller XML. For at returnere i JSON tilføjes dette i HTTP forespørgselen -default returformatet er XML.

Fx. en JSON HTTP forespørgsel udtrykt via af 'curl':
curl 'http://dda.dk/search-api?StudyUnit=true&search-string=Europæisk' -H 'Accept: application/json'

XML schema dokumenation

Anvendte XML schema filer i forbindelse med søgeparametre og søgeresultat.

DDI URN opløsningsservice

DDI URN opløsningsservicen er baseret på DDI-L URN standarden. Servicen er en web service og opløser reference metadata elementer til XML identificeret ved: agency, ID og version.

URL'en for DDI-L URN servicen er: http://dda.dk/urn-resolution/ddi-3.1 med parameteren 'urn'

Eksempelvis er URL'en for DDI-L studiet -identificeret som agency: dk.dda, ID: 18465, version: 1.0.0:

http://dda.dk/urn-resolution/ddi-3.1?urn=urn:ddi:dk.dda:18465:1.0.0

Kildekode og licens

Indekseringsplatformen vedligeholdes af Dansk Data Arkiv og udgives under LGPL licensen kildekoden findes her: github.com/DanishDataArchive/indexingplatform