Plugin AWS S3 Get (obsoleto) para grupos de agentes Jitterbit na nuvem e privados

Introdução

O plugin AWS S3 Get lê, renomeia ou exclui um arquivo do Amazon AWS S3. Um arquivo que é lido pode ser usado como fonte em uma operação.

Este plugin está disponível por padrão nos grupos de agentes Jitterbit na nuvem e também pode ser associado a grupos de agentes privados.

Esta página detalha os passos para usar o plugin AWS S3 Get:

1. Baixar e adicionar o plugin
2. Associar o plugin a um grupo de agentes
3. Atribuir o plugin a uma fonte
4. Definir variáveis globais para o plugin
5. Completar a configuração da operação

Criptografia

O plugin AWS S3 Get envia seu ID de chave de acesso AWS S3 e chave de acesso secreta fornecidos (descritos abaixo em Definir variáveis globais para o plugin) para a Amazon. A segurança é gerenciada pela Amazon, conforme descrito na documentação da Amazon sobre Credenciais de Segurança da AWS.

Uso

O plugin AWS S3 Get pode ser usado sempre que você precisar recuperar, renomear ou excluir arquivos da AWS.

Funcionalidade adicional

Além disso, essas opções oferecem funcionalidade adicional além do plugin AWS S3 Get:

• AWS S3 Create: AWS S3 create é um plugin fornecido pela Jitterbit usado para fazer upload de um arquivo para o Amazon AWS S3 como um destino dentro de uma operação no Design Studio.

• AWS REST API: A AWS REST API pode ser acessada através de uma fonte HTTP ou destino HTTP no Design Studio. Durante a configuração, pode ser necessário usar o plugin gerador HMAC-SHA256 dependendo do seu método de autenticação. Se precisar de assistência, entre em contato com o suporte.

Baixar e adicionar o plugin

O plugin AWS S3 Get é um plugin padrão do Jitterbit que já está disponível na página Plugins do Console de Gerenciamento e não precisa ser baixado ou adicionado à organização.

Associar o plugin a um grupo de agentes

Ambas as versões do plugin AWS S3 Get são associadas a grupos de agentes em nuvem do Jitterbit por padrão. Recomendamos o uso da versão 1.0.1.0.

Se estiver usando um grupo de agentes privado, antes de usar o plugin, você deve associá-lo ao grupo de agentes privado para torná-lo disponível em todos os agentes do grupo.

Os plugins estão listados na página Plugins do Console de Gerenciamento com os seguintes nomes de exibição:

• Jitterbit AWS S3 Get (versão 1.0.1.0)

• Jitterbit AWS S3 Get (versão 1.0.0.0)

Atribuir o plugin a uma fonte

Em um projeto do Design Studio, você deve atribuir o plugin a uma fonte dentro de uma operação. Uma configuração de operação de exemplo é fornecida no final desta página.

Dentro do projeto:

1. Crie uma operação. Qualquer operação que utilize uma fonte pode ser usada.
2. Crie uma fonte fictícia à qual o plugin será atribuído. Esta fonte é usada como um espaço reservado e não será realmente lida. Recomendamos o uso de uma fonte de variável global. Se outras fontes de tipo arquivo forem usadas, como Armazenamento Temporário, arquivo local ou FTP, durante a configuração da fonte, é recomendado fornecer um valor Get Files de [file].[ext].
3. Atribua o plugin à fonte. Para fazer isso, clique com o botão direito na fonte e selecione Plugin. Na janela pop-up, em Plugins disponíveis, selecione "Jitterbit AWS S3 Get" e clique em Atribuir. Em seguida, clique em OK.

Definir variáveis globais para o plugin

Para que um plugin atribuído a uma fonte funcione, quaisquer variáveis globais necessárias pelo plugin devem ser definidas. Essas variáveis são definidas em um script, que deve ser colocado antes da fonte na operação para que as variáveis possam ser inicializadas.

Para adicionar um script antes da fonte:

1. Clique com o botão direito na fonte na operação e selecione Inserir Antes Disso > Script.

2. Crie um novo Script Jitterbit que define as variáveis usadas pelo plugin para autenticar com seu bucket S3 e ler o arquivo que você especificar. Um modelo de script para as variáveis necessárias é fornecido abaixo, seguido pela documentação sobre todas as variáveis possíveis que podem ser incluídas no script.

   AWS S3 Get Script

   <trans>
   $AWS.S3.BUCKET_NAME="<YOUR_BUCKET_NAME>";
   $AWS.S3.ACCESS_KEY_ID="<YOUR_ACCESS_KEY>";
   $AWS.S3.SECRET_ACCESS_KEY="<YOUR_SECRET_KEY>";
   $AWS.S3.OBJECT_KEY="<myfile.txt>";
   </trans>
   

Complete operation setup

A parte do plugin da configuração da operação está completa após você ter (1) o script definindo as variáveis a serem usadas com o plugin e (2) o plugin atribuído a uma fonte na operação.

Para completar a configuração da sua operação, defina um target para arquivar seus dados S3, ou adicione tanto um target quanto uma transformation se você quiser transformar seus dados antes de chegar ao target.