Administração e troubleshooting

/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 ▾
Onde se encaixa: L4 · Serviços e APIsCamada: Serviços e APIs.L1L2L3L4L5L6BTP

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:

  1. Inicie a /IWFND/MAINT_SERVICE e escolha Add Service.
  2. 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.
  3. Selecione o serviço e adicione-o. Informe um pacote para transporte, ou um pacote local para um teste.
  4. De volta à tela principal, selecione o serviço e confirme que o nó ICF mostra status verde; se não mostrar, ative-o.
  5. Verifique a atribuição do system alias.
  6. Teste com o SAP Gateway Client ou com a chamada do service document no navegador.
  7. 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?

SintomaCausa provávelCorreção
Serviço não listado em Add ServiceSystem alias errado, ou o serviço não está gerado no back-endVerificar o alias e o registro do serviço no back-end
"No service found for namespace …" em runtimeServiço não registrado ou versão errada no sistema GatewayRegistrar 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 mandanteAtribuir o system alias
HTTP 403 na URL do serviçoNó ICF inativo, ou S_SERVICE ausenteAtivar o nó; ampliar a role PFCG
Metadados antigos após um transporteModelo em cacheExecutar 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.

  • /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_ADMINSICF
GerenciaServiços OData V2Service groups OData V4Nós ICF de todos os serviços HTTP
Unidade de ativaçãoUm serviçoUm service groupUm nó de caminho de URL
Tratamento do ICFUm nó por serviço V2Um nó V4 compartilhadoQualquer nó, de forma genérica
Uso típicoRegistrar, atribuir alias e ativar um serviço V2Publicar serviços V4 e roteá-losAtivar 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

Aplica-se a
SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP ERP (ECC)
Última revisão

SAP, SAP Fiori, SAPUI5, SAP S/4HANA, SAP BTP e os demais produtos e serviços SAP mencionados são marcas comerciais ou marcas registradas da SAP SE (ou de uma empresa afiliada da SAP) na Alemanha e em outros países. Este guia é independente e não é afiliado, patrocinado nem endossado pela SAP SE.