Researchmap利用者マニュアル/機関担当者用/登録、更新/研究者・業績・代理人インポートのソースを表示

<!--== '''研究者・業績・代理人インポート画面で行う研究者情報の更新'''==-->
== '''研究者・業績・代理人インポート'''==
<div style="font-size:large; margin-bottom:15px; text-decoration-line: underline;">「研究者・業績・代理人インポート」は、データ交換担当者IDにて操作することができます。</div>
<big>自機関を主所属として登録している研究者情報、代理人情報を一括で登録・更新・削除することができます。</big><br>
<div style="font-size:large; margin-bottom:10px;">※インポートファイルのフォーマットは、JSON、CSVに対応しています。<br>
　インポートファイルの仕様は、[https://researchmap.jp/public/other-document/specification 仕様書類]のページを参照してください。</div>
<div style="font-size:large; margin-bottom:15px;">※各業績を更新する場合には、<u>業績IDを指定して更新する方法を推奨</u>しています。</div>

<div style="font-size:large; margin-left:30px; margin-bottom:10;x">参照：[https://researchmap.jp/public/organ/data_linkage データ連携]、[https://researchmap.jp/outline/v2api/v2API.pdf API設計書]、[https://researchmap.jp/outline/v2api/v2CSV.pdf CSV項目定義書]</div>


<big>インポートできる情報は、以下の通りです。</big><br>
<big>◎対象の研究者・代理人</big><br>
<div style="margin-top:10px; margin-left:30px;"><big>自機関を主所属として登録している研究者およびその代理人との紐付け情報</big></div><br>

<big>◎インポートで登録・更新・削除が可能な研究者情報</big>
<div style="margin-left:30px;">
<div style="margin-top:10px;">＜研究者の「所属機関事務担当者」に対する権限設定画面＞</div>
[[ファイル:機関インポート1.gif|link=]]
<div style="margin-top:15px;">＜取得可能な範囲＞</div>
[[ファイル:機関インポート2.gif|link=]]
<br><br>

<span style="width: 22px;height: 22px; background-color:#00B285; border-radius: 50%; margin: 5px; auto;text-align:center;line-height: 22px;color:#FFFFFF; display: inline-block;">３</span>自動的に反映する：インポート後、更新した内容がそのまま公開されます<br>　　反映する前に本人が確認する：インポート後、研究者本人が承認すると公開されます<br>
<div style="font-size:large; margin-top:20px; margin-left:10px;">参照：[[Researchmap利用者マニュアル/研究者用/マイポータル/研究者情報/研究者情報の編集等に関わる権限設定#●_代理人による編集|研究者情報の編集等に関わる権限設定]]</div>
</div>
<br>

<div style="font-size:large; margin-bottom:15px;">上記以外に、インポートで更新可能なデータについての制限事項、インポートデータの作成についての注意事項がありますので、[https://researchmap.jp/public/organ/data_linkage データ連携]のページを合わせてご覧ください。</div>
<br><br>

== '''画面の操作'''==
<table class="photobox2">
<tr>
<th>[[ファイル:機関インポート3.gif|左|link=]]</th>
<td><big>データ交換担当者IDでログインすると、左メニューに「研究者・業績・代理人インポート」が表示されます。</big><br><br>
<big>&#10102; をクリックします。</big></td>
</tr>
</table>

<table class="photobox2">
<tr>
<th>[[ファイル:機関インポート4.gif|左|link=]]</th>
<td><big>&#10103; 「インポート」をクリックします。</big></td>
</tr>
</table>

<table class="photobox2">
<tr>
<th>[[ファイル:機関インポート5.gif|左|link=]]</th>
<td><big>インポートの前に整合性チェックを行い、入力データの書式チェックや既登録データとの整合性をチェックします。エラーが発生するとインポートは行われません。</big><br><br>
<big>&#10104; 整合性チェックを行うファイルを選択します。<br><br>
&#10105; 整合性チェック完了後にそのままresearchmapを更新する場合にチェックをしてください。<br><br>
&#10106; 「整合性チェック」をクリックします。</big></td>
</tr>
</table>

<table class="photobox2">
<tr>
<th>[[ファイル:機関インポート6.gif|左|link=]]</th>
<td><big>&#10107; 「更新」をクリックすることで進捗状況が更新されます。一覧の「状態」が「チェック完了」もしくは「完了」になったら結果を確認することができます。<br><br>
&#10108; 「チェック結果確認」をクリックすると＜インポートチェック結果画面＞が表示され、整合性チェックの結果を確認することができます。<br><br>
&#10109; 状態が「完了」になると、「インポート結果確認」クリックでインポート結果を確認することができます。</big></td>
</tr>
</table>

<table class="photobox2">
<tr>
<th>[[ファイル:機関インポート7.gif|左|link=]]</th>
<td><big>＜インポートチェック結果画面＞では、整合性チェックの結果を確認することができます。<br>各業績種別のタブをクリックすると、それぞれの結果を確認することができます。<br><br>
&#10110; 一覧に水色の「ｉ」アイコンが表示されている場合は、カーソルを当てるとメッセージが表示されます。</big><br>※エラーではないが更新できなかった場合に、その理由が表示されます。<br><br>
<big>&#10111; エラーが無くなると「インポート」ボタンが表示されます。クリックするとresearchmapの更新を実施します。</big></td>
</tr>
</table>

<table class="photobox2">
<tr>
<th>[[ファイル:機関インポート8.gif|左|link=]]</th>
<td><big>＜インポート結果確認画面＞では、researchmapへの更新結果を確認することができます。<br>各業績種別のタブをクリックすると、それぞれの結果を確認することができます。<br><br>エラーが無ければ、インポートは正常に終了しています。</big></td>
</tr>
</table>

== '''エラーが起きた場合'''==
<div style="font-size:large; margin-bottom:15px;">エラーが起きた場合、画面に表示されたメッセージやエラーリストを参照してエラーを解決してください。対処方法については、[https://researchmap.jp/outline/v2api/v2API.pdf API設計書]をご確認ください。<br>
各項目のバリデーションチェックの詳細についても[https://researchmap.jp/outline/v2api/v2API.pdf API設計書]をご確認ください。
</div>
<br>
<div style="font-size:large; margin-bottom:5px;">● ファイルアップロード時のエラー</div>
<table class="photobox2">
<tr>
<th>[[ファイル:機関インポート9.gif|左|link=]]</th>
<td><span style="font-size:x-large;">&#9451; </span><big>アップロードファイルが何らかの理由で取り込みできなかった場合は、画面上部にエラーメッセージが表示されます。以下をご確認ください。</big><br><br>
<big>'''インポートファイルの形式'''</big><br>
{| class="wikitable"
|-
! フォーマット !! JSON、CSV
|-
! 文字コード !! UTF-8
|-
! 許容する拡張子 !! json, jsonl, csv, zip
|-
! 1回のファイルサイズ !! 圧縮時、非圧縮時どちらの場合も最大10MBまで　
|}
</td>
</tr>
</table>

<div style="font-size:large; margin-bottom:5px;">● インポートファイルのエラー</div>
<table class="photobox2">
<tr>
<th>[[ファイル:機関インポート10.gif|左|link=]]</th>
<td><span style="font-size:x-large;">&#9452; </span><big>インポートファイルのフォーマットのエラー等で取り込めなかった場合は、「エラー内容」に理由が表示されますのでご確認ください。</big><br><br>
JSONフォーマットについては[https://researchmap.jp/outline/v2api/v2API.pdf API設計書]を、CSVフォーマットについては[https://researchmap.jp/outline/v2api/v2CSV.pdf CSV項目定義書]をご確認ください。
</td>
</tr>
</table>

<div style="font-size:large; margin-bottom:5px;">● 整合性チェックのエラー</div>
<table class="photobox2">
<tr>
<th>[[ファイル:機関インポート11.gif|左|link=]]</th>
<td><span style="font-size:x-large;">&#9453; </span><big>整合性チェックの結果エラーがあると、インポートが行われません。「エラーリストのダウンロード」からエラーリストをダウンロードして、適宜内容を修正し、整合性チェックを実施してください。</big><br><br>
各項目のチェック内容や、その対処方法については、[https://researchmap.jp/outline/v2api/v2API.pdf API設計書]をご確認ください。<br><br>
</td>
</tr>
</table>

<div style="font-size:large; margin-bottom:5px;">● インポート時のエラー</div>
<table class="photobox2">
<tr>
<th>[[ファイル:機関インポート12.gif|左|link=]]</th>
<td><span style="font-size:x-large;">&#9454; </span><big>整合性チェックでエラーが無い場合でも、インポートでエラーになることがあります。<br>1回のインポート操作で同じ業績IDのデータを複数回更新するなど、Conflictエラー（エラーコード：409）が起きた場合が該当します。この場合、エラーが発生したデータ以外は更新がされています。<br><br>
<span style="font-size:x-large;">&#9455; </span><big>Conflictエラーが起きた場合には1件目のデータで更新され、同一データを2回目以降に更新しようとしてエラーになります。「エラーリストのダウンロード」からエラーリストをダウンロードして、インポートファイルに重複データが無いかご確認ください。</big><br><br>
※業績IDを指定しない一括更新では、researchmapの類似チェックにより既登録データのより類似しているデータを探して更新しますが、異なるデータを類似と判定する可能性があるため、[https://researchmap.jp/public/organ/data_linkage#notes 業績IDを指定して更新する方法]を推奨しています。
</td>
</tr>
</table>