Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

Esta documentação é para a versão 4 e posterior do App Builder, o novo nome do Vinyl. Acesse a documentação do Vinyl aqui.

Matrizes REST JSON (drill downs) no Jitterbit App Builder

REST - matrizes JSON

  • O App Builder pode enviar JSON Arrays complexos
  • Utiliza uma nova opção: 'Drill Down'
  • Especificar tabela de detalhamento a partir da chamada de API raiz
  • E trabalhe seu caminho para baixo na estrutura JSON

Matrizes JSON - exemplo GET

O cliente tem vários endereços.

Exemplo de registro da tabela Customer de um Customer com um ID, Name e uma matriz de 2 Addresses:

Imagem 1

No lado REST, se fôssemos GET dessa tabela, isso criaria:

  1. Uma tabela Root onde o ID e o Name são:

    Imagem 2

  2. Uma tabela de endereços com 2 registros:

    Imagem 3

Matrizes JSON - exemplo POST

Registro de cliente local que gostaria de publicar.

  1. Uma tabela simples Customer com 1 registro que contém um ID e um Nome:

    Imagem 4

  2. Uma tabela de endereços com 2 registros que são ambos vinculados ao registro Customer pelo CustomerID:

    Imagem 5

Matrizes JSON - endpoint POST

Configure nosso endpoint POST como de costume.

  • Para este exemplo, fornecemos alguns JSON de amostra, que incluem nosso registro e nossas tabelas de endereços
  • Isso gera as tabelas para o Endpoint REST

Nota

O corpo da solicitação está disponível apenas para o Endpoint POST, não para o Endpoint GET.

Imagem 6

Matrizes JSON - chamada de API

Regra de chamada de API de nível superior.

  • Esta regra está inserindo o CustomerID e o Name
  • Ele está mirando na tabela raiz, que é customers (post)
  • Está selecionando id e name do CustomerTest mesa

Matrizes JSON - chamada de API

Regra de chamada de API de endereço.

  • Esta regra está sendo inserida em customers (post)/addresses
  • Ele está selecionando as informações de endereço e ID do CustomerAddressTest mesa

Matrizes JSON - detalhamento

Selecione o endereço como um 'drill down' na chamada de API de nível superior (configurações de caso extremo)

  • Agora que configuramos essas duas regras de chamada de API, podemos vinculá-las
  • Na regra de chamada de API raiz, há uma opção de configuração avançada chamada Drill Downs

    Imagem 9

  • Isso nos permite especificar sub-regras para executar

  • Neste caso, chamamos Customer_Address_POST, que grava na tabela Address REST Endpoint
  • Também configuramos o Binding

    Imagem 10

Matrizes JSON - resultado

  • Sucesso!
  • Isso também funciona com várias tabelas aninhadas
  • Suporta também matrizes simples

    • Configuração de caso extremo na tabela de Endpoint REST
    • "Array de Primitivos"

Imagem 11