Conceito e mecanismo
Antes de criar Apex para um LWC, avaliar base components e Lightning Data Service para os objetos e operações suportados. UI API aplica segurança de objetos, campos e registos. O wire fornece um fluxo de valores que devem ser tratados como imutáveis e pode emitir novamente quando dependências mudam.
Uma transformação visual deve usar uma cópia local, preservando propriedade dos dados. Métodos Apex usados com wire exigem cacheable true e leitura sem mutação. Uma operação de escrita deliberada, como confirmar uma decisão, deve usar um caminho adequado, frequentemente uma chamada imperativa.
Esta devolve uma Promise, cujo sucesso ou erro deve ser tratado explicitamente.
Aplicação guiada
Uma escrita confirmada não atualiza automaticamente todos os caminhos de leitura. Para Apex wire, guardar o resultado provisionado e passá-lo a refreshApex; o valor resolvido da Promise de refresh não é o array de dados a apresentar. Quando Apex imperativo altera registos usados por LDS, notificar os IDs afetados pelo mecanismo apropriado.
Não assumir um TTL fixo nem repetir a decisão de negócio para forçar atualização visual. Entre componentes, transmitir um contrato pequeno: um CustomEvent com ID primitivo pode bastar para comunicar seleção. Se for necessário um objeto, evitar entregar uma referência mutável aos dados internos do emissor.
Separar estados pendente, concluído e falhado na experiência do operador.
Apex para LWC, Flow e ações Agentforce
Outro objetivo oficial liga Apex aos componentes de interface, Flow e Agentforce. Quando uma interface LWC ou uma ação de agente pede a um método Apex que altere dados, separa intenção, autorização e efeito confirmado. Define contratos de entrada e de saída, valida parâmetros no servidor, trata erros de forma explícita e verifica quem executa a ação e com que acesso.
A restrição de um botão no cliente não é uma autorização no servidor; a existência de uma ação de agente também não substitui a verificação de identidade, permissões e segurança de dados. Para operações com efeitos externos ou repetição após timeout, documenta como consultar o estado e evitar duplicações.
Testa os caminhos de sucesso, falha de acesso, dados inválidos e execução repetida. Mantém observabilidade suficiente para distinguir uma resposta gerada de uma transação confirmada. Estes princípios aplicam-se a exemplos independentes, sem exigir uma organização Salesforce paga ou afirmar que o curso executou agentes reais.
Uma consola mostra uma lista Apex wire e um painel LDS. Depois de confirmar a decisão por Apex, atualiza os dois consumidores através dos respetivos mecanismos. Enquanto a leitura é atualizada, apresenta estado pendente sem voltar a gravar.
Armadilhas comuns
Mutar dados wire; escrever num método cacheable; Promise sem tratamento; Map JavaScript como parâmetro serializável garantido; um refresh para todos os caminhos.
Tópicos relacionados: Modelo de dados, identidade e metadados · Coleções e escolha entre configuração e código · Consultas, DML e resultados de erro
Distinguir leitura reativa, escrita deliberada e atualização de cache. Comunicar entre componentes com contratos pequenos e claros.
Referências
- Client-Side Caching of Apex Method Results · Salesforce rolling primary documentation inspected 2026-10-01; API context stated per example
- Lightning Data Service · Salesforce rolling primary documentation inspected 2026-10-01; API context stated per example
- Understand the Wire Service · Salesforce rolling primary documentation inspected 2026-10-01; API context stated per example
- Call Apex Methods Imperatively · Salesforce rolling primary documentation inspected 2026-10-01; API context stated per example
- Create and Dispatch Events · Salesforce rolling primary documentation inspected 2026-10-01; API context stated per example
- Salesforce Certified Platform Developer Exam Guide · Official guide states Summer25; inspected 2026-10-01