> ## Documentation Index > Fetch the complete documentation index at: https://docs.rwsintegration.com/llms.txt > Use this file to discover all available pages before exploring further. # Extrair dados do RWS Connect > Aprenda como criar uma integração que extrai dados de uma tabela do RWS Connect e os entrega como arquivo CSV Este guia mostra como criar uma integração funcional que extrai dados de funcionários de uma tabela do [RWS Connect](/pt-br/core-concepts/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](/pt-br/core-concepts/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](/pt-br/features/connections/api#simple) padrão. 1. Na barra lateral, clique em **Conexões** 2. Clique em **Nova Conexão** 3. Configure a conexão: | Campo | Valor | | ---------------------------- | --------------------------------------- | | Nome | `RWS Connect` | | Tipo | `API` | | URL | `https://connect.rwsintegration.com` | | Caminho base (URL base path) | `/` | | Autenticação | `Simple` | | Headers | `x-api-key`: a chave fornecida pela RWS | 4. 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: | 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` | 3. 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: | Campo | Valor | | ----------- | ---------------------------------------------- | | Nome | `Employees from RWS Connect` | | 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 consulta a API do RWS Connect. 1. Expanda a seção **Extração** 2. Configure estes campos: | Campo | Valor | | ------------------ | ------------- | | Conexão | `RWS Connect` | | Método | `GET` | | Caminho (URL path) | `/` | 3. Adicione os **Query Params**: | Parâmetro | Valor | | ---------------------------------------- | ----------- | | `database` | `acme` | | `table` | `employees` | | `filter[over_employee_id][extracted_at]` | `first` | 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](/pt-br/features/extract/connect-api#registro-mais-recente-por-chave) para detalhes. 4. Defina o **Path para o datapoint na resposta** como `Items` 5. Defina a **Paginação**: | Campo | Valor | | ------------------------------ | -------------- | | Tipo | `Simples` | | Parâmetro do tamanho da página | `page[size]` | | Valor do tamanho da página | `100` | | Parâmetro da página | `page[number]` | | Valor da página inicial | `1` | | Tipo de fim de paginação | `Objeto` | 6. 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: ```json theme={null} { "employee_id": "1042", "name": "Ana Souza", "department": "Sales", "city": "Manaus", "extracted_at": "2026-07-28 06:00:12.000" } ``` ### 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: | Tipo | Para | De | | ------- | ------------ | ------------- | | Simples | `employeeId` | `employee_id` | | Simples | `fullName` | `name` | | Simples | `department` | `department` | 3. Verifique o painel **Preview de Transformação**. Ele deve exibir: ```json theme={null} { "employeeId": "1042", "fullName": "Ana Souza", "department": "Sales" } ``` ### Fase de Envio A fase de Envio envia dados transformados para seu destino. 1. Expanda a seção **Envio** 2. Configure estes campos: | Campo | Valor | | ------------------ | ----------------- | | Conexão | `SFTP Connection` | | Caminho (URL path) | `/guides` | | File name | `employees.csv` | ## 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: ```csv theme={null} employeeId,fullName,department 1042,Ana Souza,Sales 1043,Bruno Lima,Finance 1044,Carla Mendes,Operations ``` 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](/pt-br/guides/rws-connect-live): a mesma api key, lendo seu sistema em tempo real. ## Próximos passos Filtros, agregações, ordenação e tudo o mais que a API suporta Filtre por datas dinâmicas como "ontem" Transforme dados com JavaScript Agende suas integrações para executar automaticamente