建立自訂表單

注意

顯示自訂表單動作是以調適型卡片技術為基礎。 請參考此頁面以尋找關於調適型卡片的詳細資訊。

訊息方塊可讓您提示使用者鍵入各種輸入，例如文字、日期及檔案，或是在畫面上顯示資訊和結果。

雖然此群組的大部分動作都可以處理需要單一輸入的案例，但是部分自動化可能需要輸入或/和輸出的組合。 解決這些案例的最佳方法是顯示自訂表單動作。

若要建立自訂表單，請部署顯示自訂表單動作，並選取自訂表格單設計工具按鈕，以打開表單設計工具。

在設計工具的左側有一個包含所有可新增至表單的可用輸入元素清單 (例如文字、日期及檔案輸入)，以及一些非互動式元素 (如文字和影像)。

若要將元素新增至自訂表單，請按兩下該元素，或將它拖放到設計工具的工作區區域中。 使用表單設計工具底部的預覽窗格，查看設定的表單在執行階段中的外觀。

新增元素之後，您就可以處理表單設計工具右側所有可用的屬性。 可用的屬性可能會因所選取元素的性質而不同。

注意

除了表單元素之外，表單設計工具還提供了一些屬性來設定自訂表單的上層對話方塊外觀。 若要設定這些屬性，請選取工作區的空白空間，然後查看相應窗格上的可用屬性。

當使用者填入自訂表單時，提供的資料會儲存在 CustomFormData 自訂物件變數中。 若要存取儲存在自訂物件中之特定輸入元素的值，請使用以下標記法：%CustomFormData['ElementID']%。

重要

每個元素的識別碼都必須是唯一的，且不可以空白。 此外，它必須以字母開頭，可以包含拉丁字母、數字和空格。 您無法在識別碼欄位中使用變數。 如果提供的識別碼不正確，則在關閉並儲存表單設計工具時，會自動還原上次使用的有效識別碼。

注意

您可以在進階資料類型中找到有關自訂物件和如何使用它們的詳細資訊。

除了輸入和非互動式元素之外，表單設計工具還提供了一些動作以在表單中執行其他功能。

將動作視為按鈕，讓您根據按下的按鈕來執行不同的功能。 例如，使用提交動作做為 [儲存] 按鈕來收集和儲存提供的使用者資料，供稍後在您的流程中使用。

注意

動作只能新增在表單結構結尾，即在任何其他表單元素類型之後。

與其他元素一樣，每個動作都有一個唯一描述它的識別碼。 選取動作時，其識別碼會儲存在 ButtonPressed 變數中。

當表單包含多個動作時，請使用此變數和條件來檢查哪個動作被按下，並為每個案例執行不同的功能。 若要尋找有關執行此行為的詳細資訊，請參閱處理自訂表單。

以下的螢幕擷取畫面顯示先前設定的自訂表單在流程執行時的外觀。

自訂表單元素

元素名稱	類型	規格	配置屬性	驗證屬性	樣式屬性	背景影像
自訂表單	上層對話方塊	標題	最小高度 (以像素為單位)，垂直內容對齊			URL、填滿模式、水平對齊、垂直對齊
文字輸入	輸入	識別碼、標籤、預設值、多行、樣式、最大長度	間距、分隔符號、高度	需要驗證、錯誤訊息、模式
數字輸入	輸入	識別碼、標籤、預設值、最小值、最大值	間距、分隔符號、高度	需要驗證、錯誤訊息
日期輸入	輸入	識別碼、標籤、預設值、最小值、最大值	間距、分隔符號、高度	需要驗證、錯誤訊息
時間輸入	輸入	識別碼、標籤、預設值、最小值、最大值	間距、分隔符號、高度	需要驗證、錯誤訊息
切換輸入	輸入	識別碼、標籤、標題、預設值、開啟時的值、關閉時的值	間距、分隔符號、高度換行	需要驗證、錯誤訊息
選項集輸入	輸入	識別碼、標籤、預設值、允許多重選取、樣式、選擇	間距、分隔符號、高度、換行	需要驗證、錯誤訊息
檔案輸入	輸入	識別碼、標籤、預設值	間距、分隔符號、高度	需要驗證、錯誤訊息
文字區塊	項目	識別碼、文字	間距、分隔符號、水平對齊、高度、換行、最大行、最大寬度		字體類型、大小、粗細、色彩、淡色、斜體、刪除線
影像	元素	識別碼、URL、替代文字	間距、分隔符號，水平對齊、高度、高度 (以像素為單位)、寬度 (以像素為單位)、大小		樣式、背景色彩
提交	動作	識別碼、標題、忽略提供的輸入
開啟 URL	動作	識別碼、標題、URL

自訂表單元素屬性

屬性名稱	選用	接受	預設值	描述
允許多重選取	N/A	布林值	False	允許選取多重選擇
替代文字	是	文字值		描述影像的替代文字
背景色彩	是	文字值		將背景套用至透明影像。 此屬性會採用影像樣式。 此屬性只能接受十六進位值
選項	是	標題和值		描述選項集中使用的選項。 由標題 (要顯示的文字) 和值 (選項的原始值) 組成
色彩	N/A	預設、深色、淺色、輔色、良好、警告、注意	預設	控制文字的色彩
預設值	是	文字值、數值		輸入元素的預設值
錯誤訊息	是	文字值		輸入的內容無效時顯示的錯誤訊息
填滿模式	N/A	封面、水平重複、垂直重複、重複		說明影像應如何填滿區域
字型類型	N/A	預設、等寬	預設	用於轉譯的字型類型
高	N/A	自動、延展、像素	自動	指定元素的高度。 「像素」選項只適用於影像元素
高度 (以像素為單位)	否	數值	0	指定影像所需的高度。 影像將扭曲以符合確切的高度。 這會覆寫 'Size' 屬性。 預設值 0 會判斷未指定任何特定高度
水平對齊	N/A	靠左、置中、靠右	文字區塊：左 影像：左	控制此元素的水平定位方式。 對於自訂表單，其說明必須裁切影像或使用重複填滿模式時，背景影像的對齊方式
識別碼	否	文字值	依元素而定	值的唯一識別碼。 用於在執行提交動作時識別收集的輸入。 如果暫時使用無效的識別碼且表單設計工具已關閉，則將套用使用的最後一個有效識別碼
忽略提供的輸入	N/A	布林值	False	如果啟用，這個動作會關閉表單而不儲存選取的輸入，以 [取消] 按鈕的形式運作
斜體	N/A	布林值	False	如果啟用，文字將變為斜體
標籤	是	文字值		此輸入的標籤
最大長度	否	數值	0	指定要收集的最大字元數。 預設值 0 會判斷未指定任何最大長度
最大行數	否	數值	0	指定要顯示的最大行數。 預設值 0 會判斷未指定任何最大行數
最大值	是	文字值		最大值提示。 如果是日期和時間輸入，則值必須以您電腦的地區格式表示
最大寬度	否	數值	0	指定文字區塊的最大寬度 (以像素為單位)。 預設值 0 會判斷未指定任何最大寬度
最小高度 (以像素為單位)	否	數值	0	指定表單的最小高度。 預設值 0 會判斷未指定任何最小高度
最小值	是	文字值		最小值提示。 如果是日期和時間輸入，則值必須以您電腦的地區格式表示
多行	N/A	布林值	False	如果啟用，則允許多行輸入
模式	是	文字值		指示此文字輸入所需格式的規則運算式
分隔符號	N/A	布林值	False	啟用時，會在元素上方畫出分隔線
大小	N/A	文字區塊：預設、小、中、大、特大 影像：自動、延伸、小、中、大	文字區塊：預設 影像：自動	控制文字或影像的大小
間距	N/A	預設、無、小、中、大、特大、邊框間距	預設	控制此元素與前一個元素之間的間距
刪除線	N/A	布林值	False	如果啟用，會劃去文字
樣式	N/A	文字輸入：文字、電話、URL、電子郵件 選項集輸入：精簡，已展開 影像：預設、人員	文字輸入：文字 選項集輸入：精簡 影像：預設	文字提示、選項集或影像的樣式
淡色	N/A	布林值	False	如果啟用，會稍微降低文字的色調，使其不那麼醒目
文字	是	文字值	新文字區塊	要顯示的文字
標題	是	文字值	切換輸入：新的切換輸入 提交：確定	自訂表單的標題或代表此動作之按鈕的切換或標籤
URL	是	文字值		影像的 URL (適用於影像元素和自訂表單) 或要開啟的 URL (使用於開啟 URL 動作)
需要驗證	是	布林值	False	判斷此輸入是否為必要
關閉時的值	是	文字值	False	切換開關關閉時的值
開啟時的值	是	文字值	True	切換開關開啟時的值
垂直對齊	N/A	上、中、下		說明必須裁切影像或使用重複填滿模式時，影像的對齊方式
垂直內容對齊	N/A	上、中、下	上	定義內容在容器中的垂直對齊方式。 僅適用於固定高度表單，或指定最小高度的表單
粗細	N/A	預設、較細、較粗	預設	控制文字粗細
寬度 (以像素為單位)	否	數值	0	影像所需的畫面寬度。 這會覆寫 'Size' 屬性。 預設值 0 會判斷未指定任何特定寬度
換行	N/A	布林值	False	如果已啟用，則允許文字換行。 否則將剪裁文字

已知問題與限制

• 問題：當 URL 屬性包含百分比字元時，預覽窗格似乎可以正常運作，但會出現無效值驗證錯誤。

• 因應措施：會發生此問題是因為 Power Automate 嘗試將百分比字元解析為變數或運算式。 若要解決這種情況，請將 URL 儲存在流程較早的變數中，避開百分比字元，然後在 URL 屬性中使用該變數。 預覽將不會顯示影像，但會在執行階段顯示。