🇺🇸 Instructions (English)
How to use Flexcel Export
Flexcel supports both Frontend and Backend Workflow exports.

Frontend Export
Use "Run Flexcel Export" to generate and download an Excel (.xlsx) file directly in the user's browser.

Backend Export
Use "Run Flexcel Export - Server Side" to generate the Excel file in a Backend Workflow and receive a downloadable file URL.

Required fields
• File Name
Name of the Excel file.
Example:
Customers_Report

• Sheet Name
Name of the worksheet tab.
Example:
Customers

• Columns
Column names separated by commas.
Example:
Name, Birth Date, Age

• Rows
JSON objects containing the data.
The property names must exactly match the Columns field.

Example:
{ "Name": "John", "Birth Date": "1988-10-25", "Age": "37" },
{ "Name": "Marcus", "Birth Date": "1985-11-06", "Age": "39" }

Important
• Dates should use the yyyy-mm-dd format whenever possible.
• When using Bubble dynamic text values, apply ":formatted as JSON-safe" to text fields to prevent JSON errors.
• Column names are case-sensitive and must match the JSON property names.

Backend Export Returns

Server-side exports return:
• success
• message
• log_id
• file_name
• file_url

Support
Backend exports generate a unique Log ID.

When requesting support, please provide the generated Log ID so the export can be traced and analyzed quickly.

🇧🇷 Instruções (Português)

Como usar o Flexcel Export
O Flexcel oferece suporte tanto para exportações em Frontend quanto em Backend Workflows.

Exportação Frontend
Utilize "Run Flexcel Export" para gerar e baixar um arquivo Excel (.xlsx) diretamente no navegador do usuário.

Exportação Backend
Utilize "Run Flexcel Export - Server Side" para gerar o arquivo Excel em um Backend Workflow e receber uma URL para download.

Campos obrigatórios
• File Name
Nome do arquivo Excel.
Exemplo:
Relatorio_Clientes

• Sheet Name
Nome da aba da planilha.
Exemplo:
Clientes

• Columns
Nomes das colunas separados por vírgula.
Exemplo:
Nome, Data de Nascimento, Idade

• Rows
Objetos JSON contendo os dados.
Os nomes das propriedades devem corresponder exatamente aos nomes definidos em Columns.

Exemplo:
{ "Nome": "João", "Data de Nascimento": "1988-10-25", "Idade": "37" },
{ "Nome": "Marcus", "Data de Nascimento": "1985-11-06", "Idade": "39" }

Importante
• Sempre que possível utilize datas no formato yyyy-mm-dd.
• Ao utilizar textos dinâmicos do Bubble, aplique ":formatted as JSON-safe" nos campos de texto para evitar erros de JSON.
• Os nomes das colunas diferenciam letras maiúsculas e minúsculas e devem corresponder exatamente às propriedades do JSON.

Retornos da Exportação Backend

As exportações server-side retornam:
• success
• message
• log_id
• file_name
• file_url

Suporte
As exportações backend geram um Log ID exclusivo.

Ao solicitar suporte, informe o Log ID gerado para que a exportação possa ser localizada e analisada rapidamente.