Definition

列表表格 最好被描述为 表单表格 ，但是能够从数据列表中添加新的记录。

New Feature

New feature added in Joget Workflow v6.

  • Paging
  • Delete Options
  • Multiple Lines Format Type


图1：在Form Builder中突出显示列表表格的屏幕截图

修改了 表单在  http://localhost:8080/jw/web/console/app/crm/1/form/builder/crm_contact

图2：突出显示在表单中使用列表表格添加新记录的屏幕截图

图3：突出显示添加在窗体中的列表表格中的新记录的屏幕截图

图4：列表表格属性

名称描述
ID元素ID（通过声明为“account”，将创建相应的数据库表列“c_account”）
Label元素标签显示给最终用户。
Data List数据列表
Columns

这里定义的列必须对应于上面选择的数据列表。

NameDescription
Value

目标表单的字段ID。

例：

在数据清单“Account Listing”中的“Account”表单中，有ID“id”和“accountName”的表单元素。

Label列标签。
Editable是/否
Format Type

如果你想格式化返回的值，你可以使用格式类型。

默认选择：文本。

可用的格式类型

  • Text -将文本格式的值设置为文本
  • HTML - 以HTML 格式输出数据
  • Multiple lines text - maintains the spacing formatting for multiple lines text, such as TextArea.

  • Date - 格式为日期。“ Format”字段中应包含原始日期和新的日期格式。

    Format: [KB：输入格式] | [KB：输出格式] 
    使用示例：
    原始值：2012/5/23 
    预期值：2012年5月23日
    格式：M/d/y|y/M/d
    注：日期格式请参考Java SimpleDateFormat。

  • Decimal - 格式为十进制。预期在“ Format”字段中的小数位数。
  • File - 显示值作为附件的链接。 在“ Format”字段中预期form def ID。  
  • Image - 将该值显示为附件的缩略图。 在“Format”字段中预期form def ID。

  • Options - Show the label of multiple choice element given the value given. Form Def ID is expected in the "Format" field.

    Expected Form Def ID

    Specify the Form Def ID that contains the actual Select Box / Radio / Check Box form element.

Format根据您选择的格式类型，可能会在此处输入其他参数。
Width

列宽以字符为单位

Sample
200px

 

图5：列表表格属性 - UI

名称描述
Enable Sorting Feature确定是否强制执行行的排序。
Field ID for Sorting
字段保持排序顺序; 必须与目标表单中的字段ID相对应。
Insert Button Label
插入按钮标签
Form to Edit Row
在添加行之后，用户可以通过在这里定义的表单中打开它来编辑记录行。
Form Submit Button Label (Normal Mode)
正常模式下的提交按钮的标签。
Form Submit Button Label (Readonly Mode)

提交按钮的标签处于只读模式。

Display field as Label when readonly?
 
Readonly

确定元素是否可编辑。

Disable Add Feature
确定是否可以添加新行。
Disable Delete Feature

确定是否可以删除一行。

Delete confirmation message
删除一行时的确认消息。
Show Row Numbering?
在最左边显示附加列来表示编号。
Paging SizeItems to be displayed per page.
Popup Dialog Height

字符高度

Sample
500px
Popup Dialog Width

Width in character

Sample
90%

 

图6：列表表格属性 - 验证和数据绑定器

名称描述
Validator

附加一个Validator插件来验证输入值。

When will validation takes place?

除非提交表格为“另存为草稿”，否则将在提交表格时进行验证。

Unique Column列/字段ID来标识记录标识。
Min Number of Row Validation (Integer)
最小行数验证（整数）
Max Number of Row Validation (Integer)
最大行数验证（整数）
Error Message
当不满足上述行要求时，将显示错误消息。
Load Binder
默认选项。表格数据将在其定义的数据库单元中以JSON格式保存/加载
Store Binder

默认选项。表格数据将在其定义的数据库单元中以JSON格式保存/加载

Delete Associated Grid Data?

If the popup form have grid element(s), this option will delete the inner grid data.

Caution

These 3 options: (Delete Associated Grid Data, Delete Associated Child Form Data, Delete Files), in combination, does apply to nested grid/child elements.

These options traverses the entire form tree. Upon encountering a 'false' condition, it will move on to the next grid/child element.

Example: Consider that the popup form has a form grid, form grid has a subform, subform has a file upload element with abc.pdf. If all options are checked, abc.pdf will be deleted. If all except ONE of the option is checked, abc.pdf will NOT be deleted.

Delete Associated Child Form Data?

If the popup form have child element(s), this option will delete the child data.

Caution

These 3 options: (Delete Associated Grid Data, Delete Associated Child Form Data, Delete Files), in combination, does apply to nested grid/child elements.

Delete Files?

If the popup form contains file upload element, this option will delete the actual uploaded file(s).

Caution

These 3 options: (Delete Associated Grid Data, Delete Associated Child Form Data, Delete Files), in combination, does apply to nested grid/child elements.

Abort Related Running Processes?If there are process instances related to the deleted row, this options will abort those process instances.

图7：列表表格属性 - 高级

名称描述
URL Request Parameters for Datalist

通过在此处定义过滤条件来优化目标数据列表选择。

名称描述
参数目标数据列表过滤器参数名称
字段ID当前表单元素字段ID
默认值搜索参数的默认值
  • No labels