Visão Geral
O Enriquecimento busca dados adicionais para cada datapoint retornado pela fase principal de Extração. Para cada registro extraído, a RWS Integration faz uma ou mais requisições de API secundárias e anexa as respostas ao datapoint, para que o restante da integração possa combinar campos tanto da extração original quanto dos enriquecimentos. O fluxo se torna Extração → Enriquecimento → Transformação → Envio.Quando usar
Use enriquecimento quando a extração principal retorna registros que estão sem detalhes disponíveis em um endpoint separado — por exemplo, buscar comentários de um post, itens de um pedido ou detalhes de endereço de um cliente identificados por um ID presente na lista principal.Configuração
Cada enriquecimento é definido por:| Campo | Descrição |
|---|---|
| Nome | Chave sob a qual a resposta é armazenada (ex.: comments) |
| Conexão | Conexão usada para a requisição |
| Método | Método HTTP (GET, POST, etc.) |
| Caminho | Caminho do endpoint, que pode incluir parâmetros como {{ parameterId }} |
| Parâmetros de query do enriquecimento | Fornecem os valores para os parâmetros referenciados no path |
{{ name }}. O valor pode ser definido de duas formas:
| Tipo | Descrição |
|---|---|
| Fixo | Um valor fixo a ser usado como parâmetro de query |
| Regra de Negócio | Um valor calculado com uma regra de negócio em JavaScript |
Fixo pode conter placeholders {{ ... }} que são interpolados a partir do datapoint da extração principal ou de outro enriquecimento — ex.: {{ id }}. Veja Parâmetros Dinâmicos para mais informações.
Referenciando outros enriquecimentos
Por padrão, todo enriquecimento é executado sobre o datapoint da extração principal. Um enriquecimento também pode depender da resposta de outro enriquecimento — útil quando uma requisição retorna um ID necessário para montar a próxima requisição. Ative Possui outro enriquecimento como dependência? e defina o Nome do enriquecimento com o nome do enriquecimento do qual ele depende. Você pode então referenciar os campos da resposta desse enriquecimento usando notação de ponto:comments retorna os comentários de um post, um enriquecimento dependente pode usar seus campos nos valores dos parâmetros de query:
| Fixed value | To |
|---|---|
{{ comments[0].postId }} | postId |
{{ comments[0].email }} | commenterEmail |
Continuar execução em caso de erro
Cada enriquecimento possui uma caixa de seleção Continuar execução mesmo com falha. Quando ativada, uma requisição de enriquecimento que falha (status http 4xx ou 5xx) não interrompe a integração — o datapoint continua pelas fases de Transformação e Envio sem os dados desse enriquecimento. Quando desativada (o padrão), uma requisição de enriquecimento que falha lança um erro e interrompe a integração. Ative isso quando o enriquecimento é opcional e você prefere entregar dados parciais a interromper a integração.Acessando dados de enriquecimento
As respostas de enriquecimento são expostas em outras seções da integração sobresources, identificadas pelo nome do enriquecimento:
comments que retorna um array:
| From | To |
|---|---|
resources.comments[0].email | firstCommentEmail |
resources.comments[0].body | firstCommentText |
Relacionados
Parâmetros Dinâmicos
Interpole valores em paths, headers e corpos de requisições
Integração com múltiplas extrações
Guia passo a passo para construir uma integração com enriquecimento