跳转至

Generate a graph from other applications（从其他应用生成图谱）

You can configure a link within other Foundry applications that will automatically generate a pre-populated Vertex graph.

Using URL parameters to generate a graph

You can use URL parameters to perform the following actions:

  • Start with an existing graph or create a new graph.
  • Add objects to the graph by specifying an object ID or object set ID.
  • Running a Search Around function.
  • Setting the time range of the time selector.

These parameters apply only to the URL that creates new graphs (/workspace/vertex/graph/create):

  • selectObjectRid: Selects and centers the graph on the specified object, if it is present.
  • objectRid: Adds the specified object as a node to the graph.
  • objectSetRid: Adds all objects in the specified object set as nodes to the graph.
  • searchAroundFnRid: Adds to the graph the result of the specified Search Around function. The function will be called with either a single object if used with the objectRid parameter, or all the objects from the objectSetRid object set.
  • Must be used in conjunction with either the objectSetRid or the objectRid URL parameter.

The following parameters apply to URLs both for existing graphs (/workspace/vertex/graph/{graphRid}) and newly-created ones (/workspace/vertex/graph/create):

  • selectedTime: Sets the selected time.
  • startTime: Sets the start time for a time range.
  • endTime: Sets the end time for a time range.

:::callout All times can be either UNIX timestamps in milliseconds or ISO-formatted dates/datetimes (e.g. 2020-02-15/2020-02-15 13:45:00 UTC). If selectedTime is specified but at least one of startTime and endTime is not, the time range will have the default duration and be centered around the selected time. If startTime and endTime are specified but selectedTime is not, the selected time will be the same as startTime. :::

Generate a Vertex graph from other applications

Once you set your URL parameter, you can use this link to generate the pre-configured graph from other applications. For example, using the Hyperlinks Widget in Object Explorer:

Add Link to Widget

中文翻译

从其他应用生成图谱

您可以在其他 Foundry 应用中配置链接，自动生成预填充的 Vertex 图谱。

使用 URL 参数生成图谱

您可以使用 URL 参数执行以下操作：

  • 从现有图谱开始或创建新图谱。
  • 通过指定对象 ID（object ID）或对象集 ID（object set ID）向图谱添加对象。
  • 运行周边搜索（Search Around）功能。
  • 设置时间选择器的时间范围。

以下参数仅适用于创建新图谱的 URL（/workspace/vertex/graph/create）：

  • selectObjectRid：如果指定对象存在，则将其选中并居中显示在图谱中。
  • objectRid：将指定对象作为节点添加到图谱中。
  • objectSetRid：将指定对象集中的所有对象作为节点添加到图谱中。
  • searchAroundFnRid：将指定周边搜索（Search Around）功能的结果添加到图谱中。该功能将根据参数调用：若与 objectRid 参数配合使用，则针对单个对象调用；若与 objectSetRid 对象集配合使用，则针对该对象集中的所有对象调用。
  • 必须与 objectSetRid 或 objectRid URL 参数之一配合使用。

以下参数适用于现有图谱（/workspace/vertex/graph/{graphRid}）和新创建图谱（/workspace/vertex/graph/create）的 URL：

  • selectedTime：设置选中的时间。
  • startTime：设置时间范围的开始时间。
  • endTime：设置时间范围的结束时间。

:::callout 所有时间均可使用毫秒级 UNIX 时间戳或 ISO 格式的日期/日期时间（例如 2020-02-15/2020-02-15 13:45:00 UTC）。如果指定了 selectedTime 但未指定 startTime 和 endTime 中的至少一个，则时间范围将采用默认时长并以选中时间为中心。如果指定了 startTime 和 endTime 但未指定 selectedTime，则选中时间将与 startTime 相同。 :::

从其他应用生成 Vertex 图谱

设置好 URL 参数后，您可以使用此链接从其他应用生成预配置的图谱。例如，在对象浏览器（Object Explorer）中使用超链接小组件（Hyperlinks Widget）：

向小组件添加链接