ユースケース開発React アプリケーションのためのOSDKチュートリアル:高度なToDoアプリケーションUseLearningTaskリファレンス

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

useLearningTask リファレンス

useLearningTask フックについて詳しくはこちら。

Copied!
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 /* * 著作権 2025 Palantir Technologies, Inc. すべての権利を留保します。 * * Apache License バージョン 2.0(「ライセンス」)に基づいてライセンスされています。 * このファイルは、ライセンスに準拠する場合にのみ使用できます。 * ライセンスのコピーは、以下から入手できます。 * * http://www.apache.org/licenses/LICENSE-2.0 * * 適用される法律で義務付けられている場合、または書面で合意された場合を除き、 * ライセンスに基づいて配布されるソフトウェアは「現状有姿」で配布され、 * 明示的か黙示的かを問わず、いかなる保証も条件も伴いません。 * ライセンスに基づく許可および制限を規定する具体的な条項については、 * ライセンスを参照してください。 */ import { useCallback, useEffect, useState } from "react"; import useSWR from "swr"; import { useOsdkClient } from "@osdk/react"; import { ITask } from "./useTasks"; import { osdkLearningTask } from "@advanced-to-do-application/sdk"; import useAdmin from "./useAdmin"; import type { ObjectMetadata, Osdk, Result } from "@osdk/client"; import type { User } from "@osdk/foundry.admin"; export const SupportedMediaType = { PDF: "PDF", IMAGE: "IMAGE", LINK: "LINK", VIDEO: "VIDEO", NONE: "NONE" } as const; export type SupportedMediaType = typeof SupportedMediaType[keyof typeof SupportedMediaType]; interface LearningTaskEnriched { osdkLearningTask: osdkLearningTask.OsdkInstance; mediaUrl: string; createdBy: User; assignedTo: User; mediaType: SupportedMediaType; } function useLearningTask(task: ITask) { const client = useOsdkClient(); const [metadata, setMetadata] = useState<ObjectMetadata>(); const { getBatchUserDetails } = useAdmin(); // useCallback を使って fetcher を定義します。 const fetcher = useCallback(async () => { // エラー処理を伴う fetch を使います。 const learningTaskResult: Result<Osdk.Instance<osdkLearningTask>> = await client(osdkLearningTask).fetchOneWithErrors(task.osdkTask.$primaryKey as string); if (learningTaskResult.error) { throw new Error(learningTaskResult.error.message); } const learningTask = learningTaskResult.value; const users = await getBatchUserDetails([learningTask.createdBy as string, learningTask.assignedTo as string]); if (!learningTask.mediaReference) { return { osdkLearningTask: learningTask, mediaUrl: learningTask.contentUrl ?? "", mediaType: learningTask.contentUrl != undefined ? SupportedMediaType.LINK : SupportedMediaType.NONE, createdBy: users[learningTask.createdBy as string], assignedTo: users[learningTask.assignedTo as string], }; } const response = await learningTask.mediaReference.fetchContents(); const blob: Blob | undefined = await response.blob(); const mediaUrl = blob ? URL.createObjectURL(blob) : ""; // メディアのメタデータを使って種類を特定します。 const mediaTypeResp = await learningTask.mediaReference.fetchMetadata(); const learningTaskEnriched: LearningTaskEnriched = { osdkLearningTask: learningTask, mediaUrl, mediaType: getMediaTypeFromMimeType(mediaTypeResp.mediaType), createdBy: users[learningTask.createdBy as string], assignedTo: users[learningTask.assignedTo as string], }; return learningTaskEnriched; }, [getBatchUserDetails, task.osdkTask.$primaryKey, client]); // データがすでにキャッシュされていない場合にのみ fetcher を渡します。 const { data, error, isValidating } = useSWR<LearningTaskEnriched>( task.osdkTask.$primaryKey as string, fetcher, { revalidateOnFocus: false, revalidateOnReconnect: false, } ); // オブジェクトタイプのメタデータを読み取り、オントロジーのプロパティ表示名を使う方法を示します。 const getObjectTypeMetadata = useCallback(async () => { const objectTypeMetadata = await client.fetchMetadata(osdkLearningTask); setMetadata(objectTypeMetadata); }, [client]); useEffect(() => { getObjectTypeMetadata(); }, [getObjectTypeMetadata]); return { learningTask: data, isLoading: !data && !error, isValidating, isError: error, metadata, }; } export default useLearningTask; const getMediaTypeFromMimeType = (mimeType: string): SupportedMediaType => { if (/application\/pdf/.test(mimeType)) { return SupportedMediaType.PDF; } else if (/image\/(jpeg|png|gif)/.test(mimeType)) { return SupportedMediaType.IMAGE; } else if (/video\/mp4/.test(mimeType)) { return SupportedMediaType.VIDEO; } else if (/text\/html/.test(mimeType)) { return SupportedMediaType.LINK; } else { return SupportedMediaType.NONE; } };