Leitura adicional OData: trazer dado de outro serviço do SAP
Quando o destino pede um campo que no SAP mora noutro serviço, o mapeamento declara uma segunda leitura pela chave do documento e usa o resultado como campo da origem.
Quando usar
A leitura principal traz o documento e o que o
$expand alcança dentro do mesmo serviço. Às vezes o destino pede um campo que vive noutro serviço, sem navegação a partir do documento — por exemplo, o fornecedor regular do produto (API_INFORECORD_PROCESS_SRV, entidade A_PurchasingInfoRecord) numa integração de produtos (API_PRODUCT_SRV).Como declarar
Na página do mapeamento (origem OData), no bloco Leitura adicional OData:
- Nome: vira o caminho no documento —
_enrichment.<nome>; - Caminho do serviço e Entidade: no mesmo host da conexão de origem (as credenciais são as dela);
- Chave de junção: o campo do documento e a propriedade da entidade que precisam ser iguais (até 3 partes; marque Número quando a propriedade não é texto);
- Campos: os que o destino precisa (vazio = todos);
- Resultado: Um (o primeiro registro) ou Lista;
- Teto de chamadas por execução: de 1 a 50.
No mapeamento, use o caminho como qualquer campo da origem:
_enrichment.fornecedor.Supplier (um) ou _enrichment.fornecedor[*].Supplier (lista).Como roda
Depois de ler o lote, a execução junta as chaves dos documentos, tira as repetidas e faz a segunda leitura em lotes de chave. A mesma chave nunca é pedida duas vezes na mesma execução. O dado original do documento fica como o SAP devolveu; o resultado entra só no dado que o mapeamento lê.
Avisos
No log da execução aparecem: documentos sem a chave, chave sem correspondência no serviço, teto de chamadas atingido e falha da leitura (com o motivo). Em todos os casos o documento segue sem o dado adicional — o mapeamento decide o que falta, e a validação do arquivo acusa se o destino exigia o campo.
Histórico e ativação
A lista de leituras faz parte do mapeamento. Num mapeamento ativo, salvar a lista passa pelas mesmas verificações de quando você ativa: se a lista nova deixar o mapeamento reprovado, nada é gravado e o motivo aparece. Mudou a lista de um mapeamento ativo, nasce uma versão nova no histórico — e restaurar uma versão antiga traz de volta a lista daquela versão, junto com as regras. Versões gravadas antes de 01/10/2026 não guardaram a lista: restaurá-las mantém a lista atual.
Histórico de versões
- 1.1.1
Corrige falso positivo de versionamento: salvar ou reativar um mapping sem mudar de fato a lista de leituras OData adicionais (só a ordem das chaves, efeito do jsonb) não cria mais uma versão nova no histórico.
26/09/2026 · updated
- 1.1.0
As leituras OData adicionais do mapeamento passam a ser tratadas como parte do mapeamento: entram no histórico de versões (restaurar uma versão traz de volta a lista daquela versão) e, num mapeamento ativo, salvar a lista passa pelas mesmas verificações da ativação — se a lista nova deixar o mapeamento reprovado, a gravação é recusada com o motivo. Trocar a lista de um mapeamento ativo cria uma versão nova, como publicar as regras.
25/09/2026 · updated
- 1.0.0
Leitura adicional OData no mapeamento. Quando o destino pede um campo que no SAP mora noutro serviço (ex.: o fornecedor do produto, no registro de info), o mapeamento declara a segunda leitura — serviço, entidade, chave de junção e campos — e a execução traz o dado junto com o documento, em lotes de chave e com teto de chamadas por execução. O mapeamento usa o resultado como qualquer campo da origem. Falha ou chave sem correspondência viram aviso no log da execução; o documento segue sem o dado.
25/09/2026 · new