注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

ユーザー向けエラー

Workshop やアクションなど、プラットフォームのほかの部分で関数を実行するときに、詳細なメッセージを含むエラーをスローしたい場合があります。その場合は、UserFacingError をスローします。例：

Copied!1
2
3
4
5
6
7
8
9
10
11
12
13
import { Function, UserFacingError } from "@foundry/functions-api";
import { Employee } from "@foundry/ontology-api";

export class MyFunctions {
    @Function()
    public async searchExactlyFiveEmployees(employees: Employee[]): Proimse<string> {
        if (employees.length != 5) {
            throw new UserFacingError(`Pass in exactly 5 employees. Received ${employees.length}.`);
        }

        // 従業員を検索します
    }
}

Copied!1
2
3
4
5
6
7
8
9
10
11
import { Osdk } from "@osdk/client";
import { Employee } from "@ontology/sdk";
import { UserFacingError } from "@osdk/functions";

export default async function searchExactlyFiveEmployees(employees: Array<Osdk.Instance<Employee>>): Promise<string> {
    if (employees.length != 5) {
        throw new UserFacingError(`Pass in exactly 5 employees. Received ${employees.length}.`);
    }

    // 従業員を検索します
}

Copied!1
2
3
4
5
6
7
8
9
10
11
12
from functions.api import function, UserFacingError
from ontology_sdk import FoundryClient
from ontology_sdk.ontology.objects import Aircraft

@function()
def search_exactly_five_employees(
    employees: list[Aircraft]
) -> str:
    if not len(aircraft) == 5:
        raise UserFacingError(f"Pass in exactly 5 employees. Received ${len(aircraft)}.")

    # 従業員を検索します

これを Workshop アプリケーション内の関数ベースのアクションとして、従業員数が正しくない状態で実行すると、ユーザーには次のエラーが表示されます。

ユーザー向けエラー

関数ベースのエクスポートで使用される関数が UserFacingError をスローすると、エクスポート失敗のトースト通知にエラーメッセージが表示されます。

詳細なユーザー向けエラーメッセージは、ユーザーが問題を特定し、解決するのに役立ちます。