Exportando envios

CSV pelo painel

Abra Submissions, ou a aba de envios de um formulário, defina os filtros que quiser e escolha Export CSV. O arquivo segue os filtros da tela.

• As colunas são id, created_at, form, status e depois uma coluna por campo. Para um único formulário, os campos definidos vêm primeiro, seguidos de quaisquer outros nomes de campo encontrados nas linhas exportadas.
• Arrays de valores simples são unidos com vírgula e espaço. Objetos são escritos como JSON.
• Valores que começam com =, +, -, @, uma tabulação ou um retorno de carro ganham um ' na frente, para que planilhas não os executem como fórmulas.
• O arquivo é UTF-8 com byte order mark, então o Excel abre acentos corretamente.
• Uma exportação comporta até 100.000 linhas e 500 colunas de campo. Restrinja os filtros em workspaces maiores, ou use a API.

Tudo com a API REST

Para um backup completo, uma sincronização agendada ou mais de 100.000 linhas, percorra as páginas da API REST com uma chave secreta que tenha submissions:read. As listas vêm das mais recentes para as mais antigas e ficam estáveis enquanto novos envios chegam.

import { createWriteStream } from "node:fs";
import { createClient } from "@ikiform/sdk";

const ikiform = createClient({ apiKey: process.env.IKIFORM_SECRET_KEY! });
const out = createWriteStream("submissions.jsonl");

for await (const submission of ikiform.submissions.iterate({
  formId: "frm_xxxxxxxxxxxxxxxx",
  status: "received",
  limit: 100,
})) {
  out.write(`${JSON.stringify(submission)}\n`);
}

out.end();