Integrações
Serviço SAP que o catálogo ainda não tem
A origem OData sai do serviço e da versão da conexão. Se o catálogo não tem essa versão, o administrador da empresa registra a mensagem do serviço (Exclusiva) ou pede ao Lefia.
Atualizado em 09/10/2026
Numa leitura OData, o formato de origem sai do serviço e da versão que a URL da conexão aponta (ex.:
Nada vai ao catálogo de todos.
Quando o catálogo já tem o serviço com uma entidade (ex.:
Quando o serviço muda no SAP (campo novo, outra estrutura), a mensagem que a empresa registrou se atualiza pelo mesmo caminho: Acrescentar outra entidade deste serviço ou atualizar a mensagem desta empresa e escolha a entidade que já é mensagem da empresa. A prévia mostra os campos novos, os retirados e os que mudaram de estrutura; Atualizar grava. Descrições e anotações ficam; o campo que o SAP retirou fica marcado como retirado; uma lista (coleção) que sumiria não é apagada: a atualização mantém essa lista como está (os mapeamentos que a usam não quebram) e aplica o resto, e a prévia avisa quais listas foram mantidas e quantos campos ficaram de fora. Se a mudança no SAP é de propósito, revise os mapeamentos e fale com a equipe do Lefia. Só o administrador da empresa atualiza, e só com a conexão da própria empresa. A mensagem é uma só para todos os ambientes da empresa (DEV, QAS e PRD — o catálogo não tem ambiente): atualizar pela conexão de um ambiente vale para os três, e como nada é apagado, o que já é usado em PRD continua lá. Entidade com parâmetros (CDS) é descrita pelo resultado, como no registro.
Salve a integração como rascunho e abra um incidente em Meus incidentes com a URL do serviço (sem credencial). Quando a mensagem estiver no catálogo, continue o rascunho.
A mesma entidade (ex.:
API_OUTBOUND_DELIVERY_SRV;v=0002). Quando o catálogo ainda não tem aquela versão do serviço, a tela avisa em vez de deixar escolher outra versão pelo nome — a outra versão tem campos diferentes e o mapeamento sairia errado.Registrar a mensagem do serviço (administrador da empresa)
- No aviso, clique em Registrar a mensagem do serviço para esta empresa (assistente, edição da integração ou Derivar mapping).
- O Lefia lê o
$metadatado serviço com a credencial da conexão e mostra a prévia: a entidade raiz (troque se houver mais de uma), quantos campos e o código da mensagem. - Clique em Registrar. A mensagem fica Exclusiva: só a sua empresa vê e usa. A origem passa a sair do serviço na hora, e abaixo do campo aparece Exclusiva.
Nada vai ao catálogo de todos.
Outra entidade de um serviço que já está no catálogo
Quando o catálogo já tem o serviço com uma entidade (ex.:
API_PRODUCT_SRV com A_Product) e você precisa de outra (ex.: A_ProductPlant, produto por planta), clique em Acrescentar outra entidade deste serviço, abaixo do campo de origem. A prévia lista só as entidades que ainda não são mensagem; o resto é igual ao registro acima. Para que ela vire Padrão Lefia (para todas as empresas), peça à equipe do Lefia em Meus incidentes.Atualizar a mensagem da empresa pelo $metadata
Quando o serviço muda no SAP (campo novo, outra estrutura), a mensagem que a empresa registrou se atualiza pelo mesmo caminho: Acrescentar outra entidade deste serviço ou atualizar a mensagem desta empresa e escolha a entidade que já é mensagem da empresa. A prévia mostra os campos novos, os retirados e os que mudaram de estrutura; Atualizar grava. Descrições e anotações ficam; o campo que o SAP retirou fica marcado como retirado; uma lista (coleção) que sumiria não é apagada: a atualização mantém essa lista como está (os mapeamentos que a usam não quebram) e aplica o resto, e a prévia avisa quais listas foram mantidas e quantos campos ficaram de fora. Se a mudança no SAP é de propósito, revise os mapeamentos e fale com a equipe do Lefia. Só o administrador da empresa atualiza, e só com a conexão da própria empresa. A mensagem é uma só para todos os ambientes da empresa (DEV, QAS e PRD — o catálogo não tem ambiente): atualizar pela conexão de um ambiente vale para os três, e como nada é apagado, o que já é usado em PRD continua lá. Entidade com parâmetros (CDS) é descrita pelo resultado, como no registro.
Ou peça ao Lefia
Salve a integração como rascunho e abra um incidente em Meus incidentes com a URL do serviço (sem credencial). Quando a mensagem estiver no catálogo, continue o rascunho.
Por que não dá para escolher outra versão
A mesma entidade (ex.:
A_OutbDeliveryHeader) existe em versões diferentes do serviço, com campos diferentes. Escolher pelo nome já gerou mapeamento sobre a versão errada — por isso a origem é derivada da conexão.