/IWFND/MAINT_SERVICE
/IWFND/MAINT_SERVICE é a transação do SAP Gateway para registrar, ativar e manter serviços OData V2, incluindo seus system aliases e nós ICF, no sistema que atende os apps SAP Fiori. Os serviços OData V4 são publicados separadamente, como service groups na /IWFND/V4_ADMIN, por isso ativar um app muitas vezes envolve as duas transações.
Resumo
- Tipo
- Transação de administração do SAP Gateway
- Nome completo
- Activate and Maintain Services
- Camada
- Serviços e APIs
- Escopo
- Serviços OData V2; service groups V4 usam a /IWFND/V4_ADMIN
- Executa em
- Sistema hub do SAP Gateway (o próprio back-end na implantação embedded)
- Quem usa
- Administradores de basis, equipes de implementação SAP Fiori
- Aplica-se a
- SAP S/4HANA on-premise e Private Edition, SAP ERP (ECC)
Camada: Serviços e APIsOnde se encaixa ▾
Camada: Serviços e APIs
Abrir o mapa de arquitetura →O que faz a /IWFND/MAINT_SERVICE?
A /IWFND/MAINT_SERVICE, com o título "Activate and Maintain Services" e também acessível na SPRO nas configurações do SAP Gateway OData Channel, gerencia todos os serviços OData V2 registrados no sistema SAP Gateway. Em uma única tela, ela:
- registra um serviço do back-end no sistema Gateway com um nome externo;
- atribui um ou mais system aliases que roteiam as requisições para o back-end que implementa o serviço;
- mostra e ativa o nó ICF do serviço;
- remove serviços e seus aliases;
- leva ao SAP Gateway Client, ao navegador e ao log de erros de um serviço selecionado.
A /IWFND/MAINT_SERVICE é o interruptor que transforma um serviço OData V2 implementado em um serviço que um app SAP Fiori consegue de fato chamar.
Como ativar um serviço OData passo a passo?
Para ativar o serviço customizado ZALDER_SUPPLIER_SRV da Alder Manufacturing:
- Inicie a /IWFND/MAINT_SERVICE e escolha Add Service.
- Informe o system alias do back-end (LOCAL em uma implantação embedded) e, opcionalmente, o nome técnico do serviço; depois, busque os serviços.
- Selecione o serviço e adicione-o. Informe um pacote para transporte, ou um pacote local para um teste.
- De volta à tela principal, selecione o serviço e confirme que o nó ICF mostra status verde; se não mostrar, ative-o.
- Verifique a atribuição do system alias.
- Teste com o SAP Gateway Client ou com a chamada do service document no navegador.
- Conceda a autorização de início: adicione o serviço à role PFCG do usuário como serviço TADIR (R3TR IWSG, nome do serviço mais o sufixo de versão), para que o S_SERVICE seja preenchido.
Cada passo continua visível depois, por isso a /IWFND/MAINT_SERVICE é o primeiro lugar a verificar quando um serviço parece estar ausente.
Quando usar a /IWFND/MAINT_SERVICE, e quando não usar?
Use a /IWFND/MAINT_SERVICE para:
- serviços OData V2 customizados de projetos SEGW ou de CDS views publicadas como V2;
- serviços individuais entregues pela SAP que uma ativação em massa deixou de fora;
- corrigir system aliases e nós ICF de serviços existentes.
Use outra ferramenta para:
- Service groups OData V4: /IWFND/V4_ADMIN.
- Muitos apps SAP Fiori de uma vez: task lists executadas com a STC01 ativam os apps e serviços de uma business role: SAP_FIORI_CONTENT_ACTIVATION para roles template da SAP e SAP_FIORI_FCM_CONTENT_ACTIVATION para roles do cliente, conforme nomeadas na documentação do SAP S/4HANA 2025.
- Service bindings RAP: publicar o service binding no ABAP Development Tools ativa o endpoint local do serviço; os detalhes do registro dependem do release e da versão do OData.
Escolher a ferramenta certa pela versão do OData e pelo volume reserva a /IWFND/MAINT_SERVICE para correções pontuais, e não para trabalho em massa.
O que significam os erros comuns da /IWFND/MAINT_SERVICE?
| Sintoma | Causa provável | Correção |
|---|---|---|
| Serviço não listado em Add Service | System alias errado, ou o serviço não está gerado no back-end | Verificar o alias e o registro do serviço no back-end |
| "No service found for namespace …" em runtime | Serviço não registrado ou versão errada no sistema Gateway | Registrar o serviço, verificar o sufixo de versão |
| "No System Alias found for Service …" | Serviço registrado sem alias para este usuário ou mandante | Atribuir o system alias |
| HTTP 403 na URL do serviço | Nó ICF inativo, ou S_SERVICE ausente | Ativar o nó; ampliar a role PFCG |
| Metadados antigos após um transporte | Modelo em cache | Executar a /IWFND/CACHE_CLEANUP e a /IWBEP/CACHE_CLEANUP |
A maioria dos problemas na /IWFND/MAINT_SERVICE são lacunas de registro, de alias ou de autorização, e não defeitos no código do serviço.
Quais transações relacionadas ajudam?
- /IWFND/V4_ADMIN: publica e gerencia service groups OData V4.
- /IWFND/GW_CLIENT: envia e reexecuta requisições contra o serviço.
- /IWFND/ERROR_LOG: mostra erros de runtime após a ativação.
- SICF: mantém nós ICF diretamente, por exemplo o nó V4 compartilhado.
- PFCG: adiciona o serviço a roles, para que os usuários recebam a autorização de início S_SERVICE.
- SEGW: abre o projeto do Service Builder por trás de um serviço V2 customizado.
- /IWFND/CACHE_CLEANUP e /IWBEP/CACHE_CLEANUP: limpam os caches de metadados do hub e do back-end.
A /IWFND/MAINT_SERVICE ativa o serviço; essas transações comprovam que ele de fato funciona.
/IWFND/MAINT_SERVICE vs. /IWFND/V4_ADMIN vs. SICF: qual é a diferença?
| /IWFND/MAINT_SERVICE | /IWFND/V4_ADMIN | SICF | |
|---|---|---|---|
| Gerencia | Serviços OData V2 | Service groups OData V4 | Nós ICF de todos os serviços HTTP |
| Unidade de ativação | Um serviço | Um service group | Um nó de caminho de URL |
| Tratamento do ICF | Um nó por serviço V2 | Um nó V4 compartilhado | Qualquer nó, de forma genérica |
| Uso típico | Registrar, atribuir alias e ativar um serviço V2 | Publicar serviços V4 e roteá-los | Ativar ou verificar um nó pelo caminho |
Perguntas frequentes
A /IWFND/MAINT_SERVICE é necessária em uma implantação embedded?
Sim. Em uma implantação embedded, os componentes de hub e de back-end são executados no mesmo sistema, mas os serviços OData V2 ainda precisam ser registrados e ativados ali. O system alias normalmente é LOCAL, em vez de um back-end remoto.
Por que meu serviço OData V4 não aparece na /IWFND/MAINT_SERVICE?
A /IWFND/MAINT_SERVICE gerencia apenas serviços OData V2. Os serviços OData V4 são publicados como service groups na /IWFND/V4_ADMIN, que os roteia por um único nó ICF compartilhado, em vez de um nó por serviço.
Ativar um serviço OData dá acesso aos usuários?
Não. A ativação torna o serviço chamável, mas cada usuário ainda precisa de autorização de início pelo objeto de autorização S_SERVICE, normalmente concedida ao adicionar o serviço a uma role PFCG. Sem ela, a requisição falha com um erro de autorização.
A /IWFND/MAINT_SERVICE pode ser usada no SAP S/4HANA Cloud Public Edition?
A SAP não documenta uso pelo cliente no Public Edition, em que a SAP opera os serviços por trás dos apps entregues. A transação se aplica a sistemas SAP S/4HANA on-premise, Private Edition e SAP ERP que executam o SAP Gateway.
Fontes
- SAP Help Portal: Activate and Maintain Services (SAP Gateway Foundation)
- SAP Help Portal: Service Group Publishing (OData V4)
- SAP Help Portal: ICF Services for OData V2 and V4
- SAP Help Portal: Activating OData/ICF Services using Task Lists
- SAP Help Portal: Rapid Activation of SAP Fiori (task lists, SAP S/4HANA)
- Aplica-se a
- SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP ERP (ECC)
- Última revisão