RWS Docs

Este guia mostra como criar uma integração funcional que extrai dados de usuários de uma API pública e os envia em formato CSV para um servidor SFTP. Ao final, você entenderá como as conexões SFTP funcionam na RWS Integration.

O que você vai construir

Você criará uma integração que:

Extrai registros de usuários do JSONPlaceholder (uma API de teste gratuita)
Transforma os dados para um formato mais simples
Envia os resultados para um servidor SFTP em formato CSV

Tempo necessário: aproximadamente 5 minutos.

Pré-requisitos

Acesso a um Workspace da RWS Integration
Um navegador web
Um servidor SFTP

Passo 1: Crie a conexão de origem

Conexões definem como a RWS Integration se comunica com sistemas externos. Você criará uma para a API de origem.

Na barra lateral, clique em Conexões
Clique em Nova Conexão
Configure a conexão:

Campo	Valor
Nome	`JSONPlaceholder API`
Tipo	`API`
URL	`https://jsonplaceholder.typicode.com`
Caminho base (URL base path)	`/`
Autenticação	`Sem autenticação`

Clique em Salvar

A API JSONPlaceholder não requer autenticação, então a opção Sem autenticação, já selecionada por padrão para novas conexões, é tudo o que você precisa.

Passo 2: Crie a conexão de destino

Agora crie uma Conexão para seu servidor SFTP de destino.

Clique em Nova Conexão
Configure a conexão:

Campo	Valor
Nome	`SFTP Connection`
Tipo	`SFTP`
URL	`sftp.example.com`
Caminho base (URL base path)	`/uploads`
Port	`22`
Username	`username`
SSH Private Key	`private_key`

Clique em Salvar

Passo 3: Crie a Integração

Com ambas as Conexões prontas, crie a Integração que move dados entre elas.

Na barra lateral, clique em Integrações
Clique em Nova Integração

Configurações gerais

Configure as propriedades básicas da integração:

Campo	Valor
Nome	`Load File to SFTP`
Versão	`1.0.0`
Tipo	`Full`
Ambiente	`Staging`
Agendamento	Diária, no horário que preferir (ex.: `09:00`)

Fase de Extração

A fase de Extração recupera dados do seu sistema de origem.

Expanda a seção Extração
Configure estes campos:

Campo	Valor
Conexão	`JSONPlaceholder API`
Método	`GET`
Caminho (URL path)	`/users`

Defina o Path para o datapoint na resposta como root
Defina a Paginação:

Campo	Valor
Tipo	`Simples`
Parâmetro do tamanho da página	`_limit`
Valor do tamanho da página	`10`
Parâmetro da página	`_page`
Valor da página inicial	`1`
Tipo de fim de paginação	`Objeto`

Verifique o painel Preview de Extração no lado direito. Ele deve mostrar:

Status: 200 OK
Um único registro de usuário (o Datapoint) como este:

{
  "id": 1,
  "name": "Leanne Graham",
  "username": "Bret",
  "email": "Sincere@april.biz",
}

Integrações SFTP não suportam a fase de Enriquecimento.

Fase de Transformação

A fase de Transformação mapeia campos de origem para o formato de destino. Para este guia, crie um mapeamento simples com três campos.

Expanda a seção Transformação
Clique em Adicionar Transformação e configure:

Tipo	Para	De
Simples	`userId`	`id`
Simples	`fullName`	`name`
Simples	`emailAddress`	`email`

Verifique o painel Preview de Transformação. Ele deve exibir:

{
  "userId": 1,
  "fullName": "Leanne Graham",
  "emailAddress": "Sincere@april.biz"
}

Isso confirma que seus mapeamentos estão funcionando corretamente com dados reais da fase de Extração.

Fase de Envio

A fase de Envio envia dados transformados para seu destino.

Expanda a seção Envio
Configure estes campos:

Campo	Valor
Conexão	`SFTP Connection`
Caminho (URL path)	`/guides`
File name	`users.csv`

A RWS Integration criará o arquivo no diretório /guides. Se o diretório não existir, ele será criado. O único formato suportado é CSV.

Passo 4: Implante a Integração

Ative o toggle Implantação
Clique em Criar Integração

A integração agora será executada automaticamente todos os dias no horário que você escolheu.

Passo 5: Execute agora

Você não precisa esperar o agendamento. Dispare a primeira execução manualmente:

Abra sua integração na lista de Integrações
Clique em Executar agora, ao lado do botão Salvar
Confirme no diálogo: a mensagem Execução iniciada aparece

Passo 6: Verifique os resultados

Vá para seu servidor SFTP e verifique se o arquivo users.csv foi criado no diretório /guides. Você deve ver um arquivo com esta estrutura:

userId,fullName,emailAddress
1,Leanne Graham,Sincere@april.biz
2,Ervin Howell,Shanna@melissa.tv
3,Clementine Bauch,Nathan@yesenia.net

Parabéns! Você criou e executou sua primeira integração SFTP!

O que você aprendeu

Conexões SFTP armazenam configurações para servidores SFTP e podem ser reutilizadas em múltiplas Integrações
Integrações seguem o padrão Extração → Transformação → Envio
Painéis de Preview atualizam automaticamente conforme você configura cada fase, permitindo validar antes de executar
Transformações simples mapeiam campos da origem para o destino usando notação JSONPath
Formato de arquivo CSV é suportado para integrações SFTP

Próximos passos

Conexões

Aprenda sobre os diferentes métodos de autenticação

Paginação

Lide com paginação e respostas de API complexas

Regras de Negócio

Domine transformações de campos com JavaScript

Agendamento

Agende suas integrações para executar automaticamente

Primeiros Passos

Guias

Conceitos Fundamentais

Enviar arquivo para destino SFTP

O que você vai construir

Pré-requisitos

Passo 1: Crie a conexão de origem

Passo 2: Crie a conexão de destino

Passo 3: Crie a Integração

Configurações gerais

Fase de Extração

Fase de Transformação

Fase de Envio

Passo 4: Implante a Integração

Passo 5: Execute agora

Passo 6: Verifique os resultados

O que você aprendeu

Próximos passos

Conexões

Paginação

Regras de Negócio

Agendamento

​O que você vai construir

​Pré-requisitos

​Passo 1: Crie a conexão de origem

​Passo 2: Crie a conexão de destino

​Passo 3: Crie a Integração

​Configurações gerais

​Fase de Extração

​Fase de Transformação

​Fase de Envio

​Passo 4: Implante a Integração

​Passo 5: Execute agora

​Passo 6: Verifique os resultados

​O que você aprendeu

​Próximos passos

Conexões

Paginação

Regras de Negócio

Agendamento

O que você vai construir

Pré-requisitos

Passo 1: Crie a conexão de origem

Passo 2: Crie a conexão de destino

Passo 3: Crie a Integração

Configurações gerais

Fase de Extração

Fase de Transformação

Fase de Envio

Passo 4: Implante a Integração

Passo 5: Execute agora

Passo 6: Verifique os resultados

O que você aprendeu

Próximos passos