Tutorial do SDK do Conector cenário 4: Processar arquivo

Introdução

Este cenário demonstra o uso de uma atividade Processar Arquivo do Dropbox.

Neste cenário, um arquivo XML é buscado no Dropbox e, em seguida, gravado em um servidor FTP como um arquivo JSON.

Aqui está a operação concluída:

1. Copiar arquivos de exemplo para o Dropbox

Copie os três arquivos de exemplo (account.xml, company.xml e customer.xml) do diretório assets/sample-data do conector do Dropbox para sua conta do Dropbox.

2. Adicionar uma atividade Processar Arquivo do Dropbox a uma operação

Arraste um tipo de atividade Processar Arquivo do Dropbox da paleta de componentes para uma nova operação na tela de design.

Digite um nome, um caminho de pasta (como /) e o nome do arquivo a ser baixado (como account.json):

Clique em Próximo para ir para a próxima etapa.

Com a atividade Processar Arquivo do Dropbox, estamos demonstrando a capacidade de um conector de configurar dinamicamente o esquema com base na seleção do usuário.

Os esquemas disponíveis estão incluídos no conector no momento da construção, mas um conector pode atualizar dinamicamente a lista e os conectores disponíveis.

Selecione a linha de conta, pois isso usará o XSD associado ao arquivo XML da conta:

Clique em Próximo para revisar o esquema de dados, mostrando que a resposta do Dropbox será um objeto de conta e seus campos.

Neste ponto, você pode voltar à tela anterior e tentar selecionar os outros tipos de objeto para ver como o esquema de dados muda para refletir o objeto escolhido.

Quando terminar, certifique-se de que selecionou o objeto de conta, pois isso será necessário para o restante do tutorial:

Clique em Concluído para fechar a configuração da atividade.

3. Adicione uma atividade de gravação FTP à operação

Arraste uma atividade de Gravação FTP do painel de componentes de design para a zona de drop do componente na tela de design para criar uma instância de uma atividade de Gravação FTP em uma nova operação. Clique duas vezes na atividade para abri-la.

Configure-a com um nome, um caminho (como /) e um nome de arquivo apropriado (como account.json ou, para um nome de arquivo com data, dropbox_process_results_[data]_[hora].json).

Você precisará especificar um esquema para a atividade. A maneira mais simples é fornecer o arquivo de saída desejado como um esquema de exemplo. Selecione Sim, fornecer novo esquema:

Você pode fornecer o esquema de várias maneiras: carregando uma URL, enviando um arquivo ou digitando ou colando diretamente no editor:

• Você pode fornecer uma URL; o arquivo account.json está disponível em https://raw.githubusercontent.com/jitterbit/dropbox-connector/master/assets/sample-data/account.json.

  

• Você também pode enviar um arquivo diretamente; o arquivo account.json está incluído no diretório assets/sample-data:

  

• Você também pode digitar ou colar diretamente no editor de esquema.

Quando concluída, a configuração da atividade deve ser semelhante a esta:

Clique em Próximo e depois em Concluído para retornar ao fluxo de trabalho.

4. Adicionar uma transformação à operação

Adicione uma transformação entre as duas atividades.

Quando abrir, dê um nome à transformação e use Automapear Correspondências Exatas para completar o mapeamento da transformação.

Se um esquema apropriado foi fornecido, todos os campos serão mapeados automaticamente e o esquema de destino (à direita) indicará que o esquema é JSON pela rotulagem do nó raiz.

Clique no ícone Fechar para salvar a configuração da transformação e retornar ao fluxo de trabalho:

5. Executar a operação

Implante e execute a operação. O arquivo de exemplo deve ser recuperado do Dropbox, processado em um formato JSON e, em seguida, colocado no servidor FTP.

No log da operação, você deve ver uma mensagem de log informando que a operação foi concluída com sucesso. No servidor FTP, você deve encontrar uma cópia do arquivo com o esquema correto: