Bloom 深链接

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

Neo4j Bloom 深链接是包含指定探索上下文的参数的 URL。可以为所有 Bloom 部署构建链接;服务器托管和桌面托管的 Bloom 应用程序,以及 Neo4j Aura 中的 Bloom。虽然所有部署的链接参数相同,但 URL 特定于您是否尝试访问服务器托管的 Bloom、桌面托管的 Bloom 或 Aura 中的 Bloom(通过工作区中的“浏览”选项卡或作为 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

当您想要在 Web 浏览器中链接到 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

当您想要链接到 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 图建立活动连接,并使用 Desktop 中为相关图存储的用户凭据。

Aura 中的 Bloom

Neo4j Aura 中的 Bloom中所述,Bloom 可作为工作区中的“浏览”选项卡作为 Aura 控制台中的独立应用程序使用。

工作区中“浏览”选项卡的链接格式如下所示

https://workspace.neo4j.io/workspace/explore[?<parameter>][&<parameter>]

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

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

如果要直接链接到控制台中的 Bloom/浏览应用程序,链接格式如下所示

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

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

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

请记住,如果所有参数包含空格或特殊字符,则应进行 URL 编码。