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 na plataforma.

Essa funcionalidade está em módulos do tipo REST.

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.

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:

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.
• Grupos de escrita: Escolha os grupos que poderão escrever o arquivo. Por padrão, é o grupo 'default'. Saiba mais em Grupos.
• 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()

• Destinos: Local onde o arquivo será enviado. É possível buscar um destino na barra de busca ou adicionar um novo em "Adicionar destino".

• 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.

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.

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.