Agente

• Visão Geral

• Requisitos mínimos

• Instalação

• Configurações

• Logs

  • Windows

  • Linus e Docker

  • Registro do Agente: Erros Possíveis

Visão Geral

Grande parte dos ERPs não dispõe de APIs abertas e completas que permitam que esses softwares sejam integrados com outras aplicações e soluções. Como alternativa, a maior parte dos fabricantes de ERPs permite ou tolera uma integração no nível de dados. Nesse tipo de integração um agente externo, tipicamente um serviço instalado na mesma máquina do banco de dados, tem acesso ao banco de dados e pode executar queries em tabelas ou views do sistema.

Partindo deste conceito, criamos o "Agente", uma extensão segura do Skyone Studio que pode ser instalada em ambientes On Premises, utilizando-se de mecanismos seguros de comunicação. Quando utilizado, o "Agente" é um componente passivo, apenas executando requisições enviadas por softwares externos ou automatizadas no Skyone Studio.

Características Gerais do "Agente":

• Conectar-se localmente a um banco de dados ou a um recurso REST

• Suporte a múltiplos tipos de banco de dados

• Suporte ao conjunto completo de recursos REST

• Processar requisições oriundas de qualquer integração no Skyone Studio, com usuários e permissões distintos

• Conectar-se ao Skyone Studio e manter um canal de comunicação aberto para receber chamadas imediatamente

• Receber chamadas “RPC like” do Skyone Studio, que são mapeadas em ações no banco de dados ou em chamadas REST

• Responder de maneira assíncrona às chamadas do Skyone Studio.

• Reiniciar-se automaticamente caso o computador onde está instalado seja reiniciado, sem a necessidade de reinserção de dados de autenticação

Requisitos mínimos

Os requisitos mínimos para o "Agente":

• Disco: 1GB livre

• Memória: 512MB

• CPU: 1 core 1.5GHz

Instalação

Para baixar e instalar o "Agente" :

1. Clique em "Terminais" e, em seguida, clique em "Baixar Agente".

2. Observe que há três opções para download: Windows, Linux e Docker. Escolha a opção mais adequada e clique em "Download".

3. Siga as instruções de acordo com o sistema operacional:

Windows

Para o sistema operacional Windows:

1. Na tela que aparece ao executar a aplicação, clique em "Avançar". Aguarde o término da instalação.

2. Uma vez que a instalação tenha sido bem sucedida, clique na opção "Iniciar Aplicação" e, em seguida, no botão "Concluir" para finalizar a instalação.

3. O Agente irá ser inicializado e serão apresentados alguns passos para a configuração do mesmo. Clique em "Próximo".

1. Informe suas credenciais de acesso ao Skyone Studio e clique em "Próximo".

1. Selecione a organização (espaço de trabalho) que deseja utilizar o "Agente", bem como digite um nome e localização para o mesmo.

1. Pronto! Seu "Agente" está configurado e pronto para ser usado em ambientes Windows. Clique em "Finalizar" para encerrar o procedimento de configuração.

Linux

Docker

Saiba mais sobre as versões suportadas pelo Agente aqui.

Será necessário reinstalar o "Agente" caso necessite movê-lo para outra estação, adicioná-lo novamente ao Skyone Studio, ou caso seja necessário realizar modificações no hardware.

Configurações

Siga as instruções para configurar o seu "Agente", de acordo com o sistema operacional:

Windows

Ao clicar no "Agente" no Windows, "Configurações" é a primeira aba a ser mostrada pela janela.

Sendo que:

• Status do serviço de integração: é possível Iniciar, Parar e Reiniciar o serviço de integração. Quando ele é parado, não é possível executar operações no Skyone Studio. envolvendo contas conectadas com "Terminal" cadastrado.

• Teste de conexão com à internet: identifica se o "Agente" está conectado com a internet.

• Conexão com o servidor: identifica se o "Agente" está conectado com os servidores do Skyone Studio.

• Limite de processos concorrentes: permite ajustar a capacidade de processamentos em paralelo entre o range de 1 a 100. O valor padrão é 50. Após qualquer alteração, clique em "Aplicar". Depois disso, confirme a reinicialização dos serviços do "Agente" clicando em "Sim", para que as novas configurações sejam ativadas.

• Permitir certificados SSL não confiáveis em requisições REST/SOAP: ao ativar essa opção, o "Agente" permitirá a comunicação entre os sistemas, mesmo que o certificado SSL não seja considerado seguro pelos padrões convencionais. Ao acionar, deslizando o botão, aparecerá uma janela para que você confirme a reinicialização dos serviços do "Agente" e, assim, as novas configurações sejam ativadas.

Quando qualquer um dos dois serviços (integração ou servidor) estiver funcionando, o ícone colorido estará verde. Caso haja problema com a conexão, ele ficará vermelho. Se o "Agente" estiver aguardando conexão com um dos serviços, o ícone ficará cinza.

Após o cadastro do "Agente", ele logo aparecerá na aba "Terminais".

Caso haja problema com algum dos serviços (integração ou servidor), o status do "Agente" cadastrado também aparecerá com a cor cinza ou vermelha na coluna "Status".

É possível fechar a janela do "Agente", sem que isto comprometa o uso do Skyone Dados. No entanto, o computador precisa ser mantido ligado para que a comunicação seja realizada.

Linux

Docker

Logs

Windows:

Há a aba de Logs, de somente leitura, que mostra todos os logs do "Agente". Esses registros serão atualizados conforme novos eventos ocorram.

Linus e Docker

É possível acessar a pasta de logs do diretório onde a aplicação está sendo executada.

Exemplo: cat /logs/log20231206.txt

Registro do Agente: Erros Possíveis

Os seguinte erros são possíveis no retorno da requisição de registro:

Mensagem de Erro	Descrição / Ação
Agent already configured on host (agente já configurado no host)	O Skyone Studio. identificou que já existe um "Agente" previamente configurado na estação. Você pode abortar a instalação ou, caso tenha autorização, pode entrar no painel do Skyone Studio. e excluir o "Terminal" associado ao "Agente" antigo. Ao fazer isso, você poderá tentar novamente a operação. Caso você não tenha permissão para excluir o "Terminal", é possível que esteja tentando instalar o "Agente" no "Espaço de Trabalho" errado. Nota: o mesmo "Agente" pode ser utilizado por diversas Integrações; portanto. não existe a necessidade de múltiplas instalações.
Agent name already exists (o nome do agente já existe)	O Skyone Studio identificou que já existe um "Agente" com o mesmo nome disponível no "Espaço de Trabalho". É possível que isso tenha acontecido por que você deseje mover o "Agente" de uma estação para outra, sem perder todo o trabalho já executado nas Integrações que apontam para o Terminal do Agente. Nesse caso, você deve instalar o "Agente" na nova estação e utilizar o mesmo nome para substituir a anterior. Dessa forma, o Skyone Dados alerta que o Agente anterior com o mesmo nome será desativado e substituído pelo novo e também pede a sua confirmação para proceder com esta alteração.
Control channel is not configured (canal de controle não configurado)	Aparece apenas durante a configuração do "Agente", antes que os seus dados sejam inseridos, e significa que o "Agente" ainda não foi configurado. Nenhuma ação deve ser tomada.