Tutorial do SDK do Conector cenário 2: Buscar arquivo
Introdução
Este cenário demonstra outro uso da atividade Buscar Arquivo do Dropbox criada em Cenário 1: Buscar arquivo.
Neste cenário, um arquivo é buscado do Dropbox e o conteúdo desse arquivo é acessado e descriptografado. Esses conteúdos são então gravados em um servidor FTP.
Nota
Ao contrário do Cenário 1, o arquivo de texto resultante contém apenas o conteúdo do arquivo recebido do Dropbox, sem os metadados.
Aqui está a operação concluída:
Importante
Para concluir esta operação e cenário, finalize a configuração pré-requisito necessária no tutorial do conector do Dropbox.
Você deve ter o seguinte:
- Acesso a uma conta do Dropbox e servidor FTP.
- Conectores do Dropbox e FTP configurados.
- Acesso ao
diretório assets/sample-data
do repositório do conector do Dropbox.
1. Copiar arquivo de amostra para o Dropbox
Se ainda não estiver presente, copie o arquivo de amostra (customers.csv
) do diretório assets/sample-data
do conector do Dropbox para sua conta do Dropbox.
2. Adicionar uma atividade de Buscar Arquivo do Dropbox a uma operação
Adicione uma atividade Buscar Arquivo do Dropbox a uma nova operação.
Como no Cenário 1, você precisará de uma atividade Buscar Arquivo do Dropbox. Você pode reutilizar a atividade Buscar Arquivo do Dropbox do primeiro cenário ou criar uma nova.
Para reutilizar a atividade do primeiro cenário, clique na aba Componentes do painel do projeto. A partir daí, você pode arrastar a atividade existente do Dropbox para uma nova operação.
3. Adicione uma transformação à operação
Adicione uma transformação após a atividade Buscar Arquivo do Dropbox.
Edite a transformação, mas ao contrário do Cenário 1, crie um novo esquema plano (Definir Esquema > Criar Plano) com dois campos de string: um campo name
e um campo content
:
Uma vez criado, você pode usar o link Mapear Correspondências Exatas para mapear os campos de origem para os campos de destino.
4. Edite os mapeamentos dos campos de destino
Adicione um script a cada campo de destino para gravar o nome e o conteúdo em variáveis globais, e então relatar os valores das variáveis globais no log da operação.
Para adicionar um script a um campo de destino, passe o mouse sobre o campo de destino, clique no ícone de adicionar e selecione Adicionar Script.
Para o campo name
, insira este script:
<trans>
$dropboxName = fetchFileResponse$name$;
WriteToOperationLog("Fetched from Dropbox: " + $dropboxName);
$dropboxName;
</trans>
Para o campo content
, insira este script:
<trans>
$dropboxContent = String(Base64Decode(fetchFileResponse$content$));
WriteToOperationLog("Decoded Dropbox file content: "
+ Length($dropboxContent) + " characters");
$dropboxContent;
</trans>
Quando os scripts forem exibidos, eles devem ser semelhantes a isto:
O script do campo name
pega o nome da resposta do Buscar Arquivo do Dropbox, atribui a uma variável global, escreve uma mensagem no log da operação e, em seguida, define o nome como o valor do campo.
O script do campo content
pega o conteúdo da resposta do Buscar Arquivo do Dropbox, decodifica de Base64, atribui a uma variável global, escreve uma mensagem no log da operação e, em seguida, define o conteúdo como o valor do campo.
Essas variáveis agora estão disponíveis para serem usadas para gravar no servidor FTP. Quando terminar, retorne ao fluxo de trabalho.
5. Adicione um script à operação
Adicione um script como um passo da operação após a transformação. Ele faz referência à atividade Gravar do FTP do Cenário 1: Buscar arquivo, conforme mostrado abaixo.
Insira como o conteúdo do script (na linguagem Jitterbit Script):
<trans>
WriteToOperationLog("Received Dropbox file: " + $dropboxName + " "
+ Length($dropboxContent) + " characters");
WriteFile("<TAG>activity:ftp/FTP/ftp_write/Write</TAG>",
$dropboxContent, $dropboxName);
FlushFile("<TAG>activity:ftp/FTP/ftp_write/Write</TAG>");
WriteToOperationLog("Wrote Dropbox file: " + $dropboxName);
</trans>
Importante
O nome FTP
usado no fragmento de código acima deve corresponder ao nome da conexão FTP e Write
deve corresponder ao nome da atividade Write FTP usada em Cenário 1: Buscar arquivo para que possa ser reutilizada.
Feche o script para retornar ao fluxo de trabalho.
6. Execute a operação
Implante e execute a operação. Se for bem-sucedido, você verá um arquivo criado no servidor FTP com o mesmo nome e conteúdo do arquivo buscado do Dropbox. Mensagens apropriadas serão registradas no log da operação: