Analytical List Page (ALP)

Uma analytical list page é adequada quando os usuários precisam ver um padrão antes de saber sobre quais itens agir. O gráfico responde "onde está o problema?", e a tabela abaixo dele responde "quais documentos?".

• Se os usuários já conhecem sua seleção e só precisam das linhas, um list report é mais simples.
• Se os usuários precisam de gráfico, filtros e itens em uma única página, use uma analytical list page.
• Se uma role precisa de um resumo de vários temas, uma overview page é mais adequada.
• Se o objetivo é acompanhar um único KPI governado a partir do launchpad, um app de KPI do SAP Smart Business é a opção mais próxima.

Exemplo: um gerente de compras da Alder Manufacturing seleciona a barra da Bright Freight em um gráfico de valor de pedidos por fornecedor e abre os itens atrasados na tabela já restringida. O app Monitor Purchase Order Items da SAP (F2358) segue esse padrão. Uma analytical list page é a escolha certa quando análise e ação pertencem à mesma tarefa.

Uma analytical list page é composta por quatro regiões, de cima para baixo:

1. Cabeçalho: o título da página, as variantes de página e, opcionalmente, KPI tags: rótulos curtos e clicáveis com um valor de KPI que abrem um card de KPI.
2. Barra de filtros visuais: pequenos gráficos, um por campo de filtro, cada um mostrando uma medida por valor de dimensão. Escolher uma barra ou um ponto define o filtro. Uma barra de filtros compacta, com campos clássicos, é o modo alternativo, mantido em sincronia.
3. Gráfico principal: um gráfico interativo dos dados filtrados. Selecionar um segmento do gráfico restringe a tabela.
4. Tabela: os itens subjacentes, com ações e navegação para uma object page ou outro app.

A área de conteúdo mostra o gráfico, a tabela ou ambos (a visão híbrida). A característica que define uma analytical list page é que gráfico e tabela compartilham um único estado de filtro, de modo que cada seleção refina os dois.

No OData V2, a analytical list page tem seu próprio template e funciona apenas com serviços analíticos; defaultContentView e defaultFilterMode definem a visão e o modo de filtro iniciais. No OData V4, um list report recebe uma configuração views com um primary path para o gráfico, um secondary path para a tabela e um defaultPath. Se um path configurado não existir, o app V4 não carrega. Uma analytical list page, portanto, só é tão boa quanto o modelo analítico por trás dela.

Um filtro visual é um campo de filtro desenhado como gráfico, construído sobre a ajuda de valores (value help) do campo:

1. A anotação ValueList do campo referencia uma presentation variant.
2. O filtro visual usa apenas a primeira medida e a primeira dimensão do seu primeiro gráfico.
3. O tipo de gráfico decide o que é exibido: um gráfico de barras mostra os três valores superiores ou inferiores; um gráfico de linhas mostra os seis primeiros ou últimos pontos de dados e exige uma dimensão de data ou hora; o OData V2 também oferece um gráfico de rosca.
4. A seleção do usuário se torna um valor de filtro, que também aparece na barra de filtros compacta.

A ajuda de valores por trás do filtro visual precisa retornar os mesmos registros que a do campo de filtro comum; caso contrário, as seleções deixam de se sincronizar. A SAP documenta os filtros visuais no OData V4 como suportados com restrições; por exemplo, apenas gráficos de barras e de linhas são renderizados, e apenas a primeira medida e a primeira dimensão da anotação do gráfico são usadas. Os filtros visuais tornam rápida a exploração em uma analytical list page, ao custo de modelagem extra para cada campo de filtro.

Sim, dependendo da versão do OData e do dono do app:

• OData V2, app próprio: a analytical list page tem suas próprias extensões de app: ações customizadas na tabela e no gráfico, filtros customizados para a barra de filtros compacta e para as KPI tags, e uma API de atualização (refresh).
• OData V4, app próprio: a analytical list page é uma variante do list report; portanto, parta das opções de extensão do list report e verifique no SAPUI5 SDK quais delas a variante ALP suporta.
• Um app entregue pela SAP: adaptation projects ou adaptação de key user, sem modificar o código da SAP; no SAP S/4HANA Cloud Public Edition, use apenas as opções de extensibilidade que a SAP documenta para essa edição.

Dois comportamentos nativos são importantes. No flexible column layout, a analytical list page suporta apenas o layout de duas colunas com a primeira coluna expandida. Quando o My Home está habilitado, os usuários podem transformar o gráfico em um card de Insights, a menos que os desenvolvedores ocultem essa opção. As extensões de uma analytical list page devem ficar nas bordas, porque a interação entre gráfico e tabela é a parte que os usuários valorizam.

1. Construir sobre um serviço sem agregação. Gráficos precisam de um entity set que suporte agregação; um serviço puramente transacional não consegue alimentá-los.
2. Paths de anotação digitados errado. No OData V4, um primary ou secondary path incorreto impede o app de carregar.
3. Ajudas de valores divergentes. Quando o filtro visual e o filtro comum leem registros diferentes, as seleções se desencontram.
4. Filtros visuais de gráfico de linhas em dimensões que não são de data. Eles não são renderizados; use um gráfico de barras.
5. KPI tags que contradizem KPI tiles. Consultas diferentes por trás do mesmo nome de KPI produzem números diferentes.

Quando o gráfico principal está vazio, verifique nesta ordem: o suporte a agregação no entity set, o path do gráfico no manifest.json, um UI.Chart padrão sem qualificador e, por fim, os filtros e as autorizações do usuário. A maioria dos defeitos de uma analytical list page são defeitos de modelo de dados e de anotação que aparecem no gráfico.