Gerenciando os dados do seu aplicativo

---

Na Base44, os dados do seu aplicativo são as informações que dão vida a tudo. Isso inclui todas as informações que seu aplicativo contém, como pessoas que fazem login, o conteúdo que você mostra, pedidos que você processa e as atividades que acontecem no seu aplicativo.

---

​

Entendendo seus dados

Todos os dados do seu aplicativo são organizados em tabelas, assim como uma planilha. Cada tabela agrupa um tipo de informação (como pessoas ou produtos) e a organiza em colunas chamadas campos, como nomes, datas ou preços. Por exemplo, se você criar um aplicativo para administrar o negócio da sua loja, pode usar as tabelas de dados na Base44 para manter tudo organizado. Você pode ter uma tabela de dados Users para armazenar os nomes e endereços de e-mail dos seus clientes, uma tabela Products listando o que você vende e uma tabela Orders para rastrear cada compra. Cada novo cliente, produto ou pedido é adicionado automaticamente como uma nova linha na tabela certa, para que você possa encontrar, atualizar ou gerenciar rapidamente as informações da sua loja.

---

​

Tipos de campos de dados

Quando você, ou a IA, adiciona um campo (coluna) à sua tabela, você escolhe que tipo de informação ele armazena. Alguns tipos de campos comuns incluem:

• Text: Para palavras, frases ou descrições (como nomes de clientes ou detalhes do produto)
• Number: Para preços, quantidades ou medidas
• Yes/No (Boolean): Para campos que são verdadeiros ou falsos (como “Está ativo?”)
• Date/Time: Para salvar datas como dia de cadastro, data do pedido ou horário do evento
• File: Para imagens, documentos ou outros arquivos
• Reference: Para vincular esta tabela a outra tabela (por exemplo, vincular cada pedido ao cliente certo)
• Object: Para casos avançados, permite adicionar informações estruturadas como um objeto JSON

---

​

Acessando os dados do seu aplicativo

É fácil ver todas as informações que seu aplicativo coleta. Você pode visualizar seus dados a qualquer momento no painel, onde cada tabela oferece uma visão clara e organizada das suas pessoas, produtos, pedidos e mais. Isso ajuda você a acompanhar o que está acontecendo no seu aplicativo e manter tudo atualizado.

​

Abrindo uma tabela

Cada tabela no seu app aparece como um cartão na página Data. Abra uma para ver seus registros. Para abrir uma tabela:

1. Clique em Dashboard no editor do seu aplicativo.
2. Clique em Data.
3. Selecione a tabela desejada.

​

Explorando seus dados

Uma vez dentro, a própria tabela e a página Data oferecem algumas formas de navegar. Dentro de uma tabela:

• Columns: Ordene por qualquer coluna e oculte ou reordene colunas. Toda tabela também tem as colunas Created, Last updated e Created by, ocultas até você ativá-las em Columns.
• Records: Continue rolando para carregar mais em vez de navegar por páginas.
• Rows: Selecione várias para movê-las juntas para a lixeira, e use o botão de copiar em uma célula de link para copiar seu valor.
• Images: Imagens enviadas para seu aplicativo aparecem como miniaturas na tabela, incluindo arquivos que seu aplicativo armazena de forma privada. Links para imagens hospedadas em outros sites continuam como links, e outros arquivos enviados aparecem como um chip de arquivo.

De volta à página Data:

• Sort by: Ordene os cartões de A a Z ou de Z a A.
• More actions: Clique no ícone em um cartão para opções rápidas: Test Permissions in preview, View Data, Export, Schema, Backup & Restore (apenas em Production), Recently deleted, Clear table records e Delete this table.

​

Pesquisando dados específicos

Use a barra de pesquisa acima da tabela para encontrar rapidamente linhas relevantes. A pesquisa examina todos os campos de texto nos seus dados, para que você possa pular diretamente para uma linha específica em vez de rolar. Para pesquisar dados:

1. Abra a tabela desejada em Data no painel do seu app.
2. Insira uma palavra, número ou frase na barra de pesquisa acima da tabela.

​

Filtrando seus dados

Use filtros para transformar uma tabela longa em uma visualização focada, por exemplo para ver apenas recursos enviados, itens pertencentes à sua equipe ou trabalho planejado para um trimestre específico. Os filtros que você recebe vêm dos campos daquela tabela, então cada tabela tem sua própria lista. Campos como datas, números e escolhas recebem um filtro, e campos de texto simples são cobertos pela caixa de pesquisa ao lado. Uma tabela feita apenas de campos de texto não tem nada para filtrar, portanto não mostra o botão Filters. Para filtrar seus dados:

1. Abra a tabela desejada em Data no painel do seu app.
2. Clique em Filters acima da tabela e selecione seus filtros.
3. Para alterar quais colunas você vê, clique em Columns e mostre, oculte ou reordene-as.

---

​

Adicionando e atualizando dados

A Base44 coleta e atualiza automaticamente os dados do seu aplicativo à medida que as pessoas interagem com ele. A IA configura suas tabelas para que as informações certas sejam salvas e mantidas atualizadas para você. No entanto, se você quiser adicionar informações manualmente (por exemplo, adicionar um produto, atualizar um registro ou inserir dados de teste), pode fazer isso facilmente pelo painel do seu aplicativo dentro do editor.

​

Adicionando dados manualmente

Adicione um único registro você mesmo quando estiver testando algo ou preenchendo uma lacuna, em vez de importar um arquivo. Para adicionar um registro:

1. Abra a tabela desejada em Data no painel do seu app.
2. Clique em Add Item.
3. Insira os dados e clique em Submit.

​

Editando dados

Para editar um registro de dados, clique na linha da tabela que deseja editar, complete os detalhes e clique em Save changes. Em Record info, o registro também mostra quando foi criado (Created), quem o criou (Created by) e quando foi atualizado pela última vez (Last updated). Registros adicionados por alguém sem login mostram Anonymous como criador. Registros criados pelo chat de IA durante a construção do seu aplicativo mostram o ID de uma conta de serviço em vez de um e-mail. Em um campo que guarda um arquivo ou uma imagem, como photo_url, clique no ícone de upload ao lado do campo para enviar um arquivo direto do seu computador, em vez de colar um link.

​

Excluindo dados

Você pode excluir um único registro da linha dele, apagar todos os registros de uma tabela pelo cartão da tabela, excluir uma tabela de que você não precisa mais ou pedir ao chat de IA para fazer isso para você. A IA prepara a ação de exclusão e pede sua aprovação antes que qualquer coisa seja removida. Para excluir um único registro, clique no ícone Delete na linha relevante da tabela. Para excluir todos os registros em uma tabela, clique no ícone More actions no cartão dessa tabela e clique em Clear table records. Para excluir uma tabela:

1. Clique em Dashboard no editor do seu aplicativo.
2. Clique em Data.
3. Clique em Clear table records no menu More actions do cartão da tabela, primeiro em Production e depois em Test, para que a tabela fique vazia nos dois.
4. Clique no ícone More actions no cartão da tabela e clique em Delete this table.
5. Clique em Delete this table para confirmar.

Para excluir dados com o chat de IA:

1. Abra o chat de IA no editor do seu aplicativo.
2. Descreva o que deseja excluir, por exemplo: Exclua os dados da Itália na entidade TripItem.
3. Revise a solicitação de exclusão que a IA sugere, incluindo o nome da entidade.
4. Clique em Approve para confirmar a exclusão ou Reject para cancelar.

---

​

Importando dados

Às vezes, você quer trazer muitas informações para o seu aplicativo de uma vez. Você pode importar dados de 2 maneiras, dependendo se deseja trabalhar diretamente no painel ou pedir ao chat de IA para ajudar.

​

Usando o chat de IA

Use o chat de IA para transformar arquivos de dados existentes em entidades e registros no seu aplicativo. Isso é útil quando você já tem informações em uma planilha ou arquivo JSON e deseja trazê-las para a Base44. Você pode fazer upload de arquivos de dados estruturados e pedir à IA para criar ou atualizar entidades para você, incluindo configurar tabelas e mapear campos. Formatos suportados para importar dados:

• CSV (.csv)
• Excel (.xlsx, .xls)
• JSON (.json)

Se você fizer upload de um arquivo Excel com várias planilhas, pode pedir à IA para importar uma única planilha ou importar todas as planilhas para suas entidades correspondentes. Para importar dados usando o chat de IA:

1. Crie a entidade para a qual deseja importar (por exemplo, Products, Contacts, Orders).
2. Abra o chat de IA no editor do seu aplicativo.
3. Clique no ícone Upload files e selecione seu arquivo de dados.
4. Peça à IA para importar os dados.
5. Revise a resposta e aprove a importação no chat.

Quando você importa dados dessa forma, a Base44 analisa a estrutura do seu arquivo e mapeia as colunas para os campos da sua entidade. Ela pode criar ou atualizar entidades se seu schema precisa mudar, adicionando novas entidades ou campos, ou ajustando tipos de campos para corresponder ao seu arquivo. Ela não atualiza ou sobrescreve registros existentes; sempre adiciona novas linhas. Se algo não corresponde, a IA atualiza o schema onde é seguro fazer isso, então tenta novamente a importação para que você não precise corrigir tudo manualmente. Para usar o chat de IA para substituir dados existentes: Se você quer que o conteúdo de um arquivo substitua todos os registros atuais em uma entidade, precisa limpar a entidade primeiro, depois importar as novas linhas do seu arquivo.

1. Peça ao chat de IA para excluir os registros na entidade relevante (por exemplo, Exclua todos os registros da entidade Orders.).
2. Confirme que você quer excluir os registros.
3. Clique no ícone Upload files e selecione seu arquivo de dados.
4. Peça ao chat de IA para importar o arquivo para a mesma entidade.

​

Diretamente no painel

Use esta opção quando você já tem um CSV que corresponde à sua tabela e simplesmente deseja que as linhas apareçam nos seus dados. Por exemplo, exporte sua lista de clientes de outra ferramenta como CSV, ajuste as colunas para corresponder à sua tabela Customers e depois importe o arquivo para gerenciar esses clientes diretamente na Base44. Importações no painel suportam arquivos CSV (.csv) e adicionam apenas novas linhas, então nunca atualizam nem sobrescrevem registros existentes. Para substituir tudo em uma tabela, clique em Clear table records nessa tabela para limpá-la e depois importe seu CSV. Valores como NULL, None, N/A, #N/A e NaN entram como vazios em qualquer coluna que não seja de texto, e campos de lista aceitam um array JSON ou uma string separada por vírgulas. Após a importação, a página Data mostra quantos registros foram adicionados e informa as linhas que não puderam ser importadas. Para importar dados do painel:

1. Clique em Dashboard no editor do seu aplicativo.
2. Clique em Data.
3. Selecione o conjunto de dados relevante (tabela).
4. Clique no ícone More actions e clique em Import.
5. Escolha seu arquivo CSV e clique em Open.

---

​

Exportando dados

Você pode querer tirar os dados do seu aplicativo para backup, análise ou para usar em outras ferramentas. Para fazer isso, você pode usar a opção Export. Por exemplo, você pode querer exportar os pedidos da sua loja ou listas de pessoas para compartilhar com seu contador, ou usar os dados para criar relatórios personalizados. Seus dados são baixados como um arquivo CSV que você pode abrir em software de planilhas como Excel ou Google Sheets. Para exportar os dados do seu aplicativo:

1. Clique em Dashboard no editor do seu aplicativo.
2. Clique em Data.
3. Selecione o conjunto de dados relevante (tabela).
4. Clique no ícone More actions e clique em Export.

---

​

Alterando permissões de dados

Cada tabela de dados tem suas próprias configurações de segurança, controlando quem pode ler e escrever seus dados. Read Access: Quem pode visualizar registros
Write Access: Quem pode criar, atualizar ou excluir registros Cada tabela tem sua própria página de permissões, listando as regras que decidem quem pode criar, ler, atualizar e excluir seus registros. As regras são combinadas, então uma pessoa precisa atender apenas a uma delas. Para verificar se suas regras funcionam, clique em Test Permissions in preview no menu More actions do cartão da tabela, no menu More actions da própria tabela ou na página Permissions da tabela depois de salvar uma alteração. A prévia do seu aplicativo abre em uma página que lê essa tabela, com a lista de pessoas para simular já aberta. Assim, você vê exatamente o que cada uma pode acessar. Saiba mais sobre como testar suas permissões. Para alterar as permissões dos seus dados:

1. Clique em Dashboard no editor do seu aplicativo.
2. Clique em Data e selecione a tabela desejada.
3. Clique em Permissions no topo da tabela.
4. Clique em Edit, altere as regras e salve.

​

Corrigindo riscos de permissão

Quando uma tabela tem um risco de segurança em nível de linha, um ícone de aviso aparece no seu cartão na página Data e um banner Permission risks detected aparece acima dos cartões. Abra a tabela para ver o mesmo banner com o risco e as regras recomendadas detalhados.

• Corrigir uma tabela: Abra a tabela e clique em Fix para aplicar as regras recomendadas, ou em More details para revisar o risco e as alterações sugeridas primeiro.
• Corrigir várias de uma vez: Na página Data, clique em Fix all no banner para corrigir todas as tabelas sinalizadas, ou clique em Select, marque as tabelas desejadas e depois clique em Fix all.

---

​

Conectando seus dados a outro aplicativo

Você pode permitir que outro aplicativo leia ou grave dados do seu aplicativo Base44. Isso é útil se você quer sincronizar informações, automatizar tarefas ou dar acesso a ferramentas externas. Para conectar seus dados a outro app:

1. Clique em Dashboard no editor do seu aplicativo.
2. Clique em API.
3. Selecione a tabela desejada no dropdown.
4. Escolha o formato que você precisa: JS SDK, JS Fetch, cURL ou Python.
5. Copie o código para ler ou atualizar dados.
6. Cole no outro app ou ferramenta, para que ele saiba como se conectar à sua tabela.

---

​

Perguntas frequentes

Selecione uma pergunta abaixo para saber mais sobre os dados do seu aplicativo.