簡 易 LOD 検 索 サイト 作 成 ツール (SPARQL Finder) 設 定 方 法 2013/12/25 大 阪 大 学 産 業 科 学 研 究 所 加 藤 敦 丈, 古 崎 晃 司
概 要 目 次 概 要 本 ドキュメントは, 簡 易 LOD 検 索 サイト 作 成 ツール の 利 用 方 法 を 解 説 したものです. ツールの 詳 細,ダウンロードは 公 開 サイト https://sourceforge.jp/projects/easylod/wiki/easylodsite をご 覧 ください 目 次 公 開 サーバを 用 いる 際 の 設 定 方 法 ( 通 常 はこちら) 独 自 サーバへの 設 置 設 定 方 法 サーバの 設 定 クライアントの 設 定 連 絡 先 大 阪 大 学 産 業 科 学 研 究 所 古 崎 晃 司 kozaki@ei.sanken.osaka-u.ac.jp
簡 易 LOD 検 索 サイト 作 成 ツール(SPARQL Finder) 公 開 サーバを 用 いる 際 の 設 定 方 法
まず 公 開 サイト (https://sourceforge.jp/projects/easylod/wiki/easylodsite) から easylodsite.zip をダウンロードし, 圧 縮 ファイルを 解 凍 しますます data.js,index.htmlという2つのファイル, およびcssというフォルダが 含 まれています. 解 凍 したファイルのうち data.js というファイルの 中 に 設 定 が 記 述 されていますので,これを 次 ページ 以 降 の 設 定 項 目 をに 沿 って,テキストエ ディタ 等 で 編 集 します
設 定 を 行 うことができる 項 目 は 以 下 の 通 りです 必 須 項 目 名 設 定 内 容 server Servletサーバアドレス endpoint 検 索 対 象 エンドポイント - sparqlconditionhead 固 定 検 索 条 件 predicates 検 索 条 件 述 語 viewpreds 表 示 項 目 - menucondition 特 定 検 索 条 件 メニューリスト 項 目 ( 左 メニューを 利 用 する 場 合 )
server 項 目 には クライアントが 接 続 を 行 う アプリケーションサーバの 設 定 を 行 います 設 定 はひとつのみ 行 います 設 定 内 容 は 以 下 の 通 りです 必 須 属 性 名 設 定 内 容 - Servletサーバアドレスを 記 述 する (サービス 名 は SparqlFinder 固 定 )
endpoint 項 目 には SPARQLエンドポイントの 設 定 を 行 います 設 定 はひとつのみ 行 います 設 定 内 容 は 以 下 の 通 りです 必 須 項 目 名 設 定 内 容 endpoint 検 索 対 象 SPARQLエンドポイント - namespaces SPARQLエンドポイントが 保 持 するSubjectリソースの namespaceヘッダ 複 数 存 在 する 場 合 は, 区 切 りで 複 数 指 定 する ( 指 定 しなかった 場 合 Subject Objectの 完 全 一 致 検 索 が 正 常 に 行 えない 場 合 がある)
sparqlconditionhead 項 目 には 検 索 の 際 に 必 ず 追 加 する 絞 り 込 み 条 件 queryを 記 述 します 設 定 内 容 は 以 下 の 通 りです 必 須 属 性 名 設 定 内 容 - 固 定 絞 り 込 み 条 件 query ( 主 語 を?s とし 述 語 と 目 的 語 を 任 意 に 指 定 する)
predicates 項 目 には 検 索 対 象 とする 述 語 の 設 定 を 行 います 述 語 は 配 列 にて 複 数 指 定 できます 設 定 内 容 は 以 下 の 通 りです 必 須 項 目 名 設 定 内 容 label 検 索 条 件 のラベル - pred 検 索 条 件 の 述 語 リソースを 記 述 する < と > で 囲 って 表 記 する 目 的 語 を 検 索 対 象 とする 場 合 は 必 須 - subject 主 語 を 検 索 対 象 とする 場 合 この 項 目 を 設 定 し 設 定 値 を ID とする - types 検 索 条 件 を 自 由 入 力 ではなく 選 択 式 とする 場 合 この 項 目 に 配 列 として 定 義 する 選 択 内 容 の 検 索 条 件 を 常 に 完 全 一 致 としたい 場 合 < と > で 囲 って 表 記 する
viewpreds 項 目 には 検 索 結 果 表 示 時 の 表 示 項 目 の 設 定 を 行 います 設 定 内 容 は 以 下 の 通 りです 必 須 項 目 名 設 定 内 容 - link 検 索 結 果 IDにハイパーリンクを 付 与 するか ( 未 設 定 の 場 合 はtrue) data 検 索 結 果 述 語 項 目 の 一 覧 を 配 列 にて 定 義 する ( 定 義 内 容 は 次 ページ)
viewpredsのdata 項 目 には 検 索 結 果 表 示 時 の 表 示 述 語 の 設 定 を 行 います 表 示 述 語 は 配 列 にて 複 数 指 定 できます 設 定 内 容 は 以 下 の 通 りです 必 須 項 目 名 設 定 内 容 label 検 索 結 果 項 目 のラベル valiable 検 索 結 果 項 目 のラベルに 紐 づく 変 数 名 述 語 ではなく 主 語 を 表 示 する 場 合 は subject を 指 定 する - pred 検 索 結 果 項 目 述 語 のリソースを 記 述 する < と > で 囲 って 表 記 する 述 語 ではなく 主 語 を 表 示 する 場 合 は 設 定 を 行 わない - link 項 目 がURLの 場 合 ハイパーリンクを 付 与 するか ( 未 設 定 の 場 合 はtrue)
この 時 点 では menuconditions の 設 定 は 行 いません
これまでの 設 定 を 行 い index.htmlをwebブラウザで 開 くと Sparql Finderの 画 面 が 表 示 されます
predicates で 設 定 した 検 索 条 件 の ラベル 一 覧 が 選 択 できることを 確 認 します
条 件 を 入 力 して find ボタンで endpoint で 指 定 したエンドポイントから 該 当 結 果 が 返 ることを 確 認 します
その 際 viewpreds で 指 定 した 主 語 / 述 語 が 表 示 されていることを 確 認 します
viewpreds で 指 定 したとおりに ハイパーリンクが 有 効 / 無 効 になっていること を 確 認 します
左 メニューを 追 加 する 場 合 以 下 の 手 順 を 行 います
条 件 を 入 力 して view condition ボタンを クリックします
条 件 に 該 当 する 文 字 列 が 表 示 されます
文 字 列 をdata.jsのmenuConditionの 要 素 として コピー&ペーストします
label(nn) となっているところの label を 左 メニューとして 表 示 したい 文 字 列 に 書 き 換 えます
設 定 したい 左 メニュー 項 目 が 複 数 ある 場 合 これまでの 手 順 を 繰 り 返 し menuconditionに 追 記 していきます
WebContent/index.htmlを 更 新 すると 左 メニューが 表 示 されていることを 確 認 します
左 メニュー 項 目 をクリックすると 該 当 条 件 で 検 索 が 行 われることを 確 認 します
ページの 見 た 目 を 変 更 したい 場 合 必 要 に 応 じて index.htmlを 編 集 します
DIV 要 素 right popup popup_2 以 外 は 自 由 に 編 集 して 構 いません このあたりは 基 本 的 に 触 らない
ただし 提 供 する 機 能 に 応 じて 以 下 の 編 集 を 行 います ID 項 目 名 設 定 内 容 find_exec 検 索 ボタン 検 索 条 件 に 応 じた 検 索 を 行 います 通 常 はそのまま 残 しておきます view_query view_cond Query 表 示 ボタ ン 左 メニュー 生 成 ボタン 検 索 条 件 に 応 じたqueryを 表 示 します Query 表 示 が 不 要 の 場 合 は 削 除 して 構 いません (その 際 DIV popup_2 も 削 除 します) 設 置 時 に 左 メニュー 項 目 を 生 成 するために 利 用 します 運 用 時 には 削 除 して 構 いません (その 際 DIV popup も 削 除 します)
見 出 しを 変 えて 検 索 ボタンのみ 有 効 にした 例 見 出 し 変 更 検 索 ボタン 以 外 削 除 ボタンラベル 変 更 その 他 スタイルシート 変 更 による スタイル 切 り 替 えも 行 うことができます
index.html,data.jsおよびcssフォルダを HTTPサーバにアップロードします ( ローカルでのみ 利 用 する 場 合 は 必 要 ありません)
アップロードしたサーバにWebアクセスすると SPARQL Finderが 利 用 できることを 確 認 します
補 足 複 数 の LOD 検 索 サイト を 同 一 サーバ 上 の 同 一 フォルダ 内 で 作 成 したい 場 合 は, 1. data.js を 検 索 対 象 毎 に 別 名 で 保 存 ( 例 : ExampleData.js) し, 2. index.html の <script type="text/javascript" src="data.js" charset="utf-8"></script> とある 箇 所 でdata.jsを1.で 変 更 したファイル 名 に 書 き 換 え, 必 要 に 応 じて 別 名 で 保 存 する. ことで 可 能 です.
これ 以 降 は, 公 開 サーバを 利 用 せずに, 本 ツールをご 自 身 の 用 意 されたサーバで 実 行 する 際 の 設 定 の 説 明 となります. 本 ツール 用 の 公 開 サーバを 利 用 される 方 は,サーバ 設 定 は 不 要 です. 簡 易 LOD 検 索 サイト 作 成 ツール(SPARQL Finder) 独 自 サーバへの 設 置 設 定 方 法 1 サーバ 設 定 方 法
まず 公 開 サイト (https://sourceforge.jp/projects/easylod/wiki/easylodsite) から SparqlFinder.war をダウンロードします 続 いて, SparqlFinder.war ファイルを ターゲットのServletサーバにて 公 開 します (tomcat manager 利 用 あるいはwebappsフォル ダに 格 納 するなど)
公 開 したサーバの SparqlFinder にアクセスす ることで SPARQL Finderが 利 用 できることを 確 認 します example.jp のポート80に 公 開 した 場 合
本 システムは クライアントサイドの html/javascriptを 書 き 換 えることで アクセス 先 エンドポイント 取 得 パラメータ 等 を 自 由 に 設 定 することができます クライアントサイドの 設 定 項 目 は SPARQL Finder 設 置 方 法.pptx を 参 照 ください
簡 易 LOD 検 索 サイト 作 成 ツール(SPARQL Finder) 独 自 サーバへの 設 置 設 定 方 法 2 クライアント 設 定 方 法
事 前 準 備 前 提 として 上 記 SPARQL Finderサーバ 設 置 方 法 に 基 づき SPARQL Finderサーバが 公 開 されているものとします http://lod.hozo.jp にて 公 開 さているSPARQL Finderサーバ をご 利 用 いただくことも 可 能 です 公 開 サイト (https://sourceforge.jp/projects/easylod/wiki/easylodsite) から WebContent.zip をダウンロードします
適 当 なフォルダに ダウンロードしたファイルを 展 開 します
WebContent/js/data.jsファイルを テキストエディタ 等 で 開 きます これ 以 降 の 設 定 方 法 は, 前 述 の 公 開 サーバを 用 い る 際 の 設 定 方 法 と 同 様 です.
WebContent 以 下 を HTTPサーバにアップロードします ( 1.SparqlFinder 公 開 サーバの WebContent 以 下 を 上 書 きしてもかまいません) ( 2.ローカルでのみ 利 用 する 場 合 は 必 要 ありません)
以 上