Skip to content

Grid CRUD

Neste tópico, mostraremos como começar a usar operações CRUD no Grid como parte do App Builder.

App Builder agora oferece uma UI para que os usuários executem operações CRUD dentro do grid. Isso é bem fácil, já que o Grid fornece Edição de Célula, Edição de Linha, Adição de Linha e Exclusão de Linha na caixa. Vamos usar a definição Swagger CRUD API Northwind personalizada e UI (mais exemplos aqui).

Se o Grid estiver vinculado a uma tabela Customers (Swagger path Image 1), a seção Data Interactions será carregada com os métodos disponíveis para Customers, após adicionar tal interação (Image 2).

Image 1: Swagger Configure Endpoints

Image 2: Painel de Propriedades -> Interações

No exemplo abaixo, você verá como usar um serviço Web API Northwind para obter todos os clientes, selecionar um cliente específico com CustomerID “BERGS” e atualizar seu CompanyName para “Testing the update”. App Builder pode fazer uma solicitação de dados real para alterar os dados remotos se o usuário final permitir através da janela de prompt (Ativar live-edit). Lembre-se de que existem dois estados de acesso a dados no App Preview. A parte Editor/usuário autenticado do workspace será solicitada diretamente com os estados de alterações em tempo real (imagem abaixo). Viewer/usuário não faz parte do workspace será notificado de que ele não tem acesso à Web API real e estará usando dados fictícios em seu lugar.

Ativar live-edit

Uma barra de notificação será exibida na parte inferior da página avisando ao usuário final que qualquer alteração feita atualizará os dados remotos. Você pode desativar esse recurso usando o botão de ação Desativar live edit.

Desativar live-edit

Demo de CRUD em Grid

Este é todo o processo CRUD em ação:

Operações CRUD em Grid

E como ficaria o código gerado para a aplicação. É assim que a aplicação acessará diretamente a camada de dados através de chamadas Web API que serão definidas para cada uma das operações CRUD.

Observe que as operações CRUD também mapeiam conceitualmente para os métodos HTTP que são usados para comunicar com APIs via HTTP.

export class SwaggerNWindService {
  constructor(private http: HttpClient) { }

  public postCustomer(data: any): Observable<any> {
    const options = {
      headers: {
        Authorization: 'Bearer <auth_value>',
      },
    };
    const body = data;
    return this.http.post(`${API_ENDPOINT}/Customer`, body, options);
  }
  public putCustomer(data: any): Observable<any> {
    const options = {
      headers: {
        Authorization: 'Bearer <auth_value>',
      },
    };
    const body = data;
    return this.http.put(`${API_ENDPOINT}/Customer`, body, options);
  }
  public deleteCustomer(id: string): Observable<any> {
    const options = {
      headers: {
        Authorization: 'Bearer <auth_value>',
      },
    };
    return this.http.delete(`${API_ENDPOINT}/Customer/${id}`, options);
  }
  public getCustomer(): Observable<any> {
    const options = {
      headers: {
        Authorization: 'Bearer <auth_value>',
      },
    };
    return this.http.get(`${API_ENDPOINT}/Customer`, options);
  }
}

Geramos um serviço que pode ser reutilizado por qualquer componente que precise executar operações CRUD contra o mesmo banco de dados. Uma boa prática é escrever tal serviço o mais genérico possível, tornando-o adequado para ser reutilizado em muitos componentes e contra diferentes servidores também.

Problemas conhecidos e limitações

  • Funciona apenas com endpoints Open API.
  • As data-actions suportam no máximo 1 parâmetro.
  • Para o evento RowDeleted, o valor do parâmetro será o valor PrimaryKey da linha de grid escolhida.
  • Para os eventos RowAdded e RowUpdated, o valor do parâmetro será o objeto vinculado à linha de grid escolhida.

Recursos Adicionais