Terminais

Conceito

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 no Skyone Studio. 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.

É possível instalar quantos "Agentes" você quiser, para um mesmo usuário ou "Espaço de Trabalho", desde que sejam instalados em diferentes dispositivos e com nomes e localização distintos. Cada um deles aparecerá como um diferente terminal na plataforma.

Contas Conectadas

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:

Exemplo de configuração de conta conectada

Gerenciamento dos Terminais

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"

Informações do Terminal

Para visualizar informações detalhadas de um terminal:

  1. Em "Terminais", escolha o "Agente" que deseja visualizar e clique no ícone de "Mais Opções";

  2. Selecione "Visualizar";

  1. 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"

Testar a Conexão

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:

  1. Em "Terminais", escolha o "Agente" cuja conexão deseja testar e clique em "Mais Opções" (ícone de três pontos);

  2. Selecione "Testar Conexão";

  1. Aguarde a conexão ser testada e o resultado.

Logs do Terminal

Para ver os logs de um terminal:

  1. Em "Terminais", escolha o "Agente" que deseja ver os logs e clique no ícone de "Mais Opções";

  2. Selecione "Logs";

  1. Os logs do terminal será exibido (se houver).

Excluir um Agente

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:

  1. Em "Terminais", escolha o Agente que deseja excluir e clique no ícone de "Mais Opções";

  2. Selecione "Excluir";

  1. Digite o nome do terminal que deseja excluir e, em seguida, confirme a ação clicando em "Excluir";

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

Last updated