|
| 項目 | 必須区分 | パラメータ | 値 | 内容 | 備考 |
| 検索条件結合 | 任意 | query_logic | int | 1 ： AND条件で結ぶ 2 ： OR条件で結ぶ |
queryで複数条件が指定された場合の項目間の結合パターンを指定 指定がない場合はデフォルト値「1」を補完する。 |
| 検索条件 | 何れか必須 | query | string （UTF-8でURLエンコード） |
（通常検索 / NOT検索） 00_ / 00not_ ： 管理番号 01_ / 01not_ ： 質問 02_ / 02not_ ： 回答 03_ / 03not_ ： キーワード 04_ / 04not_ ： 参考資料 05_ / 05not_ ： 回答プロセス 06_ / 06not_ ： 照会先 07_ / 07not_ ： 事前調査事項 08_ / 08not_ ： 寄与者 09_ / 09not_ ： 備考 10_ / 10not_ ： 提供館名 |
検索項目に管理番号が指定された場合のみ前方一致で、それ以外は中間一致で検索する。 検索項目は最大5つまでセパレータ『.』(半角ピリオド)で連結可能とする。 また、項目内の条件はスペース区切り（AND条件）、またはカンマ区切り（OR条件）で5個まで指定可能とする。 ※区切り文字のスペースとカンマは全角、半角の区別をしない |
| NDC | NDC | 値の先頭に『not_』が設定されていた場合は、Not検索として扱う。 | 前方一致で検索する。 セパレータ『.』（半角ピリオド）で最大3つまで指定可能とする。 |
||
| 登録番号 | SYS-ID | 完全一致で検索する。 | |||
| 提供館コード | LIB-ID | 値の先頭に『not_』が設定されていた場合は、Not検索として扱う。 | 完全一致で検索する。 | ||
| 事例作成日FROM | CRT-DATE_from | YYYYMMDD | |||
| 事例作成日TO | CRT-DATE_to | YYYYMMDD | |||
| 登録日FROM | REG-DATE_from | YYYYMMDD | |||
| 登録日TO | REG-DATE_to | YYYYMMDD | |||
| 最終更新日FROM | LST-DATE_from | YYYYMMDD | |||
| 最終更新日TO | LST-DATE_to | YYYYMMDD | |||
| 検索対象 | 任意 | LIB-GROUP | int | 0 ： 全館 1 ： NDL 2 ： 公共図書館 3 ： 大学図書館等 4 ： 専門図書館 5 ： アーカイブズ |
指定がない場合はデフォルト値「0」を補完する。 |
| 解決／未解決 | 任意 | SOLUTION | int | 0 ： 解決 1 ： 未解決 2 ： 解決／未解決 |
「2」は解決または未解決の情報が登録されているデータのみを検索する。 |
| 調査種別 | 任意 | RES-TYPE | string （UTF-8でURLエンコード） |
中間一致で検索する。 | |
| 内容種別 | 任意 | CON-TYPE | string （UTF-8でURLエンコード） |
中間一致で検索する。 | |
| 質問者区分 | 任意 | PTN-TYPE | string （UTF-8でURLエンコード） |
中間一致で検索する。 | |
| 検索結果取得位置 | 任意 | results_get_position | int | 指定がない場合はデフォルト値「1」を補完する。 | |
| 検索結果返却件数 | 任意 | results_num | int | 指定がない場合はデフォルト値「200」を補完する。 | |
| ソート条件 | 任意 | sort | int | 10 ： 最終更新日時による降順 11 ： 最終更新日時による昇順 20 ： 事例作成日による降順 21 ： 事例作成日による昇順 30 ： 管理番号による降順 31 ： 管理番号による昇順 40 ： 登録番号による降順 41 ： 登録番号による昇順 50 ： 被参照数による降順 51 ： 被参照数による昇順 |
指定がない場合はデフォルト値「10」を補完する。 |
| 項目名 | レファ協システムDB レファレンス事例テーブル 項目名 |
タグ名 | 項目説明 | |||
| 第1階層 | 第2階層 | 第3階層 | 4階層 | |||
| 返却結果ルートノード | （対応なし） | result_set | 【XML親要素】要素内容はなし。 | |||
| ヒット数 | （対応なし） | hit_num | リクエストされた検索条件に該当する事例数（ヒット数） | |||
| 検索開始位置 | （対応なし） | results_get_position | 検索開始位置。 ・リクエストで指定されたresults_get_positionの値と同一の値を出力 ・リクエストで指定されなかった場合は1(デフォルト：先頭位置から検索開始)を出力 | |||
| 検索結果返却件数 | （対応なし） | results_num | ||||
| 処理コード | （対応なし） | results_cd | 処理コードと、エラー内容によってはエラー位置 例：0301(2) |
|||
| 返却結果フィールド | （対応なし） | result | 要素内容はなし。検索結果が複数件になる場合、『result』タグが結果件数分表示される『QUESTION』『REG-ID』『ANSWER』『CRT-DATE』『SOLUTION』『KEYWORD』『NDC』『NDC-NOTE』『RES-TYPE』『CON-TYPE』『BIBL』『ANS-PROC』『REFERRAL』『PRE-RES』『NOTE』『PTN-TYPE』『CONTRI』『REG-DATE』『LST-DATE』『SYS-ID』『LIB-ID』『LIB-NAME』『URL』『IMAGE』『position』の親要素 | |||
| 質問 | 質問 | QUESTION | ||||
| 管理番号 | 管理番号 | REG-ID | ||||
| 回答 | 回答 | ANSWER | ||||
| 事例作成日 | 事例作成日(表示用) | CRT-DATE | ||||
| 解決/未解決 | 解決/未解決 | SOLUTION | 「解決」「未解決」の文字列を出力 | |||
| キーワード | キーワード | KEYWORD | ※登録数分タグ出力される | |||
| NDC | NDC | NDC | ※登録数分タグ出力される | |||
| NDCデコード値 | NDC | NDC-NOTE | NDCデコード値(NDC：NDC版) 例）経書(123：9版) 経書(123) ・NDC版のみで、NDCが登録されていないデータは出力しない。 ・版がない場合は「NDCデコード値(NDC)」と出力する。 ・定義されていないNDCコードが登録されており、かつ版がある場合は、「(NDC：NDC版)」と出力する。 ・定義されていないNDCコードが登録されており、かつ版がない場合は、「(NDC)」と出力する。 ・7版、8版、9版の場合も10版のデコード値を出力する。 ※登録数分タグ出力される。 |
|||
| 調査種別 | 調査種別 | RES-TYPE | ||||
| 内容種別 | 内容種別 | CON-TYPE | ||||
| 参考資料 | 参考資料－書誌的事項 参考資料－ISBN 参考資料－備考 |
BIBL | 出力形式は下記に従う。 ・書誌的事項が記載されており、備考が記載されている →『書誌的事項 （備考） 』を出力 ・書誌的事項が記載されており、備考が記載されていない →『書誌的事項』を出力 ・書誌的事項が記載されておらず、備考が記載されている →『(備考)』を出力 ※登録数分タグ出力される |
|||
| 回答プロセス | 回答プロセス | ANS-PROC | ||||
| 照会先 | 照会先 | REFERRAL | ※登録数分タグ出力される | |||
| 事前調査事項 | 事前調査事項 | PRE-RES | ||||
| 備考 | 備考 | NOTE | ||||
| 質問者区分 | 質問者区分 | PTN-TYPE | ||||
| 寄与者 | 寄与者 | CONTRI | ※登録数分タグ出力される | |||
| 登録日時 | 登録日時 | REG-DATE | ||||
| 最終更新日時 | 更新日時 | LST-DATE | ||||
| 登録番号 | システムID（登録番号） | SYS-ID | ||||
| 提供館コード | 図書館コード※ | LIB-ID | ||||
| 提供館名 | 図書館名（正式）※ | LIB-NAME | ||||
| URL | （対応なし） | URL | 一般公開用詳細表示画面のURL | |||
| 関連ファイル | （対応なし） | IMAGE | 関連画像の有無 関連画像の登録がある場合は登録数問わず「有」、 登録がない場合は「無」という文字列を出力する |
|||
| 連番 | （対応なし） | position | results_get_position（検索開始位置）からの相対的な位置（OFFSET） 。0から順に採番(0、1、2．．．)『results_get_position（検索開始位置） + position（連番）』の値が、検索結果全体から見たデータ位置を表す。 | |||
| コード | 説明 |
| 0001 | 正常終了 |
| 0101 | 検索必須項目不正 （必須項目未設定でのリクエスト） |
| 0102 | リクエストエラー（query_logicパラメータが複数指定された） 例） ・・・?query_logic=1&query_logic=1&・・・ |
| 0103 | リクエストエラー（queryパラメータが複数指定された） |
| 0104 | リクエストエラー（NDCパラメータが複数指定された） |
| 0105 | リクエストエラー（SYS-IDパラメータが複数指定された） |
| 0106 | リクエストエラー（LIB-IDパラメータが複数指定された） |
| 0107 | リクエストエラー（CRT-DATE_fromパラメータが複数指定された） |
| 0108 | リクエストエラー（CRT-DATE_toパラメータが複数指定された） |
| 0109 | リクエストエラー（REG-DATE_fromパラメータが複数指定された） |
| 0110 | リクエストエラー（REG-DATE_toパラメータが複数指定された） |
| 0111 | リクエストエラー（LST-DATE_fromパラメータが複数指定された） |
| 0112 | リクエストエラー（LST-DATE_toパラメータが複数指定された） |
| 0113 | リクエストエラー（LIB-GROUPパラメータが複数指定された） |
| 0114 | リクエストエラー（SOLUTIONパラメータが複数指定された） |
| 0115 | リクエストエラー（CON-TYPEパラメータが複数指定された） |
| 0116 | リクエストエラー（RES-TYPEパラメータが複数指定された） |
| 0117 | リクエストエラー（PTN-TYPEパラメータが複数指定された） |
| 0118 | リクエストエラー（results_get_positionパラメータが複数指定された） |
| 0119 | リクエストエラー（results_numパラメータが複数指定された） |
| 0120 | リクエストエラー（sortパラメータが複数指定された） |
| 0201 | query_logic指定不正 (1 or 2 以外が指定された) |
| 0301 | query書式不正 (検索範囲指定不正) |
| 0302 | query書式不正 (6つ以上の項目内AND・OR) |
| 0303 | query書式不正 (6つ以上の検索条件が『.』で連結されている) |
| 0401 | NDC指定不正 (4桁以上で入力された) |
| 0402 | NDC指定不正 (NOT検索時の先頭『not_』以外の位置に数字以外が入力された) |
| 0403 | NDC指定不正 (4つ以上のNDCが『.』で連結されている) |
| 0501 | SYS-ID指定不正 (数字以外が入力された) |
| 0601 | LIB-ID指定不正 (NOT検索時の先頭『not_』以外の位置に、数字以外が入力された) |
| 0701 | CRT-DATE_from指定不正 （数字以外が入力された） |
| 0702 | CRT-DATE_from指定不正 （入力が8文字以外） |
| 0703 | CRT-DATE_to指定不正 （数字以外が入力された） |
| 0704 | CRT-DATE_to指定不正 （入力が8文字以外） |
| 0705 | CRT-DATE_from、CRT-DATE_to指定不正 (TOがFROMより過去) |
| 0706 | CRT-DATE_from指定不正 （存在しない日付が指定された 20091301,20090135 等） |
| 0707 | CRT-DATE_to指定不正 （存在しない日付が指定された 20091301,20090135 等） |
| 0801 | REG-DATE_from指定不正 （数字以外が入力された） |
| 0802 | REG-DATE_from指定不正 （入力が8文字以外） |
| 0803 | REG-DATE_to指定不正 （数字以外が入力された） |
| 0804 | REG-DATE_to指定不正 （入力が8文字以外） |
| 0805 | REG-DATE_from、REG-DATE_to指定不正 (TOがFROMより過去) |
| 0806 | REG-DATE_from指定不正 （存在しない日付が指定された 20091301,20090135 等） |
| 0807 | REG-DATE_to指定不正 （存在しない日付が指定された 20091301,20090135 等） |
| 0901 | LST-DATE_from指定不正 （数字以外が入力された） |
| 0902 | LST-DATE_from指定不正 （入力が8文字以外） |
| 0903 | LST-DATE_to指定不正 （数字以外が入力された） |
| 0904 | LST-DATE_to指定不正 （入力が8文字以外） |
| 0905 | LST-DATE_from、REG-DATE_to指定不正 (TOがFROMより過去) |
| 0906 | LST-DATE_from指定不正 （存在しない日付が指定された 20091301,20090135 等） |
| 0907 | LST-DATE_to指定不正 （存在しない日付が指定された 20091301,20090135 等） |
| 1001 | LIB-GROUP 0 or 1 or 2 or 3 or 4 or 5 以外の数字・文字が入力された |
| 1101 | SOLUTION 0 or 1 or 2 以外の数字・文字が入力された |
| 1201 | results_get_position 数字以外が入力された |
| 1202 | results_get_position 整数型最大長エラー (int型の最大値2147483647より大きい値が指定された) |
| 1203 | results_get_position 0が指定された |
| 1301 | results_num 数字以外が入力された |
| 1302 | results_num 整数型最大長エラー (int型の最大値2147483647より大きい値が指定された) |
| 1401 | sort 規定されているパターン(10,11,20,21,30,31,40,41,50,51) 以外が指定された |
| 9901 | DB接続不正 （DB接続に失敗した） |
| 9902 | 内部例外発生 |
| 9903 | GETメソッド以外でリクエストが送信された |
| リクエストパラメータ | 概要 |
| results_get_position | 検索結果の取得開始位置 |
| results_num | 検索結果返却件数 |
| レスポンスフィールド | 概要 |
| hit_num | リクエストされた検索条件に該当する事例数（ヒット数） |
| results_get_position | 検索結果の取得開始位置(リクエストパラメータの入力内容と同一値を出力) |
| results_num | 検索結果返却件数 ※検索によって得られたデータ数。 リクエストパラメータresults_numで指定された件数が取得できない場合は、取得できる最大数を出力（下図・例２参照）。 |
| position | results_get_positionからの相対的な位置（OFFSET） 0から順に採番(0、1、2．．．) 『results_get_position + position』の値が、検索結果全体から見たデータ位置を表す。 |
