新 getentry の機能について
-
- 新 getentry では,アクセッション番号からの DDBJ フラットファイルの検索にご利用いただけます。
- 新 getentry は webAPI として実装しており,簡単な web フォームから利用するだけでなく,プログラムなどから直接呼び出すことが可能です。
- データの変更履歴 検索機能 が,webAPI プログラムの "gethistory" として新規に追加されました。
- 従来の getentry にあった "DDBJ フラットファイルのキーワード検索" は 新 ARSA で利用することが可能です。
入力フォームによる検索
WebAPI プログラムと URL
新 getentry の web API は以下の2つのプログラムからなります。
| getentry | アクセッション番号(データベース中のエントリの ID)を与えると,データを返します。 |
| gethistory (この機能は新設) |
アクセッション番号(データベース中のエントリの ID)を与えると,データの変更履歴を返します。 |
*特許庁由来アミノ酸配列の更新履歴は今のところとっておりません。
パラメータの指定方法
以下の2種類があります。
| 通常の GET method | http://getentry.ddbj.nig.ac.jp/getentry?database=データベース名&accession_number=アクセッション番号&追加のパラメーター(任意) |
| smart URL | http://getentry.ddbj.nig.ac.jp/getentry/データベース名/アクセッション番号
http://getentry.ddbj.nig.ac.jp/getentry/データベース名/アクセッション番号/?追加のパラメーター(任意) http://getentry.ddbj.nig.ac.jp/getentry/データベース名/アクセッション番号/リビジョン ID /?追加のパラメーター(任意) |
|
(例)
通常の GET method によるアクセッション番号 FW383979 の検索
http://getentry.ddbj.nig.ac.jp/getentry?database=ddbj&accession_number=FW383979
smart URL による特許庁由来アミノ酸配列 BD500001 の検索
http://getentry.ddbj.nig.ac.jp/getentry/patent_aa/BD500001
|
|
指定可能なパラメータについて
getentry
-
- accession 番号(必須): 検索対象の Accession 番号を指定します。
- database(任意): 検索対象のデータベースを指定します。
- revision(任意): 指定された revision 時点を検索します。
- format(任意): 結果の出力フォーマットを指定します。
- filetype(任意): 出力のファイルタイプを指定します。
- show_suppressed(任意): suppressed または replaced のデータを表示します。
- limit(任意): データの取得上限を設定します。
accession 番号(必須): 検索対象の Accession 番号を指定します。
| バージョン番号 |
ついていない場合は,最新バージョンを検索します。 ついている場合は,指定のバージョンを検索します。 |
| 複数 Accession 番号 |
|
| 範囲指定 |
範囲指定の両端の Accession 番号は前方のみの不完全でも構いません。 範囲指定も","区切りで複数指定できます。 範囲指定や複数指定ではバージョン番号を指定しても無視されます。 |
|
対象の Accession 番号が存在しない,または表示できない場合,該当の Accession 番号に対する結果は何も表示されず,limit で上限が制限されているときの数にもカウントされません。 デフォルトでの表示件数が10件に設定されているため,それ以上の件数を指定する場合には "limit" で設定を解除して下さい。 |
|
database(任意): 検索対象のデータベースを指定します。
| 指定なし | ddbj |
| DNA 系 | ddbj, wgs, mga |
| Protein 系 | uniprot, acc_dad, pid_dad, patent_aa, pdb |
|
ddbj (デフォルト)を指定すると,tpa のエントリも取得対象となります。 ※ DDBJ release に TPA は含まれておりません。 |
|
revision(任意): 指定された revision 時点を検索します。
| 通常 | yyyy-MM-dd hh:mm:ss |
| リリース時 | yyyy-MM-dd hh:mm:ss release |
| バージョン番号と revision が同時に指定されているとき,revision が優先さます。 | |
format(任意): 結果の出力フォーマットを指定します。
| 指定なし | flatfile |
| flatfile | 平文で出力します |
| xml | XML 形式に変換して出力します |
| fasta | [DNA 系] 全塩基配列 FASTA |
| [Protein 系] アミノ酸配列 FASTA | |
| trans | [DNA 系] CDS アミノ酸 FASTA |
| cds | [DNA 系] CDS 塩基配列 FASTA |
| [DAD 限定] 塩基配列 FASTA (for DAD) |
MAEEVEEERLKYLDFVRAAGVYAVDSFSTLYLYAKDISGPLKPGVDTIENVVKTVVTPVY
YIPLEAVKFVDKTVDVSVTSLDGVVPPVIKQVSAQTYSVAQDAPRIVLDVASSVFNTGVQ
EGAKALYANLEPKAEQYAVITWRALNKLPLVPQVANVVVPTAVYFSEKYNDVVRGTTEQG
YRVSSYLPLLPTEKITKVFGDEAS
aagacttcctggaagaggtcccagcgtgagtgtcgcttctggcatctgtccttctggcca
gcctgtggtctggccaagtgatgtaaccctcctctccagcctgtgcacaggcagcctggg
aacagctccatccccacccctcagctataaatagggcmtygtgacccggccrggggaaga
agctgcygttgttctgggtactacagcagaagggtatgcrgaagcsagcaccccagtctg
agatggctcctgccggtgtgagcctgagggccaccatcctctgcctcctggcctgggctg
gcctggctgcaggtgaccgggtgtacatacaccccttccacytcgtcatccacaatgaga
gtaccygtgagyagctggcaaaggccaatgccgggaagcccaaagaccccaccttcatac
ctgctccaattcaggccaagacatcccctgtggatgaaaaggccctacaggaccagctgg
filetype(任意): 出力のファイルタイプを指定します。
| 指定なし | text |
| html | HTMLファイル |
| text | テキストファイル |
| gz | gz圧縮ファイル |
|
gz圧縮ファイルのファイル名はformatの指定値によって以下のようになります。 [DNA系]flatfile flatfile.txt.gz [DNA系]xml insd.xml.gz [DNA系]fasta fasta_na.txt.gz [DNA系]trans cds_aa.txt.gz [DNA系]cds cds_na.txt.gz [Protein系]flatfile flatfile.txt.gz [Protein系]fasta fasta_aa.txt.gz [Protein系]cds cds_na.txt.gz |
|
パソコン上に上記のような画面が表示されます。
show_suppressed (任意): suppressed データを表示します。
| true | suppressed データを表示 |
| 指定なし | 10件 |
| 0以下の数字を指定 | 無制限 |
件数が多い場合,表示に時間がかかる場合があります。また,ブラウザの性能により,全件表示できない場合があります。
gethistory
-
- accession 番号(必須):検索対象のAccession番号を指定します。
- database(任意): 検索対象のデータベースを指定します。
- revision(任意): 指定されたrevision時点を検索します。
- filetype(任意): 出力のファイルタイプを指定します。
accession 番号(必須):検索対象のAccession番号を指定します。
指定方法は getentry と同じです。
2012-02-24 07:17:46 1 2012-02-24 07:17:46 live ff/DDBJ/daily/ddbj/ddbjnew/rel.88/DDBJNEWr88.087.dat.gz
2011-11-25 11:27:22 release 1 2011-11-25 11:27:22 release live ff/DDBJ/release/rel.88/ddbjvrl1.seq.gz
特許庁由来アミノ酸配列の履歴はありません
database(任意):検索対象のデータベースを指定します。
| 指定なし | ddbj |
| DNA 系 | ddbj, wgs |
指定したデータベースが履歴管理に対応していない場合は,空の結果を返します。
| 指定なし | "state" になります |
| revision | 「通常」の履歴情報 |
| state | 「詳細表示」 |
2012-02-24 07:17:46 1 live ff/DDBJ/daily/ddbj/ddbjnew/rel.88/DDBJNEWr88.087.dat.gz
2011-11-25 11:27:22 release 1 live ff/DDBJ/release/rel.88/ddbjvrl1.seq.gz
filetype(任意): 出力のファイルタイプを指定します。
| 指定なし | text |
| html | HTMLファイル |
| text | テキストファイル |
DDBJ エントリへのリンク設定方法
DDBJ の個々のエントリに対して,以下の方法でリンクを設定することができます。
例えば,アクセッション番号が AB000001 であるエントリに対する URL は
アクセッション番号が BD500001 である特許庁由来アミノ酸配列のエントリに対する URL は,
です。これを指定すると,該当のエントリが表示されます。試しに次のアクセッション番号をクリックしてみて下さい。
DRA へのリンク設定方法は,上記の方法とは異なりますので,DRA のホームページをご参照下さい。
ご自身のホームページを作成される場合に,この URL をご活用下さい。
2012.3.16