Pular para o conteúdo principal

Datatables

atenção

Gerado por Inteligência Artificial.

Visão Geral​

Este método processa parâmetros de DataTable (paginação, busca, ordenação) e retorna um DTResult<Bairro> contendo a lista de bairros conforme filtragem aplicada.

BOX3_ERP_API\BOX3_ERP_API.Core\BLL\BairroBLL.cs
public async Task<DTResult> Datatables(DTParameters item) { ... }

Dependências Diretas​

MétodoLocalizaçãoLinha
DTParameters.getSearchString()BOX3_ERP_API\BOX3_ERP_API.Core\BLL\BairroBLL.cs50
DbSet<Bairro>.AsQueryable()BOX3_ERP_API\BOX3_ERP_API.Core\BLL\BairroBLL.cs52
string.IsNullOrEmpty(string?)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\BairroBLL.cs54
string.Contains(string)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\BairroBLL.cs55
DTParameters.MakeResponse<IQueryable<Bairro>>(IQueryable<Bairro>, int?, bool?)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\BairroBLL.cs57

Referências​

Método / EndpointLocalizaçãoLinha
Datatables(DTParameters item)BOX3_ERP_API\BOX3_ERP_API\Controllers\BairroController.cs94

Detalhamento das Referências​

Datatables​

Este é o método do controller BairroController decorado com

[HttpPost("listagem")]  
public async Task<ActionResult<DTResult>> Datatables(DTParameters item) { ... }

Ele expõe o endpoint REST que recebe os parâmetros de DataTable, invoca o BLL Datatables para aplicar filtros, ordenação e paginação, e retorna o resultado formatado para o componente de tabelas no front-end.

Impacto de Alterações​

  • Qualquer mudança em getSearchString, MakeResponse ou na lógica de filtragem (Contains, IsNullOrEmpty) afeta diretamente o comportamento da paginação e busca.
  • Alterações nos critérios de ordenação em MakeResponse podem modificar a ordem dos registros retornados.

Propagação de Mudanças​

  1. Atualizar testes que simulam requisições de DataTable com vários parâmetros de busca, ordenação e paginação.
  2. Verificar o comportamento do endpoint listagem no controller após alterações no BLL.
  3. Sincronizar mudanças com o componente de tabelas no front-end para garantir compatibilidade.
  4. Atualizar documentação Swagger/OpenAPI para refletir alterações nos parâmetros de DTParameters ou no formato de DTResult.

Requisitos para Alteração Segura​

  • Cobertura de testes end-to-end com diferentes filtros (search, order, start, length).
  • Validação de parâmetros de entrada em DTParameters (valores mínimos/máximos).
  • Tratamento de exceções e retorno de mensagens claras para erros de paginação ou ordenação.
  • Garantir desempenho adequado para grandes volumes de dados.