Cartão de atenção de Conta: o que olhar primeiro

Criei um cartão compacto na página da Conta para ajudar a identificar o que merece atenção naquele momento. Ele reúne Casos prioritários, Oportunidades próximas do fechamento e tarefas atrasadas, sem substituir as listas e ferramentas usadas para acompanhar cada registro em detalhe.

A página da Conta já oferece listas relacionadas e uma linha do tempo de atividades, mas cada área mostra informações diferentes. Para uma gerente que consulta várias Contas ao longo do dia, encontrar o que exige atenção significa percorrer a página, abrir registros e juntar essas informações por conta própria. Pode haver um Caso crítico, uma Oportunidade perto do fechamento e uma tarefa atrasada, mas não existe um resumo que reúna essas informações facilmente.

A ideia era mostrar, logo no início da página e sem ocupar muito espaço, o que precisa de atenção agora. Assim, o gerente consegue decidir por onde começar e continua usando as listas existentes quando precisa investigar cada item.

Antes de criar algo novo, avaliei os componentes que o Salesforce já oferece. As listas relacionadas e a linha do tempo continuam úteis para consultar registros e acompanhar atividades em detalhe, então o novo cartão foi pensado como um resumo complementar.

Implementei um componente accountAttentionSummary usando LWC (tecnologia do Salesforce para criar componentes de interface), e que não altera registros (read-only). Para buscar as informações, usa lightning/graphql, o adaptador que conecta consultas GraphQL ao Lightning Data Service. Cada um tem uma função neste case: GraphQL pede ao sistema somente os dados necessários para aquela tela e o Lightning Data Service fornece esses dados à interface.

O cartão consulta os campos necessários em três tipos de registro relacionados à Conta: Casos abertos de alta prioridade, Oportunidades abertas próximas do fechamento e tarefas atrasadas. Para cada tipo, mostra até cinco registros e também informa a quantidade total encontrada, indicando quando existem outros itens além dos exibidos.

A interface apresenta cada grupo em uma seção compacta, com links para abrir os registros usando a navegação padrão do Salesforce. Também trata os estados de carregamento, quando os dados ainda estão sendo buscados, de lista vazia e de erro. Testes automatizados com Jest verificam esses três estados.

Como o cartão apenas consulta informações, usei o Lightning Data Service e a interface do Salesforce para respeitar as permissões de objeto e de campo do usuário. Em termos práticos, cada pessoa vê somente os registros e campos aos quais já tem acesso, sem que seja necessário recriar essa verificação em código Apex.

Poderia ser uma opção se o cartão precisasse combinar dados de forma mais complexa ou fazer cálculos que a consulta GraphQL não atende. Para este card-resumo, a consulta direta resolve a necessidade sem acrescentar essa camada de código.

Ao abrir uma Conta, a gerente vê um resumo como dois Casos críticos, uma Oportunidade próxima do fechamento e três tarefas atrasadas. Cada item tem um link para o registro correspondente, onde o trabalho continua. Se não houver nada pendente, o cartão informa que não há itens para mostrar, em vez de exibir uma lista vazia sem explicação.

As informações que antes estavam distribuídas pela página passam a aparecer juntas em um cartão no início da Conta, a área que a gerente encontra sem precisar rolar a página. As listas detalhadas continuam disponíveis para consulta, enquanto o cartão oferece uma visão rápida e não altera nenhum dado.