「JAIRO Cloud」の版間の差分

2024年12月26日 (木) 15:48時点における最新版

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

このページは有志により作成されています。NIIが作成しているものではありません。公式の情報は、JAIRO CloudのWebサイトをごらんください。
このページの情報は、有用であることを期待して掲載されていますが、内容について不正確であったり、古くなっていたりする場合があります。操作の実行は、ご自身の責任で行ってください。
JAIRO Cloudをお使いの方からの情報の追加や更新を歓迎します。特に、以下のような内容を教えていただけると、たいへんありがたいです。
- NIIのマニュアルにやり方が書いていなかった、あるいはマニュアルの記述がわかりにくかった操作
- 登録作業の際に使っている便利なソフトウェア（ExcelマクロやPower Automateなども含む）

運用事例集[編集]

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

便利なツール[編集]

インポート用TSVファイルの作成・編集[編集]

VSCode
- TSVファイルの確認や簡単な編集に使っています。
- csv,tsv用の拡張機能を入れると便利です。CSV/JSONを扱う際にオススメのVSCode拡張機能(Qiita)もご参考としてください。

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

LibreOffice
- Office互換のフリーソフトウェア。このソフトウェアに含まれるLibreOffice Calcは、ExcelファイルもCSV・TSVファイルも開けて、相互に変換もできる優れものです。

Cassava Editor
- CSVファイルを手軽に作成・編集する Windows 用のソフトウェアです。商用・非商用共に無料で利用できます。Excelに似たインターフェースでCSV・TSVファイルの編集と、文字コード・改行コードを指定しての保存ができます。

登録支援ツール[編集]

WEKO3 simple loader （前田朗さん作）
- TSVファイルから一括登録用のファイルを作成するツール

metadata_fetcher_by_DOI （林賢紀さん作）
- DOIを元にISSNなどUnpawaywallの情報と、ISSNからSherpa Service上のOAポリシーのURLを取得するツール。Excelファイルで、Power Queryで動作します。

エクスポート支援[編集]

アイテムを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}})();

質問集[編集]

操作全般[編集]

JAIRO Cloudの操作で気をつけることを教えてください[編集]

以下の操作は不具合を起こす可能性が非常に高いため、行わないでください。

Webブラウザの「戻る」ボタンの使用
Webブラウザの複数タブでの編集

また、以下の操作も不具合を起こす可能性が高く、自力で不具合の対応を行うことができないのであれば、実行しないことを強く推奨します。

アイテムタイプの追加・編集
3階層以上のインデックスの作成（参考: [JPCOAR-JC : 6940] JAIRO Cloud (WEKO3) 非公式まとめ）

設定変更等、管理作業全般[編集]

JAIRO Cloudの設定変更等、管理作業で気をつけることを教えてください[編集]

人間の記憶は当てにならず、また人事異動等で「いつ、なぜこの設定を変更したのだろう」という情報は失われがちです。変更した設定内容は自分の機関しかわかりません。従って、自分たちで記録する必要があります。

画面構成の変更やアイテムタイプの変更、インデックスの追加・変更、ユーザの追加など、管理画面でなにかしらの作業を行った際は、「いつ、何のために、何を行ったか」の記録を採っておくと後から確認できて便利です。設定を戻す際にも有効ですし、障害が起き調査を依頼する場合にも活用できます。

たとえば、以下の項目を作業記録としてExcelに都度記録する、などです。「2024年度リポジトリ担当者の基礎知識研修」でも、運用マニュアルの作成としてお勧めしています。

作業日
種類（ウェブデザイン管理、アイテムタイプ管理など管理画面のメニュー）
作業者
変更内容（どこを、何の目的で変更したかを記録します。スクリーンショットを入れたりしています。）

参考：第3回JPCOAR Webinar「2024年度リポジトリ担当者の基礎知識研修」（2024年9月3日）1．機関リポジトリの実務 ⑧運用マニュアル

運用マニュアルは、システム操作よりも、各機関独自の事項について、分かりやすく、かつ安全に保管しておくために作成する

メタデータの編集[編集]

新しいメタデータ項目を追加したい[編集]

基本マニュアルのアイテムタイプ管理をごらんください。

ただし、アイテムタイプの追加や編集は、適切に設定しないと、メタデータの編集やIRDB・CiNii Researchへの登録のためのメタデータのハーベストにおいて、予期しないエラーを発生させる原因になります。特段の理由がない限り、アイテムタイプの追加や編集は行わないことを強く推奨します。

サムネイル画像を追加したい[編集]

「ファイル」としてサムネイル画像を登録します。
- JAIRO Cloud（WEKO3）基本マニュアルにある「サムネイル登録」はまだ利用できないようです。
「ファイル情報」-「本文URL」から「オブジェクトタイプ」に「thumbnail」を指定します。これで　objectType="thumbnail" の画像が登録されます。

DOIを自由に設定したい[編集]

「アイテム個別登録」から登録した場合は、DOIは {機関のPrefix}/{WEKO3のアイテムID} で自動設定されます。変更はできません。
Prefixは、JAIRO Cloudの利用申請時に「JaLC準会員登録」を申請し、承認された際の通知にあるPrefixのみ利用できます。
Suffixを自由に設定したい場合は、アイテム一括登録（インポート）で登録する必要があります。なお、DOIのSuffixは半角英数字、半角記号「_-.;()/」以外使用できません。
2024年12月現在、JAIRO Cloudで付与できるDOIはJaLC DOIとCrossref DOIになります。DataCite DOIはサポートされていません（マニュアル）。

漢字文化圏の「著者名」の「言語」選択に迷う[編集]

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

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

作成者が日本語、英語の両方で表示される/同一人物を日本語、英語の両方で登録したい[編集]

JAIRO Cloudの仕様上、複数の言語で登録した情報は画面表示の言語（画面右上の「言語」で変更できます）と同じもの「のみ」が表示されます。日本語と英語の両方が表示される、ということではなさそうです。
- タイトル等、複数の言語表記が可能な項目は同様の仕様のようです。
従って、両方が表示される場合は、作成者が複数登録されていることになります。
日本語の作成者を入力した後に、同じ「作成者」で「+New」を押して英語の作成者姓名を追加してください。
JPCOARスキーマでのOAI-PMHの出力で、以下のように同じ <jpcoar:creator>要素に異なる言語の creatorName がある状態が、「同じ人物の複数の言語表記」が登録されている状態です。

<jpcoar:creator>
	<jpcoar:creatorName xml:lang="ja">林, 賢紀</jpcoar:creatorName>
	<jpcoar:creatorName xml:lang="en">Hayashi, Takanori</jpcoar:creatorName>
	<jpcoar:affiliation>
		<jpcoar:affiliationName xml:lang="ja">国際農林水産業研究センター</jpcoar:affiliationName>
		<jpcoar:affiliationName xml:lang="en">Japan International Research Center for Agricultural Sciences</jpcoar:affiliationName>
	</jpcoar:affiliation>
</jpcoar:creator>

以下は、「2人の人物が、それぞれ異なる言語表記」で登録されている状態です。この状態では、jpcoar:creator として2名いることになります。

<jpcoar:creator>
	<jpcoar:creatorName xml:lang="ja">林, 賢紀</jpcoar:creatorName>
	<jpcoar:affiliation>
		<jpcoar:affiliationName xml:lang="ja">国際農林水産業研究センター</jpcoar:affiliationName>
	</jpcoar:affiliation>
</jpcoar:creator>
<jpcoar:creator>
	<jpcoar:creatorName xml:lang="en">Hayashi, Takanori</jpcoar:creatorName>
	<jpcoar:affiliation>
		<jpcoar:affiliationName xml:lang="en">Japan International Research Center for Agricultural Sciences</jpcoar:affiliationName>
	</jpcoar:affiliation>
</jpcoar:creator>

メタデータの表示[編集]

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

表示されていない英語版のインデックスを「空更新」すると表示されるようになります。手順は以下の通りです。

トップページで言語を「English」に変更する。
Administration > Index Tree > Edit Tree を開き、問題が発生しているインデックスを開く
値を変更せずに「Send」ボタンをクリックする。
トップページで言語を「日本語」に変更して、同様に日本語版のインデックスを空更新する

最新の課題リストの#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のアイコン
- 空白の場合はフォルダアイコン

[名前/ファイル]の欄に名前以外の「original URL」という表記がでる[編集]

[PDF Cover Page]の設定をoff(Disable)に変えることで表示はされなくなる

画面に表示したくない情報がハーベストに必須でHideにするとエラーになる[編集]

メタデータ設定の「Hide」はログインユーザー以外から項目を隠すための設定なので、非ログインユーザー扱いであるIRDBもHideはハーベストできなくなってしまう。ハーベストで必須になる項目を画面に表示したくない場合は、「Non Display on Detail」に設定すると良い。ただし、「Non Display on Detail」は画面に表示されないだけで情報としては公開状態になっているので、事務メモを「内容記述」などに記録する場合は「Hide」にしておかないと一般利用者にもやり方次第（ExportやOAI-PMH出力）で見えてしまうし、ハーベストされるとCiNii Researchで表示される恐れがあるので適宜使い分けること

.csvファイル作成時のCCライセンス指定一覧[編集]

license_no　… ライセンスなし
license_0　 … CC BY 4.0（おそらく一番よく使う）
license_1　 … CC BY-SA 4.0
license_2　 … CC BY-ND 4.0
license_3　 … CC BY-NC 4.0
license_4　 … CC BY-NC-SA 4.0
license_5　 … CC BY-NC-ND 4.0（Elsevier等の一部出版者の著作権ポリシーで指定、よく使う）
license_6　 … CC BY 3.0（2017年以前の論文に付与されていることが多い。Royal Society of Chemistryは2024年現在も3.0を利用している）
license_7　 … CC BY-SA 3.0
license_8　 … CC BY-ND 3.0
license_9　 … CC BY-NC 3.0
license_10　… CC BY-NC-SA 3.0
license_11　… CC BY-NC-ND 3.0
license_12　… CC0

ワークフロー[編集]

ワークフローの新規作成で、表示されないアイテムタイプがある[編集]

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

インデックスの編集[編集]

インデックスツリーを閉じた（開いた）状態で表示させたい[編集]

インデックスツリーは管理者画面で最後にインデックスツリーを編集した際の展開状況が、利用者画面にも反映されます。
そのため、インデックスツリーの表示を変更したい場合は、管理者画面でインデックスツリーを利用者画面で開きたい状態に展開したうえで、適当なインデックスを空更新します。
空更新したインデックスはタイムスタンプが更新されるので注意してください。（OAI-PMH出力している場合、IRDBの更新対象となる）

インデックスが削除できない[編集]

2024年11月現在、「JAIRO Cloud（WEKO3）におけるJPCOARスキーマVersion2.0対応について」の制限事項のうち「９）インデックスの削除」の影響で、インデックスの削除ができないことがあるようです。
詳しくは JAIRO Cloud（WEKO3）サポートリリースノート 2024-09-09(v1.0.7)を参照してください。

マッピングの編集[編集]

マッピングってなんですか[編集]

アイテムタイプの属性に、スキーマの要素や属性との関連づけを設定することです。ハーベストなどの際は、マッピングの設定に基づきメタデータが出力されます。入力項目と、OAI-PMHで出力する要素・属性を関連づけます。
たとえば、JAIRO Cloudの入力項目のうち、「タイトル」のうち「タイトル」にJPCOARスキーマの要素「dc:title」を、「言語」に属性「xml:lang」を関連付けます。これにより、それぞれの入力項目がOAI-PMHで出力されます。
マッピングが行われないと入力されたデータはOAI-PMHで出力されません。また、誤りがあるとハーベスト先でエラーとなるなど、メタデータを正しく処理することができません。

マッピングはどのように編集すればよいですか[編集]

JPCOARスキーマでの出力についてはデフォルトアイテムタイプで対応できることがほとんどです。目的のデータが出力されていない、新規に追加した項目をハーベスト対象としたいなどの場合を除き、修正する必要はないと思います。
それでも修正する必要がある場合は、編集前に管理画面「アイテムタイプ管理」→「メタデータ」から、編集しようとするアイテムタイプをエクスポートし、バックアップをとっておくことをお勧めします。
設定の手順等は JAIRO Cloud(WEKO3)サポート > 本番移行における重要情報まとめの「●マッピング設定変更時の注意点」をご参照ください。https://meatwiki.nii.ac.jp/confluence/pages/viewpage.action?pageId=118166685

新規のマッピングを追加すると「Duplicate mapping as below」となり、保存できない[編集]

同一アイテムタイプ内で異なるプロパティに対して同じスキーマをマッピングさせる場合は、Schema (子)含めて全て同じようにマッピングさせる必要があります。（マニュアル）
Schema (子)の要素を追加する際、「+追加」から追加する必要があります。「+add static value」から追加すると、項目名が手入力となり、他のプロパティと同一とみなされないようです。
Schema (子)の順番も、同一のスキーマを設定している他のプロパティのものと揃える必要があります。（2画面で開いて見比べながら作業すると確実です）

アイテム一括登録（インポート）[編集]

DOIの設定と「識別子変更モード」[編集]

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

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

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

インポートに使用するTSVファイル（「data」フォルダに置く、アイテムタイプ名＋アイテムタイプIDがファイル名のファイル）の文字コードは、UTF-8 (BOM付)です。
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の記載順ではなくよりメタデータが軽い（≠本文ファイルのサイズ）アイテムから登録される。
紀要等を目次順に登録したい場合、ダミーのアイテムを先に登録し、それを正規データで上書きすることで対応可能。
- 手順書（ワード）

登録内容に””が含まれる項目を一括登録したい[編集]

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

（例）「"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ファイルが見つからない」という趣旨のエラーです。以下をご確認ください。
- ファイル名がアイテムタイプの名前＋ID、「アイテムタイプ名(アイテムタイプID).tsv」であるか。[Administration］>［アイテム管理］>［インポート］からダウンロードしたテンプレートを、ファイル名を変えずに使用するのが確実です。
- TSVファイルやPDFファイルが入っているフォルダの名前が data であるか。※これ以外の名前（例：dete、ｄａｔａ（2バイト文字でdata）など）では、エラーになります。
- ファイルの拡張子が .tsv であるか。
- フォルダ data の中に「アイテムタイプ名(アイテムタイプID).tsv」があるか。
- zipファイルは以下の構造となっているか。※「export」などのフォルダの下に「data」があるとファイルが見つからずエラーとなります。

 import.zip
 |
 +- /data
   +-/recid_n
   |  + <登録するファイル>
   +- アイテムタイプ名(アイテムタイプID).tsv

ソート[編集]

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

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

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

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

OAI-PMH, ハーベスト[編集]

IRDBのハーベストに関するFAQや「ハーベストエラー解消の手順」も参照のこと。

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

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

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

IRDBにメタデータがハーベストされたのだけど、CiNii Researchで検索できない[編集]

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

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

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

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

「エラーチェック解説」(IRDB)に該当するエラーがあるか、確認します。
エラーチェックで何を行っているか、詳しい内容は以下にあります。
- JuNii2の場合：エラーチェック・正規化仕様(JiNii2)（IRDB）
- JPCOARスキーマの場合：エラーチェック・正規化仕様(JPCOARスキーマ)（IRDB）※JAIRO Cloudではver1.0.xを使用しています。「ver.1.0.x」のPDFまたはExcelファイルをご覧ください。
IRDBのハーベスト結果のメールで指摘のあった項目について、入力が漏れていないか、誤りがないか「編集画面」で確認します。
何を記載すれば正しいか、内容がわからない場合はJPCOARスキーマガイドライン（JPCOAR）もあわせてご参照ください。
この項目を書いた人は、OAI-PMHの出力を見てチェックしています。たとえば、

 [作成者所属機関名] 言語が重複しています (ja)

のエラーに対して、OAI-PMHの出力を見ると以下のように一つのjpcoar:affiliationに対して2つの日本語（xml:lang="ja"）の所属機関名（jpcoar:affiliationName）があります。おそらく、「作成者所属」の入力にミスがあるのでは、と考えられます。単純に「所属機関名」を繰り返して同じ言語で入力する（＝所属機関名が複数あることになる）とこのようなエラーとなります。

正しくない所属機関の記述例
<jpcoar:creator>
　　<jpcoar:creatorName xml:lang="ja">はやし, たかのり</jpcoar:creatorName>
　<jpcoar:affiliation>→所属機関その１
　　<jpcoar:affiliationName xml:lang="ja">国際農林水産業研究センター</jpcoar:affiliationName>→所属機関その１の日本語名
　　<jpcoar:affiliationName xml:lang="ja">筑波大学</jpcoar:affiliationName>→所属機関その１の日本語名が重複している！
　</jpcoar:affiliation>
</jpcoar:creator>

これを解消するには、以下のように「作成者所属」で「＋New」を押して追加すると、jpcoar:affiliationが２つある、すなわち作成者所属が２つあることを記述でき、エラーも解消されます。

正しい所属機関の記述例
<jpcoar:creator>
　　<jpcoar:creatorName xml:lang="ja">はやし, たかのり</jpcoar:creatorName>
　<jpcoar:affiliation>→所属機関その１
　　<jpcoar:affiliationName xml:lang="ja">国際農林水産業研究センター</jpcoar:affiliationName>→所属機関その１の日本語名
  <jpcoar:affiliation>→所属機関その２
 　<jpcoar:affiliationName xml:lang="ja">筑波大学</jpcoar:affiliationName>→所属機関その２の日本語名
　</jpcoar:affiliation>
</jpcoar:creator>

登録時に公開日を未来の日付に設定したが、公開日になってもIRDBにハーベストされない[編集]

当該アイテムの公開日を過ぎた後、手動でアイテムの空更新を行い、タイムスタンプを更新する必要があります。自動ではタイムスタンプは更新されないのでご注意ください。

ERDB-JP連携[編集]

機関リポジトリに蓄積した逐次刊行物の書誌情報をERDB-JPに自動的に登録することができます。
ERDB-JPのパートナー登録が必要です。パートナー登録は、「コミュニティサポート by JPCOAR and NII」での申請が必要です。詳しくはパートナー登録手順（ERDB-JP）をご覧ください。
JAIRO Cloud側では、インデックスツリーのうち「該当する雑誌タイトルのインデックス」に必要な情報を登録します。管理画面の「インデックスツリー管理」→「雑誌情報」から、設定する雑誌タイトルのインデックスを選択して設定します。
- 「インデックスツリー管理」→「雑誌情報」での登録内容はERDB-JP / JAIRO Cloud 雑誌情報⾃動連携設定マニュアル（JPCOAR）のp.5～6に準じます。※このマニュアルはWEKO2用ですが、設定内容そのものはWEKO3でもおおむね同じです。
ERDB-JP / JAIRO Cloud 雑誌情報⾃動連携設定マニュアル（JPCOAR）の手順【4】、「自動連携URL」はWEKO3では以下のようになります。

https://****.repo.nii.ac.jp/static/weko/kbart/filelist.txt

※****は各機関のホスト名に置き換えてください。

統計情報[編集]

前月の統計の値がダウンロードした日で異なる[編集]

統計情報は「月の最初の平日の協定世界時(UTC)00:00」（＝日本時間(JST)朝09:00）に更新されるようです。このため、9時を前後に出力内容が異なるようです。

Googleアナリティクスで統計は取得できますか[編集]

管理画面の設定－サイト情報の「トラッキングID」に、Googleアナリティクスの「測定ID」を入力すると、Googleアナリティクスで統計がとれるようになります。あらかじめ、Googleアナリティクスのプロパティを設定する必要があります。
以下は実際に設定した後の留意事項などです。
- 管理画面やワークフローの操作もアクセス統計として記録される。サイト全体のアクセス数を集計する際に、これらを除外するかどうかは要検討。
- PDFファイルのダウンロードは、アイテム詳細画面の「ダウンロード」でダウンロードした場合のみ記録される。Google scholarなどからPDFファイルに直接リンクされ、アイテム詳細画面を経由せずにダウンロードした場合、またアイテム詳細画面のファイルアイコンからのクリック→ダウンロードは記録されない（JavaScript経由の動作だから？）模様。
- Googleアナリティクスで取得した統計情報はLooker StudioやPower BIなどを使用して、別に表示やレポートを作成する方が利用しやすい（と書いた人は考える）。

ユーザ管理[編集]

メタデータを入力できるユーザを追加・削除したい[編集]

JAIRO Cloud（WEKO3）基本マニュアルユーザーアカウント管理の通り、下記URLの機関管理メニューにログインして行います。JAIRO Cloudの管理画面では追加・更新・削除はできません。

https://idp.repo.nii.ac.jp/admin/menu/XXX/ （XXXは機関のホスト名）

登録するユーザーアカウント情報をまとめたExcelファイルを、機関管理メニューからログイン後、「会員情報をアップロードする」からアップロードしてユーザを更新します。
追加の場合はExcelファイルに行を追加します。削除の場合は行ごと削除します。

管理画面の「ユーザ管理」－「ユーザ」に、登録した覚えのないユーザ情報がある[編集]

機関管理者が登録した情報のほか、国立情報学研究所等での管理用のユーザ情報が登録されています。これらは検証作業や動作確認等、サポートのために利用されています。
機関でのユーザ管理は、別に機関管理メニューからログインして行います。この画面では変更等できません。

IIIF機能[編集]

JAIRO CloudではIIIFは利用できますか[編集]

JAIRO Cloud（WEKO3）基本マニュアル試験的機能の通り、試験的にIIIF機能が実装されています。
ある機関で2024年8月にテストしたところ、以下の通りでした。
- 画像ファイルのほか、空の manifest.json をアップロードすることで、アイテム詳細画面のIIIFプレビューワでアップロードした画像を表示することができる。manifest.json は完全に空ではアップロードできないので、内容を {} のみとした。
- 外部のIIIFプレビューワからの参照は https://(ホスト名)/api/iiif/v2/records/(コンテンツID)/manifest.json で行うようだが、外部のIIIFプレビューワでは参照・表示できない。
- https://(ホスト名)/api/iiif/v2/records/(コンテンツID)/manifest.json の resourceとして記載された画像ファイルは参照できる。IIIF Image APIには対応できているようだ。
- @id が https://(ホスト名)/api/identifier/manifest.json のように出力される。Presentation API Validatorによれば "@id is different to the location where it was retrieved" のエラーとなる。
- このmanifest.jsonをダウンロード、@idを参照用のURLに書き換えて再度アップロードしても https://(ホスト名)/api/iiif/v2/records/(コンテンツID)/manifest.json は更新されない。
- アップロードしたmanifest.json （https://(ホスト名)/record/(コンテンツID/files/manifest.json）は、content-type: text/plain; charset=utf-8 で送信されるためか、JSONとして扱えずPresentation API Validatorでエラーとなった。
- 再アップロード後、アイテム詳細画面のIIIFプレビューワで示されるmanifest.jsonのリンク先は https://(ホスト名)/api/iiif/v2/records/(コンテンツID)/manifest.json であった。アップロードした manifest.json は読まれてないように見える。

その他の管理機能[編集]

ログイン後の有効期間を延長して長時間ログインしたい[編集]

1日に設定した例

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

(TBD)

WebAPIはない？[編集]

2024年12月時点では、利用者が直接利用できる登録用WebAPIはないようです。
- APIにはSWORD 3.0を用いるとのことです。
- 「OAアシスト機能」（詳細は https://jpcoar.repo.nii.ac.jp/records/2000420 2024年10月時点で先行機関が利用中）からはSWORDを使用して登録している？

ファビコンを変更したい[編集]

ファビコン（ブラウザのタブなどに表示される小さなアイコン）を変更しても反映されない。

これについて、以下の手順で解決することがリリースノート課題リストに記載された。(2023/06/16)

Administration > 設定 > サイト情報
「トラッキングID」欄と「AddThis ID」欄に適当な文字列を入力　「a」等でも十分です。
「保存」をクリック
2で入力した「トラッキングID」欄と「AddThis ID」欄の文字列を削除して「保存」をクリック
任意の内容でサイト情報を更新して「保存」をクリック

2023-05-16 リリースノート https://meatwiki.nii.ac.jp/confluence/pages/viewpage.action?pageId=107138309 最新の課題リスト： JC_WEKO3_ISSUES_v0.9.22_pub_v4.xlsx

199 ソフトウェア課題その他 2023/6/12 【移行機関】サイト情報が保存できない v0.9.22以前 Tracking IDとAddThis IDに文字を入力して保存。その後、削除して再度保存することで回避できます。

一度アップロードした画像は削除されない？[編集]

Webデザイン管理でウィジェットに紐づけた画像ファイルは削除されないようです。

確認した事象：

［ウィジェット］の［一覧］タブをクリックし、ヘッダーのウィジェット(ID: 1)の行頭に表示されている鉛筆のアイコンをクリック。
画像を消して［Save］。
翌日にキャッシュをクリアして、画像のURLを直打ちしてアクセス。
ウィジェットで消した画像が表示された。

対策：既にアップロードした画像とは異なるファイル名でアップロードする。

コミュニティサポートへの質問のしかた[編集]

どうしてフォーマットのとおりに投稿しないといけないの？[編集]

JAIRO Cloudのサポート担当者は、多数寄せられる問い合わせを管理するため、専用のWebサービスを使用しています。投稿テンプレートで投稿しないと、問い合わせをそのサービスで管理することができなくなります。特に、問い合わせメールの件名はそのまま問い合わせの管理で使用されていると思われるため、問い合わせの投稿前に、以下のフォーマットに沿っていることを確認してください。

【質問 or 障害 or 要望】アイテム詳細画面のエラーについて（JPCOAR大学）

問い合わせを送るのはなにか期待通りに動作していないときなので、いろいろ不安だと思いますが、そのようなときこそ一息ついて、落ち着いてフォーマットを確認してから投稿しましょう。

どうして返信のときに件名を変えてはいけないの？[編集]

JAIRO Cloudのサポート担当者は、毎日多数の問い合わせのメールを受信しています。多くのメールサービスには、件名や差出人をもとに、メールのやりとりをひとまとめにして表示する「スレッド」という機能があり（Gmailなど）、サポート担当者はこの機能を使って、多数の質問と回答を整理しています。返信のときに「サポートの人が見つけやすいように」と件名を変更してしまうと、このスレッド機能が動作しなくなり、サポート担当者が質問メールやその前後のやりとりを確認することが、かえって難しくなってしまいます。
返信の際は、返信ボタンを押したら件名は変更せず、そのまま本文を書いてください。「Re:」の削除も不要ですし、【解決】や【御礼】などの追加も不要です（これらの気持ちは本文に書きましょう）。

そのほかのポイント[編集]

障害であれば、担当者も、そしてサポートに携わっているスタッフも早く解決したい気持ちは同じです。しかしながら、JAIRO Cloudは約800機関で運用中です。各リポジトリにどんな情報が掲載されているか、またどのような設定がなされているかは異なります。

以下参考と同じように「我々(?)はあなたのすぐ側には居ない」ため、調査依頼を出す際にテンプレートに従った情報をあらかじめ共有することで、その時間を短縮することができます。

参考：Namazu（注：古の全文検索ソフトウェア）: メイリングリスト#超初心者です、何もわかりませんが使いたいのです

森本淳さんのお言葉

我々(?)はあなたのすぐ側には居ないわけですから、
「車のウインカーがつきません」
「ウインカーレバーを倒してみるのは?」
「ok, ウインカーつきました」
程度のアドバイスはできると思いますが、

「車のエンジンがかかりません」というのに対して、 「ではボンネットを開けて、向かって右の前から２番目にあるバッテリーの緑 のフタを外して赤いワイヤーを外して接点部の鉛の覆いを外して接点の銅に緑 青が吹いていたらそれをサンドペーパーでこすって磨いて接点復活剤をかけて また組み上げるのがまず１点。次に向かって左３番目の ECU を開けて CPU の (以下 120 行省略) 」 みたいな指摘は、超人かアポロ13号の地上指令室でもないかぎり、 残念ながらできません。

投稿テンプレートのポイント
- 発生日時
  - 調査にあたって重要な情報です。障害によっては日時によって操作記録やデータベースの更新内容を抽出することができます。
  - 時間は正確でなくても、「何時ぐらい」「午後」ぐらいでもかまいません。
- 状況確認手順
  - 「どのような結果を期待して、このような操作をこの画面で（いつ）行った。しかし結果はこうであった。」ことがわかると調査しやすいです。
- 質問関連URL
  - どのアイテムが対象か、そのアイテムのタイトルとURLがわかると調査しやすいです。特に、URLがあるとすぐにアクセスできて時間を短縮できます。URLがないとあなたのリポジトリを探し回ることになります。

開発[編集]

WEKO3を自分のパソコンで動作させたい[編集]

WEKO3はオープンソースソフトウェアとして公開されており、誰でも入手して動作を試すことができます。

Docker Engineとgitをインストールします。Windowsをお使いの場合、WSL2でUbuntuなどのLinux環境を用意するのがかんたんです。
WEKO3のソースコードをダウンロードします。
```
git clone https://github.com/RCOSDP/weko.git
```
ソースコードのディレクトリに移動します。ここではwekoディレクトリとします。
```
cd weko
```
インストールスクリプトであるinstall.shの中の docker-compose コマンドを、 docker compose に置き換えます。
```
sed -i s/docker-compose/docker\ compose/g install.sh
```
インストールスクリプトを実行します。
```
./install.sh
```
インストールスクリプトの実行が終了したら、Webブラウザで http://localhost を開くと、WEKO3のトップページが表示されます。初期管理者のユーザ名は wekosoftware@nii.ac.jp 、パスワードは uspass123 です。
WEKO3を停止する際は、wekoディレクトリに移動したあと、以下のコマンドを実行します。
```
docker compose down
```
次回以降WEKO3を実行する際は、wekoディレクトリに移動したあと、以下のコマンドを実行します。
```
docker compose up -d
```

（まとまっていないが書き留めておく場所）[編集]

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

やったこと・解決したこと[編集]

作成者識別子のうちNRIDが正しくnameIdentifierURIに変換されなかったが、ちょっと待っていたら正しくリンクされるようになった。
IRDBにハーベストされずDOIも正常に機能しない（アクセスエラーになる）問題の1つ。個別入力作業の著者欄を追加したものの入力していないまま（空欄の著者情報を入力した扱い？）だったものを削除したところ、どちらも解決した。　正常だと「著者0;著者1;」とあるべきアイテムリストでの著者表示が「著者0;著者1;;」となっており、違和感に気付いた。

困っていること[編集]

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

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

Cite asの表示不具合
- CSSをウィジェットに記載、配置することで、見出しごと非表示にすることが可能らしい、自己責任で行う事

<style type="text/css">
<!--
.well.well2:nth-child(3) {
    display: none;
}
-->
</style>

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

<style type="text/css">
<!--
#search_type::after{
    content: '著者名で検索する際は～';
    white-space: pre;
}}
-->
</style>

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

// テキストボックスの数を取得
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();
}」

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

// ページがロードされた際に実行される処理
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);
    }
};

「非公式まとめ」を始めるにあたって[編集]

JAIRO Cloudは、日本全国で700機関以上の（2023年時点）、さまざまな種類や規模の研究機関が使用する機関リポジトリ提供サービスです。あなたが過去にわからなかったことや困っていたことは、全国にいるほかのJAIRO Cloudのユーザーの方々が、まさに今困っていることかもしれません。また、あなたが操作でつまずいた点は、将来あなたの後任の方がつまずく点かもしれません。

機関リポジトリの運営は、そのほとんどが図書館や博物館によって行われています。図書館や博物館の仕事は「助け合い」であり、またその「助け合い」によって、これまで多くの人たちにさまざまな利益を生み出してきました。機関リポジトリが日本のオープンアクセス政策を直接支える役割を担うことになった今、私たちの「助け合い」が、研究者、その先の国民、そしてなにより私たち自身にとって、これまでにない新たな利益を生み出すことになると考えています。