Derived properties in Workshop（Workshop 中的派生属性(Derived properties)）¶

Derived properties are properties that are calculated at runtime based on the values of other properties or links on objects. They allow builders to perform complex operations like linked aggregations and operations between columns directly in Workshop. Derived properties are defined at the module level and per object type.

:::callout{theme="neutral"} Derived properties are supported for a subset of widgets and features. Contact Palantir Support to discuss expanded support. :::

Configuration¶

In the Overview tab, select Derived properties from the Capabilities section. You can also select the object type from the Object types section and add a derived property on the next screen.

Derived properties configuration panel in Workshop.

Derived property types¶

Linked property/aggregation: Select a linked object property to display from a 1:1 link or calculate aggregations across a 1:N link. Aggregations may only be calculated on the linked object type's native properties. Statically defined object property filters on the linked object type may optionally be applied.

Example linked aggregation derived property type configuration.

Column math: Combine values from multiple properties on a single object type. Both the object type's native properties and aggregation type derived properties may be used and referenced. Note that other column math type derived properties may not be used.

$Example column math derived property type configuration.$

Performance considerations¶

Derived properties are computed on the fly, which may result in longer module computation times for users. This is an important consideration when using derived properties in performance-critical applications and workflows.

Limitations¶

Supported widgets¶

Derived properties are only supported for a subset of Workshop widgets and features.

Hover over the Derived properties information icon for the list of supported widgets.

Derived properties configuration panel in Workshop, info button highlighted.

Contact Palantir Support if you need expanded support.

Performance¶

Derived properties are computed in real time, so consider the impact on module loading times in performance-critical applications.

Saved states¶

Saved states do not support object sets that reference derived properties.

Sorting limitations¶

When sorting object sets that use derived properties, the object set size is limited to 200 rows. For larger object sets that require sorting, consider expressing the derived property logic as a function-backed column instead, which supports sorting up to 1,000 rows.

中文翻译¶

Workshop 中的派生属性(Derived properties)¶

派生属性(Derived properties) 是在运行时根据对象的其他属性或链接(Links)的值计算得出的属性。它们允许构建者直接在 Workshop 中执行链接聚合(Linked aggregations)和列间运算等复杂操作。派生属性在模块(Module)级别和每个对象类型(Object type)上进行定义。

:::callout{theme="neutral"} 派生属性仅支持部分组件(Widgets)和功能。如需扩展支持，请联系 Palantir Support 进行讨论。 :::

配置¶

在 Overview 选项卡中，从 Capabilities 部分选择 Derived properties。您也可以从 Object types 部分选择对象类型，然后在下一个界面中添加派生属性。

Workshop 中的派生属性配置面板。

派生属性类型¶

链接属性/聚合(Linked property/aggregation)： 选择一个链接对象属性以从 1:1 链接中显示，或跨 1:N 链接计算聚合。聚合只能基于链接对象类型的原生属性进行计算。可以选择应用在该链接对象类型上静态定义的对象属性过滤器。

链接聚合派生属性类型配置示例。

列运算(Column math)： 组合单个对象类型上多个属性的值。可以使用和引用该对象类型的原生属性以及聚合类型的派生属性。请注意，不能使用其他列运算类型的派生属性。

$列运算派生属性类型配置示例。$

性能注意事项¶

派生属性是即时计算的，这可能会导致用户的模块计算时间变长。在对性能要求极高的应用和工作流中使用派生属性时，这是一个重要的考量因素。

限制¶

支持的组件¶

派生属性仅受部分 Workshop 组件和功能支持。

将鼠标悬停在 Derived properties 信息图标上，即可查看受支持的组件列表。

Workshop 中的派生属性配置面板，高亮显示信息按钮。

如需扩展支持，请联系 Palantir Support。

性能¶

派生属性是实时计算的，因此在对性能要求极高的应用中，请考虑其对模块加载时间的影响。

已保存状态¶

已保存状态(Saved states)不支持引用派生属性的对象集(Object sets)。

排序限制¶

对使用派生属性的对象集进行排序时，对象集大小限制为 200 行。对于需要排序的更大对象集，请考虑将派生属性逻辑表达为函数支持列(Function-backed column)，该方式支持对多达 1,000 行进行排序。