本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Quick 中使用應用程式中的資料
<a name="working-with-data-apps"></a>

您可以在快速應用程式中以多種方式保留和管理應用程式中的資料。

## 內建應用程式儲存
<a name="apps-builtin-storage"></a>

保留資料最簡單的方法是使用內建的應用程式儲存。它是一種鍵值系統，不需要外部設定和擴展來支援大量記錄。

### 儲存範圍
<a name="apps-storage-scopes"></a>
+ **私有儲存** — 資料僅對目前使用者可見。將 用於個人設定、偏好設定、儲存的篩選條件、書籤和每個使用者狀態。
+ **共用儲存** — 具有應用程式存取權的任何人都可看見資料。用於協作清單、評論、投票、共用組態和團隊資料。

### 儲存操作
<a name="apps-storage-operations"></a>


| 作業 | 私有 | 共同 | Description | 
| --- | --- | --- | --- | 
| 放置項目 | 是 | 是 | 存放或更新鍵值項目。 | 
| 取得項目 | 是 | 是 | 依金鑰擷取項目。 | 
| 列出項目 | 是 | 是 | 列出具有選用金鑰字首篩選條件的項目。 | 
| 刪除項目 | 是 | 是 | 依索引鍵移除項目。 | 
| 依標籤列出 | 否 | 是 | 依標籤查詢共用項目 （次要索引）。 | 

### 重要概念
<a name="apps-storage-concepts"></a>
+ **資料表** — 資料的邏輯分組。您可以定義資料表名稱；不需要設定。
+ **金鑰** — 每個項目在其資料表中都有唯一的金鑰。金鑰最多可達 255 個字元。
+ **值** — 最多 350 KB 的字串值。針對結構化資料使用 JSON 序列化。
+ **標籤 （僅限共用）** — 共用項目上的選用分類字串。標籤可依類別有效查詢。
+ **寫入模式** — UPSERT （預設） 會覆寫現有項目。如果金鑰已存在，INSERT 失敗，這有助於防止重複。

**注意**  
每個應用程式都有完全獨立的儲存體。資料會在使用者工作階段和應用程式重新載入之間持續存在。

## 匯出資料
<a name="apps-exporting-data"></a>

您可以要求代理程式新增匯出功能。Quick 中的應用程式支援透過橋接 API 將資料匯出為 CSV、JSON、PDF 和 Excel 檔案。您也可以讓應用程式將資料快照寫入連線空間。這可做為備份，並讓資料可供其他 Quick 功能使用。

## 在 AI 推論作用中時處理寫入核准
<a name="apps-write-approvals"></a>

當應用程式使用 AI 推論並寫入資料 （共用儲存或透過動作連接器） 時，您必須檢閱並核准每個寫入承載。此安全措施可確保您在應用程式保留內容之前檢閱 AI 產生的內容。

三種策略可以降低核准提示的頻率：

1. **批次寫入** — 在單一操作中收集所有項目並將其儲存在單一儲存金鑰下。

1. **將 AI 與寫入**分開 — 設計應用程式，以便 AI 處理和資料持久性發生在不同的使用者動作中。

1. **不需要時移除 AI 推論** — 如果您的應用程式不使用 AI 產生的內容，請確保 AI 推論整合未註冊。如果沒有 AI 推論，您可以選擇「允許此應用程式」進行寫入操作。許可會跨工作階段持續存在。

## 存取使用者資訊
<a name="apps-user-identity"></a>

使用 Quick 中的應用程式，您可以在執行時間存取目前使用者的身分。這可讓您個人化應用程式體驗、顯示使用者名稱或實作每個使用者邏輯。

可用的使用者資訊包括電子郵件、名字、姓氏和身分名稱。

**提示**  
將使用者身分與私有儲存結合，以建立個人化體驗，例如每位使用者的問候語、已儲存偏好設定、書籤和自訂儀表板。