微程式用戶手冊
主頁
主頁
  • 基礎控制項

基礎控制項

基礎控制項是最常用的資料錄入控制項,如填寫姓名的單行文本、選擇性別的單選框、填寫年齡的數值等

單行文本

用於在表單中收集文本型資料,例如姓名、簡介、電話號碼和會員卡號等

單行文本最大長度爲200字符

1610096008442-4cecfcaa-bdd2-4980-ac3a-8d957188e95e.gif控制項屬性

  • 預設值:控制項的預設顯示值,顯示在表單中
  • 水印文本:文本框中顯示的水印,獲得焦點或輸入內容後水印消失
  • 正則校對:設定文本框的格式,採用JS的正則規則,系統預置了8種模板,可選擇或輸入。輸入正則表單式後,系統會對輸入的內容校對。
  • 計算規則:設定控制項的計算規則,支持函數計算如下圖所示

1612428780235-c46d116f-d2ce-4627-857e-b2f10dabee92.png

多行文字

表單設計:1610096034428-10bdaa1d-90cf-44ee-bb9f-7b1dd7efa44e.png

用於在表單中錄入多行資料的場景,例如會議記錄和訂單詳情等。

多行文字無法選擇不同格式,預設錄入字符限制2000字符,可以修改,長度無上限

多行文字的輸入框樣式可以設定爲富文本形式

1610698052580-8aeb4eeb-9ee5-4474-8e25-895a494f50ae.png

前端展示:

1612432319249-4970fc53-e0ce-478a-b68e-b4590f74e777.png

日期

用於表單中選擇日期、時間的場景,如出差日期、請假時間等,可以設預設值爲目前時間1610096145084-f21e54bf-e055-4b2f-8f41-845d74f15370.gif

  • 顯示模式:日期顯示的模式,有4種模式:年月、年月日、年月日時分、年月日時分秒,預設第一種
  • 日期最小/大值:設定表單裏面能選擇的最小/大日期,可以直接選擇日期或選擇日期型的資料項(包括建立時間、修改時間)。設定了最小或最大值後,在這個範圍外的日期置灰不能選

數值

用於表單中數值記錄或計算的場景,只允許錄入數字,如採購商品的數量、價格等

1610096176444-d5e997aa-a72b-4dd6-b38c-d74383e238f9.gif

  • 格式:數值顯示的格式。格式可選:空(不限小數位數),整數(2000)、一位小數(2,000.0)、兩位小數(2,000.00)三位小數(2,000.000)、四位小數(2,000.0000)、五位小數(2,000.00000)、六位小數(2,000.000000)、七位小數(2,000.0000000)、八位小數(2,000.00000000)百分比(20%)、百分比一位小數(20.0%)、百分比兩位小數(20.00%)、人民幣(¥2,000.00、¥2,000.00、¥2,000.00)、美元($2,000.00、$2,000.000、$2,000.0000)、歐元(€2,000.00、€2,000.000、€2,000.0000)、港幣(HK$2,000.00、HK$2,000.000、HK$2,000.0000)
  • 數值格式支持5,6,7,8位小數點;
  • 當表單的資料項設定爲空時,展示與計算 * 展示 + 輸入中,超過位數後,不顯示輸入無效,且會有小浮框提示。
    • 1623402221076-8440a6ea-58de-472b-b20e-86fdbd7485e5.png

        + 失焦狀態,保留8位小數
        + 送出後,保留8位小數
      
      • 計算
        • 如果計算結果超過8位小數,保留8位小數即可。
      • 邏輯:數值限制:最大長度16位,精度8位(8位小數)
  • 計算規則:設定控制項的計算規則,支持多個資料項(數值類型)的加、減、乘、除、求和、平均值、最大值、最小值、計數、向上取整、向下取整,例如:總價=價格*數量

1612428504755-e5191df2-ffdf-4d81-abe6-42b5e528c417.png

  • 備註:格式,只是一個符號,比如%,輸入20,顯示20%,資料庫儲存的是20,並不是0.2,涉及到計算需要除以100

單選框

用於在表單中選擇單個選項的場景,例如性別和滿意度等。

1610096199061-d4295a14-03e7-4094-a014-de1b5541001f.gif

  • 選項:單選列表的選項值,可新增多個,單個選項值不能超過200字符,選中的值爲預設值。
  • 方向:表單中選項的橫向和縱向顯示,預設橫向,單個選項內容較多時時可以選擇縱向
  • 顯示設定:勾選項/全部項,選擇勾選項,在表單運行時,只顯示表單編輯時勾選的選項

1610096224972-13570fc6-512b-4c8f-a657-9e46ee67797e.png

複選框

用於在表單中選擇一個或多個選項的場景,例如多選題和偏好選項等。

下拉框

用於在表單中單選或多選的場景,以下拉形式展現,例如選擇行業、區域等

1610096246295-8b16d904-95ae-42f8-9266-7dc9511d9622.png

  • 是否多選:選擇單個or多個選項
  • 顯示空選項:下拉框中是否存在空值,選擇true時,下拉選項中有一個空值
  • 空選項值:顯示空,選項爲true時顯示

下拉框排序

當選項設定來自引用的業務模型,可以設定選項的排序欄位,和排序方式。

1610699233625-5fbad0fd-7f14-47eb-8004-6bee124106ce.png


邏輯型

用於表單中邏輯選擇的場景,例如是否同意、是否報銷等,勾選選項即爲是,預設勾選

附件

用於表單中上傳文件的場景,如上傳合同、詳細材料等

  • 限定文件格式:設定上傳的文件格式,格式如:.jpg,.png,.doc
  • 單個文件大小:上傳的單個文件大小,上傳的附件不能超出設定大小200M
  • 批次下載:是否可批次下載已上傳的文件,文件下方有批次下載按鈕
  • 上傳/刪除附件事件:上傳/刪除附件時系統彈出的提示,填寫格式如:alert(提示)
  • 附件支持列表匯出爲連結。

圖片

  • 用於表單中上傳圖片的場景,如請假單、病例截圖等
  • 圖片支持格式:.jpg,.jpeg,.png,.gif,.bmp,.svg,.tif,其他類型不支持
  • 上傳圖片數量:允許上傳的圖片數,單張/多張,預設多張
  • 只允許拍照:行動端上傳圖片時只能拍照上傳,不能選擇已有相冊中的圖片,此功能僅行動端有效。
  • 水印:拍照後自動在圖片產生包含“拍照人、拍照時間、拍照地點”的水印。
  • 壓縮:上傳圖片會進行壓縮處理,可節省儲存的空間及提高圖片預覽的速度。
  • 圖片質量:壓縮打開時展示,壓縮圖片的質量
  • 表單運行圖片預覽,支持下載和旋轉。

手寫簽名

用於表單中新增簽名的場景,只支持行動端

地址

用於選擇省市區填寫詳細地址,或使用地圖定位的場景,如目前位置、公司地址等

1610096273397-e35f08be-4528-41d8-b2e4-3397ff68b01c.gif

  • 控制項類型:可切換地址、地圖定位
  • 地址格式:下拉選擇,選項爲:省/市/縣區、省/市、省,預設是:省市縣區
  • 顯示詳細地址:是否顯示詳細地址框,可手動輸入詳細地址
  • 顯示空選項: 是否顯示空,當設定格式爲:省/市/縣區,只需選擇省市時,縣區就可以選擇空值

前臺表單中,在詳細地址中使用地圖選擇位置,並自動填寫到地址中

地圖定位

  • 顯示模式:下拉選擇,準確定位/任意位置。準確定位常用於定位,如公司附近打卡;任意位置用於獲得公司地址訊息等
  • 精確範圍:準確定位時顯示,選擇定位的周邊範圍,下拉框選擇:1km,500m,200m,預設500m

人員單選、人員多選、部門單選、部門多選

用於表單中選擇人員或部門的場景,如審批人、同行人員、所屬部門等1610096294478-34e164b7-3b15-462c-97b9-e2092b513e27.gif

  • 是否多選:可以選擇組織或用戶的個數
  • 可選類型:前臺選擇的類型,選擇組織、用戶、全部
  • 預設值:預設顯示的用戶或組織,可選擇發起人(類型爲用戶或全部)或發起人部門(類型爲組織或全部),或不選擇
  • 組織根節點:用於控制前臺可選擇的組織或用戶,設定後前臺只能選擇根節點下的組織用戶,當表單選人控制項設定了組織根節點,則表單運行時按照組織根節點展示(同時判斷用戶查看權限),當表單沒有設定組織根節點,則按照組織部門查看權限執行。
  • 是否遞歸展示:是否允許根節點下方子部門遞歸顯示,選擇false,前臺只顯示根節點下的組織和用戶,不顯示子部門的用戶等,組織根節點不爲空時顯示
  • 角色範圍:控制前端選擇的用戶,選擇一個角色後,表單中只顯示角色下的用戶。類型爲用戶時顯示
  • 對應關係:選擇用戶時,將用戶訊息對應給其他欄位,如用戶的部門、電話等,用戶單選時顯示
  • 支持預設值顯示目前用戶第一級、第二級、第三級組織、第四級組織、第五級組織

選人控制項對應說明

1、只有人員控制項可以對應自己的部門訊息、角色、基本訊息等給到部門控制項或其他控制項。

1617953791108-c8671e5b-d275-49e2-b689-aa3c43ec681b.png

2、選人控制項的對應與根節點相關,如果選人控制項對應中,根節點比對應的部門控制項大,那麼有可能對應失敗。

場景:如果我設定選人控制項根節點爲一級別組織,對應的部門控制項爲二級組織,那麼選人控制項的一級組織是無法對應到部門控制項的。

1617953919916-575d9525-1fdd-49d1-bd9c-127a7129bca3.png

3、如果根節點的組織不匹配,也是無法對應的,比如企業微信的選人控制項要對應部門給釘釘的部門控制項。那麼對應必然失敗。

更新: 2022-09-28 21:02:02
原文: https://www.yuque.com/skwme4/hyk0u0/grknf4