Enviando um formulário com um anexo de arquivo

Neste exemplo, demonstramos como enviar um formulário que inclui um anexo de arquivo usando a API OneEntry.

✅ Objetivo do cenário:

• Obter a configuração do formulário da Plataforma OneEntry
• O usuário preenche um formulário (por exemplo, resposta, feedback).
• Anexa um arquivo (imagem, currículo, documento).
• Os dados e o arquivo são armazenados juntos em FormData
• Enviar os dados coletados para uma API OneEntry.

✅ O que você precisa:

• Uma PROJECT_URL e APP_TOKEN válidos para autenticação com a API OneEntry.
• Formulário no OneEntry com um campo do tipo "File" (tipo arquivo)
• Marcador do formulário (por exemplo, resume_form)

📌 Importante:

• Estes exemplos não incluem tratamento de erros.
• Você pode gerenciar erros usando um bloco try-catch ou empregando uma construção como await Promise.catch((error) => error).

Cenário

1. Importar defineOneEntry do SDK e definir url e token

Exemplo:

import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'sua-url-do-projeto';
const APP_TOKEN = 'seu-token-do-app';

2. Criando um cliente API com a função defineOneEntry()

Exemplo:

const { Forms, FormData } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

3. Obter formulário pelo marcador do OneEntry

Exemplo:

const fileForm = await Forms.getFormByMarker('file');

Resultado:

{
  "id": 8,
  "attributeSetId": 11,
  "type": "data",
  "localizeInfos": {
    "title": "Arquivo",
    "titleForSite": "",
    "successMessage": "Processamento de dados bem-sucedido",
    "unsuccessMessage": "Processamento de dados malsucedido",
    "urlAddress": "",
    "database": "0",
    "script": "0"
  },
  "version": 0,
  "position": 1,
  "identifier": "file",
  "processingType": "script",
  "templateId": null,
  "attributes": [
    {
      "type": "file",
      "marker": "file",
      "isLogin": null,
      "isSignUp": null,
      "position": 1,
      "settings": {},
      "isVisible": true,
      "listTitles": [],
      "validators": {},
      "localizeInfos": {
        "title": "Arquivo"
      },
      "additionalFields": [],
      "isNotificationEmail": null,
      "isNotificationPhoneSMS": null,
      "isNotificationPhonePush": null
    },
    {
      "type": "image",
      "marker": "image",
      "isLogin": null,
      "isSignUp": null,
      "position": 2,
      "settings": {},
      "isVisible": true,
      "listTitles": [],
      "validators": {},
      "localizeInfos": {
        "title": "Imagem"
      },
      "additionalFields": [],
      "isNotificationEmail": null,
      "isNotificationPhoneSMS": null,
      "isNotificationPhonePush": null
    },
    {
      "type": "groupOfImages",
      "marker": "images_group",
      "isLogin": null,
      "isSignUp": null,
      "position": 3,
      "settings": {},
      "isVisible": true,
      "listTitles": [],
      "validators": {},
      "localizeInfos": {
        "title": "Grupo de Imagens"
      },
      "additionalFields": [],
      "isNotificationEmail": null,
      "isNotificationPhoneSMS": null,
      "isNotificationPhonePush": null
    }
  ],
  "moduleFormConfigs": [
    {
      "id": 3,
      "moduleIdentifier": "content",
      "isGlobal": false,
      "isClosed": false,
      "viewOnlyUserData": false,
      "commentOnlyUserData": false,
      "entityIdentifiers": [
        {
          "id": "services",
          "isNested": false
        }
      ]
    }
  ]
}

4. Obter configurações adicionais para o envio do formulário

Exemplo:

const moduleFormConfig = fileForm?.moduleFormConfigs?.[0];

5. Enviando um arquivo com a entrada do formulário=input=file

Enviar

Dados:

// JS
let selectedFiles = null;

// handleFileChange
const handleFileChange = (e: any) => {
  selectedFiles = e.target.files;
};

// handleSubmit
const handleSubmit = async (e, file) => {
  e.preventDefault();

  // 4. Obter configurações adicionais para o envio do formulário
  const moduleFormConfig = fileForm?.moduleFormConfigs?.[0];

  // 5. Preparando os dados do formulário
  const formData = [
    {
      marker: 'file',
      type: 'file',
      value: file,
      fileQuery: {
        type: 'page',
        entity: 'editor',
        id: 4965,
      },
    },
  ];

  // 6. Enviando um formulário com FormData.postFormsData()
  const postFormResp = await FormData.postFormsData({
    formIdentifier: 'file',
    formData: formData,
    formModuleConfigId: moduleFormConfig?.id || 0,
    moduleEntityIdentifier: moduleFormConfig?.entityIdentifiers?.[0]?.id || '',
    replayTo: null,
    status: 'sent',
  });
};

Exemplo:

// HTML
<form
  onSubmit={(e) => handleSubmit(e, selectedFiles)}
  className="flex flex-col gap-3 p-10 border rounded-3xl"
>
  <input
    type="file"
    onChange={handleFileChange}
    className="bg-white text-slate-800 p-3 rounded-2xl"
  />
  <button
    type="submit"
    className="bg-white text-slate-800 p-3 rounded-2xl"
  >
    Enviar
  </button>
</form>

Resultado:

{
  "formData": {
    "formIdentifier": "file",
    "time": "2025-11-10T06:30:56.488Z",
    "formData": [
      {
        "marker": "file",
        "type": "file",
        "value": [
          {
            "filename": "files/project/page/4965/editor/4f82c7e0-b1c5-4144-b7dc-202e3b50d357.json",
            "downloadLink": "https://your-project.oneentry.cloud/cloud-static/files/project/page/4965/editor/4f82c7e0-b1c5-4144-b7dc-202e3b50d357.json",
            "size": 259391
          }
        ]
      }
    ],
    "entityIdentifier": "services",
    "fingerprint": "UQ_rrofe2",
    "isUserAdmin": false,
    "formModuleId": 3,
    "userIdentifier": null,
    "parentId": null,
    "id": 119
  },
  "actionMessage": "Processamento de dados bem-sucedido"
}

Exemplo final

// 1. Importar defineOneEntry do SDK e definir PROJECT_URL e APP_TOKEN
import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'sua-url-do-projeto';
const APP_TOKEN = 'seu-token-do-app';

// 2. Criando um cliente API 
const { Forms, FormData } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

// 3. Obter formulário pelo marcador do OneEntry
const fileForm = await Forms.getFormByMarker('file');

// 3.1 Enviando um arquivo com a entrada do formulário=input=file
// JS
const selectedFiles = [];
const handleFileChange = (e) => {
  selectedFiles = e.target.files;
};

// handleSubmit
const handleSubmit = async (e, file) => {
  e.preventDefault();

  // 4. Obter configurações adicionais para o envio do formulário
  const moduleFormConfig = fileForm?.moduleFormConfigs?.[0];

  // 5. Preparando os dados do formulário
  const formData = [
    {
      marker: 'file',
      type: 'file',
      value: file,
      fileQuery: {
        type: 'page',
        entity: 'editor',
        id: 4965,
      },
    },
  ];

  // 6. Enviando um formulário com FormData.postFormsData()
  const postFormResp = await FormData.postFormsData({
    formIdentifier: 'file',
    formData: formData,
    formModuleConfigId: moduleFormConfig?.id || 0,
    moduleEntityIdentifier: moduleFormConfig?.entityIdentifiers?.[0]?.id || '',
    replayTo: null,
    status: 'sent',
  });
};

// HTML
<form
  onSubmit={(e) => handleSubmit(e, selectedFiles)}
  className="flex flex-col gap-3 p-10 border rounded-3xl"
>
  <input
    type="file"
    onChange={handleFileChange}
    className="bg-white text-slate-800 p-3 rounded-2xl"
  />
  <button
    type="submit"
    className="bg-white text-slate-800 p-3 rounded-2xl"
  >
    Enviar
  </button>
</form>