# Como utilizar o Proxy para Data Engine

A funcionalidade "**Proxy para Data Engine**" simplifica a integração dos dados externos com o Data Stack. Ela pode ser utilizada como geração de arquivos estruturados (como JSON) para uso posterior no **Skyone Studio**.

{% hint style="info" %}
Essa funcionalidade está em módulos do tipo REST.
{% endhint %}

### Como acessar

Na área de edição do fluxo, selecione "**Editar**" no módulo REST. Por padrão, a opção "**Proxy para Data Engine**" está desativada. Clique no botão para ativá-la.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FL86NZi5xJcnGYLZcUcvU%2Fproxy-data-engine.gif?alt=media&#x26;token=a59e42e7-f9df-456d-beb7-ad331fb3d1a1" alt=""><figcaption></figcaption></figure>

Após ativar o "**Proxy para Data Engine**", o botão "**Configurar**" ficará habilitado.

### Configuração do Data Proxy

Para configurar o "**Proxy para Data Engine**", siga os seguintes passos:

1. Clique no botão "**Configurar**", localizado no lado direito do "**Proxy para Data Engine**".
2. Será mostrada a tela de configurações globais:

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FZBLNWEAsZIaUkSowycNp%2FF27BAC62-2DC1-4693-842D-4861EA3FDBAB.png?alt=media&#x26;token=97944f1f-05ff-44c0-b41a-df8dfd6fa23b" alt=""><figcaption></figcaption></figure>

&#x20;Sendo que:

* **Formato de arquivo:** Escolha entre Parquet, CSV, JSON ou Excel.
* **Nome do arquivo:** Adicione um nome.
* **Grupos de leitura:** Escolha os grupos que poderão ler o arquivo. Por padrão, é o grupo '*default*'. Saiba mais em [Grupos](https://docs.skyone.cloud/visao-geral/configuracoes-e-preferencias/usuarios-e-permissoes#permissoes).
* **Grupos de escrita:** Escolha os grupos que poderão escrever o arquivo. Por padrão, é o grupo 'default'. Saiba mais em [Grupos](https://docs.skyone.cloud/visao-geral/configuracoes-e-preferencias/usuarios-e-permissoes#permissoes).
* **Tags (opcional)**: Categorize o arquivo.
* **Utilizar variáveis de retorno (opcional)**: Este é um recurso que permite extrair e utilizar valores específicos da resposta do proxy. Você pode configurar variáveis para retornar valores específicos. Ao escolher essa opção, mostra os campos "**Chave**" e "**Retorno**" para que você possa preenchê-los. A única função interna é o $count()

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FIXWsH8GCxqnGhSFyDwhO%2F557DDBB8-D27A-463D-A71F-B108321D94C4.png?alt=media&#x26;token=f8e561e0-b389-4cdb-850d-94deb76d78d8" alt=""><figcaption></figcaption></figure>

* **Destinos**: Local onde o arquivo será enviado. É possível buscar um destino na barra de busca ou adicionar um novo em "**Adicionar destino"**.&#x20;
* Ao clicar em "**Adicionar destino**", preencha os campos de "**Configurações de destino**":
  * **Tipo**
  * **Destino**
  * **Caminho**: pasta destino no **Data Stack**.

\
3\. Após preencher os campos, clique em "**Concluir**".

### Teste e validação

Após preencher os campos do módulo REST, clique em "**Próximo**".  Você será direcionado para a tela de Entradas, Saídas e Teste.&#x20;

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FR1cpaf5AoYtCOC1U2AYm%2FFC8A3E6A-2AB2-49AA-BD8E-10A64000A3E7.png?alt=media&#x26;token=06d728f5-2580-42b6-844f-f2d194dfa413" alt=""><figcaption></figcaption></figure>

### Exemplo Prático: análise de vendas

Imagine que você gerencia uma equipe de vendas e precisa de um relatório detalhado ao final de cada dia para avaliar o desempenho e calcular as comissões dos seus vendedores. Em vez de coletar manualmente essas informações de diferentes fontes, você pode automatizar esse processo com o "**Proxy para Data Engine**".

Para conseguir analisar as suas vendas, você vai precisar:

* **API de Vendas:** Configure o proxy para se conectar a uma API de vendas que fornece dados consolidados ao final do dia.
* **Arquivo de Saída:** Crie arquivo com os dados retornados pela API em um arquivo JSON ou em outro formato adequado no **Data Stack**.
* **Análise e Relatórios:** Utilize o arquivo gerado para criar relatórios detalhados e realizar análises, como o cálculo das comissões dos vendedores.

{% hint style="warning" %}
Importante: O "Proxy para Data Engine" salva os dados exatamente como são retornados pela API. Sendo assim, se a estrutura dos dados retornados pela API for complexa, o arquivo gerado refletirá essa complexidade.
{% endhint %}
