Target Mapping
Um target mapping no SAP Fiori Launchpad é a regra que resolve um intent de navegação — um semantic object mais uma ação, como PurchaseOrder-display — para um aplicativo concreto: um app SAPUI5, uma transação do SAP GUI for HTML, um aplicativo Web Dynpro ABAP ou uma URL. Sem um target mapping correspondente, um tile não consegue abrir nada.
Resumo
- Tipo
- Objeto de conteúdo do launchpad (regra de navegação)
- Camada
- Conteúdo, navegação e acesso
- Mantido em
- Technical catalogs, criados com o Launchpad App Manager (Launchpad Designer em releases mais antigas); os business catalogs os referenciam pelo Launchpad Content Manager; inbounds do app descriptor no SAP BTP
- Chega aos usuários por
- Business catalogs atribuídos por meio de business roles
- Diagnóstico com
- /UI2/FLIA (análise de intents); /UI2/FLC (verificação de consistência, descontinuada a partir da ABAP platform 2025 em favor da /UI2/FLPCA e da visão de problemas do content manager)
- Quem trabalha com ele
- Administradores do launchpad, desenvolvedores SAP Fiori, equipes de basis/segurança
- Aplica-se a
- SAP S/4HANA (todas as opções de implantação), SAP BTP
Camada: Conteúdo, navegação e acessoOnde se encaixa ▾
O usuário abre o SAP Fiori Launchpad. O launchpad carrega os spaces, pages e tiles concedidos pelos business roles do usuário. Nenhum código de aplicação é executado ainda.
Relacionados:SAP Fiori Launchpad · Business Role · Spaces e Pages
O tile não contém um app. Ele dispara um intent — um semantic object mais uma ação, como PurchaseOrder-display — com parâmetros opcionais.
Relacionados:Tile · Semantic Object · Navegação baseada em intent
O launchpad procura os target mappings nos catálogos dos roles do usuário e os filtra por tipo de dispositivo e por parâmetros. Se nada corresponder, o usuário vê um erro de navegação.
Relacionados:Target Mapping · Catálogos (technical e business) · /UI2/FLIA
O target mapping correspondente inicia o destino: um app SAPUI5 ou SAP Fiori elements, uma transação SAP GUI for HTML, uma aplicação Web Dynpro ABAP ou uma URL.
Relacionados:Target Mapping · SAP Fiori Elements · SAP GUI for HTML (Web GUI)
Como funciona um target mapping?
Toda navegação no SAP Fiori Launchpad é uma solicitação de um intent, não de um app específico. A resolução ocorre em cinco etapas:
- Um tile, um link ou outro app dispara um intent: um semantic object mais uma ação, opcionalmente com parâmetros, como um número de documento.
- O launchpad reúne todos os target mappings disponíveis para o usuário por meio dos catálogos das roles do usuário.
- O launchpad filtra esses target mappings por semantic object, ação, tipo de dispositivo e regras de parâmetros.
- O target mapping correspondente fornece o destino: o tipo de aplicativo, o componente do app ou a transação, e o alias de sistema.
- O launchpad inicia esse destino e repassa os parâmetros.
Se nenhum target mapping passar pela etapa 3, o usuário recebe um erro de navegação em vez de um app. Um target mapping é, portanto, uma regra de roteamento avaliada em runtime, e não um elemento de UI.
O que um target mapping contém?
| Campo | O que ele controla |
|---|---|
| Semantic object | A entidade de negócio do intent, p. ex. PurchaseOrder |
| Ação | A operação, p. ex. display, manage, create |
| Tipo de aplicativo | No launchpad app manager: SAPUI5 Fiori App, Transaction (SAP GUI for HTML), Web Dynpro Application, WebClient UI Application ou URL App |
| Destino | O ID do componente SAPUI5, o código da transação, o aplicativo Web Dynpro ou a URL que realmente é iniciado |
| Alias de sistema | Contra qual sistema de back-end o app roda |
| Tipos de dispositivo | Desktop, tablet e/ou celular |
| Parâmetros | Valores padrão, parâmetros obrigatórios e se parâmetros adicionais são permitidos, ignorados ou não permitidos |
O mesmo intent pode ter destinos diferentes para tipos de dispositivo ou roles diferentes, e é assim que um mesmo tile pode abrir um app completo no desktop e um app simplificado no celular. Cada campo de um target mapping restringe ou redireciona o ponto em que um intent chega.
Como tiles e target mappings se relacionam?
Um tile é o ponto de entrada visual que armazena um intent; um target mapping é a regra que resolve esse intent. Os dois são objetos separados, muitas vezes definidos juntos, mas às vezes em technical catalogs diferentes. O usuário precisa ter acesso a ambos — ao tile pelos catálogos que o disponibilizam e ao target mapping pelos catálogos das suas roles — para que um clique abra um app. Um target mapping pode atender a muitos tiles e links dentro de apps, e um tile pode ser resolvido de forma diferente por dispositivo. Os tiles decidem o que os usuários veem; os target mappings decidem o que realmente abre.
Quando criar ou alterar um target mapping?
Crie ou altere um target mapping quando:
- um app SAPUI5 customizado precisa poder ser iniciado a partir do SAP Fiori Launchpad;
- uma transação do SAP GUI ou um aplicativo Web Dynpro ABAP sem um app SAP Fiori nativo precisa de um tile;
- uma role deve abrir um app diferente para o mesmo intent, por exemplo um app customizado em vez do standard; nesse caso, evite deixar vários target mappings correspondentes nas roles do mesmo usuário e teste com a /UI2/FLIA.
Evite dois atalhos comuns:
- copiar target mappings entregues pela SAP para catálogos customizados quando referenciá-los manteria o fluxo de atualizações da SAP, porque as alterações no original são propagadas para as suas referências;
- usar ações curinga ou regras de parâmetros abertas que tornam a resolução imprevisível.
Uma alteração de target mapping é uma decisão de design de navegação e merece a mesma revisão que uma alteração de role.
Por que a navegação falha quando o tile está visível?
Um tile visível prova que o usuário consegue ver o tile, não que o intent é resolvido. As causas habituais, em ordem de frequência relatada por profissionais:
- O catálogo do tile está atribuído, mas o catálogo do target mapping está ausente das roles do usuário.
- O target mapping não está habilitado para o tipo de dispositivo do usuário, então o app funciona no desktop e falha no celular.
- As regras de parâmetros rejeitam os parâmetros que o tile ou o link envia.
- O alias de sistema aponta para o back-end errado.
- Os caches do launchpad ainda guardam o conteúdo antigo após uma alteração. No front-end server ABAP, execute o report /UI2/INVALIDATE_GLOBAL_CACHES na SE38 ou a transação /UI2/INVAL_CACHES; a SAP reserva o /UI2/INVALIDATE_CLIENT_CACHES para casos excepcionais.
Execute a /UI2/FLIA para o usuário afetado antes de editar qualquer conteúdo, porque a análise de intents mostra quais target mappings o launchpad realmente considerou. Falhas de navegação quase sempre são problemas de atribuição de roles ou de correspondência de regras, e não apps quebrados.
Como os target mappings funcionam no SAP BTP e no SAP Build Work Zone?
- Apps no SAP BTP: um app declara os seus destinos de navegação como inbounds no seu app descriptor (manifest.json, em
sap.app→crossNavigation→inbounds). O SAP Build Work Zone usa esses inbounds como os target mappings do site. - Conteúdo do SAP S/4HANA: o back-end expõe roles selecionadas por meio de content exposure, e o SAP Build Work Zone as consome com o sistema SAP S/4HANA configurado como provedor de conteúdo.
O conceito é idêntico em todas as opções de implantação — entra um intent, sai um aplicativo. Só muda o lugar onde a regra é mantida.
Target mapping vs. tile vs. semantic object: qual é a diferença?
| Tile | Semantic object | Target mapping | |
|---|---|---|---|
| O que é | Entrada visual em uma page | Nome de entidade de negócio usado em um intent | Regra de resolução de um intent |
| Pergunta que responde | Onde o usuário clica? | De qual business object se trata? | Qual app abre, em qual dispositivo e sistema? |
| Onde fica | Technical catalog; colocado em pages | Definições de semantic objects | Technical catalog ou inbound do app descriptor |
| Falha típica | Não está nos catálogos do usuário, então nunca aparece | Grafia errada ou não definido, então nenhum intent corresponde | Não está nos catálogos do usuário ou as regras não correspondem, então a navegação falha |
Perguntas frequentes
Qual é a diferença entre um tile e um target mapping?
Um tile é o que o usuário clica no SAP Fiori Launchpad; um target mapping é a regra que decide qual aplicativo abre para o intent do tile. Ambos precisam estar disponíveis pelas roles do usuário para que a navegação funcione.
O mesmo tile pode abrir apps diferentes no desktop e no celular?
Sim. Os target mappings têm configurações de tipo de dispositivo, então o mesmo intent pode ser resolvido para aplicativos diferentes por dispositivo, desde que exista um target mapping correspondente para cada tipo de dispositivo que os usuários utilizam.
Por que o meu tile SAP Fiori mostra um erro em vez de abrir o app?
Na maioria dos casos, o usuário consegue ver o tile, mas não tem nenhum target mapping que corresponda ao seu intent, porque o catálogo que contém o target mapping não está nas roles do usuário ou as regras de dispositivo ou de parâmetros não correspondem. A /UI2/FLIA mostra o motivo exato.
Onde os target mappings são mantidos no SAP S/4HANA?
On-premise e na Private Edition, os target mappings são criados em technical catalogs com o Launchpad App Manager (/UI2/FLPAM); o Launchpad Designer fazia isso em releases mais antigas e agora está descontinuado. O Launchpad Content Manager (/UI2/FLPCM_CUST) não cria target mappings: ele adiciona referências a eles em business catalogs. Para apps implantados no SAP BTP, eles vêm dos inbounds do descriptor de cada app. Para o SAP S/4HANA Cloud Public Edition, consulte o SAP Help Portal da sua release.
Transações do SAP GUI no launchpad precisam de um target mapping?
Sim. Um tile que abre uma transação clássica pelo SAP GUI for HTML continua precisando de um target mapping do tipo transação que aponte para o código da transação e para o alias de sistema.
Fontes
- SAP Help Portal: Target Mappings (SAP Fiori launchpad, ABAP platform)
- SAP Help Portal: Analyzing intents with Fiori Launchpad Intent Analysis (/UI2/FLIA)
- SAPUI5 SDK: Manifest (descriptor for applications) — crossNavigation inbounds
- SAP Help Portal: Cache invalidation for the SAP Fiori launchpad (ABAP platform)
- SAP Help Portal: Launchpad content checks (/UI2/FLC check list and deprecation note)
- Aplica-se a
- SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP S/4HANA Cloud Public Edition · SAP BTP
- Última revisão