ISO 5127 Web Services List

WService

• getConceptByKeyword
• getConceptByURI
• getConceptPrefLabel
• getConceptAltLabel
• getConceptNotation
• getConceptDefinition
• getConceptNote
• getConceptSource
• getConceptExample
• getConceptBroader
• getConceptNarrower
• getConceptRelated
• getConceptInScheme
• getSchemeTitle
• getSchemeCreator
• getSchemeContributor

Endpoint address: http://URIbase/ilod/CXF/wservice
WSDL : http://URIbase/ilod/CXF/wservice?wsdl
Target namespace: http://webservice.lods.org/

The URIbase should be specified by ISO. The URIbase currently in use is “www.lib.szu.edu.cn/nkosapp”.

Name of Web Service

public String getConceptByKeyword(String schemeURI,String keyword)；

Description

This service will search for concepts by means of the input query keyword string, and then return concepts list (a list of concepts) string description.

The search can be filtered through the specified searchMode(default:Any) and language(default:en). The result of this method will be in txt or skos format.

Parameters

String schemeURI(the specified ontology identifier)

String keyword(the specified any string)

Extensible parameters in the future

format: optional parameter, there are several values, such as skos, json and ntriples.

searchMode: optional parameter, there are several values, such as  Exact, Front, Post and Any.

lang: optional parameter, there are several values, such as zh(Chinese), en(English), fr(French) and de(Germany).

outlang: optional parameter, there are several values, such as zh(Chinese), en(English), fr(French) and de(Germany).

Return Values

String result(It returns a list of some concepts)

Example(tested by SoapUI 4.6.1)

schemeURI: stand for ontology name you will search, for example: http://www.lib.szu.edu.cn/nkos/ISO_5127/

String keyword: the keyword string you will search in specified ontology, for example: the string “history museum” you request

Output:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

   <soap:Body>

      <ns2:getConceptByKeywordResponse xmlns:ns2="http://webservice.lods.org/">

         <getConceptByKeyword>{

  "skos:notation": "3.6.4.3.15",

  "skos:prefLabel": "history museum",

  "skos:definition": "museum (3.2.3.06) concerned with the history of a defined geographic area or a cultural group of people over a limited period or over the centuries",

  "skos:broader": "http://www.lib.szu.edu.cn/nkos/ISO_5127/3.6.4.3",

  "skos:note": "Note 1 to entry: Includes museums with collections of historical objects, commemorative museums, military museums, museums on historical persons, etc.",

  "skos:related": "http://www.lib.szu.edu.cn/nkos/ISO_5127/3.2.3.06",

  "rdf:type": "http://www.w3.org/2004/02/skos/core#Concept",

  "dc:source": "Note 2 to entry: Adapted from the UNESCO classification.",

  "dc:source": "[SOURCE: ISO 18461:2016, definition 2.2.11]"

}

{

  "skos:notation": "3.6.4.3.16",

  "skos:prefLabel": "natural history museum",

  "skos:definition": "museum (3.2.3.06) concerned with subjects relating to one or several natural sciences disciplines",

  "skos:broader": "http://www.lib.szu.edu.cn/nkos/ISO_5127/3.6.4.3",

  "skos:related": "http://www.lib.szu.edu.cn/nkos/ISO_5127/3.2.3.06",

  "rdf:type": "http://www.w3.org/2004/02/skos/core#Concept",

  "skos:example": "EXAMPLES Disciplines such as biology, geology, botany, zoology, palaeontology and ecology.",

  "dc:source": "Note 1 to entry: Adapted from the UNESCO classification.",

  "dc:source": "[SOURCE: ISO 18461:2016, definition 2.2.12, modified]"

}</getConceptByKeyword>

      </ns2:getConceptByKeywordResponse>

   </soap:Body>

</soap:Envelope>

Name of Web Service

public String getConceptByURI(String schemeURI,String conceptURI)；

Description

This service will search for a concept by means of the input query string, and then return its string description.

The search can be filtered through the specified searchMode(default:Exact) and language(default:en). The result of this method will be in txt or skos format.

Parameters

String schemeURI(the specified ontology identifier)

String conceptURI(the specified concept identifier)

Extensible parameters in the future

format: optional parameter, there are several values, such as skos, json and ntriples.

searchMode: optional parameter, there are several values, such as  Exact, Front, Post and Any.

lang: optional parameter, there are several values, such as zh(Chinese), en(English), fr(French) and de(Germany).

outlang: optional parameter, there are several values, such as zh(Chinese), en(English), fr(French) and de(Germany).

Return Values

String result(It returns string description of the concept)

Example(tested by SoapUI 4.6.1)

schemeURI: stand for ontology name you will search, for example: http://www.lib.szu.edu.cn/nkos/ISO_5127/

conceptURI: the concept string you will search in specified ontology, for example: the string “3.1.1.01” you request

Output:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

   <soap:Body>

      <ns2:getConceptResponse xmlns:ns2="http://webservice.lods.org/">

         <getConcept>{

  "skos:notation": "3.1.1.01",

  "skos:prefLabel": "object",

  "skos:broader": "http://www.lib.szu.edu.cn/nkos/ISO_5127/3.1.1",

  "skos:note": "Note 1 to entry: Objects may be material (e.g. an engine, a sheet of paper, a diamond), immaterial (e.g. conversion ratio, a project plan) or imagined (e.g. a unicorn).",

  "skos:note": " Note 2 to entry: See also “entity” (3.1.13.27); and ISO/IEC 27000:2016, definition 2.55. ",

  "skos:definition": "anything perceivable or conceivable",

  "rdf:type": "http://www.w3.org/2004/02/skos/core#Concept",

  "dc:source": "[SOURCE: ISO 1087‐1:2000, definition 3.1.1]"

}</getConcept>

      </ns2:getConceptResponse>

   </soap:Body>

</soap:Envelope>

Name of Web Service

public String getConceptPrefLabel(String schemeURI,String conceptURI)；

Description

This service will search for a concept by means of the input query string, and then return its prefLabel (preferred label, skos:prefLabel) string description.

The search can be filtered through the specified searchMode(default:Exact) and language(default:en). The result of this method will be in txt or skos format.

Parameters

String schemeURI(the specified ontology identifier)

String conceptURI(the specified concept identifier)

Extensible parameters in the future

format: optional parameter, there are several values, such as skos, json and ntriples.

searchMode: optional parameter, there are several values, such as  Exact, Front, Post and Any.

lang: optional parameter, there are several values, such as zh(Chinese), en(English), fr(French) and de(Germany).

outlang: optional parameter, there are several values, such as zh(Chinese), en(English), fr(French) and de(Germany).

Return Values

String result(It returns the prefLabel string of some concept)

Example(tested by SoapUI 4.6.1)

schemeURI: stand for ontology name you will search, for example: http://www.lib.szu.edu.cn/nkos/ISO_5127/

conceptURI: the concept string you will search in specified ontology, for example: the string “3.1.3” you request

Output:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

   <soap:Body>

      <ns2:getConceptPrefLabelResponse xmlns:ns2="http://webservice.lods.org/">

         <getConceptPrefLabel>Evaluation and statistics</getConceptPrefLabel>

      </ns2:getConceptPrefLabelResponse>

   </soap:Body>

</soap:Envelope>

Name of Web Service

public String getConceptNote(String schemeURI,String conceptURI)；

Description

This service will search for a concept by means of the input query string, and then return its note (skos:note) string description.

The search can be filtered through the specified searchMode(default:Exact) and language(default:en). The result of this method will be in txt or skos format.

Parameters

String schemeURI(the specified ontology identifier)

String conceptURI(the specified concept identifier)

Extensible parameters in the future

format: optional parameter, there are several values, such as skos, json and ntriples.

searchMode: optional parameter, there are several values, such as  Exact, Front, Post and Any.

lang: optional parameter, there are several values, such as zh(Chinese), en(English), fr(French) and de(Germany).

outlang: optional parameter, there are several values, such as zh(Chinese), en(English), fr(French) and de(Germany).

Return Values

String result(It returns the note string of some concept)

Example(tested by SoapUI 4.6.1)

schemeURI: stand for ontology name you will search, for example: http://www.lib.szu.edu.cn/nkos/ISO_5127/

conceptURI: the concept string you will search in specified ontology, for example: the string “3.1.1.15” you request

Output:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

   <soap:Body>

      <ns2:getConceptNoteResponse xmlns:ns2="http://webservice.lods.org/">

         <getConceptNote>Note 1 to entry: Data are often understood as taking the form of a set (3.1.1.09) of values of qualitative or quantitative variables.</getConceptNote>

      </ns2:getConceptNoteResponse>

   </soap:Body>

</soap:Envelope>

Name of Web Service

public String getConceptDefinition(String schemeURI,String conceptURI);

Description

This service will search for a concept by means of the input query string, and then return its definition (skos:definition) string description.

The search can be filtered through the specified searchMode(default:Exact) and language(default:en). The result of this method will be in txt or skos format.

Parameters

String schemeURI(the specified ontology identifier)

String conceptURI(the specified concept identifier)

Extensible parameters in the future

format: optional parameter, there are several values, such as skos, json and ntriples.

searchMode: optional parameter, there are several values, such as  Exact, Front, Post and Any.

lang: optional parameter, there are several values, such as zh(Chinese), en(English), fr(French) and de(Germany).

outlang: optional parameter, there are several values, such as zh(Chinese), en(English), fr(French) and de(Germany).

Return Values

String result(It returns the definition string of some concept)

Example(tested by SoapUI 4.6.1)

schemeURI: stand for ontology name you will search, for example: http://www.lib.szu.edu.cn/nkos/ISO_5127/

conceptURI: the concept string you will search in specified ontology, for example: the string “3.1.1.08” you request

Output:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

   <soap:Body>

      <ns2:getConceptDefinitionResponse xmlns:ns2="http://webservice.lods.org/">

         <getConceptDefinition>of an object (3.1.1.01) taken away from its original context (3.1.2.05)</getConceptDefinition>

      </ns2:getConceptDefinitionResponse>

   </soap:Body>

</soap:Envelope>