庫存

QR 碼標籤與掃描

了解容器短代碼的意義、如何製作與貼上標籤、如何用手機掃描，以及掃描無結果代表什麼。

QR 標籤讓您不用再走回筆電。不必在冷凍櫃找到瓶子、記住名稱後再搜尋庫存，只要將手機對準貼紙，品項與可用操作就會出現。在實驗台工作正是產品的目的之一。

容器上的代碼是什麼

每張標籤都有一個短代碼，由 Labsistant 發出，以字母與數字指向實驗室中的特定對象。代碼本身就是標籤的識別。QR 方塊只是方便相機讀取的形式；貼紙刮傷或結霜時也能手動輸入代碼。

因此有以下特點：

每個品項只有一個有效標籤。再次申請會回傳既有標籤，不會建立第二個。因此同一個容器不會有兩個不同的有效代碼。
代碼不是品項名稱。它不包含試劑名、批號或數量。連線時掃描會讀取 Labsistant 目前紀錄，因此幾個月前列印的標籤仍可顯示目前數量。離線結果則是下文說明的快取快照。
標籤可以撤銷。印刷內容仍可讀取，但不再開啟任何紀錄，適用於容器除污後重新使用的情況。

代碼可對應庫存品項、存放位置與已排程實驗。目前，建立按鈕位於庫存品項上。

標籤在網頁應用程式中建立，而非手機端。

開啟庫存，點選品項以開啟詳細資料面板。
捲動至QR 標籤。
點選產生 QR 標籤，會顯示短代碼、QR 方塊與版本號。若已有有效標籤，會回傳同一個標籤。
點選列印標籤，只列印這張標籤：含網頁連結的 QR，下方附短代碼。若使用自己的標籤列印軟體，可透過下載 PNG或下載 SVG儲存方塊影像。
方塊下方有兩個連結，可單獨使用：
- 複製網頁連結可取得開啟品項的連結。
- 複製應用程式連結可取得直接開啟手機 Labsistant 應用程式的連結。

庫存品項的標籤操作可由實驗室 PI、品項管理者或擁有者、所屬群組成員使用；實驗室共用庫存則所有成員皆可使用。已關閉品項不能產生或撤銷標籤。

停用標籤時，點選撤銷標籤並確認。它將不再開啟品項；可產生新標籤替換。撤銷不會刪除庫存品項。

兩個實用習慣：

將短代碼以文字保留在方塊下方。列印標籤會自動完成；若使用下載影像自行排版，也請加上代碼。結霜、凝結水與彎曲的 1.5 mL 管會妨礙讀取。即使 QR 無法讀取，清楚的文字代碼仍可使用。
將標籤貼在能保持完好的地方。瓶蓋頂部常被擦拭，盒底則朝向層架。容器側面、填充線上方通常較能保持乾淨且清楚可見。

若要替冷凍櫃、層架或盒子貼標籤，請先閱讀建立存放位置與格狀盒與槽位，確保對應物件已在 Labsistant 中建立。

下方手機控制項名稱保留行動應用程式目前顯示的英文。

開啟 Labsistant 應用程式，前往 Scan。
取得權限後，相機會自動開啟。首次使用時請在手機上允許存取。若已手動關閉，點選 Camera；若拒絕權限，可用 Open settings 啟用，或手動輸入代碼。
將方塊保持在畫面內，查詢會自動開始，不必按快門。可用縮放按鈕或雙指縮放，需要更多光線時使用 Torch。
若相機無法讀取方塊，在 QR code 欄位輸入短代碼並點選 Look up。這會執行相同查詢，通常比反覆避開反光更快。

標籤開啟後，會顯示品項與可用操作。各項操作的意義與使用時機請參閱更新、消耗或調整品項數量。

短時間內重複掃描同一標籤會被忽略，以免重複查詢。掃描本身不會變更庫存；請確認畫面上的操作，或選擇 Scan next 讀取另一標籤。

離線時，應用程式可查詢這台裝置快取的標籤。顯示的品項資料是先前快照，不是即時數量。恢復連線並由伺服器確認目前品項前，無法變更庫存。

沒有結果通常有明確原因。請對照訊息：

Labsistant 訊息	意義	如何處理
`QR code not found`	您可見的標籤中沒有符合代碼的紀錄。	請核對並輸入印刷代碼。若代碼正確，標籤可能不存在、屬於其他實驗室，或指向您無權存取的品項。
`This label has been revoked`	已找到標籤，但它已不再有效。	為品項產生新標籤並更換貼紙。
`You do not have access to this QR label`	查詢遭拒，可能是工作階段或權限變更；這不代表貼紙有問題。	登出後重新登入，再次掃描。若仍失敗，請讓 PI 檢查實驗室成員資格與品項存取權限。
`Scan a Labsistant label or enter the short code`	掃描內容不是可識別的 QR 連結或短代碼格式。	您掃描的是供應商條碼或運送標籤。Labsistant 只能查詢自己發出的代碼。
`Offline. This label has not been cached on this device yet.`	目前處於離線狀態，此裝置的快取中沒有該標籤。	恢復網路後再次掃描。
`That took too long`	查詢未及時回傳結果。	檢查連線並再次掃描標籤。

請留意 QR code not found：它同時涵蓋未知代碼與無權存取的對象。先確認印刷代碼屬於手中容器。若貼紙不對或標籤已停用，請有標籤權限的人產生正確標籤並更換。已知的撤銷標籤也可能顯示上方獨立的撤銷訊息。

無權存取的對象也會回傳相同的 QR code not found，避免透露代碼是否存在。這是刻意設計的：持有貼紙不應暴露其他實驗室的紀錄。若同事能開啟而您不能，請與 PI 核對成員資格與品項存取權限。單次查詢失敗本身不能證明需要更換標籤。