Converters API

Description

The Converters API is the central tool for managing knowledge captures. By utilizing OSGI Framework, the Converter API is able to access dynamically deployed converters within the Virgo Container - Eclipse Virgo - and perform conversions from JSON to OWL. Also, given an endpoint with an active Fuseki HTTP service the Converter API finally uploads the Ontology content to this service for storing, reasoning and querying.

How to get the code

git clone https://@opensourceprojects.eu/git/p/timbus/context-model/converters-api timbus-context-model-converters-api

Development

This tool was developed in the context of Work Package 6, Task 6.5 - Context Information and Metadata Capture Tool under the name TIMBUS Capture Tool.

Usage

This tool is comprehensably accessed through the Context Population GUI.
With an existing extraction, this tool can be used through a POST HTTP request with the following JSON parameters performed to .../populator/api/convert :

1
2
3
4
5
6
7
8

{
    "maxThreads" : "",
    "url" : "",
    "requestId" : "",
    "callBackInfo" : "", 
    "fusekiendpoint" : "",
    "dataset" : ""
}

maxThreads: Maximum conversion threads running simultaneously
url: Url containing the extraction to be converted
requestId: The extraction request Id
callbackInfo: An Object Array containing all desired callback Urls. Each object of the Array must contain the following parameters: "originalEndpointPort", "originalEndpointPath", "HTTPRequestType"
fusekiEndpoint: The fuseki endpoint for the OWL to be uploaded
dataset: Dataset name within the desired Fuseki endpoint

NOTE: The Converters API defaults to the Fuseki service in testbed.timbusproject.net

License

Copyright (c) 2014, Caixa Magica Software Lda (CMS).
The work has been developed in the TIMBUS Project and the above-mentioned are Members of the TIMBUS Consortium.
TIMBUS is supported by the European Union under the 7th Framework Programme for research and technological development and demonstration activities (FP7/2007-2013) under grant agreement no. 269940.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTIBITLY, or FITNESS FOR A PARTICULAR PURPOSE. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law or agreed to in writing, shall any Contributor be liable for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work.
See the License for the specific language governing permissions and limitation under the License.

Authors

Jorge Simões jorge.simoes@caixamagica.pt
Miguel Gama Nunes miguel.nunes@caixamagica.pt
Ricardo F. Teixeira <ricardo.teixeira@caixamagica.pt>