diff --git a/docs/spec/base/admin/ADMIN_2_4.md b/docs/spec/base/admin/ADMIN_2_4.md
index 8088bbb3..f8db5af8 100644
--- a/docs/spec/base/admin/ADMIN_2_4.md
+++ b/docs/spec/base/admin/ADMIN_2_4.md
@@ -320,6 +320,7 @@
| .publish_status | .PUBLISH_STATUS | アイテムの公開/非公開を指定する。public/privateのいずれかを設定する。必須項目。 |
| .feedback_mail[0] | .FEEDBACK_MAIL[0] | フィードバックメールの送信先メールアドレスを指定する。複数指定可。 |
| .request_mail[0] | .REQUEST_MAIL[0] | リクエストメールの送信先メールアドレスを指定する。複数指定可。 |
+| .researchmap_linkage | .RESEAECHMAP_LINKAGE | Researchmapへの連携フラグ |
| .item_application.workflow | .ITEM_APPLICATION
.WORKFLOW | コンテンツファイルがない場合の利用申請のワークフローIDを指定する。 |
| .item_application.terms | .ITEM_APPLICATION.TERMS |コンテンツファイルがない場合の利用規約IDを指定する。この列のデータ行にterm_freeが入力された場合、利用規約を自由入力として.item_application.terms_descriptionが表示される。 |
| .item_application
.terms_description | .ITEM_APPLICATION
.TERMS_DESCRIPTION | コンテンツファイルがない場合の利用規約(自由入力)を指定する。 |
diff --git a/docs/spec/base/other/RESEARCHMAP_LINKAGE.md b/docs/spec/base/other/RESEARCHMAP_LINKAGE.md
new file mode 100644
index 00000000..4a88a117
--- /dev/null
+++ b/docs/spec/base/other/RESEARCHMAP_LINKAGE.md
@@ -0,0 +1,435 @@
+# API連携によるレコード追加機能
+
+## 目的・用途
+
+本機能は、WEKO3のシステム内で登録した公開状態のアイテムのレコードを、researchmapで提供されているAPIを利用してresearchmapの業績情報に追加するための機能である。この機能により、事前に利用機関毎にJSTが発行したAPIキーを使用して、API キーに紐づいた機関に所属する一般会員の業績情報の更新を行うことが出来る。
+
+## 利用方法
+celeryのタスクとして、researchmapへの業績情報の登録処理が実行される。
+定期的に(例:一日一回)、バッチ処理により実行される。
+
+## 利用可能なロール
+
+
| ロール | +システム +管理者 |
+リポジトリ +管理者 |
+コミュニティ +管理者 |
+登録ユーザー | +一般ユーザー | +ゲスト +(未ログイン) |
+
|---|---|---|---|---|---|---|
| 利用可否 | +× | +× | +× | +× | +× | +× | +
| パラメーター名 | +項目名 | +説明 | +
|---|---|---|
| check | +整合性チェックのみ行うかどうか | +パラメーター(GET)に「check」(または、check=1)を記載すると、入力チェックのみ実行され、その結果を確認できます。その場合、「一括更新結果確認」の API より確認します。check を指定しなくても入力チェックを行い、1 件でもエラーがあった場合、更新処理は行いません。 | +
| id | +一括更新 ID | +「check」パラメーターをつけ、入力チェックのみ行ったデータは、本 API のレスポンスより取得される +bulk_url を用いてインポートを実行できます。対象は、 check の API を実行し、その結果が確認できる状態であれば、実行できます。 |
+
| 項目名 | +アクション名 | +説明 | +
|---|---|---|
insert +(merge 指定) |
+ マージ +(追加・更新) |
+ 指定ドキュメントがない場合、新規登録。追加・更新を行おうとしている会員の業績リスト中に類似ドキュメントがあればエラーとなります。 | +
insert +(similar_merge指定) +priority=input_data |
+ 類似データマージ(入力データ優先) |
+ 「マージ」と基本的には同じですが、追加・更新を行おうとしている会員の業績リスト中に類似ドキュメントがあった場合、入力データ(または、入力データを指定ドキュメントとマージしたもの)を優先させ、類似ドキュメントをマージします。 +※ 業績情報のみ指定可能。 +※ 入力データの項目に存在しない項目のみ、類似ドキュメントの値を補完することになります。 +※ 類似業績とマージした際は、本人による登録であっても承認状態を「承認済-自動」とします(「却下」可能にするため)。 +※ 研究者、代理人ではsimilar_merge 指定はできません。 |
+
insert +(similar_merge指定) +priority=similar_data |
+ 類似データマージ(類似データ優先) |
+ 「マージ」と基本的には同じですが、追加・更新を行おうとしている会員の業績リスト中に類似ドキュメントがあった場合、類似ドキュメントを優先させ、入力データ(または、入力データを指定ドキュメントとマージしたもの)をマージします。 +※ 業績情報のみ指定可能。 +※ 類似ドキュメントの項目に存在しない項目のみ、入力データの値を補完することになります。 +※ 類似業績とマージした際は、本人による登録であっても承認状態を「承認済-自動」とします(「却下」可能にするため)。 |
+
insert(force 指定) |
+ 入力データ強制追加 | +「マージ」と基本的には同じですが、類似ドキュメントがあった場合でも、別業績として扱い強制的に新規登録を行います。ただし、類似ドキュメントが機関以外(本人相当)によって登録/更新されている場合は、追加することができません。 +※ 業績情報のみ指定可能。 +※ 多用すると、同じ会員リスト中に類似業績が増え続けます。通常の「merge」指定でエラーになり、類似業績と分けてどうしても登録したい場合のみご利用ください。 |
+
| パラメーター名 | +項目名 | +説明 | +
|---|---|---|
| id | +一括更新ID(必須) |
+ 「研究者情報、代理人情報一括更新」のレスポンスにて取得したID。 | +
| display_type | +成功 or 失敗のどちらのリストを表示するか |
+ success: 正常に登録されたリストを表示(or 正常にチェック終了になったもの) +error: エラーリストを表示 +デフォルト: error |
+
| next | +次ページを表示するかどうか |
+ 「next=xxx」指定。 +<インポート結果> +json の最終行の"no", "line"を「_」区切りで指定するとxxx 以降のデータが出力されます。例えば「next=1_30」であれば、1 ファイル目の 31 行目からの結果が表示されます。 +<API の更新結果> +行数: 指定した行数の続きからデータを取得します。 +"true": 前回取得した続きからデータを取得します。(next パラメーターを指定し、値を指定しない場合も、前回取得した続きからデータ取得します。) +前のページを取得したい場合は、再度、next を指定せず取得する必要があります(1 ページから再取得)。 +ただし、next パラメーターを利用せずに、ある一定期間過ぎますと、有効期限切れとなりエラーとなります。 |
+
| limit | +ページあたりの一括更新結果件数 |
+ デフォルト: 1000 件。最大:3000 件。 +※ 最大値をこえた指定をした場合、3000 として出力されます。 |
+