受信データの管理
フォーム管理機能では、フォームから送信されたデータ(以下、受信データ)を管理できます。
受信データのリスト取得
受信データのリストを取得するにはCMS SDKを使用します。
フォーム管理機能が有効なテーブルに対して submissions()
メソッドを呼び出します。これにより、そのフォームに紐づく受信データを扱うクライアントメソッドが使用できます。次に list()
や get()
メソッドを呼び出すことで、受信データのリストを取得できます。
const submissions = await cmsClient.tables.form.submissions(formId).list({
order: { createdAt: "desc" },
});
console.log(submissions);
// {
// "contents": [
// {
// "id": "M3nIwgo21UAsZToo",
// "updatedAt": "2025-01-01T00:00:00.000Z",
// "createdAt": "2025-01-01T00:00:00.000Z",
// "_formId": "A8CE7NflEFVT70cK",
// "_content": {
// "lastName": "John",
// "firstName": "Doe",
// "email": "john.doe@example.com",
// "body": "This is a test message."
// },
// "_formSchema": {
// "lastName": {
// "type": "text",
// "required": true
// },
// "firstName": {
// "type": "text",
// "required": true
// },
// "email": {
// "type": "text",
// "required": true
// },
// "body": {
// "type": "textarea",
// "required": true
// }
// },
// "_attachments": [],
// "status": "in_progress",
// "memo": "This is a memo."
// }
// ],
// "totalCount": 1
// }
以下、重要なプロパティを示します。
_content
受信データの内容です。書き換えることはできません。
_formSchema
受信時点でのフォームのスキーマです。書き換えることはできません。
_attachments
受信データに紐づく添付ファイルの情報です。書き換えることはできません。
storage型 のデータです。ファイルにアクセスするためのURLが含まれています。
受信データの更新
受信データを更新するには、update()
メソッドを使用します。
スキーマの submissionColumns で定義したカラムのみ更新できます。
await cmsClient.tables.form.submissions(formId).update(submissionId, {
status: "closed",
memo: "updated memo text",
});
受信データの削除
受信データを削除するには、delete()
メソッドを使用します。
await cmsClient.tables.form.submissions(formId).delete(submissionId);