您位於此處:
檔案上載增強型畫面輸入元件 (Beta 版)
讓使用者有機會從流程畫面上載檔案。「檔案上載增強型」(Beta 版) 流程畫面元件與現有的「檔案上載」畫面元件類似,但有一些主要差異。「檔案上載增強型」(Beta 版) 畫面元件可用於 Aura 和 Lightning Web Runtime (LWR) 網站,而不只是 Aura 網站。此外,您也可以要求使用者在流程中繼續之前上載文件。
必要版本
| 檢視支援的版本。 |
設定檔案上載增強型元件
您可以從流程中選取資源,例如變數或全域常數,您也可以手動輸入值。
| 屬性 | 描述 |
|---|---|
| 接受的格式 | 使用 .ext 格式,輸入使用者能上載的檔案副檔名清單,並以逗號分隔。 此屬性接受單一值資源。該值會視為文字處理。 |
| 允許多個檔案 | 若設定為 $GlobalConstant.True,使用者可以上載多個檔案。 此屬性接受單一值布林值資源。 |
| API 名稱 | 元件的 API 名稱。 API 名稱可以包含底線和不含空格的英數字元。它必須以字母開頭,且不能以底線結尾。它也不能有兩個連續的底線。 |
| 已停用 | 若設定為 $GlobalConstant.True,元件將會停用。 此屬性接受單一值布林值資源。 |
| 檔案上載標籤 | 必要。顯示在上載按鈕上方的標籤。 此屬性接受單一值資源。該值會視為文字處理。 |
| 暫留文字 | 使用者將滑鼠停在元件上顯示的工具提示。 此屬性接受單一值資源。該值會視為文字處理。 |
| 相關記錄識別碼 | 必要。與檔案相關聯記錄的識別碼。如果沒有值傳送過來,元件將會停用。 此屬性接受單一值資源。該值會視為文字處理。 |
| 必要 | 要求使用者在前往下個畫面前先輸入值。 |
將「檔案上載增強型元件」的值儲存在流程中
所有屬性皆可儲存在流程變數中,但通常您必須儲存以下屬性。當使用者瀏覽到下一個畫面時,系統會指派值至流程變數。
| 屬性 | 描述 |
|---|---|
| 內容文件識別碼 | 已上載檔案的識別碼。 您可以將此值儲存在「文字」集合變數中。 |
| 上載檔案名稱 | 已上載檔案的名稱。 您可以將此值儲存在「文字」集合變數中。 |
設定元件可視性
指定決定流程何時顯示元件的邏輯。
| 選項 | 描述 |
|---|---|
| 顯示元件的時間 | 使用條件邏輯設定元件何時顯示。 您可以將元件設定為:
|
驗證輸入
提供用來評估使用者輸入內容是否有效的公式,以及無效時要顯示的錯誤訊息。
| 選項 | 描述 |
|---|---|
| 錯誤訊息 | 如果使用者輸入無效值,則指定會在元件下方顯示的錯誤訊息。 |
| 公式 | 提供公式運算式以傳回布林值。 如果公式運算式評估為 true,表示輸入有效。如果公式運算式評估為 false,則錯誤訊息會顯示在元件下方。 如果使用者將欄位留空,且欄位非必要,則流程不會執行驗證。如果使用者將欄位留空且欄位是必要欄位,則欄位會顯示預設錯誤訊息,而不是您的自訂錯誤訊息。 |
指定重新造訪畫面值的行為
指定當使用者輸入值、瀏覽至上一個畫面,然後返回具有此元件的畫面時,元件會執行何種動作。
檔案上載限制
依預設,若 Salesforce 未變更限制,則您最多可以同時上載 10 個檔案。同時上載檔案數量的組織上限為 25 個,最低為 1 個。上載檔案的大小上限為 2 GB。在 Experience Cloud 網站中,檔案大小限制與允許的類型會遵循網站檔案仲裁所決定的設定。
考量事項
- 如果使用者未上載任何檔案,則「內容文件識別碼」和「上載的檔案名稱」 輸出的值為空白集合,以
“[]”表示。如果您勾選 ISBLANK 或 ISNULL 運算子,值一律為false。 - 依預設,來賓使用者的檔案會封鎖而無法上載。管理員可以變更設定,讓來賓使用者能夠上載檔案。進入 設定 | Salesforce Files | General 設定,然後選取「允許網站來賓使用者上載檔案」。此設定僅在組織中已啟用「安全」來賓使用者記錄存取設定時才有效。
- 當來賓使用者上載檔案時,元件會傳回
ContentVersionId,而不會傳回ContentDocumentId。 - Lightning Out 不支援「檔案上載」元件。
- 與透過 URL 存取的流程搭配使用時,在行動應用程式或瀏覽器上不支援檔案上載元件。在 Lightning 應用程式產生器或體驗產生器中使用檔案上載元件時,不適用此限制。
