Desenvolvimento de microserviços e APIs REST com o framework minimalista Horse em Delphi. Rotas, controllers, middlewares, gerenciamento de memória e tratamento de parâmetros.

2026-07-064

delphi-webstencils-templates

regyssilveira/AgentKit4D

Diretrizes de qualidade e desenvolvimento de templates HTML e páginas dinâmicas com Web Stencils (Server-Side Rendering) no Delphi.

2026-07-064

delphi-migration-dbx-to-firedac

regyssilveira/AgentKit4D

Diretrizes e mapeamentos de expressões regulares para migração de componentes dbExpress (DBX) para FireDAC no Delphi.

2026-07-064

delphi-dext-framework

regyssilveira/AgentKit4D

Diretrizes de qualidade e desenvolvimento de APIs web, ORM, injeção de dependências e testes utilizando o Dext Framework em Delphi.

2026-07-064

delphi-acbr-integration

regyssilveira/AgentKit4D

Arquitetura e padrões de integração com o ecossistema ACBr (Automação Comercial Brasil) em Delphi. Desacoplamento de UI e controle fiscal.

2026-07-064

name	delphi-migration-bde-to-firedac
description	Diretrizes e mapeamentos de expressões regulares para migração de componentes Borland Database Engine (BDE) para FireDAC no Delphi.

Diretrizes para Migração de BDE para FireDAC no Delphi

Esta skill define o guia técnico e o mapeamento de componentes/tipos para migração de projetos Delphi que utilizam o Borland Database Engine (BDE) legado para a tecnologia moderna de acesso a dados FireDAC.

1. Automatização da Migração (reFind.exe)

O RAD Studio inclui um utilitário de console chamado reFind.exe (localizado na pasta bin da instalação do Delphi). Ele permite processar em lote todo o projeto, substituindo as classes, propriedades e cláusulas uses via expressões regulares.

Como Executar o reFind para BDE

Para rodar a migração em lote em todas as units .pas e arquivos de tela .dfm de forma recursiva, execute o prompt de comando da pasta do projeto com os caminhos corretos:

"C:\Program Files (x86)\Embarcadero\Studio\<VERSAO>\bin\reFind.exe" /s /d:*.pas /d:*.dfm "C:\Users\Public\Documents\Embarcadero\Studio\<VERSAO>\Samples\Object Pascal\Database\FireDAC\Tool\reFind\BDE2FDMigration\FireDAC_Migrate_BDE.txt"

(Substitua <VERSAO> pela versão do Delphi instalada, por exemplo: 22.0 para o Delphi 11, 23.0 para o Delphi 12, ou 37.0 para o Delphi 13).

2. Substituição de Classes de Componentes (Mapeamento)

Ao realizar a migração manual ou revisar o resultado do reFind.exe, aplique os seguintes mapeamentos de classe:

Classe Legada BDE	Nova Classe FireDAC	Unit FireDAC Necessária
`TSession`	`TFDManager`	`FireDAC.Comp.Client`
`TDatabase`	`TFDConnection`	`FireDAC.Comp.Client`, `FireDAC.Stan.Intf`, `FireDAC.Stan.Option`, `FireDAC.UI.Intf`
`TTable`	`TFDTable`	`FireDAC.Comp.Client`, `FireDAC.Comp.DataSet`
`TQuery`	`TFDQuery`	`FireDAC.Comp.Client`, `FireDAC.Comp.DataSet`, `FireDAC.DApt`
`TStoredProc`	`TFDStoredProc`	`FireDAC.Comp.Client`, `FireDAC.Comp.DataSet`, `FireDAC.DApt`
`TUpdateSQL`	`TFDUpdateSQL`	`FireDAC.Comp.Client`
`TBatchMove`	`TFDBatchMove`	`FireDAC.Comp.BatchMove`
`TParam`	`TFDParam`	`FireDAC.Stan.Param`
`TParams`	`TFDParams`	`FireDAC.Stan.Param`
`TBlobStream`	`TFDBlobStream`	`FireDAC.Comp.DataSet`
`TAutoIncField`	`TFDAutoIncField`	`FireDAC.Comp.DataSet`
`TDBDataSet` / `TBDEDataSet`	`TFDRDBMSDataSet`	`FireDAC.Comp.Client`
`EDBEngineError`	`EFDDBEngineException`	`FireDAC.Stan.Error`

3. Substituição e Mapeamento de Propriedades

Muitas propriedades de componentes do BDE mudaram de nome ou de estrutura de acesso no FireDAC. Abaixo estão as principais conversões e remoções:

Propriedades a Mapear/Modificar:

DatabaseName → ConnectionName (ou Connection apontando para o TFDConnection correspondente).
AliasName → ConnectionDefName.
Session.* → FDManager.*.
IsAlias → IsConnectionDef.
AddAlias → AddConnectionDef.
DeleteAlias → DeleteConnectionDef.
ModifyAlias → ModifyConnectionDef.
GetAliasParams → GetConnectionDefParams.
GetAliasNames → GetConnectionDefNames.
FindDatabase → FindConnection.
OpenDatabase → OpenConnection.
CloseDatabase → CloseConnection.
GetDatabaseNames → GetConnectionNames.
Unidirectional → FetchOptions.Unidirectional.
UpdateRecordTypes → FilterChanges.
RequestLive → UpdateOptions.RequestLive.
UpdateMode → UpdateOptions.UpdateMode.
TransIsolation → TxOptions.Isolation.
TTable.ReadOnly → UpdateOptions.ReadOnly.
TQuery.DataSource → MasterSource.
TDatabase.Execute → ExecSQL.

Propriedades Obsoletas a Remover (Código e DFM):

SessionName (o gerenciamento de conexões no FireDAC usa TFDConnection e TFDManager de forma centralizada ou implicitamente thread-safe via Pools).
PrivateDir.
Propriedade Origin nos campos persistentes no .dfm.

4. Tipos, Constantes e Enumerados

Mapeie as definições do BDE para os enumerados correspondentes do FireDAC:

Isolamento de Transação:

TTransIsolation → TFDTxIsolation (em FireDAC.Stan.Option)
tiDirtyRead → xiDirtyRead
tiReadCommitted → xiReadCommitted
tiRepeatableRead → xiRepeatableRead

Atualizações (Update Request):

TUpdateKind → TFDUpdateRequest (em FireDAC.Phys.Intf)
ukModify → arUpdate
ukInsert → arInsert
ukDelete → arDelete

Ações em Erros de Atualização:

TUpdateAction → TFDErrorAction (em FireDAC.Stan.Intf)
uaFail → eaFail
uaAbort → eaExitFailure
uaSkip → eaSkip
uaRetry → eaRetry
uaApplied → eaApplied

Modos do Batch Move:

TBatchMode → TFDBatchMoveMode (em FireDAC.Comp.BatchMove)
batAppend → dmAppend
batUpdate → dmUpdate
batAppendUpdate → dmAppendUpdate
batDelete → dmDelete
batCopy → dmAlwaysInsert

5. Limpeza de Cláusulas Uses (Units Obsoletas)

Remova as seguintes units legadas da cláusula uses de todas as suas classes Delphi:

BDE.DBTables
BDE.BDEConst
DBTables
BDEConst
BDEMTS
BDE