新規コアの追加方法
このページでは、IPT上級者向けの設定方法を説明します。 |
IPTは常に3つのコア(タクソン、オカレンス、イベント)をデフォルトでインストールした状態で出荷されます。IPT 2.1以降、カスタムコアをIPTに追加することができるようになり、新しいデータ標準のプロトタイプを作成するコミュニティにとって有用です。この方法では、コミュニティは自分たちのデータを新しいコアにマッピングする試みを開始し、そのプロパティのセットを繰り返し改良することができます。
以下の3つのステップで説明します。
-
新しいコアを作成し、
-
GBIFに登録して、
-
それを使用するIPTを設定する。
手順
-
コアXMLの定義を書く
コアとなるXMLの定義は、GBIF拡張スキーマに準拠することが必要です。ダーウィンコア・オカレンスコアなど、既存のコア定義を単純に適用するのが最も簡単です。コア定義には、レコード識別子となるプロパティ(例:オカレンスコアの場合は http://rs.tdwg.org/dwc/terms/occurrenceID、イベントコアの場合は GBIFシソーラススキーマに準拠する必要がある点のみ異なります。この場合も、link:https://rs.gbif.org/vocabulary/dwc/basis_of_record_2024-02-19.xml[ダーウィンコアタイプ語彙など、既存の語彙定義を適用するのが最も簡単です。
-
GBIFにコアを登録する
コアの定義がまだ変更されていない間に、GBIFサンドボックスレジストリに登録されます。コアを登録するには、こちらの手順で rs.gbif.org リポジトリにプルリクエストを行います。審査に通れば、https://rs.gbif.org/sandbox/core/ にマージされ、サンドボックスレジストリの拡張機能リストに含まれます。コア定義が確定すると、つまり、そのプロパティのセットが凍結されると、https://rs.gbif.org/core/ でホストされ、ライブレジストリの拡張機能リストに含まれます。コア以外の拡張機能や語彙を登録する場合も、同じプロセスが適用されます。
-
IPTを設定する
To configure the IPT to use the Material Sample Core for example, add the following 2 lines to
$IPT_DATA_DIR/config/ipt.properties
.上記のように、コロンがある場合は必ずエスケープしてください* ipt.core_rowTypes=http\://rs.tdwg.org/dwc/terms/MaterialSample ipt.core_idTerms=http\://rs.tdwg.org/dwc/terms/materialSampleID
これは、IPTがrowType http://rs.tdwg.org/dwc/terms/MaterialSample を持つすべての拡張をコアタイプとして認識し、その識別子の項として http://rs.tdwg.org/dwc/terms/materialSampleID を使用するように設定するものである。複数のコアを指定することができ、パイプ文字の
|
で区切ります。ipt.core_idTerms の最初のエントリが core_rowTypes の最初のエントリの ID となり、以下同様です。最後に、ipt.properties ファイルを保存して、Tomcat を再起動し、コアをインストールします。これでコアはIPTで使用できるようになりました。