Tutorial do SDK do Conector cenário 1: Buscar arquivo

Introdução

Este cenário demonstra o uso de uma atividade Buscar Arquivo do Dropbox, onde um arquivo é buscado no Dropbox e, em seguida, gravado em um servidor FTP.

Neste cenário, o arquivo resultante será um arquivo JSON que inclui tanto o conteúdo do arquivo original quanto os metadados sobre o arquivo recebidos do Dropbox.

Nota

Para um exemplo onde o conteúdo do arquivo é retornado sem os metadados do Dropbox, veja Cenário 2: Buscar arquivo.

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

Importante

Para concluir esta operação e cenário, complete 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 a um 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 exemplo para o Dropbox

Copie o arquivo de exemplo (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

Arraste uma atividade Buscar Arquivo do Dropbox da paleta de componentes de design para a zona de drop de componentes na tela de design para criar uma instância de uma atividade Buscar Arquivo do Dropbox em uma nova operação. Clique duas vezes na atividade para abri-la.

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

Clicar no botão Próximo levará você a uma tela onde poderá revisar o esquema de dados:

Isso mostra o que é retornado do Dropbox como resposta. Estará em formato XML e mostra que os metadados sobre o arquivo são retornados além do campo content, que contém o conteúdo real.

Clique em Concluído para retornar ao fluxo de trabalho.

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

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

Digite um nome, forneça um esquema JSON e um nome de arquivo (como dropbox_result_[data]_[hora].json). Este nome de arquivo criará um novo nome de arquivo com timestamp toda vez que a operação for executada.

Para o esquema, você pode copiar e colar o seguinte JSON e definir o nome do arquivo do esquema como customers.json:

{
  "name": "customers.csv",
  "clientModified": "2018-03-16T14:40:39-07:00",
  "serverModified": "2018-04-10T14:10:52-07:00",
  "rev": "49a708770",
  "size": 2231,
  "sharingInfo": {
    "readOnly": null,
    "parentSharedFolderId": null,
    "modifiedBy": null
  },
  "content": "Y29tcGFueSxhZGRy...I2NzcsKDc4MikgMzQzLTAyNjA=",
  "link": null
}

A atividade de FTP Gravar ficará assim:

Clique em Próximo e depois em Concluído para fechar a configuração da atividade de FTP Gravar.

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

Passe o mouse sobre a área entre as duas atividades na operação e clique na zona de drop de componentes para abrir um menu onde você pode selecionar Nova Transformação.

Configure a transformação com um nome. Se você criou o esquema na atividade de FTP Gravar conforme descrito acima, pode usar o link Mapear Correspondências Exatas Automaticamente para mapear automaticamente todos os campos da fonte Buscar Arquivo do Dropbox para o destino Gravar do FTP.

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

5. Execute a operação

Supondo que você tenha colocado um arquivo customers.csv em uma pasta acessível na sua conta do Dropbox, agora você pode implantar e executar a operação.

No log da operação, você deve ver a operação sendo recebida e, em seguida, concluída com sucesso:

6. Confirme o sucesso

Para confirmar o sucesso, abra seu servidor FTP e verifique se o arquivo foi adicionado.

Nota

Se você estiver usando o servidor FTP de treinamento da Jitterbit, um visualizador web para ele está localizado em https://training2.jitterbit.com/WebInterface/login.html.

O novo arquivo deve estar no diretório raiz com um nome semelhante a dropbox_result_[data]_[hora].json. Se você baixar e visualizar o arquivo, ele parecerá semelhante a isto:

{
  "name": "customers.csv",
  "clientModified": "2018-03-16T14:40:39-07:00",
  "serverModified": "2018-04-10T14:10:52-07:00",
  "rev": "49a708770",
  "size": 2231,
  "sharingInfo": {
    "readOnly": null,
    "parentSharedFolderId": null,
    "modifiedBy": null
  },
  "content": "Y29tcGFueSxhZGRy...I2NzcsKDc4MikgMzQzLTAyNjA=",
  "link": null
}

O arquivo é um arquivo JSON, com os metadados do Dropbox sendo os primeiros campos. O campo content aparece como uma string codificada em Base64.