入门

函数的核心功能之一是能够轻松访问已集成到Foundry Ontology中的数据。Ontology为您的组织提供数据的语义建模，使得访问结构化数据和在应用案例中重用逻辑变得容易。

先决条件

本教程假设您已经创建并设置了一个TypeScript代码库。如果还没有，请先完成入门教程。

导入Ontology类型

您要在函数中使用的任何Object或链接类型必须被导入到包含您代码库的项目中。点击资源导入侧边栏可以查看已导入到项目中的Object类型。

ontology-import-side-panel

您的组织可能没有机场和航班对象。请使用您有权限访问的任意Object类型进行操作。

要导入其他Object类型，您需要在资源导入侧边栏中选择添加按钮。如果尚未选择Ontology，系统将提示您选择一个Ontology。如果您至少有一个已导入的Ontology类型，所选Ontology将自动被解析。

一旦选择了Ontology，将出现一个搜索模式。您的Ontology将取决于您组织中可用的Object类型。首先选择几个Object类型及其连接的链接类型。在本例中，我们将导入机场和航班对象，以及它们之间的链接类型。

ontology-import-example

选择确认选择以将Ontology类型导入项目。代码助手将自动重启以重新生成代码绑定，以反映您所导入的新Object和链接类型。

在您的代码中，您现在可以从@foundry/ontology-api包中导入Ontology类型。如果您使用的是私有Ontology，包名将改为@foundry/ontology-api/<ontology-api-name>。

私有Ontology

如果您使用的是私有Ontology，请在以下所有示例中将@foundry/ontology-api替换为@foundry/ontology-api/your-private-ontology-api-name-here。

添加一个基于Object的函数

接下来，让我们使用刚刚导入的Object类型编写一个函数。您的代码将依赖于可用的Object类型、属性和链接类型。切换回代码选项卡，并尝试导入您刚添加的一个Object类型：

Copied!1
2
import { Airport } from "@foundry/ontology-api";
// 从 @foundry/ontology-api 模块中导入 Airport 类

然后，编写一个以该Object为输入的函数：

Copied!1
2
3
4
5
6
@Function()
public myObjectFunction(airport: Airport) {
    airport.
    // 这里的代码块定义了一个函数 `myObjectFunction`，它接受一个 `Airport` 类型的参数 `airport`
    // 目前函数体为空，可以在此处对 `airport` 对象进行操作
}

一旦代码助手启动，只需输入 airport. 即可查看可用属性和链接类型的自动完成：

在此示例中，我们使用模板字符串 ↗将机场的 city 和 country 字段组合成一个人类可读的位置：

Copied!1
2
3
4
@Function() // 标记为一个函数
public airportLocation(airport: Airport): string { // 定义一个方法，接收一个类型为 Airport 的参数
    return `${airport.city}, ${airport.country}`; // 返回机场所在的城市和国家，格式为 "城市, 国家"
}

根据您自己的Ontology实验API，并编写一个基于您的Object类型返回值的函数。