Item Registration：メタデータ入力

目的・用途

Item Registrationの一部として、画面上の入力欄でメタデータを設定する。

利用方法

ワークフローで、Item Registration画面を表示する。

利用可能なロール

※一般ユーザーは、ロールとして利用可能に設定することはできないが、個別のユーザーをAction Userとして設定することはできる。

機能内容

1. アイテムのメタデータを入力する

• 【アイテム登録画面】に入力するアイテムのメタデータを表示する

• 【Administration > アイテムタイプ管理（Item Types） > メタデータ（Meta）画面】で設定したOptionに応じて、アイテム登録/編集画面におけるアイテムタイプ項目の表示を制御する

  • メタデータ画面のItem Nameに対するOption属性に「Required」を設定した項目は、アイテム登録/編集画面の表示時に「Required」パネルに配置し、パネルを展開可能とする
    
    「Required」を設定した項目のラベルの右側に「 * 」と付けされる
    • Item Name配下のAttributeに対するOption属性「Required」はこの制御の対象としない
  • メタデータ画面のItem Nameに対するOption属性に「Multiple」、「List Display」、「Specify Newline」を設定したものを「Optional」パネルに配置し,パネルを開閉可能とする
  • 以下の項目は本ストーリーでの対応の対象としない
    • サムネイル（Thumbnail）
    • Contributor
    • 公開日（PubDate）
    • フィードバックメール送信先（Feedback Mail Destination）

• 日付のフォーマットで定義されるプロパティまたは属性に対して、3つのフォーマット（YYYY-MM-DD、YYYY-MM、YYYY）が入力できる

  • 入力方法はカレンダー入力、または手入力である
  • デフォルト値はサーバ日付（/api/admin/get_server_date）を利用する
  • 無効な日付が入力された場合のチェックを行う
    • modules/weko-theme/weko_theme/static/js/weko_theme/search_detail.js
    • modules/weko-theme/weko_theme/static/js/weko_theme/top_page.js

• 「作成者」、「寄与者」、「権利者情報」の識別子Schemeの選択肢は ID Prefix から自動で取得する （v2.0.0）

• 「作成者」、「寄与者」の所属機関識別子Schemeの選択肢は Affiliation ID から自動で取得する （v2.0.0）

• 作成者プロパティへの著者情報の入力

  • 「著者DBから入力」（From author DB）ボタンを押下すると、著者DBの検索ウィンドウが表示される
  • 「検索」ボタンを押すと、【Administration > 著者DB管理（Author Management） > 編集（Edit）】で登録された著者DB一覧を表示する
  • ［入力（import）］ ボタンを押すと、選択した著者情報をメタデータの各エリアに入力する
  • 「Add Author」ボタンを押すと、著者登録画面が表示され著者情報を登録することができる（登録すると著者DB管理画面にも反映される）
  • コミュニティ管理者、登録ユーザーの場合は著者登録画面のコミュニティ選択欄の選択肢にアクティビティを作成したコミュニティを加える。
  • アイテム作成時、作成者識別子は編集不可となる。
  • アイテム編集時、作成者識別子"WEKO"のデータ部分はユーザーでの編集は不可とする（作成者識別子Scheme, 作成者識別子URI, 作成者識別子はグレーアウトする）。それ以外の識別子は変更可能となる。
  • アイテム登録時にDB, ESに"author_link"という情報を持たせ、アイテムと著者DBの紐づけを行う
  • アイテムとの紐づけを行わない(解除する)場合は、「作成者」パネル内の各入力エリアの右上にある[×]で紐づけを解除する
  • アイテムで個別に編集した作成者の項目は、Adminの著者DBには反映されない。
    
    なお、アイテムで個別に編集した後に著者DBから著者を取り込むと、個別編集した項目は上書きされる

2. アイテムのメタデータを自動入力できる

• Web APIのアカウント情報を設定する

  • 【Administration > 設定（Setting） > WebAPIアカウント（WebAPI Account）画面】にアイテムメタデータ自動入力機能で連携するWeb APIのアカウント情報を設定する
    
    現在、CrossRefのみ対応している
  • 設定項目は以下とする
    • 「入力タイプ」（Input Type） ：タイプを選択する
    • 各種APIに必要なアカウント設定フィールド
      • 入力タイプで "CrossRef" を選択した場合は、以下の入力フィールドを表示する
        
        「CrossRefクエリサービスアカウント」（CrossRef Query Services Account）
  • Saveボタンを押すと設定情報が保存される
  • 保存した設定情報は、アイテムメタデータ自動入力機能におけるAPIアカウント認証で使用する

• アイテムメタデータを自動入力する

  • アイテムメタデータ登録画面に「メタデータをAPIから取得」（Retrieve Metadata from API）ボタンを押すと、メタデータ自動入力のポップアップが表示される
    
    「ID選択」プルダウンにタイプを選択し、「取得」（Get）ボタンを押すと書誌情報が取得される形とする

• CrossRef API経由でアイテムメタデータを入力する

  • 「CrossRef」を選択し、DOIの値をテキストフィールドに入力して「取得」（Get）ボタンを押すと、【Administration > 設定（Setting） > WebAPIアカウント（WebAPI Account）画面】に設定されたAPIの利用にあたり必要なクレデンシャル情報(CrossRef Query Services Account)で書誌情報が取得される
    • 取得データは、アイテムの対応項目および対応するJPCOARマッピングが設定されたメタデータ項目に自動入力される
      
      取得データの入力先メタデータ項目

• CiNii API経由でアイテムメタデータを入力する
  • 「CiNii」を選択し、CRIDをテキストフィールドに入力して「取得」（Get）ボタンを押すと書誌情報が取得される
  • 書誌情報の取得は、CiNii API を利用する
    
    [CiNii ResearchのJSON-LD]
    
    https://support.nii.ac.jp/ja/cir/r_json
  • 取得データは、アイテムの対応項目および対応するJPCOARマッピング(jpcoar_v2_mapping)が設定されたメタデータ項目に自動入力される 取得データの入力先メタデータ項目

• 指定したWEKOIDのデータを流用してアイテムメタデータを入力する

  • 「WEKOID」を選択し、recidの値をテキストフィールドに入力して「取得」（Get）ボタンを押すと、書誌情報が取得される
    • PersestentIdentifier.getを用い、pidstore_pidテーブルからレコードID(object_uuid)を取得する
    • JPCOARスキーママッピングが一致した項目について、メタデータを流用入力する
      • recidに指定したアイテムと、編集対象のアイテムのアイテムタイプが異なっていても、JPCOARマッピングが一致した項目について流用入力する
      • マッピングしていない項目は流用入力対象外とする
    • データ流用時（「Get」ボタン押下時）に、取り込み対象アイテムの参照権限があるか権限チェックを行う
      • 非公開のアイテムについては、自分が参照できるアイテムでなければ流用入力できない
      • ただし、参照権限があっても(ロールによらず)Hide設定がされた項目については流用入力できない

• 制限公開用のアイテムタイプに対して、いくつかの項目が自動入力されて、アイテム登録画面に非活性の状態で表示される
  
  対象項目は、以下のファイルを参照する

  • ファイル： 別紙「利用申請および利用報告アイテムタイプ.xlsx」
    • 「利用申請」シート：「利用申請」と「二段階利用申請」アイテムタイプの説明
    • 「利用報告」シート：「利用報告」アイテムタイプの説明

• 「メタデータをAPIから取得」からメタデータを自動入力した際、ISBN/ISSN/DOIはすべて「jpcoar:sourceIdentifier」にマッピングされるが、このマッピング情報がアイテムタイプに複数存在する場合は、１つ目（１番上）のプロパティにのみセットする

3. Web APIによるDOIを使用したメタデータ補完機能

• 「メタデータをAPIから取得」（Retrieve Metadata from API）ボタンを押すと出現するポップアップウィンドウにて、「ID選択」プルダウンでDOIを選択し、DOIを入力して「取得」（Get）ボタンを押すことで、管理者によって設定された優先度順にAPIから取得したメタデータで、すでに画面に手入力したメタデータを更新する。

• instance.cfgにて、以下のように設定する

    # weko_items_autofill/config.pyに利用可能なWeb APIのリストを定義する
    WEKO_ITEMS_AUTOFILL_API_LIST = [
        "JaLC API",
        "医中誌 Web API",
        "CrossRef",
        "DataCite",
        "CiNii Research"
    ]
  
    # instance.cfgに使用するWeb APIの優先度を定義する
    WEKO_ITEMS_AUTOFILL_TO_BE_USED = [
        # 優先度順に格納
        "医中誌 Web API",
        "CrossRef",
        "DataCite",
        "Original"
    ]
  

• 処理概要
  • WEKO_ITEMS_AUTOFILL_API_LISTに設定されたAPIのリストから、WEKO_ITEMS_AUTOFILL_TO_BE_USEDに設定されたWEB APIからDOIをもとにメタデータを取得し、プロパティごとに自動入力する。
  • 同じプロパティに対して複数のAPIからメタデータが取得された場合は、WEKO_ITEMS_AUTOFILL_TO_BE_USEDに設定された順番で優先度をつけて最上位のAPIから取得したメタデータを入力する。
  • 上記の例だと、Originalのメタデータに対して、DataCite、CrossRef、医中誌 Web APIの順にメタデータを取得し、プロパティ単位で上書きする。 Originalは、画面に手入力したメタデータを指す。
  • 各APIについては、ADMIN_X_X：メタデータ補完機能を参照のこと。

4. アイテム重複チェック機能

メタデータの入力後に、同一のメタデータを持つアイテムがすでに登録されていないかをチェックする。

以下の条件で登録済みのアイテムのメタデータを検索し、同一のメタデータを持つアイテムが存在する場合は、モーダルで警告を表示する。

1. 論文の識別子による検索
   
   DOIが完全一致するアイテムがあるか
   
   ┗ DOIが完全一致すれば同一判定とし、2.以降の検索は行わない ※DOIは一意であるため

2. 「タイトル」「資源タイプ」「著者」の組み合わせによる検索

   1. タイトルが完全一致するアイテムを検索（大文字小文字・全角半角の表記ゆれは補正）
      
      ┗ タイトルの完全一致を対象とする。言語は検索対象外とする
   2. i.でヒットしたアイテムの内、資源タイプが完全一致するものを検索
   3. ii.でヒットしたアイテムの内、著者全員が一致するものを検索
      
      ┗ 著者が複数あった場合、一つでも一致する著者があれば同一判定とし警告のメッセージを表示する

キャンセルボタンを押下すると、モーダルが閉じる。

関連モジュール

• 「weko_workflow」：アイテム編集可能な権限をチェックする処理モジュールである
• 「weko_items_ui」：メタデータ登録を管理する処理モジュールである
• 「weko-items-autofill」：メタデータ自動入力用のデータを取得する処理モジュールである

処理概要

選択されたメタデータを表示する処理

• パネルがオープンか、クローズかの状態を取得する

  • すべての項目に対してデフォルトの状態はクローズとする
  • 「$rootScope.recordsVM.invenioRecordsSchema.required」から必須項目を取得し、それらの項目のパネルが初期としとオープンの状態とする

• パネルの中身に表示する処理はプロパティのデータを取得し、タイプに応じて以下のテンプレートで表示する

  • form.html（https://github.com/inveniosoftware/invenio-records-js/blob/master/src/invenio-records-js/templates/form.html）
  • decorators（https://github.com/inveniosoftware/invenio-records-js/tree/master/src/invenio-records-js/templates/decorators）

• 設定

更新履歴