Flexible Programming Model

O modelo de programação flexível não é um framework separado, mas um conjunto de opções que o SAP Fiori elements para OData V4 oferece para ir além dos floorplans enquanto o framework continua no controle:

1. Pontos de extensão em list reports e object pages aceitam seções, colunas e ações customizadas escritas em SAPUI5.
2. Building blocks posicionam elementos orientados por metadados, como uma tabela, uma barra de filtros ou um campo, onde for necessário.
3. Controller extensions e a ExtensionAPI permitem que o código customizado reaja a eventos do framework, como salvar ou navegar.
4. Custom pages adicionam ao roteamento do app uma página com sua própria XML view. A página é executada no runtime do SAP Fiori elements (componente sap.fe.core.fpm), com o binding context do OData, navegação para páginas padrão e suporte a building blocks.

O modelo de programação flexível é, portanto, uma escala gradual entre UI gerada e UI escrita à mão, decidida página por página e seção por seção.

Building blocks são elementos de UI reutilizáveis e orientados por anotações do SAP Fiori elements para OData V4, os mesmos elementos que o framework usa para montar seus floorplans.

• Não são controles, mas templates. Um building block é um conjunto de instruções de templating. Em runtime, ele produz controles adequados aos dados vinculados: um texto para uma propriedade string, um seletor de data para uma data.
• Configurados em três lugares. As anotações do serviço definem o comportamento padrão, atributos XML inline o refinam e o manifest sobrescreve ambos quando há conflito.
• Referenciados por metadata path. Um building block aponta para um entity set, uma propriedade ou uma anotação, em vez de vincular colunas manualmente.
• Exemplos: Table, FilterBar, Chart, Field, Share e Page.

Como leem as mesmas anotações que os floorplans, os building blocks herdam o gerenciamento de variantes, a personalização e o reconhecimento de draft. Os building blocks são o motivo pelo qual uma custom page ainda pode ter a aparência e o comportamento de uma página padrão do SAP Fiori elements.

A orientação da SAP é usar SAP Fiori elements tanto quanto possível e SAPUI5 freestyle tanto quanto necessário:

Os quatro podem conviver em um único app: um cockpit de fornecedores na Alder Manufacturing poderia combinar um gráfico customizado com um building block Table padrão e depois abrir uma object page padrão.

Teste de decisão: se uma página que você planeja construir em freestyle contém uma barra de filtros e uma tabela padrão, experimente primeiro uma custom page com building blocks. O modelo de programação flexível é a escolha certa quando o layout é customizado, mas as partes são padrão.

• Sem escolha rígida. As equipes não precisam abandonar o SAP Fiori elements no momento em que um requisito fica fora de um floorplan.
• Comportamento padrão sem esforço extra. Os building blocks trazem do framework a filtragem, as variantes, as mensagens, o tratamento de draft e a acessibilidade.
• As anotações continuam sendo a fonte da verdade. Um rótulo alterado nas anotações do serviço atualiza tanto as páginas de floorplan quanto as custom pages.
• Superfície de extensão suportada. Controller extensions e a ExtensionAPI dão ao código customizado hooks documentados, mais fáceis de manter estáveis entre upgrades do SAPUI5.

Para apps OData V4, o modelo de programação flexível é o caminho mais direto para adicionar UI customizada sem abrir mão do que o SAP Fiori elements já oferece.

• Apenas OData V4. Building blocks e custom pages pertencem ao SAP Fiori elements para OData V4. Um app OData V2 mantém os pontos de extensão do V2; adotar o modelo significa migrar app e serviço para o V4.
• Depende da versão. Os building blocks chegam release a release, então um app só pode usar o que a versão do SAPUI5 do sistema de destino oferece; a API reference indica a release em que cada building block ficou disponível.
• Nem todo recurso do floorplan é transferido. A SAP documenta, por exemplo, que criar um card para a seção Insights do My Home não está disponível quando o building block de tabela está em uma custom page ou em uma seção customizada.
• O uso em freestyle tem pré-requisitos. Building blocks podem aparecer em apps SAPUI5 freestyle, mas a configuração que cada building block exige deve ser verificada na documentação do SAPUI5 da release em uso.
• O SAP S/4HANA Cloud Public Edition segue suas próprias regras de extensibilidade para apps construídos pelo cliente; consulte a documentação dessa edição antes de planejar um.

O modelo de programação flexível amplia o que o SAP Fiori elements pode fazer; ele não elimina a dependência do OData V4 e de anotações bem projetadas.

1. Reconstruir elementos padrão à mão. Uma tabela customizada com sua própria lógica de filtro duplica os building blocks Table e FilterBar. Configure o building block em vez disso.
2. Configurar em três lugares. Quando anotações, atributos XML e configurações do manifest descrevem a mesma tabela, o manifest prevalece e os outros parecem quebrados. Escolha um lugar por configuração.
3. Carregar fragments da forma errada. A SAP exige que fragments carregados dinamicamente que contêm building blocks sejam carregados pelo método loadFragment da ExtensionAPI.
4. Corrigir a UI em vez do serviço. Um rótulo ausente geralmente é um problema de anotação; corrigi-lo em código customizado o esconde de todas as outras páginas.
5. Ignorar a versão do SAPUI5 em produção. Building blocks testados na release mais recente podem não existir no front-end server.

A maioria dos problemas com o modelo de programação flexível são erros de configuração ou de separação em camadas, e não limites do próprio modelo.