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

仪表板 (Dashboards)

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

在 NeoDash 中,一个仪表板由若干页面组成,每个页面又可以包含多个报表。

Dashboard

例如:上图显示了一个包含三个页面的仪表板:Breweries(酿酒厂)、Beer Ratings(啤酒评分)和 Styles(风格)。窗口顶部显示了仪表板标题 My Beer Database Dashboard 🍺

当前选中了第一页,其中包含三个报表:一个表格、一个图表和一张地图。每个报表都可以有自己的名称,并且使用且仅使用一个 Cypher 查询来填充数据。有关报表工作原理的更多信息,请参阅“报表”章节。

仪表板管理

启动 NeoDash 后,您将可以选择创建新仪表板或打开现有仪表板(如果有)。连接后,可以使用侧边栏上的按钮来保存、加载或共享仪表板。

Save/Load/Share Button

保存仪表板

简单来说,NeoDash 仪表板就是一个 JSON 文件。例如,默认仪表板具有以下结构

{
  "title": "",
  "version": "2.0",
  "settings": {
    "pagenumber": 0,
    "editable": true,
    "fullscreenEnabled": true,
    "parameters": {}
  },
  "pages": [
    {
      "title": "Main Page",
      "reports": [
        {
          "title": "Hi there 👋",
          "query": "**This is your first dashboard!** \n \nYou can click (⋮) to edit this report, or add a new report to get started. You can run any Cypher query directly from each report and render data in a variety of formats. \n \nTip: try _renaming_ this report by editing the title text. You can also edit the dashboard header at the top of the screen.\n\n\n",
          "width": 3,
          "type": "text",
          "height": 3,
          "selection": {},
          "settings": {}
        },
        {
          "title": "",
          "query": "MATCH (n)-[e]->(m) RETURN n,e,m LIMIT 20\n\n\n",
          "width": 3,
          "type": "graph",
          "height": 3,
          "selection": {
            "Movie": "title",
            "Genre": "name"
          },
          "settings": {
            "nodePositions": {}
          }
        }
      ]
    }
  ]
}

打开保存对话框后,有三种保存仪表板的方式:

  1. 保存为文件。这会触发当前仪表板以 .json 文件的形式下载。

  2. 保存到 Neo4j。这会将仪表板的字符串表示形式作为节点存储在数据库中。当使用 Neo4j 多数据库功能时,您可以选择将仪表板保存在哪个数据库中。

  3. 直接复制粘贴 JSON 内容。

请注意,您当前活动的仪表板存储在浏览器缓存中。如果您清除缓存(Cookie),仪表板内容将会丢失。

加载仪表板

与保存界面一样,可以通过以下三种方式之一加载仪表板:

  1. 从文件加载。这需要您在计算机上选择一个 .json 文件。

  2. 从 Neo4j 加载。这需要您选择存储在数据库中的仪表板节点。从 Neo4j 加载时,您将看到按时间倒序排列的仪表板列表。

  3. 通过直接粘贴到编辑器中来加载 JSON 文件。

共享仪表板

可以通过生成直接链接来与其他用户共享仪表板。此链接将包含:

  • 指向仪表板的链接(直接 URL 或 Neo4j 中的仪表板名称)。

  • (可选)仪表板所报告数据库的凭据。请注意,使用此功能时,共享链接将包含数据库凭据,这可能存在安全风险。

  • 仪表板应以“编辑器模式”还是“独立模式”查看。后者将配置 NeoDash 在精简后的界面中运行,不启用任何编辑器功能。

在生产数据库上部署 NeoDash 时,不建议使用“共享”功能。建议改为设置独立的 NeoDash 部署。更多信息请参阅“发布”章节。

仪表板访问控制

利用此功能,您可以通过 Neo4j 原生的基于角色的访问控制 (RBAC) 功能来管理仪表板访问权限。在此窗口中,通过利用数据库中现有的标签或创建新标签,为当前选中的仪表板节点添加额外标签,从而规范访问权限。

您可以通过点击侧边栏仪表板名称旁边的三个点并选择“访问控制 (Access Control)”选项来找到此功能。

此方法应与分配给特定角色的标签受限权限结合使用。详情请参阅 访问控制管理

Dashboard Access Control

仪表板设置

点击仪表板侧边栏中的 设置 ⚙️ (Settings) 按钮,即可访问整个仪表板的设置。

Dashboard Settings

此窗口可用于控制以下设置:

名称 可更改 默认值 描述

可编辑

开启

如果启用,则以“编辑模式”显示仪表板。如果不启用,则以“视图模式”显示。在视图模式下,所有编辑功能将被禁用,页面和报表无法被移动、编辑或重命名。

启用报表全屏视图

开启

如果启用,报表右上角将显示 🔳 全屏 按钮,允许用户最大化可视化效果。

最大查询时间(秒)

20

查询被自动取消前允许执行的最长时间。如果您有复杂的分析查询,请增加此时间。

禁用行数限制

关闭

如果启用,仪表板的自动 行数限制 功能将被禁用。

页面编号

0

当前查看的仪表板页面编号。此项只能通过仪表板标题栏中的切换页面功能进行更改。

全局参数

{}

在仪表板中所有报表间共享的全局参数。有关全局参数的更多信息,请参阅下一节。

参数

仪表板参数是键值对,可以在报表的查询中使用。按照惯例,NeoDash 中的仪表板参数总是以 $neodash_ 开头。

参数只能通过 参数选择 (Parameter Select) 报表进行设置(和取消设置)。设置参数后,它将可用于仪表板中的所有报表。使用仪表板参数的查询如下所示:

MATCH (m:Movie)<-[a:ACTED_IN]-(p:Person)
WHERE m.title = $neodash_movie_title
RETURN m, a, p

深度链接参数

对于基于浏览器的 NeoDash 部署,您可以通过 URL 参数设置 NeoDash 参数。例如,当用户访问以下 URL 时:

https://neodash.graphapp.io/?neodash_person_name=Adam

这将在加载仪表板后将参数 $neodash_person_name 设置为 Adam

© . This site is unofficial and not affiliated with Neo4j, Inc.