Adaptação de UI (Adapt UI)

A adaptação de UI nunca edita o código do app. A SAPUI5 flexibility registra cada mudança como um pequeno delta semântico, por exemplo "campo Supplier Rating movido para o grupo Delivery", vinculado ao ID estável do controle, e o armazena no repositório em camadas.

Em tempo de execução, o app carrega suas views originais e aplica os deltas armazenados de cada camada, em ordem:

Como as mudanças referenciam IDs estáveis, e não posições na tela, elas sobrevivem a atualizações do app enquanto os controles referenciados ainda existirem. A adaptação de UI é, portanto, uma camada de mudanças registradas sobre um app intocado.

• Personalização (usuários finais). Os usuários ajustam tabelas, filtros e visões para si mesmos e podem compartilhar visões como públicas. Nada muda para os outros usuários, a menos que escolham uma visão compartilhada.
• Adaptação key user (key users). A partir do menu do usuário, o Adapt UI abre um modo WYSIWYG com arrastar e soltar e menus de contexto. Os key users reorganizam, renomeiam, removem ou adicionam campos e grupos para todos, e podem publicar o resultado como um app variant separado. No SAP Fiori elements para OData V4, os key users também podem ajustar variantes de List Report, mover ou renomear botões, reorganizar seções do Object Page e incorporar conteúdo.
• Adaptação por desenvolvedores (desenvolvedores). Um adaptation project no SAP Business Application Studio, criado com as SAP Fiori tools, adiciona fragments em extension points, controller extensions ou mudanças no descriptor. O resultado é um app variant com ID próprio que referencia o original.

Os três níveis compartilham um único mecanismo, mas diferem no alcance: a adaptação de UI por key users altera o app para todos, a personalização o altera para um usuário, e a adaptação por desenvolvedores pode alterar o comportamento.

• Sem código e sem modificação. Os key users alteram layouts sem desenvolvedores, e o app original da SAP permanece intocado.
• Segurança em upgrades por design. As mudanças são deltas sobre IDs estáveis, mantidos na sua própria camada.
• Rede de segurança embutida. A ferramenta avisa antes de mudanças arriscadas, como remover um campo obrigatório, e as mudanças podem ser desfeitas ou redefinidas para o app original.
• Rascunhos e versões. A partir do ABAP Platform 2022, os key users podem salvar rascunhos, manter várias versões, reverter e publicar uma versão escolhida.
• App variants. Um único app entregue pode atender equipes diferentes, por exemplo um app variant de pedido de compra para os compradores de fábrica da Alder Manufacturing, com menos campos.

Para ajustes no nível da tela, a adaptação de UI é a ferramenta mais leve entre as opções de extensibilidade do SAP S/4HANA.

• Apenas apps habilitados. O app precisa de controles suportados e IDs estáveis; apps que constroem a UI dinamicamente não podem ser adaptados.
• Apenas o que já existe. A adaptação de UI pode exibir um campo que o serviço já fornece, mas não pode criar um novo campo, verificação ou cálculo. Campos customizados vêm antes da extensibilidade key user.
• Layout, não lógica. Valores padrão, validações e regras de processo ficam fora do escopo; algumas ações standard, como editar, salvar e excluir, estão excluídas da adaptação de botões no SAP Fiori elements.
• Apenas desktop. A adaptação key user exige um navegador desktop e um tamanho mínimo de tela.
• UIs clássicas são diferentes. As transações do SAP GUI são adaptadas com outras ferramentas; o SAP S/4HANA Cloud Public Edition oferece adaptação de UI para aplicativos clássicos baseada no SAP Screen Personas.
• Sobrepõe a personalização. As configurações do key user podem sobrepor as configurações do usuário final, então os usuários podem precisar reaplicar as suas.

Esses limites mantêm a adaptação de UI segura: ela remodela telas sem mudar o que o sistema faz.

A orientação da SAP é adaptar em um sistema de teste ou de desenvolvimento e levar o resultado para produção, porque mudanças feitas diretamente em produção podem entrar em conflito com as transportadas.

• SAP S/4HANA on-premise e Private Edition: quando o key user publica uma versão, o sistema solicita uma request de transporte, que um administrador libera. Por isso, os key users precisam de autorizações de transporte além da role de key user.
• SAP S/4HANA Cloud Public Edition: a publicação não solicita transporte; as mudanças são reunidas para exportação por meio de uma software collection.
• App variants seguem o mesmo caminho: a publicação os adiciona a uma request de transporte ou software collection.

Critério de decisão: se mais de uma pessoa adapta o mesmo app, defina um responsável por app, porque apenas um key user deve adaptar um app por vez. A adaptação de UI é configuração com seu próprio caminho de transporte e merece a mesma disciplina de release que qualquer mudança.

Verifique estas causas em ordem:

1. Role ausente. O usuário não tem a SAP_UI_FLEX_KEY_USER nem uma cópia dela na PFCG.
2. App não habilitado. O app não suporta adaptação key user, por exemplo porque não tem IDs estáveis.
3. Sistema sem suporte. O app roda em um back-end ou plataforma em que a adaptação de UI não está disponível.
4. Dispositivo ou página errados. O usuário está em um celular ou tablet, ou não está na página atual do launchpad.

A documentação da SAP cita as três primeiras como os motivos pelos quais o Adapt UI não aparece. A ausência da entrada Adapt UI é quase sempre uma questão de role ou de habilitação do app, não um defeito do launchpad.