表单

本文档涉及 Neo4j Labs 旗下不受支持的 NeoDash 版本。如需使用受支持的 NeoDash 产品，请参阅 NeoDash 商业版。

表单是一种特殊类型的报告，允许用户运行预定义的、带参数的查询。单个表单可以包含

创建表单时，需要编写在点击提交按钮时调用的 Cypher 查询。该查询随后可以使用作为输入指定的参数。下图展示了一个表单示例——左侧是用于定义表单的设置，右侧是用户可见的最终表单。

示例

没有参数的表单实际上是运行指定查询的按钮。可以使用一个或多个按钮在图中执行简单操作。下面是一个简单按钮表单的示例。提交时，将执行以下查询

MERGE (c:Counter)
SET c.count = c.count+1

要创建带动态输入的表单，需要同时使用参数和按钮。下面是一个删除图中节点的表单示例。提交时，将执行以下查询

MATCH (p:Person)
WHERE p.name = $neodash_person_name
DETACH DELETE p

通过隐藏提交按钮，表单也可以作为一种节省空间的方式来嵌入多个参数选择器。请在报表的高级设置中禁用 Has Submit Button，并向表单中添加两个或更多参数选择器。

名称	类型	默认值	描述
表单按钮文本	文本 (text)	提交	显示在提交表单的按钮上的文字。
重置按钮文本	文本 (text)	重置表单	显示在将表单恢复为数据录入模式的按钮上的文字。
确认消息	多行文本	表单已提交。	表单成功提交后向用户显示的文字。
提交后清除参数	开启/关闭	开启	表单提交后清除仪表盘中的所有参数。
有提交按钮	开启/关闭	开启	启用后，用户可以通过按钮提交表单。禁用后，表单将进入仅参数模式。
有重置按钮	开启/关闭	开启	启用后，用户可以通过按钮将表单重置以继续输入数据。
有提交消息	开启/关闭	开启	启用后，提交表单后会进入单独的页面；否则始终停留在数据录入模式。
报表说明	markdown 文本		指定后，会在报告标题添加另一个按钮，点击可打开弹出窗口。该弹窗包含此设置渲染后的 Markdown 内容。

名称

类型

默认值

描述

表单按钮文本

文本 (text)

提交

显示在提交表单的按钮上的文字。

重置按钮文本

文本 (text)

重置表单

显示在将表单恢复为数据录入模式的按钮上的文字。

确认消息

多行文本

表单已提交。

表单成功提交后向用户显示的文字。

提交后清除参数

开启/关闭

开启

表单提交后清除仪表盘中的所有参数。

有提交按钮

开启/关闭

开启

启用后，用户可以通过按钮提交表单。禁用后，表单将进入仅参数模式。

有重置按钮

开启/关闭

开启

启用后，用户可以通过按钮将表单重置以继续输入数据。

有提交消息

开启/关闭

开启

启用后，提交表单后会进入单独的页面；否则始终停留在数据录入模式。

报表说明

markdown 文本

指定后，会在报告标题添加另一个按钮，点击可打开弹出窗口。该弹窗包含此设置渲染后的 Markdown 内容。