Skip to main content

Web Service Method: Map RDF Metadata to Concept URIs

Abstract

Web Service Method: Map RDF Metadata to Concept URIs

Description

Map existing textual metadata in an RDF document to concept URIs in a thesaurus.

URL: /extractor/api/map

Request

Supported Methods

POST

Content-Type

application/x-www-form-urlencoded

HTTP Parameter

Parameter

Type

Required

Description

conceptInfo

Array of String

false

Properties that should be returned for mapped concepts additional to the URI (eg. prefLabel, altLabel, hiddenLabel)

format

String

true

Determines the serialization format of the result and the format of the RDF data sent in the request body. ['application/rdf+xml' or 'text/rdf+n3']

languages

Array of String

false

List of languages that should be considered for mapping, none = no language restriction

mappingMode

String

true

The mapping mode to use. ['label' or 'fulltext']

projectName

String

true

The unique identifier of the project to use for the mapping

rdfProperties

Array of RdfProperty

true

An array of RDF property configurations that should be considered for mapping

replaceMode

String

false

The replace mode to use if mappingMode is 'label'. ['object' or 'subject']

statements

String

true

The rdf statements on which the mapping will be performed

thesaurusNameSpace

String

false

Optional prefix name for thesaurus uris. Use together with thesaurusUri parameter

thesaurusUri

String

false

Optional thesaurus uri to be replaced with a prefix. Use together with thesaurusNameSpace parameter

Response

This method returns execution results in plain text format.

ExamplesInput RDF
@prefix dc: <http://purl.org/dc/elements/1.1/> .
<http://resource.semantic-web.at/topic/Fixed_Income> dc:creator "Max Mustermann"@en .
Parameters

replaceMode = object

format = text/rdf+n3

projectName = 1DAB23D0-F28A-0001-A0E6-4E505B00DEC0

conceptInfo[0] = http://www.w3.org/2004/02/skos/core#prefLabel

conceptInfo[1] = http://www.w3.org/2004/02/skos/core#altLabel

rdfProperties[0].rdfProperty = http://purl.org/dc/elements/1.1/creator

rdfProperties[0].conceptscheme[0] = http://vocabulary.semantic-web.at/thesaurus_map/9fa05835-68dd-43e7-843e-76079160052f

mappingMode = label

statements = @prefix dc: <http://purl.org/dc/elements/1.1/http://resource.semantic-web.at/topic/Fixed_Incomehttp://purl.org/dc/elements/1.1/>. <http://resource.semantic-web.at/topic/Fixed_Income> dc:creator "Max Mustermann".

API Call

Example Request

http://vocabulary.semantic-web.at/extractor/api/map?replaceMode=object&format=text%2Frdf%2Bn3&projectName=1DAB23D0-F28A-0001-A0E6-4E505B00DEC0&conceptInfo[0]=http%3A%2F%2Fwww.w3.org%2F2004%2F02%2Fskos%2Fcore%23prefLabel&conceptInfo[1]=http%3A%2F%2Fwww.w3.org%2F2004%2F02%2Fskos%2Fcore%23altLabel&rdfProperties[0].rdfProperty=http%3A%2F%2Fpurl.org%2Fdc%2Felements%2F1.1%2Fcreator&rdfProperties[0].conceptscheme[0]=http%3A%2F%2Fvocabulary.semantic-web.at%2Fthesaurus_map%2F9fa05835-68dd-43e7-843e-76079160052f&mappingMode=label&statements=%40prefix%20dc%3A%20%3Chttp%3A%2F%2Fpurl.org%2Fdc%2Felements%2F1.1%2F%3E%20.%0A%3Chttp%3A%2F%2Fresource.semantic-web.at%2Ftopic%2FFixed_Income%3E%20dc%3Acreator%20%22Max%20Mustermann%22%40en%20.%0A

Note

The parameters are URL encoded.

Result
<http://resource.semantic-web.at/topic/Fixed_Income> <http://purl.org/dc/elements/1.1/creator> <http://vocabulary.semantic-web.at/thesaurus_map/5583b289-9a30-431e-a7b9-ca9ea168186a> .
<http://vocabulary.semantic-web.at/thesaurus_map/5583b289-9a30-431e-a7b9-ca9ea168186a> a <http://www.w3.org/2004/02/skos/core#Concept> ;
<http://www.w3.org/2004/02/skos/core#prefLabel> "Max Mustermann"@de ;
<http://www.w3.org/2004/02/skos/core#altLabel> "Maximilian"@de .
Input RDF
@prefix dc: <http://purl.org/dc/elements/1.1/> .
<http://resource.semantic-web.at/topic/Fixed_Income> dc:creator "Max Mustermann"@en .
Parameters

Same as before but with

replaceMode = subject

API Call

Example Request

http://vocabulary.semantic-web.at/extractor/api/map?replaceMode=subject&format=text%2Frdf%2Bn3&projectName=1DAB23D0-F28A-0001-A0E6-4E505B00DEC0&conceptInfo[0]=http%3A%2F%2Fwww.w3.org%2F2004%2F02%2Fskos%2Fcore%23prefLabel&conceptInfo[1]=http%3A%2F%2Fwww.w3.org%2F2004%2F02%2Fskos%2Fcore%23altLabel&rdfProperties[0].rdfProperty=http%3A%2F%2Fpurl.org%2Fdc%2Felements%2F1.1%2Fcreator&rdfProperties[0].conceptscheme[0]=http%3A%2F%2Fvocabulary.semantic-web.at%2Fthesaurus_map%2F9fa05835-68dd-43e7-843e-76079160052f&mappingMode=label&statements=%40prefix%20dc%3A%20%3Chttp%3A%2F%2Fpurl.org%2Fdc%2Felements%2F1.1%2F%3E%20.%0A%3Chttp%3A%2F%2Fresource.semantic-web.at%2Ftopic%2FFixed_Income%3E%20dc%3Acreator%20%22Max%20Mustermann%22%40en%20.%0A
Result
<http://vocabulary.semantic-web.at/thesaurus_map/5583b289-9a30-431e-a7b9-ca9ea168186a> <http://www.w3.org/2004/02/skos/core#altLabel> "Maximilian"@en ;
        <http://purl.org/dc/elements/1.1/creator> "Max Mustermann"@en ;
        a <http://www.w3.org/2004/02/skos/core#Concept> ;
        <http://www.w3.org/2004/02/skos/core#prefLabel> "Max Mustermann"@en .
Input RDF
@prefix dc: <http://purl.org/dc/elements/1.1/> .
@prefix voc: <http://vocabulary.semantic-web.at/onotlogy/v1#> .
<http://resource.semantic-web.at/topic/Fixed_Income> dc:creator "Max Mustermann"@en .
<http://resource.semantic-web.at/topic/Fixed_Income> voc:Publication "Research Daily - Fixed Income"@en .
Parameters

replaceMode = object

format = text/rdf+n3

projectName = 1DAB23D0-F28A-0001-A0E6-4E505B00DEC0

conceptInfo[0] = http://www.w3.org/2004/02/skos/core#prefLabel

conceptInfo[1] = http://www.w3.org/2004/02/skos/core#hiddenLabel

rdfProperties[0].rdfProperty = http://purl.org/dc/elements/1.1/creator

rdfProperties[0].conceptscheme[0] =http://vocabulary.semantic-web.at/thesaurus_map/9fa05835-68dd-43e7-843e-76079160052f

rdfProperties[1].rdfProperty = http://vocabulary.semantic-web.at/onotlogy/v1#Publication

rdfProperties[1].conceptscheme[0] =http://vocabulary.semantic-web.at/thesaurus_map/725b7443-05be-4a79-b424-aa511f5ed869

mappingMode = label

statements = @prefix dc: <http://purl.org/dc/elements/1.1/> . @prefix voc: <http://vocabulary.semantic-web.at/onotlogy/v1#> . <http://resource.semantic-web.at/topic/Fixed_Income> dc:creator "Max Mustermann" . <http://resource.semantic-web.at/topic/Fixed_Income> voc:Publication "Research Daily - Fixed Income" .

API Call

Example Request

http://vocabulary.semantic-web.at/extractor/api/map?replaceMode=object&format=text%2Frdf%2Bn3&projectName=1DAB23D0-F28A-0001-A0E6-4E505B00DEC0&conceptInfo[0]=http%3A%2F%2Fwww.w3.org%2F2004%2F02%2Fskos%2Fcore%23prefLabel&conceptInfo[1]=http%3A%2F%2Fwww.w3.org%2F2004%2F02%2Fskos%2Fcore%23altLabel&rdfProperties[0].rdfProperty=http%3A%2F%2Fpurl.org%2Fdc%2Felements%2F1.1%2Fcreator&rdfProperties[0].conceptscheme[0]=http%3A%2F%2Fvocabulary.semantic-web.at%2Fthesaurus_map%2F9fa05835-68dd-43e7-843e-76079160052f&rdfProperties[1].rdfProperty=http%3A%2F%2Fvocabulary.semantic-web.at%2Fonotlogy%2Fv1%23Publication&rdfProperties[1].conceptscheme[0]=http%3A%2F%2Fvocabulary.semantic-web.at%2Fthesaurus_map%2F725b7443-05be-4a79-b424-aa511f5ed869&mappingMode=label&statements=%40prefix%20dc%3A%20%3Chttp%3A%2F%2Fpurl.org%2Fdc%2Felements%2F1.1%2F%3E%20.%0A%40prefix%20voc%3A%20%3Chttp%3A%2F%2Fvocabulary.semantic-web.at%2Fonotlogy%2Fv1%23%3E%20.%0A%0A%3Chttp%3A%2F%2Fresource.semantic-web.at%2Ftopic%2FFixed_Income%3E%20dc%3Acreator%20%22Max%20Mustermann%22%40en%20.%0A%3Chttp%3A%2F%2Fresource.semantic-web.at%2Ftopic%2FFixed_Income%3E%20voc%3APublication%20%22Research%20Daily%20-%20Fixed%20Income%22%40en%20.%0A
Result
<http://resource.semantic-web.at/topic/Fixed_Income> <http://vocabulary.semantic-web.at/onotlogy/v1#Publication> "Research Daily - Fixed Income"@en ;
        <http://purl.org/dc/elements/1.1/creator> <http://vocabulary.semantic-web.at/thesaurus_map/5583b289-9a30-431e-a7b9-ca9ea168186a> .
<http://vocabulary.semantic-web.at/thesaurus_map/5583b289-9a30-431e-a7b9-ca9ea168186a> a <http://www.w3.org/2004/02/skos/core#Concept> ;
        <http://www.w3.org/2004/02/skos/core#prefLabel> "Max Mustermann"@en ;
        <http://www.w3.org/2004/02/skos/core#altLabel> "Maximilian"@en .
Input RDF
@prefix dcterms: <http://purl.org/dc/terms/> .
@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
<http://vocabulary.semantic-web.at/legislation/bd_krankentransportrl> dcterms:subject <http://vocabulary.semantic-web.at/legislation/krankenversicherung> .
<http://vocabulary.semantic-web.at/legislation/krankenversicherung> a skos:Concept , <http://schema.semantic-web.at/Category/Rechtsgebiete> ;
        skos:prefLabel "public health insurance"@en .
Parameters

replaceMode = object

format = text/rdf+n3

projectName = 1DAB23D0-F28A-0001-A0E6-4E505B00DEC0

conceptInfo[0] =http://www.w3.org/2004/02/skos/core#prefLabel

conceptInfo[1] = http://www.w3.org/2004/02/skos/core#hiddenLabel

rdfProperties[0].rdfProperty =http://www.w3.org/2004/02/skos/core#prefLabel

rdfProperties[0].conceptscheme[0] =http://vocabulary.semantic-web.at/thesaurus_map/e8f5c0eb-c110-43d3-b346-84ecf6433089

mappingMode = label

statements = @prefix dcterms: <http://purl.org/dc/terms/> . @prefix skos: <http://www.w3.org/2004/02/skos/core#> . <http://vocabulary.semantic-web.at/legislation/bd_krankentransportrl> dcterms:subject <http://vocabulary.semantic-web.at/legislation/krankenversicherung> .<http://vocabulary.semantic-web.at/legislation/krankenversicherung> a skos:Concept , <http://schema.semantic-web.at/Category/Rechtsgebiete> ; skos:prefLabel "public health insurance"@en .

API Call

Example Request

http://vocabulary.semantic-web.at/extractor/api/map?replaceMode=object&format=text%2Frdf%2Bn3&projectName=1DAB23D0-F28A-0001-A0E6-4E505B00DEC0&conceptInfo[0]=http%3A%2F%2Fwww.w3.org%2F2004%2F02%2Fskos%2Fcore%23prefLabel&conceptInfo[1]=http%3A%2F%2Fwww.w3.org%2F2004%2F02%2Fskos%2Fcore%23altLabel&rdfProperties[0].rdfProperty=http%3A%2F%2Fwww.w3.org%2F2004%2F02%2Fskos%2Fcore%23prefLabel&rdfProperties[0].conceptscheme[0]=http%3A%2F%2Fvocabulary.semantic-web.at%2Fthesaurus_map%2Fe8f5c0eb-c110-43d3-b346-84ecf6433089&mappingMode=label&statements=%40prefix%20dcterms%3A%20%3Chttp%3A%2F%2Fpurl.org%2Fdc%2Fterms%2F%3E%20.%0A%40prefix%20skos%3A%20%3Chttp%3A%2F%2Fwww.w3.org%2F2004%2F02%2Fskos%2Fcore%23%3E%20.%0A%0A%3Chttp%3A%2F%2Fvocabulary.semantic-web.at%2Flegislation%2Fbd_krankentransportrl%3E%20dcterms%3Asubject%20%3Chttp%3A%2F%2Fvocabulary.semantic-web.at%2Flegislation%2Fkrankenversicherung%3E%20.%0A%0A%3Chttp%3A%2F%2Fvocabulary.semantic-web.at%2Flegislation%2Fkrankenversicherung%3E%20a%20skos%3AConcept%20%2C%20%3Chttp%3A%2F%2Fschema.semantic-web.at%2FCategory%2FRechtsgebiete%3E%20%3B%0A%09skos%3AprefLabel%20%22public%20health%20insurance%22%40en%20.%0A
Result
<http://vocabulary.semantic-web.at/legislation/bd_krankentransportrl> <http://purl.org/dc/terms/subject> <http://vocabulary.semantic-web.at/legislation/krankenversicherung> .
<http://vocabulary.semantic-web.at/legislation/krankenversicherung> a <http://www.w3.org/2004/02/skos/core#Concept> , <http://schema.semantic-web.at/Category/Rechtsgebiete> ;
        <http://www.w3.org/2004/02/skos/core#prefLabel> <http://vocabulary.semantic-web.at/thesaurus_map/951b77de-7839-4369-a0f0-9ce32536b4f1> .
<http://vocabulary.semantic-web.at/thesaurus_map/951b77de-7839-4369-a0f0-9ce32536b4f1> a <http://www.w3.org/2004/02/skos/core#Concept> ;
        <http://www.w3.org/2004/02/skos/core#prefLabel> "public health insurance"@en .