Saltar para o conteúdo
Verificado

Tabelas e campos

As colunas de uma tabela são um conjunto fechado de seis tipos, cada um convertido à entrada, mais os índices que tornam uma linha localizável.

Uma tabela é definida uma só vez, no Xuda Studio, e todos os locais que mostram os seus dados, a grelha do Studio, o separador Dados do dashboard, um programa Obter Dados ou uma chamada direta à API, leem as mesmas definições de campos.

A referência completa do esquema

Esta página trata dos campos tal como os encontra ao criar e navegar numa tabela. Para a lista completa de propriedades, os índices e como um programa Obter Dados ou Definir Dados aponta para uma tabela, veja Tabela em Building Blocks.

Seis tipos de campo, mais nenhum

Cada campo de uma tabela é exatamente de um de seis tipos. O Studio mostra cada um com o seu próprio ícone no cabeçalho da grelha em vez de um selo de texto, uma vez que uma coluna é estreita e um id de campo como ORD_Total já ocupa quase toda a largura:

Não existe um sétimo tipo, nem forma de adicionar um personalizado. Um campo que não se encaixe nestes seis, um bloco de texto formatado, um ficheiro, uma relação com outra tabela, é modelado como uma string (um id, um caminho, um blob codificado em JSON) ou uma array/object deles; não existe um tipo de coluna próprio de primeira classe para nenhum deles numa tabela.

O que cada tipo faz realmente com um valor

Tanto dbs_create como dbs_update convertem o valor que envia através do tipo declarado do campo antes de ser guardado, por isso vale a pena saber exatamente o que cada conversão faz em vez de assumir um significado familiar:

string

Tudo o que ainda não seja uma string é convertido com uma conversão simples para string. Um valor em branco ou em falta é guardado como "".

number

É guardado Number(value). Um valor que não seja interpretado como um número finito passa para 0 em vez de rejeitar a escrita. Um valor em branco ou em falta também é guardado como 0.

boolean

Apenas uma lista fixa de tokens é lida como true (Y, 1, true, TRUE, ON, YES) e outra lista fixa como false (N, 0, false, FALSE, OFF, NO); tudo o resto, incluindo um valor em branco, é guardado como false.

object

Uma string é interpretada como JSON5; um valor que já tenha a forma de um objeto é guardado tal como está. Um valor em branco ou em falta, ou uma string que não seja interpretada, é guardado como {}.

array

Uma string é primeiro interpretada como JSON5 e, se falhar, é avaliada como um literal JavaScript; um valor que já tenha a forma de uma matriz é guardado tal como está. Um valor em branco ou em falta, ou uma string que nenhuma das interpretações trate, é guardado como [].

date

Não há tratamento específico de datas à entrada: a string que enviar é guardada exatamente como foi enviada. Escolha um formato, ISO 8601 (2026-09-25T00:00:00.000Z) é a predefinição mais segura, uma vez que nada na plataforma normaliza um campo de data por si, e uma tabela com formatos mistos ordena e filtra de forma inconsistente.

Um number nunca rejeita uma escrita

Enviar um valor que não pode tornar-se um número válido para um campo number não faz a chamada falhar, guarda silenciosamente 0. Valide você mesmo um valor numérico antes de o escrever se um 0 estiver errado.

Dar nomes aos campos

Não existe uma regra de nomenclatura imposta além de os ids dos campos serem únicos na tabela, mas todas as tabelas já existentes num projeto Xuda seguem uma convenção: prefixe cada campo com um código curto da própria tabela, de modo que ORD - Orders produz ORD_Id, ORD_Total, ORD_Status. Mantém os nomes dos campos sem ambiguidade quando uma consulta, uma expressão ou um ficheiro de importação tem de referenciar várias tabelas ao mesmo tempo.

Marcar um campo como obrigatório

Um campo tem um indicador de obrigatório que define ao criá-lo, junto com o tipo e o comentário, para registar que uma linha não deve ser guardada sem um valor aí.

As tabelas têm o seu próprio estado ativo/arquivado

Separadamente de uma linha individual ser arquivada (eliminada de forma recuperável, veja Consultar dados através da API), uma tabela em si pode estar ativa ou arquivada como nó do Studio. O separador Dados do dashboard lista as tabelas de um projeto como cartões, alternáveis entre Ativo e Arquivado, cada cartão a mostrar o nome da tabela e o seu número atual de linhas. Arquivar uma tabela aqui é uma ação do lado do Studio sobre o nó, é uma operação diferente de arquivar linhas dentro dela.