diff sparql/executor.xml @ 0:7785ad38967f default tip

Uploaded
author atsuko
date Thu, 25 Aug 2011 22:14:55 -0400
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sparql/executor.xml	Thu Aug 25 22:14:55 2011 -0400
@@ -0,0 +1,133 @@
+<?xml version="1.0"?>
+<tool id="sparql query executor" name="SPARQL Query Tool" is_multi_byte="true">
+  <description>gets RDF graphs by using SPARQL.</description>
+  <description lang="ja">SPARQLを使ってRDFグラフを取得します</description>
+  
+  <inputs>
+    <param name="endpoint" type="text" value="" size="60" label="Endpoint URL" />
+    <param name="query" format="txt" type="data" label="Query" />
+  </inputs>
+
+  <outputs>
+    <data format="txt" name="output" />
+  </outputs>
+
+  <command interpreter="ruby">executor.rb -e '$endpoint' --query-file '$query' -o '$output'</command>
+
+  <help>
+**What it does**
+
+SPARQL is a query language for RDF graphs.
+
+About SPARQL, see http://www.w3.org/TR/rdf-sparql-query/
+
+-----
+
+**How to use**
+
+To use this tool a user first needs SPARQL query as an input. 
+
+For example::
+
+	SELECT * WHERE {
+	  ?s ?p ?o
+	} LIMIT 10
+
+Please input a SPARQL endpoint URL ( e.g. http://www.semantic-systems-biology.org/biogateway/endpoint ) and select the SPARQL query dataset.
+
+And click the execute button.
+
+The results can be shown on the middle pane by clicking the eye symbol on the history pane.
+
+-----
+
+.. class:: infomark
+
+**Note:** SPARQL results has a header line (e.g. ?S ?V ?O). If you want to remove the header line, use the `'Text Manipulation / Remove beginning' tool`_, and remove a first line.
+
+.. _`'Text Manipulation / Remove beginning' tool`: /tool_runner?tool_id=Remove+beginning1
+
+-----
+
+**Output**
+
+SPARQL results as tabular format.
+
+-----
+
+**Example**
+
+If you specify example parameter, the results was::
+
+	?s	?p	?o
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid-nullable&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid-nonblank&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid-nonblank-nullable&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#default&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#default-nullable&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar-nullable&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar-dt&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar-dt-nullable&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+
+  </help>
+
+  <help lang="ja">
+**概要**
+
+SPARQLはRDFグラフを取得するための問い合わせ言語です。
+
+SPARQLに関する詳しい情報は http://www.w3.org/TR/rdf-sparql-query/ を参照してください。
+
+-----
+
+**使い方**
+
+ツールを使う準備として、以下のようなSPARQLクエリーをヒストリーに用意してください::
+
+	SELECT * WHERE {
+	  ?s ?p ?o
+	} LIMIT 10
+
+クエリーをヒストリーに用意したら、このツールを表示しSPARQL endpoint URL( 例: http://www.semantic-systems-biology.org/biogateway/endpoint )を入力し、そして先ほど用意したクエリーのデータセットをSPARQL queryとして指定して下さい。
+
+以上が完了したら、executeボタンを押して下さい。
+
+問い合わせが行われ、結果がデータセットとしてヒストリーに積まれます。目で描かれたアイコンを押すと問い合わせ結果が真ん中のペインに表示されます。
+
+-----
+
+.. class:: infomark
+
+**ノート:** SPARQLの問い合わせ結果には「?S ?V ?O」のようなヘッダ行が含まれます。もしこれを取り除きたい場合は、`'Text Manipulation / Remove beginning' tool`_ ツールを利用して下さい。
+
+.. _`'Text Manipulation / Remove beginning' tool`: /tool_runner?tool_id=Remove+beginning1
+
+-----
+
+**出力**
+
+タブ区切り形式でSPARQLの問い合わせ結果が出力されます。
+
+-----
+
+**使用例**
+
+上記の「使い方」で示したクエリを指定して問い合わせた場合、以下のような結果が得られます。::
+
+	?s	?p	?o
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid-nullable&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid-nonblank&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#default-iid-nonblank-nullable&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#default&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#default-nullable&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar-nullable&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar-dt&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+	&lt;http://www.openlinksw.com/virtrdf-data-formats#sql-varchar-dt-nullable&gt;	&lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#type&gt;	&lt;http://www.openlinksw.com/schemas/virtrdf#QuadMapFormat&gt;
+
+  </help>
+
+</tool>