Bloom 深度链接

在许多情况下,以初始上下文启动 Bloom 是有用的,这样您的 Bloom 之旅可以从该上下文出发。该上下文可以由应用程序、网站、电子邮件或您使用的其他媒介提供。为了支持初始上下文,您可以构建一个包含所需标识符的模式或搜索查询的链接,以便能够立即从该起点开始探索。

Neo4j Bloom 深度链接是包含用于指定探索上下文的参数的 URL。链接可针对所有 Bloom 部署方式构建;包括服务器托管的 Bloom、桌面托管的 Bloom 应用程序以及 Neo4j Aura 中的 Bloom。虽然所有部署方式的链接参数相同,但 URL 会根据您是要访问服务器托管的 Bloom、桌面托管的 Bloom 还是 Aura 中的 Bloom(通过 Workspace 中的 Explore 选项卡或 Aura 控制台中的独立应用)而有所区别。

Bloom 在深度链接中接受以下参数

表 1. 深度链接参数

参数

描述

search

Bloom 能识别的任何 搜索输入类型

perspective

视角的名称。

run=true/false

是否运行查询(默认设置为 false)。

这些参数是可选的,如果其中包含空格或其他特殊字符,需要进行 URL 编码。

视角是与特定数据库关联的,数据库信息随视角一起存储,这意味着通过深度链接打开 Bloom 时,会自动根据视角选择对应的数据库。

点击深度链接后,传入的搜索上下文会填充到搜索输入框中。如果 run 参数设置为 true,Bloom 将自动执行获取到的第一个查询建议。如果省略 run 参数,则默认设为 false,Bloom 只会使用搜索输入来获取建议。视角上下文用于为特定探索选择预期的视角。

为了说明这一点,设想您得到了一份特定职能部门的员工名单。

bloom deeplink list

基于此,您可能希望在 Bloom 中探索某位特定员工的图谱。

bloom deeplink

服务器托管的 Bloom

当您想在网页浏览器中链接到 Bloom 时,需要为服务器托管的 Bloom 构建链接。链接格式如下:

http://<server_hosting_Bloom>[:<http-port>]/bloom/[?<parameter>][&<parameter>]...
https://<server_hosting_Bloom>[:<https-port>]/bloom/[?<parameter>][&<parameter>]...

在上面的示例中(如果希望链接直接运行查询),链接应构建如下:

http://1.1.1.1:7474/bloom/?search=employee%203115112&perspective=HRM%20Perspective&run=true

请记住,如果参数中包含空格或特殊字符,需要进行 URL 编码。

桌面托管的 Bloom

深度链接仅在 Neo4j Desktop 版本 1.5 和 1.6 only 中受支持。

当您想链接到 Bloom 并在 Neo4j Desktop 中打开它时,需要为桌面托管的 Bloom 构建链接。链接格式如下:

neo4j://graphapps/neo4j-bloom/[?<parameter>][&<parameter>]...

在上面的示例中(如果希望链接直接运行查询),链接应构建如下:

neo4j://graphapps/neo4j-bloom/?search=employee%203115112&perspective=HRM%20Perspective&run=true

请记住,所有参数如果包含空格或其他特殊字符,都需要进行 URL 编码。

指向桌面托管的 Bloom 的深度链接需要一个对相应 Neo4j 图数据库的 active(活动)连接,并使用桌面中为该图数据库存储的用户凭证。

Aura 中的 Bloom

如在 Bloom in Neo4j Aura 中所述,Bloom 在 Aura 控制台中以 Explore 形式提供。

Aura 控制台中 Explore 的链接格式如下:

https://console-preview.neo4j.io/tools/explore[?<parameter>][&<parameter>]

在上面的示例中(如果希望链接直接运行查询),链接应构建如下:

https://console-preview.neo4j.io/tools/explore?search=employee%203115112&perspective=HRM%20Perspective&run=true

如果您希望直接链接到控制台中的 Bloom/Explore 应用,链接格式如下:

https://bloom.neo4j.io/index.html[?connectURL=AURADBCONNECTINFO][&<parameter>]

在上述相同的示例搜索中(如果希望链接直接运行查询),链接应构建如下:

https://bloom.neo4j.io/index.html?connectURL=neo4j%2Bs%3A%2F%2F93918bf2.databases.neo4j.io&search=employee%203115112&perspective=HRM%20Perspective&run=true

请记住,所有参数如果包含空格或其他特殊字符,都需要进行 URL 编码。