Tutorial do Conector Cenário 5: Obter Arquivo¶
Obtendo um Arquivo (JSON ou XML) do Dropbox e gravando em um servidor FTP¶
Este cenário demonstra o uso de uma atividade Dropbox Get File. Neste exemplo, um arquivo (JSON ou XML) é obtido do Dropbox e, em seguida, gravado em um servidor FTP. Semelhante a Cenário 4: Processar Arquivo, o arquivo é especificado dinamicamente durante a configuração da atividade no Cloud Studio lendo o conteúdo do diretório de a pasta Dropbox.
Isso é diferente da atividade do Dropbox Process File do cenário anterior, onde o nome do arquivo e o esquema usado para processar o arquivo é especificado separadamente e os esquemas disponíveis são predefinidos no conector.
Para isso, você precisará de arquivos JSON e XML apropriados em sua conta do Dropbox. Arquivos de amostra (JSON e XML) para isso propósito estão incluídos no assets/sample-data directory
de os arquivos de origem do conector do Dropbox.
Aqui está a operação concluída:
1. Copie os arquivos de amostra para o Dropbox¶
Copie os arquivos de amostra do assets/sample-data directory
de o conector do Dropbox para o diretório raiz da sua conta do Dropbox.
2. Crie um novo workflow¶
Comece com um novo workflow no projeto atual. Você pode reutilizar componentes dos cenários anteriores, mas um novo workflow torna mais fácil manter as operações separadas.
3. Adicionar uma atividade de obtenção de arquivo do Dropbox a uma operação¶
Arraste um tipo de atividade Obter arquivo do Dropbox da paleta de componentes para uma nova operação na quadro de design.
Digite na configuração um nome (como “Get File”) e o caminho da pasta (você pode usar o padrão de /
se você colocou os arquivos de dados de amostra no diretório raiz da sua conta do Dropbox):
Clique em Avançar para ir para a próxima etapa.
Com a atividade “Dropbox Get File”, estamos demonstrando a capacidade de um conector para configurar dinamicamente o esquema baseado em uma seleção do usuário. Os esquemas disponíveis são incluídos no conector no momento da compilação, mas um conector poderia atualizar dinamicamente a lista e os conectores disponíveis. Selecione a linha “account.json”, pois isso usará o XSD associado ao arquivo JSON da conta:
Clique em Avançar para revisar o esquema de dados, mostrando que a resposta do Dropbox será um objeto JSON e mostrando seus campos. Neste ponto, você pode voltar para a tela anterior e tentar selecionar os outros tipos de arquivo para ver como o esquema de dados muda para refletir o arquivo escolhido. Quando terminar, anote qual arquivo você selecionou; vamos mostrar o tutorial usando o account.json
arquivo:
Clique em Concluído para fechar a configuração da atividade.
4. Adicione uma atividade de gravação de FTP à operação¶
Usando o endpoint FTP chamado ” FTP” que você configurou para este tutorial (consulte Cenários do tutorial em Tutorial do conector do Dropbox), arraste um FTP Write atividade para a operação logo após a atividade “Dropbox Get File”:
Configure-o com um nome (como Write Get
), um caminho (como /
) e um padrão de nome de arquivo apropriado (como dropbox_get_results_[date]_[time].json
). A atividade “FTP Write” ficará assim:
Clique em Avançar e em Concluído para retornar ao workflow.
5. Adicione uma transformação à operação¶
Adicione uma transformação entre as duas atividades.
Quando ele abrir, dê um nome à transformação (como “Get to FTP Write”), use Mirror Source Schema e, em seguida, Correspondências exatas automáticas para criar o mapeamento de transformação. Quando concluída, a transformação deve se parecer com esse:
Em seguida, retorne ao workflow.
6. Execute a operação¶
Implante e execute a operação. O arquivo selecionado deve ser recuperado do Dropbox e gravado no servidor FTP com um nome baseado no padrão. No log da operação, você deve ver uma mensagem de log informando que a operação foi bem-sucedida concluído.
Variações¶
Agora você pode revisar a operação e experimentar outros arquivos de amostra (JSON ou XML) e ver se eles são processados de maneira semelhante moda.