Terminais
Last updated
Last updated
Um terminal é uma entidade lógica que representa a conexão de um único "Agente", instalado em uma máquina e vinculado a um usuário, ao "Espaço de Trabalho" desse usuário na plataforma.
Um "Espaço de Trabalho" pode conter vários terminais. Além disso, qualquer usuário do espaço pode executar o Agente.
Em uma máquina com um "Agente" instalado, um terminal atua como um intermediário para permitir que uma aplicação acesse o Banco de Dados de uma empresa ou a interface REST de um ERP. Isso possibilita várias integrações diferentes sem a necessidade de uma API pública. Assim, diversos fluxos dentro de um "Espaço de Trabalho" podem usar o mesmo terminal, conectados por uma ou mais contas de usuário.
Após instalar e configurar um "Agente" em um ambiente local (On Premises), automaticamente é criado um terminal na plataforma Skyone Dados. Daí em diante, você pode escolher e usar esse terminal na plataforma para configurar contas do tipo REST ou Banco de Dados. Quando você seleciona um terminal na configuração dessas contas, as credenciais da conta são enviadas ao Agente para serem usadas localmente.
Você pode associar várias contas conectadas a um único terminal. Isso significa que você pode criar diversos usuários em um banco de dados para serem utilizados em diferentes integrações. Cada usuário poderá ser configurado em uma conta distinta, mas todas as contas apontarão para o mesmo terminal.
O terminal de um "Agente" é permanentemente monitorado, de forma que a plataforma sempre sabe quando ele está conectado e operacional. Por outro lado, a queda de um terminal, percebida através da desconexão do "Agente" a ele conectado, implica a queda de todas as contas conectadas a ele associadas.
Por padrão, o campo "Terminal" de uma conta do tipo REST ou Banco de Dados é deixado em branco, o que corresponde à não utilização do "Agente" durante a conexão. Para utilizar um "Agente" previamente instalado, você deverá selecionar um dentre os terminais (ativos ou não) que estão configurados no sistema:
Quando você utiliza um "Terminal" numa conta, a execução de operações em um módulo (testes) ou em um fluxo (testes ou execução) somente ocorrerá se o "Agente" estiver sendo executado e o status do "Terminal" estiver ativo (verde).
Na aba "Terminais" você verá todos os terminais conectados ao "Espaço de Trabalho" selecionado. Caso não tenha ainda instalado e configurado um agente, poderá baixar o "Agente" clicando em "Baixar Agente".
Após a configuração de um ou mais Agentes, a lista dos terminais disponíveis e seus respectivos detalhes e status serão exibidos na tela:
Cada linha corresponde a uma entrada de "Agente" com as suas informações básicas. As informações desta tela são dinâmicas, com atualização automática em alguns segundos.
Sendo que:
ID: identificador único do "Agente"
Nome do Agente: nome atribuído na configuração do "Agente"
Conectado em: última vez que o "Agente" se conectou
IP do Agente: endereço IP do computador onde o "Agente" foi instalado, exibido apenas quando este está conectado
Host ID: assinatura do host que identifica unicamente a máquina onde o "Agente" está instalado
Status: status da conexão do "Agente"
Para visualizar informações detalhadas de um terminal:
Em "Terminais", escolha o "Agente" que deseja visualizar e clique no ícone de "Mais Opções";
Selecione "Visualizar";
A tela visualização das Informações do Terminal será exibida e você verá os seguintes campos:
Host ID: assinatura do host, que identifica de forma única a máquina onde o "Agente" está instalado
Nome do Agente: nome fornecido na configuração do "Agente"
Localização do Agente: localização fornecida na configuração do "Agente"
IP do Agente: endereço IP da máquina onde o "Agente" está instalado
Conectado em: data da última conexão, no formato DD/MM/AAAA HH:MM:SS
Último controle do APC: última vez que a plataforma enviou uma APC (Agent Procedure Call - chamada realizada pelo "Agente" )
Último dado do APC: última vez que a plataforma recebeu mensagens
Controles entregues pelo APC: quantidade de mensagens enviadas
Dados recebidos pelo APC: quantidade de mensagens recebidas
Contas Conectadas: contas que apontam para o "Terminal"
Para ver os logs de um terminal:
Em "Terminais", escolha o "Agente" que deseja ver os logs e clique no ícone de "Mais Opções";
Selecione "Logs";
Os logs do terminal será exibido (se houver).
O status da conexão garante que existe uma conexão estabelecida, porém não garante o funcionamento completo. O teste de conexão executa um teste completo envolvendo o "Agente" .
Para testar a conexão:
Em "Terminais", escolha o "Agente" cuja conexão deseja testar e clique em "Mais Opções" (ícone de três pontos);
Selecione "Testar Conexão";
Aguarde a conexão ser testada e o resultado.
Este recurso permite visualizar todas as contas conectadas ao terminal, além de oferecer opções para migrá-las ou desvinculá-las.
Para visualizar as contas:
Em "Terminais", escolha o Agente que deseja visualizar as contas conectadas e clique no ícone de "Mais Opções";
Selecione "Contas".
A tela exibirá as informações da conta: Nome da conta, ID e o Tipo.
Além disso, estão disponíveis duas ações:
Migrar conta:
Clique em "Migrar".
Selecione o terminal de destino.
Clique em "Próximo".
Confirme a migração digitando o nome do terminal.
Finalize clicando em "Confirmar".
Desvincular conta:
Clique em "Desvincular".
Digite o nome do terminal que deseja desvincular.
Confirme a ação clicando em "Desvincular".
Caso você exclua um "Agente" da aba "Terminais" e queira depois voltar a utilizar a aplicação, será necessário desinstalar e reinstalar a aplicação. Isto também é necessário caso deseje alterar as configurações iniciais de instalação (Espaço de Trabalho, conta do Skyone Studio, Nome e Localização do Agente).
Para excluir um "Agente", siga os seguintes passos:
Em "Terminais", escolha o Agente que deseja excluir e clique no ícone de "Mais Opções";
Selecione "Excluir";
Digite o nome do terminal que deseja excluir e, em seguida, confirme a ação clicando em "Excluir";
De volta ao "Agente" , a conexão ao servidor será interrompida. Para configurar novamente o "Agente" será necessária a desinstalação e reinstalação.
