親愛的客戶，您好：
針對 7 月 22 日「Primo VE NDE 新介面與設定指南」課程中所蒐集到的問題，本次統一回覆內容包含「自然語言檢索介接」、「既有連結轉址」、「第三方 Add-on 整合」，以及「聯盟（NZ）的 Mixpanel 架構與資料範圍」，說明如下：


一、 自然語言檢索如何與外部系統介接？

NDE 的自然語言檢索（Natural Language Search）可透過專用的 Deep Link，從 Primo VE 外部啟動自然語言搜尋。

連結格式：

https://<Primo網域>/nde/nlsSearch?vid=<View ID>&original_query=<自然語言查詢內容>


必要參數：

  • Host URL + /nde/ ：Primo 的 Host URL 加上 /nde/，例如：https://ap01.primo.exlibrisgroup.com/nde/
  • nlsSearch?：自然語言檢索的連結路徑
  • original_query：自然語言查詢內容，上限為 500 個字元
  • vid — View ID，格式為「機構代碼:視圖名稱」

選用參數：

  • tab
  • search_scope：指定檢索範圍
  • lang：指定介面語言，例如 zh-tw 或 en

若未提供選用參數，系統會使用該 View 的預設值。

範例連結：

https://ap01.primo.exlibrisgroup.com/nde/nlsSearch?tab=Everything&search_scope=MyInst_and_CI&vid=TRIAL_8_INST:NDE_Demo&lang=zh-tw&original_query=幫我找AI相關圖書



二、 NDE 上線後，哪些既有連結與設定不需要修改？

NDE 的正式上線是以視圖（View）為單位執行。當館方針對某個原 Primo VE View 執行「轉換到上線（Switch to Live）」後，所有原本連到該 Primo VE View 的網址，原則上都會自動導向對應的 NDE View。


原則上，以下使用原 View 的連結與設定不需要修改：


項目

說明

外部頁面嵌入的Primo搜尋框

外部搜尋框送出的檢索會自動導向對應的 NDE View，不需修改原有搜尋框設定。

永久連結（Permalink）

使用原 Primo VE View 的永久連結（Permalink）及 Deep Link 會自動導向對應的 NDE View。

OpenURL（Services Page）

URL 參數與語法維持不變，不需要修改（https://<Primo_domain>/openurl/<Alma_institution_code>/<view_code?>）

已儲存的檢索及檢索歷程

執行 Switch to Live 時，若保留預設勾選的「複製已儲存的搜尋與搜尋歷史」，既有的已儲存檢索及檢索歷程會複製至 NDE，並於上線後提供使用。

認證方式（Authentication Methods）

NDE 支援與現行介面相同的認證方式，既有認證設定會自動沿用。


※ 注意：館方完成「轉換到上線（Switch to Live）」後，仍應逐一確認圖書館首頁、外部系統及其他網站中的所有 Primo 相關連結與搜尋功能是否正常運作。



三、 Add-on 整合（Third Iron： LibKey/BrowZine、
StackMap、Springshare）

由於 NDE 採用新的 Angular 技術架構，若館方目前在原始 Primo VE 介面中整合 Third Iron、StackMap、Springshare 或其他第三方服務，原有的 JavaScript、自訂元件及串接方式無法直接沿用，需確認廠商是否已提供支援 NDE 的 Add-on 或相容版本，並重新設定。

兩種整合方式：

1. 使用 「附加元件設定 （Add-on Configuration）」（設定式，較簡易）

路徑：設定（Configuration）  > 探索 （Discovery） > 其它 （Other） > 附加元件設定（Add-on Configuration）

此為新推出的設定選項，館方可透過 Alma 的「附加元件設定」載入支援 NDE 的第三方 Add-on，但前提是廠商已完成相容版本的開發，並提供所需的設定資訊。

Ex Libris 已與 Third Iron、StackMap 及 Springshare 等廠商合作建立 NDE Add-on 整合機制；實際支援項目與設定方式仍應以各廠商最新說明為準。

※ 同一 View 可加入的 Add-on 數量沒有限制。


2. 使用 NDE 客製化開發框架

若第三方廠商尚未提供可直接設定的 NDE Add-on，則需由廠商或開發人員使用 NDE 客製化開發框架，重新開發或調整整合功能。

可請廠商參考 Ex Libris 官方開發指南：


針對 Third Iron（LibKey／BrowZine）

Third Iron 已提供適用於 Primo NDE 的 Add-on，以及相關設定說明與逐步操作指南。既有的 LibKey／BrowZine 整合不會自動移轉至 NDE，館方需依 Third Iron 提供的最新版文件重新設定。

四、 NZ 的 Mixpanel 架構與資料範圍

聯盟可依需求選擇「獨立式（Independent Institutions）」或「集中式（Centralized Consortium）」專案架構。不同架構下，NZ 與各 IZ 的 Mixpanel Project 配置及可查看的資料範圍有所不同。

1. 獨立式（Independent Institutions）

在獨立式架構下，各 IZ 與 NZ 皆有各自獨立的 Mixpanel Project。

Mixpanel Project

可查看的資料

A 機構 Project

A 機構自有 Primo View 的使用數據，不包含 Union View 使用數據

B 機構 Project

B 機構自有 Primo View 的使用數據，不包含 Union View 使用數據

C 機構 Project

C 機構自有 Primo View 的使用數據，不包含 Union View 使用數據

NZ Project

Union View 的全部使用數據

※ 在獨立式架構下，各 IZ 僅能在自己的 Project 中查看自有 Primo View 的使用數據；Union View 的使用數據則統一收錄於 NZ Project，各 IZ Project 無法查看。


2. 集中式（Centralized Consortium）

在集中式架構下，整個聯盟共用一個 Mixpanel Project，並透過不同的 Data View 控制各管理者可查看的資料範圍。

Data View

可查看的資料

Global View

（All Project Data）

整個聯盟的所有使用數據，包含完整的 Union View 使用數據

A 機構 Data View

A 機構自有 Primo View 的使用數據，以及使用者透過 Union View 登入 A 機構後所產生的使用數據

B 機構 Data View

B 機構自有 Primo View 的使用數據，以及使用者透過 Union View 登入 B 機構後所產生的使用數據

C 機構 Data View

C 機構自有 Primo View 的使用數據，以及使用者透過 Union View 登入 C 機構後所產生的使用數據

※ 在集中式架構下，NZ 管理員可透過 Global View 查看整個聯盟的使用數據；各 IZ 則可透過所屬的 Data View，查看本機構自有 Primo View 的使用數據，以及使用者透過 Union View 登入該機構後所產生的使用數據。

上述「透過 Union View 登入該機構後所產生的使用數據」，以 A 機構為例：使用者進入聯盟的 Union View，選擇 A 機構並完成登入後，若繼續於 Union View 中進行檢索、查看紀錄或使用其他功能，這些後續操作會被識別為 A 機構的 Union View 使用數據，並顯示於 A 機構的 Data View 中。


以上為本次課程相關問題的補充說明，敬請各館依實際使用情況進行確認與設定。如有任何問題，歡迎再與我們聯繫，謝謝。