Featuresフォーム管理受信データの管理

受信データの管理

フォーム管理機能では、フォームから送信されたデータ(以下、受信データ)を管理できます。

受信データのリスト取得

受信データのリストを取得するには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);