「JAIRO Cloud」を編集中

{{DISPLAYTITLE:JAIRO Cloud (WEKO3) 非公式まとめ}}

このページでは、JAIRO Cloud (WEKO3) の使い方に関する情報を非公式にまとめています。

* '''このページは有志により作成されています。NIIが作成しているものではありません。公式の情報は、[https://jpcoar.repo.nii.ac.jp/page/42 JAIRO CloudのWebサイト]をごらんください。'''
* '''このページの情報は、有用であることを期待して掲載されていますが、内容について不正確であったり、古くなっていたりする場合があります。操作の実行は、ご自身の責任で行ってください。'''<br>

== 運用事例集 ==

[[JARIO_Cloud/case_studies|JAIRO Cloudの自動化・効率化、その他「こうやって運用している」例を集めています。]]

== 関連サイト ==

* [https://meatwiki.nii.ac.jp/confluence/pages/viewpage.action?pageId=63868507 基本マニュアル (NII)]
** [https://meatwiki.nii.ac.jp/confluence/pages/viewpage.action?pageId=63868534 用語集]
* [https://meatwiki.nii.ac.jp/confluence/pages/viewpage.action?pageId=63875565 リリースノート (NII)] 最新の課題リスト（＝解決されていない障害）もここにあります。
** [https://meatwiki.nii.ac.jp/confluence/pages/viewpage.action?pageId=118166862 アイテムマッピング資料 (NII)]
* [https://www.youtube.com/playlist?list=PLZdRLSdt3sbg58n634Dd03D1k5RRuUr6R 操作説明会の動画 (JPCOAR)]
* [https://jpcoar.repo.nii.ac.jp/page/155 ユーザーサポート用メーリングリスト (JPCOAR)]
** アーカイブのURLは非公開。メーリングリストのメール本文の末尾を参照
* [https://www.magazine.jpcoar.org/news/924a1752-dffd-46e9-8417-9fe2e81ba3c9 JAIRO Cloud（WEKO3）ビギナーQ&A ～リポジトリ登録で困った時は～ (JPCOAR)]

== 便利なツール ==

* [https://github.com/maedaak/WEKO3_simple_loader/tree/main WEKO3 simple loader]
** TSVファイルから一括登録用のファイルを作成するツール

* アイテムを100件ずつエクスポートする画面にすぐ移動するためのブックマークレット
** WEKO3で1度にエクスポートにできる件数は100件が上限なので、それを一度に表示・選択できるようにつくりました
** 使用する為の手順は以下の通りです
# 以下のコードをコピーして、ブックマークに登録し、ブックマークレットを作成する
# WEKO3にアクセスして、適当なインデックスや検索結果を表示する
# その画面のまま、ブックマークから先ほど登録したブックマークレットをクリックする
# 1ページ100件表示のエクスポートページに移動する
 javascript:(function(){url=document.location.href;if(url.match(/^https:\/\/.+\/[^\/]+\?.+$/)){var b=url.match(/^https:\/\/[^\/]+\//),a=url.match(/[^\/]+\?.+$/);a=a[0].replace(/^[^\/]+\?/,"");a=a.replace(/size=\d+/,"size=100");a=a.replace(/page=\d+/,"page=1");location.href=b+"items/export?"+a}})();

* VScode
** TSVファイルの確認や簡単な編集に使っています。
** csv,tsv用の拡張機能を入れると便利です。[https://qiita.com/%20whitecat%2022/items/63cc60228853d97edb06 CSV/JSONを扱う際にオススメのVSCode拡張機能(Qiita)]もご参考としてください。

* [https://mfactory.me/ gPad]
** TSVをExcel"風"に表示できるテキストエディタ<br>メタデータの中身を確認したいとかごく単純な変更がある、という場合にExcelに貼り付けずに＝値の勝手な置換をさせずに作業できる<br>多機能なVScodeと見やすさのgPad。お好みで

== 質問集 ==

=== メタデータの編集 ===

==== 新しいメタデータ項目を追加したい ====

(TBD)

==== サムネイル画像を追加したい ====
 
* 「ファイル」としてサムネイル画像を登録します。
** [https://meatwiki.nii.ac.jp/confluence/pages/viewpage.action?pageId=63868509#id-%E3%82%A2%E3%82%A4%E3%83%86%E3%83%A0%E5%80%8B%E5%88%A5%E7%99%BB%E9%8C%B2-3%EF%BC%8E2%EF%BC%8E%E3%83%A1%E3%82%BF%E3%83%87%E3%83%BC%E3%82%BF%E5%85%A5%E5%8A%9B JAIRO Cloud（WEKO3）基本マニュアル]にある「サムネイル登録」はまだ利用できないようです。
* 「ファイル情報」-「本文URL」から「オブジェクトタイプ」に「thumbnail」を指定します。これで　objectType="thumbnail" の画像が登録されます。

==== DOIを自由に設定したい ====

* 「[https://meatwiki.nii.ac.jp/confluence/pages/viewpage.action?pageId=63868509 アイテム個別登録]」から登録した場合は、DOIは {機関のPrefix}/{WEKO3のアイテムID} で自動設定されます。変更はできません。
* Prefixは、JAIRO Cloudの利用申請時に「JaLC準会員登録」を申請し、承認された際の通知にあるPrefixのみ利用できます。
* Suffixを自由に設定したい場合は、[https://meatwiki.nii.ac.jp/confluence/pages/viewpage.action?pageId=63868511 アイテム一括登録（インポート）]で登録する必要があります。なお、DOIのSuffixは半角英数字、半角記号「_-.;()/」以外使用できません。

==== 漢字文化圏の「著者名」の「言語」選択に迷う ====
著者（作成者、寄与者etc.）の言語は、国籍ではなく、どの言語で名前を表記しているかで選択します。日本語でも外国語（主に繁体字）でも漢字での表記が変わらない事もありますが、その場合は本文言語や掲載媒体で主に使用されている言語などから判断する必要があります。

例：森鴎外（日本人）<br>
森, 鴎外→ja<br>
Mori, Ogai→en<br>
森, 鸥外→zh-cn

=== メタデータの表示 ===
==== ページの言語を日本語から英語に切り替えると、追加したアイテムがインデックスに表示されない ====

* 表示されていない英語版のインデックスを「空更新」すると表示されるようになります。手順は以下の通りです。
# トップページで言語を「English」に変更する。
# Administration > Index Tree > Edit Tree を開き、問題が発生しているインデックスを開く
# 値を変更せずに「Send」ボタンをクリックする。
# トップページで言語を「日本語」に変更して、同様に日本語版のインデックスを空更新する
* [https://meatwiki.nii.ac.jp/confluence/pages/viewpage.action?pageId=132712032 最新の課題リスト]の#170、「インデックス情報のキャッシュが表示言語のみ保存される」に該当します。

==== 英語ページ・日本語ページに直接移動するURLを作成したい ====
* 「[トップページURL]/lang/<lang_code>」URLで、言語を指定してトップページに遷移できます。
** <lang_code>に指定できるのはja・enのみです。
 （例）https://jpcoar.repo.nii.ac.jp/lang/en
* 「 [トップページURL]/lang/<lang_code>?next=<リダイレクト先のパス> 」を設定することで、直接指定した言語のページへ遷移できます。
** 元のURLにリクエストパラメータが含まれる場合はURLエンコードが必要です。
 （例）https://jpcoar.repo.nii.ac.jp/page/46?page=1&size=20&sort=controlnumber の英語ページへのURLの場合
 　　　https://jpcoar.repo.nii.ac.jp/lang/en?next=/page%2F46%3Fpage%3D1%26size%3D20%26sort%3Dcontrolnumber

==== ファイルの名称（リンク）を任意の名称で表示したい ====
* 表示されるファイル名称は「ファイル情報＞ラベル」で変更可能。

==== ファイルのアイコンがPDFではなく、フォルダで表示されてしまう ====
* 表示されるアイコンは「ファイル情報＞本文URL＞フォーマット」に依存する。
** 「application/pdf」の場合はPDFアイコン
** 「application/vnd.openxmlformats-officedocument.spreadsheetml.sheet」でExcelのアイコン
** 空白の場合はフォルダアイコン

=== ワークフロー ===
==== ワークフローの新規作成で、表示されないアイテムタイプがある ====
* 新規に作成したアイテムタイプは、ワークフローを新規に追加して紐付けする必要があります。「ワークフロー管理」の「ワークフロー」、「＋Create WorkFlow」から新規にワークフローを作成して、新しいアイテムタイプを指定しておいてください。

=== マッピングの編集 ===
==== 新規のマッピングを追加すると「Duplicate mapping as below」となり、保存できない ====
* 同一アイテムタイプ内で異なるプロパティに対して同じスキーマをマッピングさせる場合は、Schema (子)含めて全て同じようにマッピングさせる必要があります。（[https://meatwiki.nii.ac.jp/confluence/pages/viewpage.action?pageId=63868523#id-%E3%82%A2%E3%82%A4%E3%83%86%E3%83%A0%E3%82%BF%E3%82%A4%E3%83%97%E7%AE%A1%E7%90%86-%E3%82%A2%E3%82%A4%E3%83%86%E3%83%A0%E3%82%BF%E3%82%A4%E3%83%97%E3%82%92%E3%83%9E%E3%83%83%E3%83%94%E3%83%B3%E3%82%B0%E3%81%99%E3%82%8B8%EF%BC%8E1%EF%BC%8E%E3%82%A2%E3%82%A4%E3%83%86%E3%83%A0%E3%82%BF%E3%82%A4%E3%83%97%E3%82%92%E3%83%9E%E3%83%83%E3%83%94%E3%83%B3%E3%82%B0%E3%81%99%E3%82%8B マニュアル]）
* Schema (子)の要素を追加する際、「+追加」から追加する必要があります。「+add static value」から追加すると、項目名が手入力となり、他のプロパティと同一とみなされないようです。
* Schema (子)の順番も、同一のスキーマを設定している他のプロパティのものと揃える必要があります。（2画面で開いて見比べながら作業すると確実です）

=== アイテム一括登録（インポート） ===
==== DOIの設定と「識別子変更モード」 ====

* 自動採番でDOIを付与する場合は、通常モードでインポートします。「識別子変更モード」にはチェックを入れません。また、DOI_RAを設定し、DOIはprefix/ を記述します。
* 独自のDOIを付与する場合は「識別子変更モード」をチェックしてインポートします。この場合は、DOI_RAとDOI(prefix/suffix)を記述します。

{| class="wikitable"
|+ インポートでの設定内容
|-
!  !! 識別子変更モード !! DOI_RA  !! DOI
|-
| DOIを付与しない || 通常モード || 空欄にする || 空欄にする
|-
| 自動採番でDOIを付与 || 通常モード || 設定する|| prefix/ を記述する
|-
| 独自のDOIを付与 || 識別子変更モード || 設定する|| prefix/suffix を記述する

|}

==== TSVファイルの文字コードがUTF-8ではないらしくインポートができない ====

* インポートに使用するTSVファイル（「data」フォルダに置く、アイテムタイプ名＋アイテムタイプIDがファイル名のファイル）の文字コードは、UTF-8 (BOM付)です。
* [https://meatwiki.nii.ac.jp/confluence/pages/viewpage.action?pageId=63868511#:~:text=%E2%80%BB%C2%A0Excel%20%E3%81%A7%E3%83%87%E3%83%BC%E3%82%BF%E4%BF%AE%E6%AD%A3%E3%82%92%E8%A1%8C%E3%81%86%E9%9A%9B%E3%81%AE%E6%B3%A8%E6%84%8F%E7%82%B9 JAIRO Cloud（WEKO3）基本マニュアルの「アイテム一括登録（インポート）」(NII)]以下の手順で編集すると、文字コードはそのままでTSVファイルを作成できます。
* Excelから「テキスト(タブ区切り) (*.txt)」「Unicode テキスト (*.txt)」で保存しても、文字コードはUTF-8に設定されません。また、再度Excelで読み込んだ場合に、桁がずれるなどして正しく読み込めない場合があります。

==== 「サーバ内部エラー」になりインポートができない ====

* 以下の場合に「サーバ内部エラー」となるようです。まずはTSVファイルの内容をご確認ください。
** インデックスIDが数字でない（＝1.70536E+12のような E+n の形式になる）→Excelでの編集時に「セルの書式設定」で「数値」に設定する

==== 紀要等のインポートで目次順にIDを付与したい ====

* 現在（2024年3月18日）のWEKO3では、インポートで複数アイテムを同時に登録すると、TSVの記載順ではなくよりメタデータが軽い（≠本文ファイルのサイズ）アイテムから登録される。<br>紀要等を目次順に登録したい場合、ダミーのアイテムを先に登録し、それを正規データで上書きすることで対応可能。
** [[メディア:KiyounoID.docx|手順書（ワード）]]

==== 登録内容に””が含まれる項目を一括登録したい ====

*インポートファイルに「””」を含む項目がある場合は、「””」を二重に入力して、更にその項目を「””」で囲むとインポートできるようです。

（例）
「"Wear and Tear" : James Johnsonにおける胃弱とモダニティ」を入力する場合
⇒「"""Wear and Tear"" : James Johnsonにおける胃弱とモダニティ"」

「How is Habermas considered, starting from "phenomenology"? Part 10」を入力する場合
⇒「"How is Habermas considered, starting from ""phenomenology""? Part 10"」

*その他の方法：「"」の形式にこだわりがない場合

区切り文字として認識されるダブルクォーテーションは「"」(文字コード“22”)なので、これ以外のダブルクォーテーション、

例えば「“”」（文字コード“E2 80 9C”と“E2 80 9D”の組み合わせ）などで代替することで、テキストの見た目を維持したままインポートできる。

==== ファイルをアップロードしたら「The csv/tsv file was not found（略）. Check if the directory structure is correct.」と表示されてインポートできない ====

* TSVファイルやPDFファイルが入っているフォルダの名前が、 data であるか確認してください。これ以外の名前（例：dete、ｄａｔａ（2バイト文字でdata）など）では、エラーになります。
* ファイルの拡張子が .tsv であるか確認してください。
* フォルダ data の中に .tsv のファイルがあるか、確認してください。

=== ソート ===
==== 100件以上のアイテムがあるインデックスにカスタムソートを設定したい ====

* カスタムソートを行うインデックスを選択し、URLのsize=100の100部分をアイテム数と同数の値に変更することでアイテム全件を表示できる。

==== アイテムを並び替えた順でエクスポートしたい ====

* 一覧画面で並べ替えた後、ブラウザの更新ボタンか「F5」キーを押して、ページを再読み込みしてから、「エクスポート」を押すと、並び替えた順でエクスポートできる。

=== OAI-PMH, ハーベスト ===

[https://support.irdb.nii.ac.jp/ja/faq IRDBのハーベストに関するFAQ]や「[https://doi.org/10.34477/0002000350 ハーベストエラー解消の手順]」も参照のこと。

{| class="wikitable"
|+ メタデータ登録から検索されるまでの目安
|-
| 1週目 || メタデータ登録
|-
| 2週目 || IRDBでハーベスト
|-
| 3週目 || （図書など）NDLサーチで検索できるようになる
|-
| 4週目 || （論文など）CiNii Researchで検索できるようになる
|}

==== IRDBにメタデータがハーベストされたのだけど、IRDB上で検索できない ====

* 「ハーベスト処理結果の通知メール」で、ワーニングや項目エラーがないのにIRDB上で検索できない（ハーベストされたメタデータがIRDB上で「このページにアクセスする権限がありません」と表示される）場合は、IRDB上の機関ユーザ情報の設定に問題があるようです。 [https://support.irdb.nii.ac.jp/ja NIIに連絡]すると対応いただけます。

==== IRDBにメタデータがハーベストされたのだけど、CiNii Researchで検索できない ====
* ハーベスト処理結果のうち、「OAI連携先種別」にciniia（論文）、ciniir（研究データ）、ciniid（博士論文）があるものがCiNii Researchの連携対象です。ない場合は、メタデータのうち資源タイプ等が異なりデータ連係の対象となっていない場合があります。[https://support.irdb.nii.ac.jp/ja/harvest IRDB ハーベスト仕様]をご確認ください。
* IRDBでのハーベスト後、10～14日ぐらいでCiNii Researchで検索できるようです。

==== IRDBにメタデータがハーベストされたのだけど、国立国会図書館（サーチ、デジタルコレクション）で検索できない ====

* ハーベスト処理結果のうち、「OAI連携先種別」にirdb（IRDB）、ndl（博士論文本文の自動提出）があるものが連携対象です。ない場合は、メタデータのうち資源タイプ等が異なりデータ連係の対象となっていない場合があります。[https://support.irdb.nii.ac.jp/ja/harvest IRDB ハーベスト仕様]をご確認ください。
* IRDBでのハーベスト後、2～7日ぐらいで国立国会図書館サーチで検索できるようです。
* [http://www.ndl.go.jp/jp/help/dissertations.html#anchor12 博士論文のNDLデジタルコレクションへの反映は数ヶ月かかる]ようです。

==== メタデータのハーベスト後、エラーが出た。何を/どこを修正すればいいかわからない ====

* 「[https://support.irdb.nii.ac.jp/ja/harvest/junii2/validation エラーチェック解説]」(IRDB)に該当するエラーがあるか、確認します。
* エラーチェックで何を行っているか、詳しい内容は以下にあります。
** JuNii2の場合：[https://support.irdb.nii.ac.jp/ja/harvest/junii2/mapping エラーチェック・正規化仕様(JiNii2)]（IRDB）
** JPCOARスキーマの場合：[https://support.irdb.nii.ac.jp/ja/harvest/jpcoar/mapping エラーチェック・正規化仕様(JPCOARスキーマ)]（IRDB）※JAIRO Cloudではver1.0.xを使用しています。「ver.1.0.x」のPDFまたはExcelファイルをご覧ください。

=== その他の管理機能 ===
==== ログイン後の有効期間を延長して長時間ログインしたい ====
[[ファイル:スクリーンショット 2024-02-20 215449.png|サムネイル|左|1日に設定した例]]

* ログイン後、画面右上のユーザーアカウントのプルダウンメニューから［セッション］を選択します。
* 「Life Time」から、有効期間を設定できます。最長は「1日」です。



<br>

<br>


==== WebAPIはない？ ====

* 2024年3月時点では、直接利用できる登録用WebAPIはないようです。
** APIには[https://swordapp.github.io/swordv3/swordv3.html SWORD 3.0]を用いるとのことです。

== （まとまっていないが書き留めておく場所） ==

（このセクションは「とりあえず書き留めておく」場所です。
箇条書きなどで書いてみてください。後で誰かがまとめてくれるはずです。）

=== やったこと・解決したこと ===

* 作成者識別子のうちNRIDが正しくnameIdentifierURIに変換されなかったが、ちょっと待っていたら正しくリンクされるようになった。

=== 困っていること ===

（運用で困っていることを箇条書きなどで書いてみてください。後で誰かが回答して、まとめてくれるはずです。'''確実な回答が必要、急いでいるなどの場合は公式メーリングリストへの投稿をおすすめします。'''）

（ワークフロー内アクティビティに残存する「ページ未検出」エラーの解消は、公式メーリングリストで移行タスクフォースにご依頼ください。）

* Cite asの表示不具合
** CSSをウィジェットに記載、配置することで、見出しごと非表示にすることが可能らしい、自己責任で行う事
<pre>
<style type="text/css">
<!--
.well.well2:nth-child(3) {
    display: none;
}
-->
</style>
</pre>

* トップページの検索窓と全文キーワードのラジオボタンの下に、任意の文字列を記載するにはどうすればよいのでしょうか?(例・つくばリポジトリ様の「著者名で検索する際は～」)
** CSSをウィジェットに記載、配置することで、任意の文字列を表示させることが可能。自己責任で行う事。ただし、アクセシビリティの観点からは良くない。
*** CSSをウィジェットに記載、配置するには、「ウェブデザイン管理 > ウィジェット」で表示される一覧の中から、使用中(Enable=✓)かつHTMLが書けるもの(例：Widget Type = [Header] or [Notice])を編集(鉛筆アイコン)する。
*** エディタ画面では"<>"を押下してコード記述モードにして、下記のCSSをコピペして、再度"<>"を押下して表示モードにしたうえで、"Save"ボタンを押下する(この手順で無いとSaveボタンが押せない)
<pre>
<style type="text/css">
<!--
#search_type::after{
    content: '著者名で検索する際は～';
    white-space: pre;
}}
-->
</style>
</pre>


* 論文のカスタムソートを一気に行うためのJavascriptをChatGPTを利用して作ったが、保存すると数字が消えてしまう

<pre>
// テキストボックスの数を取得
var textBoxes = document.querySelectorAll("input[type='text']");
var textBoxCount = textBoxes.length;

// テキストボックスに逆順に整数を入力する
for (var i = 0; i < textBoxCount; i++) {
    var value = textBoxCount - i;
    textBoxes[i].value = value.toString();
}」
</pre>

ここまでをコンソールで実行することには成功したが、以下が反映されない。
そのため、保存ボタンを押すとテキストボックスに自動入力された数字が消えてしまう。

<pre>
// ページがロードされた際に実行される処理
window.onload = function() {
    // セッションストレージからテキストボックスの内容を取得し、テキストボックスに表示する
    var textBoxes = document.querySelectorAll("input[type='text']");
    for (var i = 0; i < textBoxes.length; i++) {
        var key = "textBoxValue_" + i;
        var savedValue = sessionStorage.getItem(key);
        if (savedValue !== null) {
            textBoxes[i].value = savedValue;
        }
    }
};

// ページがアンロードされる際に実行される処理
window.onbeforeunload = function() {
    // テキストボックスの内容をセッションストレージに保存する
    var textBoxes = document.querySelectorAll("input[type='text']");
    for (var i = 0; i < textBoxes.length; i++) {
        var key = "textBoxValue_" + i;
        sessionStorage.setItem(key, textBoxes[i].value);
    }
};
</pre>

(TBD)