Leitura adicional OData: trazer dado de outro serviço do SAP

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.