Truque Inteligente: Limpando Collections ao Navegar no Oracle APEX

Otimização de Fluxos no APEX: Limpeza de Dados de Collection com Navegação Recomendada

No Oracle APEX, collections são frequentemente usadas para armazenar dados temporários durante sessões de usuário. No entanto, ao navegar entre páginas, pode ser necessário limpar os dados dessas collections para garantir que as informações apresentadas ou processadas sejam sempre atualizadas. Neste artigo, abordaremos como você pode fazer isso ao definir o destino de navegação da página, utilizando a limpeza de cache.

Desafio Comum

Ao trabalhar com dados dinâmicos em sua aplicação, pode ser necessário reiniciar o estado de determinadas collections ao navegar para uma nova página. Em vez de manusear manualmente cada collection, o APEX permite limpá-las de forma elegante ao definir opções de link ou botão.

Muitos desenvolvedores utilizam o seguinte método para limpar collections, o que requer a execução direta de PL/SQL:

BEGIN
    APEX_COLLECTION.DELETE_COLLECTION(
        p_collection_name => 'MY_COLLECTION');
END;

Embora funcional, essa abordagem demanda uma chamada explícita de PL/SQL, o que potencialmente incrementa a complexidade do desenvolvimento. Se essa chamada está incorporada em um processo ao entrar em determinada tela, talvez seja mais eficiente adicionar diretamente no campo de Limpar Cache durante a navegação da página.

Solução com Limpeza de Cache

O APEX oferece a capacidade de limpar o cache de páginas ou, mais especificamente, de collections quando você configura a navegação entre páginas. Vamos ver como configurá-las.

Passo a Passo

Configurar o Link ou Botão:

• Acesse a página em que você possui o link ou botão que, ao ser clicado, redireciona para outra página.
• Edite a ação de navegação do link ou botão que leva à nova página.

Limpar Cache no Destino:

• Na seção de configuração do destino, procure pela opção “Limpar Cache”.
• No campo “Limpar Cache”, insira: MY_COLLECTION
• Onde NOME_DA_COLLECTION é o nome da sua collection que você deseja limpar ao acessar a nova página.
• Se deseja limpar também outras caches de page, inclua seus IDs, separados por vírgulas. Por exemplo: MY_COLLECTION,PAGE1,PAGE2

Salvar e Testar:

• Salve as mudanças e execute sua aplicação.
• Ao clicar no link ou botão, você deve verificar se os dados da collection são devidamente refrescados ou limpos na página de destino.

Resultado

• A configuração do seu link de destino ficará semelhante a esta configuração:

Link Builder de Destino com a configuração Limpar Cache de uma collection

Conclusão

Ao utilizar a funcionalidade nativa do Oracle APEX para limpar cache através de navegações, você garante a integridade e a atualização dos dados em tempo real. Este truque reduz a complexidade de sua aplicação, permitindo que as collections sejam limpas de forma automática ao ponto de navegação, mantendo as informações fluídas e precisas.

Se você integrar esta técnica em seu fluxo de trabalho, compartilhe seus insights e melhorias nos comentários! 🚀