Skip to main content
Este guia mostra como criar uma integração funcional que extrai dados de funcionários de uma tabela do RWS Connect e os envia em formato CSV para um servidor SFTP. Ao final, você saberá como consultar tabelas do Connect, incluindo manter apenas o registro mais recente por funcionário, e usar o resultado como qualquer outra fonte de API.

O que você vai construir

Você criará uma integração que:
  1. Extrai o snapshot atual de funcionários de uma tabela do RWS Connect
  2. Transforma os dados para um formato mais simples
  3. 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
  • Uma tabela do RWS Connect já provisionada e a x-api-key fornecida pela RWS (para solicitar uma, veja RWS Connect)
  • Um servidor SFTP
Os exemplos usam um tenant acme com uma tabela employees. Substitua pelos nomes do seu database e da sua tabela.

Passo 1: Crie a conexão de origem

A API do RWS Connect usa uma conexão Simple padrão.
  1. Na barra lateral, clique em Conexões
  2. Clique em Nova Conexão
  3. Configure a conexão:
  1. Clique em Salvar

Passo 2: Crie a conexão de destino

Agora crie uma Conexão para seu servidor SFTP.
  1. Clique em Nova Conexão
  2. Configure a conexão:
  1. Clique em Salvar

Passo 3: Crie a Integração

Com ambas as Conexões prontas, crie a Integração que move dados entre elas.
  1. Na barra lateral, clique em Integrações
  2. Clique em Nova Integração

Configurações gerais

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

Fase de Extração

A fase de Extração consulta a API do RWS Connect.
  1. Expanda a seção Extração
  2. Configure estes campos:
  1. Adicione os Query Params:
O parâmetro filter[over_employee_id][extracted_at]=first mantém apenas o registro mais recente por funcionário. As tabelas do Connect preservam um snapshot por execução, e esse filtro transforma o histórico no estado atual. Veja Consultando a API do RWS Connect para detalhes.
  1. Defina o Path para o datapoint na resposta como Items
  2. Defina a Paginação:
  1. Verifique o painel Preview de Extração no lado direito. Ele deve mostrar:
  • Status: 200 OK
  • Um único registro de funcionário (o Datapoint) como este:

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.
  1. Expanda a seção Transformação
  2. Clique em Adicionar Transformação e configure:
  1. Verifique o painel Preview de Transformação. Ele deve exibir:

Fase de Envio

A fase de Envio envia dados transformados para seu destino.
  1. Expanda a seção Envio
  2. Configure estes campos:

Passo 4: Implante a Integração

  1. Ative o toggle Implantação
  2. 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:
  1. Abra sua integração na lista de Integrações
  2. Clique em Executar agora, ao lado do botão Salvar
  3. 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 employees.csv foi criado no diretório /guides. Você deve ver um arquivo com esta estrutura:
Parabéns! Você construiu uma integração sobre uma tabela do RWS Connect!

O que você aprendeu

  • Tabelas do RWS Connect são consultadas através de uma conexão Simple padrão, sem necessidade de conector especial
  • database e table identificam seus dados: o nome do tenant do onboarding e a tabela combinada quando o conector foi solicitado
  • O filtro over_ transforma o histórico de snapshots no estado atual, mantendo o registro mais recente por chave
  • Items e a Paginação Simples (page[size] / page[number]) se encaixam direto na configuração de extração da plataforma

Precisa dos dados ao vivo?

Este guia lê das tabelas do Connect — seus dados até a última atualização. Quando uma integração precisa da resposta do seu sistema agora (monitoramento e auditorias, por exemplo), use o RWS Connect Live: a mesma api key, lendo seu sistema em tempo real.

Próximos passos

Consultando a API do RWS Connect

Filtros, agregações, ordenação e tudo o mais que a API suporta

Parâmetros Dinâmicos

Filtre por datas dinâmicas como “ontem”

Regras de Negócio

Transforme dados com JavaScript

Agendamento

Agende suas integrações para executar automaticamente