exportar_preenchimentos
Export filtered Coletum form submissions to Excel or CSV files on disk, matching the standard export layout or custom field, sheet, metadata, and CSV settings.
Instructions
Exporta os preenchimentos filtrados para planilha no disco, no mesmo padrão da exportação do Coletum.
Sem ajustes, o arquivo é o que o cliente já conhece: aba LEIA-ME, aba do formulário (1 linha por preenchimento, código, campos, contagem dos grupos e das fotos, metadados no fim) e uma aba por grupo repetível ou campo com várias respostas, ligadas pelos códigos (1.2, 1.2.0, 1.2.0.1) e por links internos. O CSV é o mesmo conjunto em arquivos: ponto e vírgula, vírgula decimal, UTF-8 com BOM. Com ajustes: escolher campos, aba única (modo linhas ou colunas), metadados no começo ou fora, rótulos, CSV com vírgula e ponto, extras. Ajuste inválido é recusado antes de ler os preenchimentos. Custo: 1 chamada por página de 500, mais 1 pela estrutura na primeira vez. Para em max_paginas e avisa se ficou preenchimento de fora. Devolve só o caminho, o link, as contagens e o consumo da cota, nunca o conteúdo (CSV: o link da pasta e o de cada arquivo). Rode contar_preenchimentos antes para saber quantas chamadas vai gastar. Ao terminar, sempre mostre ao usuário o caminho completo de cada arquivo (vem no começo da resposta e em mostrar_ao_usuario), em bloco de código, para ele copiar; se ele pedir para abrir, use mostrar_arquivo. Nunca diga só 'na pasta do projeto'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| origem | No | Origem da criação: mobile (aplicativo), web_private (sistema, logado) ou web_public (link público). | |
| ajustes | No | Só quando o cliente pedir algo diferente do padrão do Coletum; vazio = igual à exportação do sistema. Chaves: campos{mostrar[] (só estes, nesta ordem), ocultar[]} com o rótulo, a chave ou o cabeçalho; aba_unica ("linhas": uma linha por resposta, repetindo os campos simples; "colunas": uma linha por preenchimento, cada resposta numa coluna numerada), sem abas filhas nem códigos de relacionamento; metadados ("fim" padrão, "inicio" ou "fora"); rotulos{cabeçalho ou rótulo atual: nome novo}; csv{separador ";" ou ",", decimal "," ou "."}; extras[] ("precisao", "altitude", "origem"). Ex.: {"aba_unica": "linhas", "campos": {"ocultar": ["Observações"]}}. | |
| formato | No | xlsx (um arquivo: LEIA-ME, aba do formulário e uma aba por grupo repetível ou campo com várias respostas) ou csv (uma pasta: um arquivo por tabela e LEIA-ME.txt). | xlsx |
| criado_por | No | Id do usuário que criou (aparece como autor_id em buscar_preenchimentos). | |
| gerado_por | No | Nome em "Exportação realizada por" no LEIA-ME. Padrão: "Coletum via MCP". | |
| editado_por | No | Id do usuário que fez a última edição. | |
| max_paginas | No | Limite de páginas (chamadas) a gastar com os preenchimentos. Padrão 5. | |
| pasta_saida | No | Pasta onde gravar. Padrão: COLETUM_PASTA_SAIDA ou Documentos/Coletum/saidas. | |
| id_formulario | Yes | Id numérico do formulário (vem de listar_formularios). | |
| tamanho_pagina | No | Preenchimentos por página. Padrão 500 (o máximo, o que gasta menos chamadas). Reduza só para formulários muito pesados. | |
| criado_antes_de | No | Só preenchimentos criados antes desta data (exclusivo). AAAA-MM-DD ou data e hora ISO. | |
| criado_depois_de | No | Só preenchimentos criados depois desta data (exclusivo). AAAA-MM-DD ou data e hora ISO. | |
| editado_antes_de | No | Só preenchimentos editados antes desta data. | |
| editado_depois_de | No | Só preenchimentos editados depois desta data. Atenção: traz apenas os editados, não os novos. |