Dados da tabela

De forma simples, vamos à explicação de como alimentar a tabela do Data Plus.

Alimentando manualmente

No painel, ainda na tela de criação da tabela, você irá notar que existe um botão chamado Dados na listagem da sua tabela criada. Veja abaixo:

Ao clicar você será redirecionado para a tela de listagem de dados da tabela. E irá notar um botão Adicionar no canto direito superior.

Em seguida irá abrir um "popup" lateral com as colunas que foram criadas no exemplo de criando uma tabela. Perceba que foram criadas três colunas: "firstname", "lastname" e "is_admin". Veja no exemplo abaixo:

Para salvar uma informação na tabela, basta alimentar os campos e clicar em Salvar. Em seguida você irá notar que a informação será salva na tabela. Caso queira Editar ou Excluir, basta seguir os botões da linha criada para realizar as ações. Veja abaixo:

Alimentando via código pela IDE

Vamos mostrar agora como fazer o exemplo anterior de forma automática, criando um formulário e enviando a "requisição" para salvar os dados no Data Plus via código.

Cadastrar uma informação

É bem simples, basta fazer a chamada do método padrão da PWA abaixo em sua função de salvar os dados:

_database('usuarios').create({
  firstname: 'teste',
  lastname: 'docs',
  is_admin: true
});

O método _database('nome_da_tabela') recebe por padrão uma string no parâmetro que é exatamente o nome dado na sua tabela do Data Plus.

Ainda no método você irá notar a chamada do .create({}) que é responsável por salvar os dados passados em seu "body". O objeto passado no exemplo acima, possui exatamente os slugs das colunas que estamos utilizando em nosso exemplo de formulário de contato.

Dessa forma ao executar a chamada do método, os dados serão enviados diretamente para o Data Plus. Lembre-se que é importante validar o formulário para que se adeque às restrições das colunas como por exemplo colunas "obrigatórias".

Atualizar uma informação

Semelhante ao "create" mostrado acima, o "update" é bem simples, basta seguir o código abaixo:

_database('usuarios').update('id_da_linha_da_tabela', {
  firstname: 'John',
  lastname: 'Doe',
  is_admin: false
});

Temos então a chamada do _update(id, body), ele recebe dois parâmetros o id, e o body. O id é a identificação da linha da tabela, e o body são as informações que serão atualizadas na sua tabela.

note

A tabela retornará uma lista de rows e nela você poderá ver o campo extra id que é criado automaticamente ao salvar uma nova informação.

O ID da linha da tabela é retornado via requisição, como veremos abaixo no exemplo Buscar uma informação.

Buscar uma informação

Para buscar uma informação da tabela, basta seguir o código abaixo:

_database('formulario_de_contato').search('nome_do_campo', '=', 'valor');

Com a chamada do .search('campo', '=', 'valor') é possível buscar qualquer informação da tabela baseado em algum campo.

Temos também a listagem em massa das informações da tabela veja abaixo:

_database('formulario_de_contato').list(1, 10);

Nesse exemplo, usando o .list(1, 10), serão trazidos todos os dados da sua tabela, com uma paginação onde 1 é a página atual e 10 é o limite de itens por página.

Por fim temos a busca de apenas uma linha da tabela, baseada no id, veja abaixo:

_database('formulario_de_contato').get('id_da_linha_da_tabela');

Remover uma informação

Siga o código abaixo:

_database('formulario_de_contato').remove('id_da_linha_da_tabela');

Para remover é bem simples, basta fazer a chamada do .remove('id') passando o "id da linha da tabela".