Conexões

O que é a área de Conexões

A área de Conexões centraliza e gerencia todos os pontos de integração da Wisedit com fontes de dados internas ou externas. Cada conexão pode ter múltiplas integrações associadas, desde que sejam do mesmo tipo (CSV, NoSQL, REST, SOAP ou SQL).

Listagem de conexões

Tela de listagem de conexões

A listagem de conexões pode ser acessada no menu lateral (Sidebar).

Nesta tela você pode:

🔍 Filtrar conexões - Por nome, última execução, tipo de conexão, tipo de dado ou situação
➕ Adicionar nova conexão - Criar uma nova conexão no sistema
✏️ Editar conexão - Modificar configurações de conexões existentes
📋 Duplicar conexão - Criar cópia de uma conexão existente

Adicionar uma nova conexão

Campos marcados com * são obrigatórios.

ETAPA 1: Configuração Geral

Etapa 1 - Configuração Geral

Campos comuns a todos os tipos de conexão.

1. Nome da conexão*

Descrição: Nome amigável e único para identificar esta conexão.

Exemplos: Banco de Dados de Clientes, MongoDB Produção.

2. Descrição

Descrição: Campo opcional para adicionar informações relacionadas à conexão que está sendo cadastrada.

Exemplo: Conexão com o banco de dados principal que armazena informações de usuários e logs.

3. Tipo da conexão*

Descrição: Define a tecnologia principal da conexão.

Tipos disponíveis:

CSV - Arquivos de valores separados por vírgula
NoSQL - Bancos de dados não relacionais (MongoDB)
REST - APIs RESTful
SOAP - Web Services SOAP
SQL - Bancos de dados relacionais

4. Situação*

Descrição: Indica se a conexão está operacional ou desativada.

Tipos:

Ativo: a conexão poderá ser utilizada nas execuções.
Inativo: a conexão ficará salva, mas não será utilizada.

5. Alerta*

Descrição: Define se o sistema deve emitir notificações em caso de falha ou indisponibilidade.

Tipos:

Sim: o usuário recebe uma notificação no e-mail informando.
Não: não será notificado sobre indisponibilidades.

ETAPA 2: Configuração Específica por Tipo

Dependendo do tipo de conexão selecionado na ETAPA 1, você deverá preencher campos específicos conforme as seções abaixo.

Navegação rápida:

CSV - Arquivos CSV como fonte de dados
NoSQL - Bancos de dados não relacionais
REST - APIs RESTful com autenticação
SOAP - Web Services SOAP
SQL - Bancos de dados relacionais

CSV

Conexão CSV

Descrição: Utiliza arquivos .csv como fonte de dados.

NoSQL

Conexão NoSQL

1. Tipo de banco*

Descrição: Especifica o sistema de gerenciamento de banco de dados NoSQL que será utilizado.

Tipos disponíveis: MongoDB

2. Nome do banco de dados*

Descrição: O nome exato do database dentro da sua instância MongoDB à qual você deseja se conectar.

Exemplos: wisedit_app, clientes_db.

3. Host*

Descrição: O endereço do servidor onde o banco de dados MongoDB está hospedado. Pode ser um endereço IP ou um nome de domínio. A porta padrão do MongoDB (27017) pode ser adicionada se for diferente, no formato host:porta.

Exemplos: localhost, 127.0.0.1, cluster0.abcde.mongodb.net.

Descrição: O nome de usuário (username) utilizado para autenticar a conexão com o banco de dados.

Exemplos: admin, user_wisedit.

5. Senha*

Descrição: A senha (password) associada ao usuário (login) informado. Por segurança, o campo exibirá os caracteres como pontos. Você pode clicar no ícone de “olho” para visualizar a senha digitada.

REST

Campos Iniciais

1. Base URL*

Descrição: O endereço principal da API. É a parte da URL que não muda entre as requisições.

Exemplo: https://viacep.com.br/ws/

2. Mapeamento de retorno

Descrição: Após a autenticação e a chamada à API, esta seção serve para conectar os dados recebidos da resposta com os campos internos do Wisedit.

Campos:

Campo retorno (key): O nome da chave no JSON de resposta da API (ex: logradouro)
Campo destino: O campo no seu sistema onde o valor será salvo

Clique em Adicionar para cada campo que deseja mapear.

Preenchimento por Tipo de Autenticação

Dependendo do tipo de autenticação que a API REST exige, preencha conforme abaixo:

Navegação rápida:

NO AUTHENTICATION - APIs públicas
AUTH BODY - Credenciais no corpo da requisição
BASIC AUTH - Autenticação com usuário e senha
API KEY - Chave de API
BEARER TOKEN - Token de autenticação

NO AUTHENTICATION (REST)

Conexão REST - No Authentication

Quando usar: Para APIs públicas que não exigem nenhum tipo de login, chave ou token.

Como preencher:

Selecione NO AUTHENTICATION no campo “Tipo de autenticação”
Configure o Mapeamento de retorno conforme necessário

AUTH BODY (REST)

Conexão REST - Auth Body

Quando usar: Quando a API exige que as credenciais sejam enviadas diretamente no corpo (body) da requisição, em formato JSON.

Como preencher:

1. Path URL*

Digite o caminho do recurso (ex: login, authenticate).

2. Objeto JSON de envio

Adicione as chaves e valores que a API espera receber para autenticação:

JSON Key: O nome do campo (ex: username, apiKey)
JSON Value: O valor correspondente (ex: meu_usuario, chave_secreta_123)

Clique em Adicionar para cada par de chave/valor necessário.

BASIC AUTH (REST)

Conexão REST - Basic Auth Quando usar: Quando a autenticação é feita enviando um nome de usuário e uma senha, codificados no padrão “Basic Authentication”.

Como preencher:

1. Path URL*

Digite o caminho do recurso (ex: login, authenticate).

2. Login*

Insira o nome de usuário fornecido pela API.

3. Senha*

Insira a senha correspondente ao usuário. A Wisedit se encarregará de formatar e enviar esses dados no cabeçalho da requisição de forma segura.

API KEY (REST)

Conexão REST - API Key

Quando usar: Usado quando a API fornece uma “chave de API” (API Key) que deve ser enviada para autorizar as requisições. Geralmente, essa chave é enviada nos cabeçalhos (headers).

Como preencher:

1. Path URL*

Digite o caminho do recurso (ex: login, authenticate).

2. Token key*

O nome do campo da chave que a API espera. Verifique na documentação da API qual é o nome correto.

Exemplos comuns: Authorization, x-api-key, api_key.

3. Token value*

O valor da sua chave de API (o token em si).

Exemplo: Bearer sk_live_123abc..., abc123xyz456....

SOAP

Campos Iniciais

1. URL do WSDL*

Descrição: Este é o campo mais importante. WSDL (Web Services Description Language) é um arquivo que descreve o que o serviço faz. Você deve inserir aqui o endereço completo do WSDL fornecido pela documentação do serviço.

Formato Comum: Geralmente, a URL termina com ?wsdl, ?WSDL, ou .wsdl.

Exemplo: http://ws.correios.com.br/calculador/CalcPrecoPrazo.asmx?wsdl.

2. Mapeamento de retorno

Descrição: Após a autenticação e a chamada à API, esta seção serve para conectar os dados recebidos da resposta com os campos internos do Wisedit.

Campos:

Campo retorno (key): O nome da chave no JSON de resposta da API (ex: logradouro)
Campo destino: O campo no seu sistema onde o valor será salvo

Clique em Adicionar para cada campo que deseja mapear.

Preenchimento por Tipo de Autenticação

Dependendo do tipo de autenticação que o serviço SOAP exige, preencha conforme abaixo:

Navegação rápida:

NO AUTHENTICATION - Serviços públicos
AUTH BODY - Credenciais no corpo da requisição
BASIC AUTH - Autenticação com usuário e senha
API KEY - Chave de API

NO AUTHENTICATION (SOAP)

Conexão SOAP - No Authentication

Quando usar: Para serviços públicos que não exigem nenhum tipo de login, chave ou token.

Como preencher:

Selecione NO AUTHENTICATION no campo “Tipo de autenticação”
Configure o Mapeamento de retorno conforme necessário

AUTH BODY (SOAP)

Conexão SOAP - Auth Body

Quando usar: Quando o serviço exige que as credenciais sejam enviadas diretamente no corpo (body) da requisição, em formato JSON.

Como preencher:

1. Path URL*

Digite o caminho do recurso (ex: login, authenticate).

2. Objeto JSON de envio

Adicione as chaves e valores que o serviço espera receber para autenticação:

JSON Key: O nome do campo (ex: username, apiKey)
JSON Value: O valor correspondente (ex: meu_usuario, chave_secreta_123)

Clique em Adicionar para cada par de chave/valor necessário.

BASIC AUTH (SOAP)

Conexão SOAP - Basic Auth

Quando usar: Quando a autenticação é feita enviando um nome de usuário e uma senha, codificados no padrão “Basic Authentication”.

Como preencher:

1. Path URL*

Digite o caminho do recurso (ex: login, authenticate).

2. Login*

Insira o nome de usuário fornecido pelo serviço.

3. Senha*

Insira a senha correspondente ao usuário. A Wisedit se encarregará de formatar e enviar esses dados no cabeçalho da requisição de forma segura.

API KEY (SOAP)

Conexão SOAP - API Key

Quando usar: Usado quando o serviço fornece uma “chave de API” (API Key) que deve ser enviada para autorizar as requisições.

Como preencher:

1. Path URL*

Digite o caminho do recurso (ex: login, authenticate).

2. Token key*

O nome do campo da chave que o serviço espera. Verifique na documentação do serviço qual é o nome correto.

Exemplos comuns: Authorization, x-api-key, api_key.

3. Token value*

O valor da sua chave de API (o token em si).

Exemplo: Bearer sk_live_123abc..., abc123xyz456....

SQL

Conexão SQL