Operação do Pipeline: Executar Apex
Execute código Apex anônimo diretamente dentro de um pipeline Revvy para executar lógica personalizada do Salesforce, automatizar operações de dados ou acionar atividades pós-implantação
O Executar Apex a operação permite que você execute código Apex anonimamente em uma organização Salesforce conectada. É útil para realizar ações automatizadas, como inicialização de dados, atualizações de configuração ou disparar lógica de validação após a implantação.
Esta operação executa o trecho de código fornecido na configuração da etapa e registra os resultados de compilação e tempo de execução para revisão.
Opções de Configuração
Ao criar ou editar uma etapa Executar Apex, configure o seguinte:
Nome: Nome da etapa para identificar a ação (por exemplo, Executar Anônimo).
Operação: Executar Apex.
Organização Alvo: Escolha a org Salesforce onde o código deve ser executado (por exemplo, SandboxAlvo).
Código: Insira o código Apex a ser executado (por exemplo,
System.debug('Olá do Execute Anonymous!');)
Próxima Etapa (Em Sucesso / Em Falha): Defina o que o pipeline deve fazer após a execução — Parar ou Continuar.
Criando uma Etapa Executar Apex
Vá para Pipelines → Criar ou Editar um pipeline existente.
Clique no ícone + entre Iniciar e Parar.
No painel de configuração, insira:
Nome: Executar Anônimo
Operação: Executar Apex
Organização Alvo: SandboxAlvo
Código: System.debug('Olá do Execute Anonymous!');
Em Sucesso / Em Falha: Parar
Clique Adicionar para salvar.
Executando um Pipeline
Clique Executar Pipeline no canto superior direito.
O pipeline é executado e envia o código Apex fornecido para a org alvo.
Atualizações de status em tempo real:
Em Progresso — Execução do código iniciada.
Concluído — Código executado com sucesso.
Exceção — A execução falhou devido a erros de sintaxe ou em tempo de execução.
Visualizando Resultados
Após a execução, vá para Código → Branch → Atividades → Pipelines.
Cada trabalho lista informações principais:
Tipo: Executar Apex
Status: Concluído / Exceção / Em Progresso
Duração: Tempo total de execução
Criado Por: Usuário que iniciou o trabalho
Clique no nome do pipeline (por exemplo, Validar Pipeline) para abrir os resultados detalhados do trabalho.
Logs e Saída de Execução
Selecione a etapa Executar Anônimo na visualização de resultados do pipeline para abrir os logs de execução.
Os logs exibem mensagens de compilação e tempo de execução do Apex em tempo real retornadas pelo Salesforce.
Exemplo de log:
Solução de Problemas
Erros de Compilação: Verifique a sintaxe do código Apex — assegure-se de que pontos e vírgulas e declarações de variáveis estejam corretos.
Problemas de Autorização: Verifique se a org conectada tem permissões apropriadas para executar código anônimo.
Timeouts: Operações Apex de longa duração podem exceder limites de tempo de execução. Otimize a lógica ou divida em etapas menores.
Sem Saída: Adicione instruções System.debug() no código para registrar valores ou operações-chave.
Melhores Práticas
Use Executar Apex para automatizar tarefas de configuração após a implantação de metadados.
Mantenha trechos de código simples — evite DML ou chamadas externas a menos que necessário.
Sempre teste seu código em um sandbox antes de executar em produção.
Combine Executar Apex com Etapa Manual para revisão ou aprovação antes da execução.
Monitore os logs em Atividades → Pipelines para confirmar execuções bem-sucedidas.
Atualizado