Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Inserir

Insere um novo registro em

um

uma tabela do banco

da

de dados.

Parâmetros

de Entrada  Nota

Nome

Tipo

Doc

Parâmetro 1Objeto/campos

Objeto contendo o registro com os dados a serem inseridos, quando configurado via objetos

ou, campos, contendo um ou mais dados a serem inseridos, quando configurados via campos

Nota

titleObs.:

Os parâmetros de entrada para função apresentam-se de acordo com os campos, ou o objeto, adicionados na

tela

janela de configuração do bloco de programação, o que significa dizer que cada campo definido representa um novo parâmetro da função.

Configuração do bloco

É possível inserir um registro na tabela do banco de dados de duas formas diferentes, via campos ou por objeto, essa configuração é feita a partir do campo Tipo (destaque 2 da figura 1).

Para configurar o bloco Inserir, clique no símbolo da engrenagem, isso fará com que a janela Configurar Bloco de Programação seja exibida. Após informar a entidade (destaque 1 da figura 1), é possível selecionar os campos que serão usados a partir dos atributos do objeto (Tipo Campos) ou apenas passando o Objeto, nesse caso, não será possível configurar os campos.


Image Added

Figura 1 - Inserção de dados via campos


  1. Entidade: abre a janela de seleção de entidades.
  2. Tipo: informa se o bloco será alimentado a partir dos atributos "Campos" da entidade ou a partir do "Objeto".
  3. + Novo Campo: clique para adicionar os campos da entidade.
  4. Campos: lista de campos adicionados.
  5. Botão Excluir: apaga os campos inseridos. Exclua todos os campos para retornar ao tipo "Objeto"

Para saber mais sobre o campo Modo de Consulta, acesse a figura 1.1 da documentação Assistente de consulta JPQL.

Compatibilidade

Image Modified Servidor

Exemplo 1

A função abaixo em destaque permite a inserção de um registro contendo os parâmetros definidos na tela de configuração do bloco de inserção.

- Inserção via campos

Assim que selecionamos a entidade (destaque 1 da figura 1), o bloco é configurado por padrão com o tipo objeto, para que possamos mudar o tipo para campos, devemos clicar em + Novo campo (destaque 3 da figura 1) para adicionar os campos. Definidos os campos, basta inserir os valores que serão salvos no registro, confira na figura 1.1.


Image Added

Figura 1.1 - Bloco de programação Inserir configurado via campos


Confira abaixo o resultado da inserção. 


Image Added

Figura 1.2 - Registro sendo exibido na Grade

Exemplo 2 - Inserção via objeto

Além da inserção via campos, também é possível inserir um registro passando um objeto já com seus atributos. No exemplo abaixo estamos criando um objeto a partir do bloco de programação Criar novo objeto.  


Image Added

Figura 1.3 - Bloco de programação Inserir configurado via objeto


Confira abaixo o resultado da inserção. 


Image Added

Figura 1.4 - Registro sendo exibido na Grade

Sobre o bloco

O bloco de programação Inserir insere dados em um registro de duas formas diferentes, a primeira é passando os campos que se deseja inserir, como exemplificada na figura 1.1. A segunda forma é passando diretamente o objeto, figura 1.3.

Image Removed

Sobre Inserção(Insert SQL)

Insert é uma declaração da linguagem SQL, “Structured QueryLanguage” ou, em Português, Linguagem de Consulta Estruturada,

 que

 que insere um ou

mais registros em uma tabela em

mais registros em uma tabela em um banco de dados.

Informações
titleMais sobre

Inserção(Insert SQL)

Sobre o bloco

O comando de inserção de um registro utilizando o bloco Inserir pode ser criado clicando-se no botão de configuração do bloco de programação.

Image Removed

Configuração do bloco de programação

 

Utilizando o bloco de inserção

A inserção de registros em banco de dados pode ser feita através do modo visual, permitindo que o usuário não necessite de uma interação direta com códigos na linguagem SQL.

Para mais informações sobre como inserir de forma visual um registro em bancos de dados acesse o link abaixo.

Informações
titleMais sobre

Utilizando o assistente de inserção visual

 

 

 

 

para saber mais clique aqui.