사용자에게 오류를 알리기

Workshop이나 액션과 같은 플랫폼의 다른 부분에서 Functions를 실행할 때, 자세한 메시지와 함께 오류를 발생시키고 싶을 수 있습니다. 이를 위해서는 @foundry/functions-api 패키지에서 UserFacingError를 발생시키면 됩니다. 예를 들면:

Copied!
1
2
3
4
5
6
7
8
9
10
    @Edits(Employee)
    @OntologyEditFunction()
    public editExactlyFiveEmployees(employees: Employee[]): void {
        // 직원 배열의 길이가 정확히 5인지 확인합니다.
        if (employees.length != 5) {
            // 길이가 5가 아닌 경우 사용자에게 오류 메시지를 반환합니다.
            throw new UserFacingError(`정확히 5명의 직원을 입력하세요. 받은 직원 수: ${employees.length}.`);
        }
        // ...
    }

이를 Function-backed 액션으로 실행하고 Workshop 애플리케이션에서 직원 수가 잘못 입력된 경우, 사용자는 다음 오류를 볼 수 있습니다:

자세한 사용자 대면 오류 메시지를 추가함으로써 Function의 다른 사용자가 문제를 빠르게 식별하고 해결할 수 있습니다.