Lightning Web Components

Construir uma UI personalizada em torno da REDA Financials é um trabalho comum de LWC — os objetos são objetos personalizados, os serviços de dados são os padrão, e seus componentes ficam ao lado dos do pacote em qualquer página Lightning. O trabalho fino está no que você constrói sobre.

Acesso a dados a partir dos seus componentes

• Lightning Data Service em primeiro lugar: lightning-record-form, os adaptadores wire e a UI API falam fluentemente com objetos refin__ — CRUD com layouts, FLS e validações resolvidos de graça.
• Seu Apex onde a lógica mora: um controlador que consulta faturas, ou chama refin.GlobalTaxService para pré-visualização de impostos em tempo real na sua própria UI de cotação (veja Desenvolvimento em Apex na REDA).
• Mudanças de status a partir da UI = contabilização: um botão no seu componente que faz PATCH do status para 'Posted' via LDS executa o mecanismo completo — construa o tratamento de erros em torno da mensagem do DML, que já é texto pronto para o usuário.

Compondo com as páginas do pacote

• As páginas de registro estão abertas: coloque seus componentes nas páginas de registro empacotadas (ou clone a flexipage e reorganize) — um painel personalizado de "contexto do contrato" ao lado da fatura, um cartão de propriedade no ativo.
• Os formulários se estendem sem código: antes de escrever um componente para "adicionar um campo ao formulário da fatura", verifique os conjuntos de campos — os formulários empacotados ganham colunas de forma declarativa.
• A navegação é padrão: seus componentes criam links diretos para qualquer registro ou lista da REDA usando o serviço de navegação da plataforma; as telas empacotadas fazem o mesmo de volta.

Padrões que valem a pena

• Painéis de contexto verticais — os dados do seu setor (propriedade, projeto, caso) exibidos ao lado do documento financeiro que os referencia.
• Criação guiada — um assistente que coleta as entradas do seu domínio, cria o documento em rascunho via LDS e entrega o usuário ao formulário padrão para a parte contábil.
• Painéis somente leitura — consultas via adaptador wire sobre faturas/livro razão com a visualização de sua escolha, complementando os painéis padrão.

Um componente na prática: a pré-visualização de impostos da cotação de locação da Meridian

A equipe de locação da Meridian Properties Group queria mostrar o aluguel com impostos incluídos durante a negociação, antes de qualquer fatura existir. O componente é um LWC REDA de manual: sua UI, seu controlador, o mecanismo do pacote. O controlador monta uma solicitação para refin.GlobalTaxService a partir das entradas da cotação:

refin.GlobalTaxService.TaxRequest req = new refin.GlobalTaxService.TaxRequest();
req.entityId        = quote.entityId;
req.accountId       = quote.tenantAccountId;
req.transactionDate = Date.today();
req.side            = 'Sales';

refin.GlobalTaxService.TaxLineRequest line = new refin.GlobalTaxService.TaxLineRequest();
line.lineKey   = 'rent-1';          // ecoado de volta para correlação
line.amount    = quote.monthlyRent;
line.productId = quote.rentProductId;
req.lines      = new List<refin.GlobalTaxService.TaxLineRequest>{ line };

refin.GlobalTaxService.TaxResponse res = refin.GlobalTaxService.calculateTax(req);

A resposta traz totalTaxAmount e resultados por linha (alíquota, valor, contas contábeis resolvidas), correlacionados de volta por lineKey. Como o contrato não realiza nenhum DML e nunca lança exceção para quem o chama, o componente verifica res.success, exibe res.errorMessage quando falso, e copia os valores de que precisa para seu próprio formato de resposta no wire. Quando o contrato é assinado e a fatura real é contabilizada meses depois, os números batem até o centavo — um único mecanismo, dois consumidores.

As proteções que sua UI herda

Erros comuns a evitar

O que vem a seguir

1. Extensibilidade por FieldSets — a alternativa sem código a verificar primeiro.
2. Desenvolvimento em Apex na REDA — a camada de lógica.
3. Integração de Fluxos do Salesforce — o meio-termo declarativo.

Perguntas frequentes