跳转至

Configure Object Explorer(配置对象浏览器)

Customizable object type Groupings on Home Page

To create and add an object type to a group, visit the object type's metadata widget in the Ontology Manager. Note that you must have editor permission on the Ontology to create and add an object type to a group.

If there are custom groups configured, any non-hidden object types that do not belong to a group will be placed in a group at the bottom of the page called “Other”.

Linking to object view from Actions success toast

Once an Action has been successfully applied, the success toast (pop-up confirmation message) can be configured to display a hyperlink to the object view for the object instance that has been created or modified. This provides quick access to the object view for newly-created or modified objects.

To configure the success toast in this way, you will need to add a new type class (see code below) to the Primary Key parameter of the relevant create object Action or to the Object Reference List parameter of the relevant modify object Action. The type class can be added using the Ontology Editor app, which requires you to have ontology editing permissions.

kind: "actions"
name: "view_object_with_type:<OBJECT_TYPE_ID>"

Let’s walk through an example of adding a success toast that links to the object view for a newly-created object instance.

  1. The Ontology Action “Create New Aircraft” allows us to create a new Aircraft object instance.

Action Success Toast Typeclass

  1. In the pop-up menu, input the relevant information and then select “Submit”. In this case, an Aircraft object instance with Id of 187 and Aircraft Registration of Q-AHE will be created.

Apply Action

  1. Now that we have added the type class described above on the Primary Key parameter, the success toast will display a hyperlink to the newly-created object instance Q-AHE. Clicking on the hyperlink will bring us to the object view of this object instance.

Success Toast

Hiding Actions in Object Explorer

Actions will automatically be shown in three places across Object Explorer as described in the action type documentation. To hide an Action of an object type, add the hubble-oe:hide-action type class to the Object Reference List parameter in Ontology Editor app. You will need to have access to edit the ontology to do this.

Hide Actions Typeclass

Actions on a Dynamic Object Set

:::callout{theme="warning"} This feature is still in development and is subject to deprecation without an automatic migration. Thus, using it means taking a risk that you will need to manually migrate your actions in the future. If you plan to use this particular feature, contact your Palantir representative before doing so. :::

In some cases, you may want to use the results of an exploration as a dynamic object set, rather than a static object set. Dynamic object sets are saved as the representation of the filters applied. As such, when new data matches (or does not match) those filters, the object set will be updated.

The most typical use case of this feature is to add a reference to a dynamic object set as a property value on an object instance.

Let's walk through an example of creating an action that allows us to assign a dynamic set of Aircraft objects to an Airline object, based on the Aircraft Manufacturer's Serial Numbers (MSNs).

  1. Ensure that the Airline object type has a String property (in this case Aircraft Set) where you can add a reference to a set of "Aircraft" objects as a value. Enable value formatting for this property, and select Resource RID from the dropdown. This way, the object set RIDs assigned to this property will appear as a link to the object set in Object Explorer.

Value Formatting

  1. Now you're ready to create the action. On the action, add a Modify Object rule on the Airline object type's Aircraft Set property.

Modify Object Rule

  1. On the Aircraft Set parameter, add the following type class, where <OBJECT_TYPE_ID> is the object type ID of the object type you want this action to appear as an option for in the exploration view (in this case, the Aircraft object type).
kind: "hubble-oe-object-set-rid"
name: <OBJECT_TYPE_ID>
  1. Also on the Aircraft Set parameter, add the following type class, where <RESOURCE_RID> is the RID of a folder that contains the correct permissions you want to grant to the dynamic object sets. Note that the object sets are not exposed in a Project and are not searchable - this RID is only used to specify what permissions the saved object sets should receive.
kind: "hubble-oe-security-rid"
name: <RESOURCE_RID>
  1. Once the action has been created, navigate to an exploration on Aircraft objects. As an example, we might want to assign all Aircraft with an MSN between 5,025 and 5,050 to Frontier Airlines. To do so, filter down to those objects and select the newly created action from the Actions dropdown.

Assign Aircraft

This will automatically create a dynamic object set for your current exploration and assign it to the Aircraft Set property on the Airline object you select from the dropdown.

Choose Airline

  1. Now, a link to the set of Aircraft with an MSN between 5,025 and 5,050 will appear in the Aircraft Set property on the "Frontier Airlines Inc." object. If any new Aircraft with an MSN in this range are added to the ontology or any of the Aircraft currently in the set are removed from the ontology, the set will automatically be updated.

Airline Exploration

  1. Using a Linked Objects Exploration widget, you can see the contents of this dynamic object set by visiting the Object View for "Frontier Airlines Inc.":

Linked Objects Exploration

When configuring this widget, set the Initial Exploration to From Object Set RID Property and the Object Set RID Property to Aircraft Set.

Linked Objects Exploration Configuration

Default Layout Administrative Users

A user who belongs to the hubble-exploration-admins multipass group, or who has the Object Exploration Admin application permission in Control Panel, can rename, delete, or save default layouts for object types. The layout includes any changes that have been made to the results table configuration. If you are an admin user and wish to set a layout as default for all users, under Set as default layout tick the For all users checkbox when saving the layout, as seen in the image below.

Edit Default Layout


中文翻译


配置对象浏览器

首页上可自定义的对象类型分组

要创建对象类型并将其添加到分组中,请访问本体管理器(Ontology Manager)中该对象类型的元数据组件。请注意,您必须拥有本体的编辑权限才能创建对象类型并将其添加到分组中。

如果已配置自定义分组,任何不属于某个分组的非隐藏对象类型将被放置在页面底部名为"其他"的分组中。

从操作成功提示链接到对象视图

操作成功应用后,可以将成功提示(弹出确认消息)配置为显示指向已创建或已修改对象实例的对象视图的超链接。这为新建或修改的对象提供了快速访问对象视图的途径。

要按此方式配置成功提示,您需要在相关创建对象操作的主键参数或相关修改对象操作的对象引用列表参数中添加一个新的类型类(type class)(参见下方代码)。可以使用本体编辑器(Ontology Editor)应用程序添加类型类,这要求您拥有本体编辑权限。

kind: "actions"
name: "view_object_with_type:<OBJECT_TYPE_ID>"

让我们通过一个示例来演示如何添加指向新创建对象实例对象视图的成功提示。

  1. 本体操作"创建新飞机"允许我们创建一个新的飞机对象实例。

操作成功提示类型类

  1. 在弹出的菜单中输入相关信息,然后选择"提交"。在本例中,将创建一个ID为187、飞机注册号为Q-AHE的飞机对象实例。

应用操作

  1. 现在,我们已在主键参数上添加了上述类型类,成功提示将显示指向新创建的对象实例Q-AHE的超链接。点击该超链接将跳转到此对象实例的对象视图。

成功提示

在对象浏览器中隐藏操作

操作会自动显示在对象浏览器的三个位置,如操作类型文档所述。要隐藏某个对象类型的操作,请在本体编辑器应用程序中为对象引用列表参数添加hubble-oe:hide-action类型类。您需要拥有编辑本体的权限才能执行此操作。

隐藏操作类型类

对动态对象集的操作

:::callout{theme="warning"} 此功能仍在开发中,可能会在没有自动迁移的情况下被弃用。因此,使用此功能意味着您需要承担未来手动迁移操作的风险。如果您计划使用此特定功能,请先联系您的Palantir代表。 :::

在某些情况下,您可能希望将探索结果用作动态对象集(dynamic object set),而不是静态对象集。动态对象集保存为所应用过滤器的表示形式。因此,当新数据匹配(或不匹配)这些过滤器时,对象集将自动更新。

此功能最常见的用例是将对动态对象集的引用作为属性值添加到对象实例上。

让我们通过一个示例来演示如何创建一个操作,该操作允许我们根据飞机制造商的序列号(MSN)将一组动态的Aircraft对象分配给一个Airline对象。

  1. 确保Airline对象类型有一个String属性(本例中为Aircraft Set),您可以在该属性中添加对一组"Aircraft"对象的引用作为值。为此属性启用值格式化,并从下拉菜单中选择Resource RID。这样,分配给此属性的对象集RID将在对象浏览器中显示为指向该对象集的链接。

值格式化

  1. 现在您可以创建操作了。在操作上,为Airline对象类型的Aircraft Set属性添加一个修改对象规则。

修改对象规则

  1. Aircraft Set参数上,添加以下类型类,其中<OBJECT_TYPE_ID>是您希望此操作在探索视图中作为选项出现的对象类型的ID(本例中为Aircraft对象类型)。
kind: "hubble-oe-object-set-rid"
name: <OBJECT_TYPE_ID>
  1. 同样在Aircraft Set参数上,添加以下类型类,其中<RESOURCE_RID>是一个文件夹的RID,该文件夹包含您希望授予动态对象集的正确权限。请注意,这些对象集不会在项目中公开,也不可搜索——此RID仅用于指定保存的对象集应接收的权限。
kind: "hubble-oe-security-rid"
name: <RESOURCE_RID>
  1. 操作创建完成后,导航到Aircraft对象的探索页面。例如,我们可能希望将所有MSN在5,025到5,050之间的Aircraft分配给Frontier Airlines。为此,过滤出这些对象,然后从操作下拉菜单中选择新创建的操作。

分配飞机

这将自动为您当前的探索创建一个动态对象集,并将其分配给从下拉菜单中选择的Airline对象的Aircraft Set属性。

选择航空公司

  1. 现在,MSN在5,025到5,050之间的Aircraft集合的链接将出现在"Frontier Airlines Inc."对象的Aircraft Set属性中。如果任何MSN在此范围内的新Aircraft被添加到本体,或者当前集合中的任何Aircraft被从本体中移除,该集合将自动更新。

航空公司探索

  1. 使用链接对象探索组件,您可以通过访问"Frontier Airlines Inc."的对象视图来查看此动态对象集的内容:

链接对象探索

配置此组件时,将初始探索设置为从对象集RID属性,并将对象集RID属性设置为Aircraft Set

链接对象探索配置

默认布局管理员用户

属于hubble-exploration-admins多通组(multipass group)的用户,或在控制面板中拥有Object Exploration Admin应用程序权限的用户,可以重命名、删除或保存对象类型的默认布局。布局包括对结果表格配置所做的任何更改。如果您是管理员用户,并希望将某个布局设置为所有用户的默认布局,请在保存布局时,在设置为默认布局下勾选对所有用户复选框,如下图所示。

编辑默认布局